Virtual Desktop Images (Software Stacks)

A Software Stack is an Amazon Machine Image (AMI - pronounced Ay-Em-i) with your applications pre-installed and configured for your users. Users can then provision their virtual desktops easily with all the software pre-loaded and ready to be used.

Prepare a virtual desktop to be used as Software Stack

Windows

IMPORTANT

A Software Stack, also known as Amazon Machine Image (AMI), is a complete snapshot of your EC2 host.

Make sure you do not have any confidential data hosted on your Virtual Desktop before creating the image.

Here is a non exhaustive list of recommendations you must review prior to creating the image:

It's highly recommended to start creating a new Software Stack from a brand new Virtual Desktop.
Verify you have not stored any passwords on your internet browser. It's recommended to clear the cache of all browsers.
Verify there is no confidential information on your current $HOME directory.
Verify your Document/Download/Desktops folders are empty or don't contains any confidential information.
Verify the list of local user(s) that belong to the "Administrators" group. User(s) who have Administrator permissions on the virtual desktop will inherently have the same permissions on all future desktops launched by the software stack.
As an extra step, you can completely delete your $HOME directory

First, launch your Virtual Desktop and install some applications. Once you are done, click the Search Button and right-click on "Windows PowerShell" to "Run As Administrator".

On the PowerShell terminal, execute the following command to re-enable the execution of EC2 UserData script.

C:\ProgramData\Amazon\EC2-Windows\Launch\Scripts\InitializeInstance.ps1 -Schedule

At this point, go back to the IDEA Virtual Desktops web-interface, select your Virtual Desktop and click "Action" > "Show Info" to display detailed details about your desktop, then search for "Instance ID".

Open your EC2 console and search for your instance then click "Actions" > "Image and templates" > "Create Image"

Choose a name and a description, make sure to check "No Reboot: Enable" then click "Create Image"

Navigate to the AMI tab and verify if your image status is "available" and copy your AMI ID.

My AMI is taking forever:

You will not be able to use your image until the status is available.

Creating an AMI may take a couple of hours depending the size of the image.

To check the progress of your image, navigate to "Snapshots" section and refer to the Progress column for all EBS volumes created by your image

Once your AMI is in available state, log in to IDEA and refer to Register a new Software Stack on IDEA

Register a new Software Stack on IDEA

To register a new Software Stack, click "Create Software Stack" under the "Software Stacks (AMIs)" section

You will be asked to enter a name, description and other parameters specific to your image.

You will also need to specify which IDEA Projects are authorized to use this image. Refer to Project Management to learn more about IDEA Projects and ACLs.

Storage Size (GB) must match the size of the EBS volumes attached at the time of the image creation

Use your new Virtual Desktop Software Stack

Once created, the Software Stack will be visible to all users who belong to the associated project(s). Refer to Create a virtual desktop (Linux/Windows) to learn how to launch your desktop with the new image

PreviousSessions NextPermissions management

Last updated 2 years ago