Search - Installation Guide

Revision History

Version » Revision History

Revision Date Version Changes 13/01/2021 1.0 Initial Document 22/01/2020 1.1 Added HA and single deployment diagrams in Section 7 08/02/2021 1.2 Ammended supported browsers …

*Please Note: The instance MUST have Internet connectivity. Log on to the WorkSpaces Manager EC2 instance, go to your preferred browser and go to http://localhost. From a browser, connect to the Private IP address of the WorkSpaces Manager portal instance from a…

Prerequisites for the installation of the WorkSpaces Manager appliance

This section is made up of the following Prerequisites AWS WorkSpaces Cost Optimizer Active Directory Service Account Port Requirements

Integrate with WSUS

Installing the Appliance » First Time Setup » Additional Options » Integrate with WSUS

Windows Server Update Services (WSUS) enables to deploy the latest Microsoft product updates in an automatic manner, ensuring that the Windows WorkSpaces are up-to-date in terms of upgrades. More info can be found on the Microsoft website. If this is enabled, then we…

HTTPS/TLS Encryption

Appendices » HTTPS/TLS Encryption

To configure HTTPS/TLS encryption in front of the WorkSpaces Manager Appliance, you can add a Network Load Balancer as explained below. If you have not created a Network Load Balancer, refer to it create one NLB. Now that we have a friendly hostname, we can associate…

WorkSpaces Portal Requirements

Software requirements » WorkSpaces Portal Requirements

Platforms Support Windows Server 2012 R2/2016/2019. Only 64-bit versions where applicable are supported. Both physical and virtual instances are also supported. Additional Software • Microsoft® .NET Framework 4.6.2 or higher • Microsoft SQL Server Express or…

Email for Report

Installing the Appliance » First Time Setup » Additional Options » Email for Report

The email of the person\group that receives the Activity report stated in Activity Reporting.

CO (Cost Optimizer) Alternate Format

Installing the Appliance » First Time Setup » Amazon Web Services » CO (Cost Optimizer) Alternate Format

This option is used when upgrading from version 1 of the AWS Cost Optimizer to the newest. If there is an error about getting the log from the bucket, we will enable this feature.

AccessLog Group

Installing the Appliance » First Time Setup » Amazon Web Services » AccessLog Group

This is to add the CloudWatch Log Group that manages all the information from users’ connection, like public IP, client version, latency, etc. Check CloudWatch Log Group for details.

Default AWS Region

Installing the Appliance » First Time Setup » Amazon Web Services » Default AWS Region

This is the AWS Region that your Amazon WorkSpaces are hosted in. For example, Ireland will be eu-west-1. A full list of Regions can be located here.

Multiple Accounts

Installing the Appliance » First Time Setup » Additional Options » Multiple Accounts

This enables management of WorkSpaces across multiple AWS accounts. Please refer to the Multi AWS Accounts section of the WorkSpaces Manager Administrator Guide which tells you how to set it up.

WorkSpaces Performance Monitor Agent requirements

Software requirements » WorkSpaces Performance Monitor Agent requirements

The WorkSpaces Performance Monitor Agent requires .NET 4.6.2 or higher pre-installed on the WorkSpaces themselves. If it is not installed, the agent will prompt for the installation. Installation covered in the WorkSpaces Performance Monitor Agent…

WSUS URL

Installing the Appliance » First Time Setup » Additional Options » WSUS URL

This will normally default to the same node in which WSM runs, so we will use “localhost”. This requires to configure the basic options of WSUS. There is an intro in WSUS Configuration.

Portal URL

Installing the Appliance » First Time Setup » Additional Options » Portal URL

Enter your portal URL here: e.g. https://wsmportal.mycompany.com. We recommend adding a Network Load Balancer (NLB) offloading SSL certificates in front of the portal, as explained in HTTPS/TLS Encryption

WorkSpace Service Update Frequency (mins)

Installing the Appliance » First Time Setup » Additional Options » WorkSpace Service Update Frequency (mins)

This will automatically update the local database with up-to-date information on this period. 15 minutes is sufficient for most cases, but you would not want to do this on, for example, a 1-minute period on a very large WorkSpaces and user estate. If you need to do a…

Auto Provision

Installing the Appliance » First Time Setup » Additional Options » Auto Provision

Turns on Auto-Provisioning of WorkSpaces via Active Directory groups. See AP Profiles section of the Administration Guide for more information on this. If Auto-Provision is enabled, the service will poll the Active Directory groups every 15 minutes for new…

Active Directory Service Account

Prerequisites for the installation of the WorkSpaces Manager appliance » Active Directory Service Account

When adding the AD Service Account to support AWS WorkSpaces you will have to provide an account with permissions to create computer objects within AD to the OU specified at the time. • See Administrator Active Directory Permissions for details We recommend using…

Software requirements

WorkSpaces Manager is available as a standalone product and consists of three parts: The Management Portal, the Update Service, and the WorkSpaces Performance Monitor Agent. The WorkSpaces Management Portal provides one central location where users can manage their…

SMTP

Installing the Appliance » First Time Setup » SMTP

This enables the appliance to send emails informing new users once a new WorkSpace is ready and\or if their password is to expire. It is also required for the auto-delete function. You could use AWS Simple Email Service (SES) to achieve this, or your own SMTP setup.…

Statistics Retention Days

Installing the Appliance » First Time Setup » Additional Options » Statistics Retention Days

If the WorkSpace Performance Monitor Agent has been deployed to the WorkSpaces, it will periodically report back the server key metric statistics as defined in the Group Policy (see here for installing the WorkSpaces Performance Monitor Agent). In a large estate, this…

User/Admin Portal

High Availability » User/Admin Portal

There are several ways that HA can be provided for the Portal including Auto Scaling Groups. The simplest method is to make an Amazon Machine Image (AMI) of your appliance. 1. Log into your Amazon Web Services EC2 site using your administrative…

AD Group Applications

Installing the Appliance » First Time Setup » Applications » AD Group Applications

Enable this is you use software distribution on to your WorkSpaces from the likes of Liquidware FlexApp, App-V, etc. This allows users to add and remove applications available to them through the Self-Service side of the WorkSpaces Manager Portal. You can change this…

Product Highlights

Updated 15th January 2023 for WorkSpaces Manager 5.5.0 Product highlights: • WorkSpaces Environment Management with optional application self-service feature for domain group-based application deployment • Task driven User & WorkSpaces provisioning • Performance…

CloudWatch Log Group

Appendices » CloudWatch Log Group

Go to CloudWatch Click on “Events” > “Rules” Click on the button “Create rule” In the “Rule Detail”, we put a “Name” and “Description” and leave the default configuration as shown below: In the “Event…

License Key Process

Apply For License Key » License Key Process

Go to the AWS Marketplace and search for ‘Workspaces Manager’ and select ‘Nuvens’ as the Vendor filter. Select the product below. Now, select ‘Continue to Subscribe’. Some regions may ask for a second confirmation: If you are…

SES Configuration

Appendices » SES Configuration

To configure AWS Simple Email Service (SES) as a SMTP Relay for WorkSpaces Manager, we will need to do the following steps: 1) DNS Domain to be used as sender 2) Create DNS records as requested 3) Create SMTP Credentials 4) Test emails 5) Configure WSM First, navigate…

Installing the WorkSpaces Management appliance from AWS Marketplace

Installing the Appliance » Installing the WorkSpaces Management appliance from AWS Marketplace

Please ensure you are logged on to your AWS Console. Proceed to the AWS Marketplace and search for ‘Workspaces Manager Appliance’. Alternatively, click this link AWS Marketplace to take you there. When found, select ‘Continue to subscribe’. You now need…

WorkSpaces Client Disconnection after idle time

WorkSpaces Performance Monitor Agent » WorkSpaces Client Disconnection after idle time

Introduction In the context of Amazon WorkSpaces, “idle time” refers to the period during which a user is not actively using their virtual desktop or workspace session, but if the client software is open, this is not detected because the PCoIP or WSP client is…