LogoLogo
  • Welcome to WorkSpaces Manager
  • Overview
    • Change Log
      • Stable
      • Beta
    • Portal Requirements
      • Software Requirements
      • Hardware Requirements
    • Installation Prerequisites
      • Active Directory Service Account
      • Amazon WorkSpaces Cost Optimizer
      • CloudWatch Log Group & Eventbridge Rule
      • Port Requirements
      • AWS Service Endpoints
    • Installation Procedure
      • Subscribe to WorkSpaces Manager License Key
      • Request a License Key
      • Subscribe to WorkSpaces Manager Appliance
      • Deploy WorkSpaces Manager Appliance via CloudFormation
      • Configure WorkSpaces Manager
    • Upgrade Procedures
      • From Version 5
      • WSM Update Tool
      • Latest Version Updates
    • Alternate deployment options
      • Install manually on EC2
      • Deployment from Shared AMI
        • Security Group
        • IAM Requirements: Custom Policies
        • IAM Requirements: Role and EC2 instance profile
        • Shared AMI (Amazon Machine Image)
      • Create AMI via Packer
      • Deploy an RDS Database via Terraform
    • WorkSpaces Performance Monitor Agent
    • High Availability (HA)
    • Appendices
      • Administrator Active Directory Permissions
      • SES Configuration
      • HTTPS/TLS Encryption
      • Friendly Portal URL Address
      • GPO and values for WorkSpaces Performance Monitor Agent
      • GPO and value for Disconnection after idle time
      • IAM Policies in JSON format
      • AWS CLI v2
      • LDAP (Active Directory) Troubleshooting for WSM
      • RDS Database Options
Powered by GitBook
On this page
  1. Overview
  2. Installation Procedure

Deploy WorkSpaces Manager Appliance via CloudFormation

PreviousSubscribe to WorkSpaces Manager ApplianceNextConfigure WorkSpaces Manager

Last updated 5 months ago

Choose the region where you would like to deploy your WorkSpaces Manager appliance, then click on "Continue to Configuration".

Next, click on "Continue to Launch".

From the "Choose Action" dropdown, select "Launch CloudFormation". Then, click on "Launch".

In the next section, accept all the default entries and click on "Next".

Now, specify the parameters for the CloudFormation stack configuration. Start by providing a Stack Name for the CloudFormation stack, such as "CF-WSMv6". It’s recommended to name the object using the acronym of the service being used in AWS, like starting with "CF" for CloudFormation.

Enter:

  • VPC: From the drop-down menu, choose the VPC where you want to deploy WorkSpaces Manager.

  • Subnet: Select a private subnet from the available options within your chosen VPC to host the WorkSpaces Manager.

  • Subnet: Select a private subnet from the available options within your chosen VPC to host the WorkSpaces Manager.

  • Subnet: Select a private subnet from the available options within your chosen VPC to host the WorkSpaces Manager.

  • RDP Location CIDR: Specify the CIDR block that will allow WorkSpaces users and administrators to access the WorkSpaces Manager. You can modify this setting later by navigating to AWS Console > EC2 > Security Groups.

You will need the associated PEM or PPK key file to decrypt the password later. It’s recommended to store the key in AWS Secrets Manager for future access and security.

Now, configure the additional options:

  1. Tags: It's strongly recommended to tag your resources if desired.

  2. Permissions: Leave this blank as the necessary permissions will be created automatically.

  3. Advanced Options: Keep all settings at their default values. If you wish, you can enter an SNS Topic ARN to receive notifications when the stack is created, but this is optional. You'll know the process is complete when the WorkSpaces Manager appears as an EC2 instance in the console.

After configuring the options, click on "Next".

You will now be on the Review screen. Scroll down to the bottom, check the acknowledgment box, and then click on "Next".

A summary of your configuration will be displayed. Once you have reviewed it, click on "Submit" to begin the deployment.

You will be redirected back to the stack status screen, where you can track the progress of the WorkSpaces Manager stack creation.

You can monitor the tasks as they are being executed. Once the stack creation is complete, the status will change from CREATE_IN_PROGRESS to CREATE_COMPLETE. The entire process typically takes around 3 to 4 minutes to finish.

If you now check your EC2 instances in the region where you installed WorkSpaces Manager, you should see the WorkSpaces Manager instance. Allow approximately 15-20 minutes for the status checks to complete and for the local administrator password to be automatically generated.