Skip to content

HyWorks Installation Overview

Objective

The installation section explains how to install various modules of the Accops HyWorks product suite, including the necessary software, detailed installation steps, and troubleshooting.

Installers

Multiple modules communicate with each other in a typical Accops deployment and thus should be installed with appropriate configurations and strategy. Several factors, such as concurrency and delivery aspects, can affect deployment, installation, and configuration.

Listed below are the modules that come under the HyWorks suite and can be installed in the HyWorks deployment:

  1. HyWorks Controller: The HyWorks controller setup can be used to install the following modules:

    1. HyWorks Controller Service: The core of HyWorks Controller, which performs most of the brokering and management tasks for a typical VDI deployment.

      1. HyWorks Licensing Service: This gets installed automatically with HyWorks Controller Service, which is responsible for managing the licensing.

      2. HyWorks Upgrade Service: This gets installed with HyWorks Controller Service and is required for the automatic upgrade of HyWorks DVM tools.

      3. HyWorks Monitoring Services: The Monitoring Service collects system performance data from the Windows server hosting the HyWorks Controller or Session Host Server and reports to the HyWorks Controller service.

    2. HyWorks Controller Management Console: Web interface to manage HyWorks resources and configurations.

      1. Management Console for Administrator.

      2. RMS Portal for reservation management.

    3. HyWorks Reservation Management Service for HyLabs.

    Note

    • HyWorks Controller, Management Console, and RMS service can be installed on the same server or different servers.

    • When being installed on different servers, the RMS service and Management Console are installed on the same server, and the HyWorks Controller is installed on different servers.

  2. Session Host Server: This component must be installed on Windows servers to configure multi-user session host servers. Once installed on supported Windows servers, one server will provide sessions (desktop or application) to multiple users. When installed, the following components are installed automatically:

    1. HyWorks Session Host Agent: Service to facilitate user sessions and session management.

    2. HyWorks DVM Tools - Lite: Service for multiple functions, including desktop customization.

    3. Accops User Experience Manager: Service used to monitor and control application and session attributes as per configuration.

    4. Accops Server Session Extensions: Used for PDF Printing, File transfer, clipboard control, etc.

      1. HyPrint PDF Printer (Must be explicitly selected in the latest setups.) In recent versions, this option is separated and, when chosen, prompts for an explicit dependency on Ghostscript. See more details here.

    5. Built-in USB Direction (Server-side module, Optional): Required for USB redirection from endpoint to servers.

    6. Accops HyWorks Monitoring Service

    7. HyWorks USB Redirection Driver: Select to install the Built-in USB Redirection Driver for USB redirection use cases.

    8. HyWorks USB Cleaner: The module serves as a cleanup agent that runs when sessions disconnect to remove redirected USB devices. Select this option during USB Redirection Driver installation.

    9. Advance Drive Redirection: For better performance than native drive redirection, select this option. A prompt will appear to confirm internet connectivity for installing the necessary components. Details can be found here.

    10. Accops HyShell: Gets installed by default. Advanced desktop customization tool. After installation, specific settings must be configured to activate this feature fully.

    11. Session Recorder Module: An internal module for recording sessions, installed by default. The recordings are then transmitted to SRMS (Session Recording Manager Server) for streaming.

  3. HyWorks DVM Tools: Similar to the session host server, Accops HyWorks DVM Tools are installed on desktop-class systems to configure them for consumption as personal desktops in HyWorks. The following components are installed automatically with HyWorks DVM Tools:

    1. HyWorks Desktop Agent: Component required for system customization, user session management, and multiple other tasks.

    2. Accops User Experience Manager: Service used to monitor and control application and session attributes as per configuration.

    3. Accops Server Session Extensions: Used for PDF Printing, File transfer, clipboard control, etc.

    4. Built-in USB Direction (Server-side module, Optional): Required for USB redirection from endpoint to servers.

    5. HyWorks USB Cleaner (USB Disconnection/Remover Utility): For removing redirection USB devices on session disconnections.

    6. HyPrint: (Separated in 3.6 versions). Requires Ghost script installation and configuration.

    7. Accops Session Recorder: For recording the sessions.

    8. AUEM (Accops User Experience Manager): Required for System Monitoring, user experience management, user notification, and event monitoring.

    9. Virtual Camera: Available only on Windows 11 (Single-session desktops). For all other platforms, this option will be disabled.

    10. Advance Drive Redirection: Requires internet to download and install dependencies (OpenSSH Client and Server). More details can be found here.

  4. Hyper-V Connector: To be installed on Microsoft Hyper-V and SCVMM servers to enable them as providers or connectors in HyWorks. Hyper-V Connector receives commands for provisioning, power operations, and other tasks from the Controller and executes them on Hyper-V or SCVMM servers.

  5. Accops VM Scale booster: Used for reducing communication overhead on HyWorks Controller and thus improving performance and helping in scale.

  6. Scheduler and Action Processor: Windows services, usually installed on HyWorks Controllers, provide automatic power management for session host servers, scheduled actions, and session-level notifications. When installed on Windows servers, the following components are installed:

    1. Accops HyWorks Scheduler: Having two components Scheduler Worker and the Scheduler Service. It receives plan inputs from the HyWorks Controller and, according to schedules, places the corresponding plan in the queue for execution.

    2. Accops HyWorks Action Processor: Receives the execution plan and implements it.

  7. Session Recording Manager: To be installed on Windows Servers, and to be designated as Session Recording Manager. It installs the following sub-components:

    1. Session Recording Aggregator: Receiving and managing recordings from desktop agents.

    2. Session Recording Manager Service: Listing and streaming uploaded recordings on the HyWorks Management Console.

  8. Accops Certificate Manager: To be installed on separate supported Linux servers and required for generating and managing certificates, e.g., virtual smart card-based logon.

  9. Accops Policy Manager: Required for System Resource Optimization by AUEM, Desktop policy, and script execution. On separate supported Linux systems.

Document Flow

Now that basic information about HyWorks modules is provided, the next section covers installing these components. The installation instructions for each of the following components will be provided under the following sub-sections:

  • Prerequisite: Listing the hardware/software to be installed before installing the respective component.

  • Fresh Installation: Listing step-by-step process to install the module for the first time.

  • Maintenance: Process for repairing and upgrading respective modules.

  • Troubleshooting: Section for providing any specific troubleshooting steps.