This article is a quick guide for adding a Microsoft Windows template to use with your Amazon Workspaces Core deployment. It is part of the Getting Started with Workspot article series.
Below are the steps to set up WorkSpaces Core template for this integration.
Note: Your AWS account must be set up for Amazon WorkSpaces Bring Your Own License (BYOL) and Bring Your Own Protocol (BYOP) or import process will fail. See BYOL document on how to request BYOL and BYOP.
Create a WorkSpaces BYOL/BYOP base image by following the steps 1 through 5 in the WorkSpaces admin guide.
Once the image has been imported into EC2, you will then create an EC2 instance based on that imported Amazon Machine Image (AMI).
Enable metadata access with V1/V2 support. Do not use the “V2 Tags Only” setting.
Remotely connect to the EC2 instance using Remote Desktop Protocol (RDP).
Install and configure the Workspot agent:
Download the latest Workspot Agent.
Install Agent as an Administrator and provide your Workspot Control Admin credentials (see Workspot Agent Installation and Configuration).
As an administrator, browse to the C:\Program Files\WorkspotAgent folder.
Launch WorkspotConfigEditor.exe. Note: You may need to get permissions to the c:\programdata\WorkspotAgent folder to create the XML config file.
Select the option for “Do Not Domain Join” and choose “Submit.”
Once the Workspot agent has been installed and configured, rerun AWS Workspaces BYOL Checker tool to ensure that all tests PASSED. Do not select “Run Sysprep”
Create another AMI with the same name as the EC2 instance. Workspot Control captures the Instance Name from metadata tag used for registration.
Once the AMI is created, import the AMI as a Workspace Image using the AWS CLI. (using the same name as the EC2 instance and AMI name as before). Use the
import-workspace-image
CLI command . The Ingestion type must be “BYOL_REGULAR_BYOP” or “BYOL_GRAPHICS_G4DN_BYOP” for GPU template. Example below.
aws workspaces import-workspace-image --ec2-image-id ami-888888888 --ingestion-process BYOL_REGULAR_BYOP --image-name myworkspacesimage --image-description Windows-10-Enterprise --region us-east-1
Wait for the image to reach the Success state. In Workspaces console, create a bundle using the same name as the image created.
Register the template in Workspot Control:
Sign into Workspot Control to register template.
Go to “Setup > Cloud > aws_workspaces_core_cloudname.”
Click on “Register Template > Search” and select your template from the list.
Click Save.
You can now use your template in desktop pools.
Related Documents