Installation Checklist
Introduction
This checklist outlines the resources and information required before beginning the installation of the Virtual Appliance. Ensure that all necessary components, configurations, and authorizations are in place before proceeding.
Before You Start: Gather the Following Resources
Hypervisor Information
Ensure that your hypervisor is on the supported list:
VMware ESXi 5.5 - 7.0 (OVA file)
Microsoft Hyper-V - Server 2012 R2 and higher (VHDX file)
Citrix Hypervisor 8.2 (OVA file)
Microsoft Azure (VHD file)
Ensure that you have the necessary permissions to make changes to the hypervisor or coordinate with the Infrastructure Admin team if needed.
Hardware Resources for Virtual Appliance
Ensure the following resources are available for the VM hosting the Virtual Appliance:
CPU: 4 vCPU
RAM: 8GB RAM
Storage: 100 GB virtual Hard Disk
Download the Virtual Appliance in your preferred format (OVA, VHD, or VHDX). For details, see Downloads.
Networking and DNS Information
Obtain the Fully Qualified Domain Name (FQDN) for the Virtual Appliance.
Ensure that the appropriate DNS settings are in place.
Active Directory (AD) Accounts
Create the necessary Virtual User accounts in Active Directory and ensure they are licensed for the appropriate systems and applications (e.g., RDS CALs, Citrix, Office365, etc.)
Configure the Logon Executable via Group Policy for Virtual Users at the user level (not machine level).
Create an AD account for the Launcher to log in, and consider creating a service account for sending email alerts.
Account Checklist
Before you begin the installation, verify that your user accounts and logon configurations are set up correctly:
Test User Login
Log in with one of your test user credentials to access the target environment, applying the same authentication method as your end users
This ensures that users can authenticate and access the virtual desktops or applications they will need.
Active Directory User Permissions
Ensure that the Virtual User accounts are correctly synchronized with Active Directory and authorized to access the target resources (e.g., Citrix, VMware, etc.)
Ensure that the Admin AD User Group has appropriate administrative access to the required resources.
Ensure that the Read-only AD User Group has the necessary read-only access to the required resources.
Logon Configuration
Ensure that the Logon Executable is configured to start during the logon process via Group Policy at the user level (not the machine level).
There are several ways to fulfill this requirement:
Group Policy to execute Logon Executable at Windows logon
NETLOGON/ Logon Script for the Virtual User AD User
shell:startup (For single-user OS scenarios, not recommended for production)
shell:common startup (For multi-session OS scenarios, not recommended for production)
Launcher Resources
Launcher Hardware
Ensure that the Launcher machines meet the minimum hardware requirements:
2 vCPU
4GB RAM
Minimum available disk space: 1GB free virtual hard disk space.
Logon Configuration
Configure auto-login for the Launcher machines if necessary.
Launcher Software
Download and prepare the Launcher software for installation on the required machines.
Windows 7 and later (32/64-bit) or Windows Server 2012 R2 or later
Microsoft .NET Framework 4.8
Client Connector Application (Citrix Workspace, VMware Horizon Client, Universal Web Connector)
Login Enterprise Launcher
Client Connector
Ensure that the Client Connector software (e.g., Citrix Workspace, VMware Horizon, RDP, UWC) is installed and ready on the Launcher machine.
Server and Broker Information
Broker Configuration
Ensure that your brokers (e.g., Citrix, VMware Horizon) are configured and ready to accept connections from Virtual Users.
Resource Pools/VMs
Ensure that the resource pools and VMs needed for Virtual Users and Launchers are set up in your hypervisor or virtualization environment
Certificates
Obtain the necessary certificates (if applicable) for secure communication and ensure they are installed and configured for the Virtual Appliance and Launchers.
Additional Information to Verify
Permissions and Access Rights
Ensure you have the appropriate permissions to install and configure software on the necessary machines (Launcher, Target Environment, etc.). If not, coordinate with the relevant teams.
Licensing Requirements
Virtual User Licensing: Ensure that each Virtual User has the correct licensing to interact with the target resources (e.g., RDS CALs, Citrix, etc.)