Skip to content

HyWorks Session Host server Installation on a Windows server

The HyWorks Session and Host Server components are necessary on the Windows RDS Servers to provide 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 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 store specific data temporarily.

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

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 to the Windows server, which will 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, and 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, using port number 3389.
    2. Accops HyWorks Session Host service: This service is required for delivering the application and shared hosted desktops from the Session Host server, as well as 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.

Post Installation Configurations

Install Ghostscript for HyPrint PDF Printer

Ghostscript is used for PDF-based printing in HyWorks. The latest versions of HyWorks DVM Tools and HyWorks Session Host Server are not packaged with Ghostscript and therefore do not install Ghostscript by default.

Recent setups provide the option to select components during installation. HyPrint is not selected by default. If HyPrint is chosen, the administrator will be prompted to manually install and set up the dependencies.

Attempting to print using the HyPrint PDF Printer on a system without Ghostscript will fail with the error:

"Generating PDF failed!"

This document outlines the steps to install and configure Ghostscript.

Applicable for versions: v3.6 or later.

  1. Download the latest version of Ghostscript Setup (64-bit) from its release page:
    https://github.com/ArtifexSoftware/ghostpdl-downloads/releases

    1. Last verified version: v10.03.1

  2. Run the setup on the server where Session Host or DVM Tools are already installed.

    1. If an older version of Ghostscript (e.g., 9.06) is present, the installer will prompt you to remove it. Confirm the action.

    2. Allow the installation to complete.

  3. Configure Ghostscript path:

    1. After installation, open Registry Editor.

    2. Navigate to:
      HKEY_LOCAL_MACHINE\SOFTWARE\Accops\HyPrint

    3. Locate and update the following registry keys with the full path of the Ghostscript executable:

      1. GhostScript_32_Path
        (e.g., C:\Program Files\gs\gs10.03.1\bin\gswin64.exe)

      2. GhostScript_64_Path
        (e.g., C:\Program Files\gs\gs10.03.1\bin\gswin64.exe)

    4. Save the registry changes and close the Registry Editor.

  4. Log out if the user is already logged in.

  5. HyPrint should now function from the next user connection.