HyWorks Session Host server Installation on a Windows server

The HyWorks Session and Host Server components are required on the Windows RDS Servers to deliver Applications and Shared desktops to end-users using HyWorks.

The HyWorks Session Host server can be installed using the session host installer setup.

Note

• Copy the HyWorks setup locally on the target server. Running the HyWorks setup from the UNC path is not supported and will fail.

• Running the HyWorks setup may also fail during the file extraction process if the logged-in user has a roaming profile. Hence, it is recommended to log in with local administrator user credentials.

• Using a freshly installed Windows operating system is crucial. Attempting to use a pre-existing image with conflicting agents installed by other VDI software suites can cause failures without clear indications of the issues.

The HyWorks Session Host server comprises the following components:

• Accops HyWorks Session Host

• Accops HyWorks Monitoring Service

• Accops Session Server Extension

• Accops Session Recording

• Accops HyWorks DVMTool-Lite

• Accops User Experience Manager (AUEM)

Refer to the Accops HyWorks Session Host Server section for details.

Prerequisites

1. .Net 4.7.2(or later): Refer to the Software Requirements section.

2. Microsoft SQL Server Compact Edition v4.0-SP1: Prerequisite for installing the HyWorks Controller or the Session Host Server. SSCE is used by the HyWorks session host agent and monitoring services to temporarily store some data.

3. Session host server v3.4.0.16805 or later does not require SQL CE; the older version will need SQL CE 4.0-SP1.

   • If not installed, the setup should prompt you to download it using the Internet. However, it is also possible to install it prior to invoking the setup.

   • Direct download link: https://www.microsoft.com/en-in/download/details.aspx?id=30709

Installation Steps

1. Log in to the Windows Server with user credentials, administrative privileges, and permission to install certificates.

2. Copy the HyWorks Session Host server setup on the Windows server, which is to be configured with the HyWorks Session Host server role.

3. Launch the Installation wizard by clicking the installer.

   

4. Click Next to proceed with the installation.

   

5. Accept the terms and click Next to proceed.

   

6. Change the Installation Directory, if required, and click Next to proceed. The default installation folder is C:\Program Files (x86)\Accops.

   

7. Click Install to start the installation process for the HyWorks Session Host.

   

8. This will start the installation and automatically enable all the required roles, features as well as the following components:

   1. Microsoft Remote Desktop Services: When selecting the HyWorks Session Host server role during installation, the remote desktop server role will be installed automatically with port number 3389.
   2. Accops HyWorks Session Host service: This service is required for delivering the application, the Shared Hosted desktops from the Session Host server, and for management. The port number for the Session Host service is 38871.
   3. Accops HyWorks Monitoring Service: This service is required to monitor system performance. Its port number is 38870.
   4. Accops Sessions Extensions: These are required for HyPrint and sending messages to logged-in users.
   5. Session Recording: Required for recording the user’s sessions.
   6. Accops HyWorks DVM Tool-Lite: Required to enable the VM customization and VM Scale Booster to work.
   7. Accops User Experience Manager: Required to provide system performance information to the Accops Reporting Server, record sessions, manage sessions, and display messages to end users.

   The current state of installation will be displayed on the screen.

   

9. Once the installation process is complete, the system should reboot to allow Windows to make the necessary changes to the system. Click Yes to restart the computer.

The Windows server is now ready with the Accops HyWorks Session Host server role configured.

Installation Logs

HyWorks installation logs can be used for troubleshooting and verification purposes. The installation logs are generated at the following location:

C:\ProgramData\HyWorksSessionHost\Logs Running the HyWorks setup may also fail during the file extraction if the logged-in user has a roaming profile. Hence, it is recommended to log in with local administrator user credentials. Using a freshly installed Windows operating system.