Tehama Desktops are virtual Windows or Linux desktops. These desktops are cloud-based, making them easily accessible to anyone you make them available to.
An image of the desktop contains the operating system, software and settings of the desktop.
Before a desktop image is created, some things have to be done to make the desktop ready to be imaged.
Only the Windows C:\ drive is contained in the image, all other drives do not make it into the image. This means the user profile has to be copied into the C:\ drive if you intend to move your user profile to the new image.
To help ensure a successful Custom Image, a Tehama Desktop must first be prepared for imaging, Several files and scheduled tasks are not necessary and should be removed.
Our Technical Support Team has automated the process below for your benefit. You can simply download the tool here.
Alternatively, you can go through the manual steps
Manual Image Preparation
- Preparing your desktop for the image creation process
- Complete all pending Windows updates including restarting the desktop to make sure updates are 100% complete
- Delete the tehama-info file in the C:\Tehama directory. The tehama-info file is a text file
- Delete the config.json file in the C:\Tehama directory
- Delete the .authToken file from the user directory (D:\Users\<username>\)
- Change the IPv4 Checksum offload vale:
- Go to Network and Sharing Center in Control Panel
- Under ‘view your active networks’, select ‘Ethernet’ with Access type: Internet
iii. Click ‘Properties’
- Select ‘Internet Protocol Version 4 (TCP/IPv4)’ and click on ‘Configure’
- Click on the ‘Advanced’ tab on the dialog box that comes and confirm that ‘IPv4 Checksum offload’ is selected, change the value using the dropdown menu on the right hand side
- Turn off Windows Security or Windows Defender
- Turn off Windows Firewall for all Profiles
- Delete SessionStatus task on Task Scheduler
- Run the ImageChecker tool
- Go to C:\Program Files\Amazon
- Double click on the ImageChecker application, click ‘Yes’ on the User Account Control dialog
iii. Click ‘Run’ on the Amazon Workspaces Imager Checker Tool and wait for the process to complete
- Once all the tests are passed, your Tehama Desktop is ready for the image creation process
After the image has been created, you have to go into your new desktop and make a few changes
- Enable Windows Firewall for all profiles
- Turn on Windows Security or Windows Defender
Before creating an image, DIA must fully removed or Staged for Imaging the desktop. If you have DIA fully installed and running on your desktop, you do not have to worry about the nuts and bolts of uninstalling DIA and preparing it for imaging, we have a DIA install (and removal) tool to get the work done here.
Manual DIA Removal
- Uninstall both ControlUp Edge DX components in Add/Remove Programs (You will find this in Windows Control Panel)
- You will have the ControlUp Edge DX - Agent Manager and the ControlUp Edge DX - SIP Agent components, uninstall both
- Delete the Avacee data directory in C:\ProgramData\Avacee
- Delete the Avacee registry key: HKLM\Software\Avacee or HKLM\Software\ControlUP
choose Option 3 to prepare DIA for Imaging
Desktop Icon Backup (Tehama Desktop powered by Amazon Workspaces)
As the User Profile on a Tehama Desktop powered by Amazon Workspaces resides on the D drive. The desktop icons and userspace will not be included in a Custom Image. To preserve the Desktop icons, they must be copied to the public desktop
The following are entirely optional steps to manually backup some of the settings on the desktop.
They are not needed to facilitate the image creation process.
Manual Desktop Icon Backup
- If you want to move your desktop shortcuts, copy your shortcuts to “C:\Users\Public\Public Desktop” (Note: “C:\User\ Public\Public Desktop” is a hidden directory. Enable ‘Hidden Items’ in views on the menu bar)
- The Tehama user profile is in the D:\ drive, and some applications save your user settings and data in the user profile directory which is located in the D:\ drive. If you intend to save those application settings and files, you should move those files and directories to the C:\ drive
We have a suite of tools to help you backup your browser settings for both Internet Explorer and Google Chrome.
Manual Google Chrome Backup and Restore
- Go to D:\Users\<username>\AppData\Local\Google\Chrome\User Data and copy the directory named ‘Default to the C:\ drive’
- After the image has been created, go to C:\ and copy the Default directory from where where you placed it and put it in the %userprofile%\AppData\Local\Google\Chrome\User Data
Manual Google Internet Explorer Backup and Restore
- Copy all files with the .lnk and .url extensions to C:\Users\Public\Desktop
- Create a directory named ie-backup in C:\Tehama
- Go to Registry Editor, Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft and right click on Internet Explorer. Select ‘Export’.
- Enter a name for the .reg file that will be created and select the ie-backup directory you created earlier
- After the image has been created, go to C:\Tehama\ie-backup and import the .reg file you created