Skip to content

HyWorks DVM Tools Installation

This section provides information on the HyWorks DVM Tools installation process on Windows desktop VMs.

Note

  • Copy the HyWorks setup to the target server locally. Running the HyWorks setup from the UNC path is not supported and will fail.
  • Running the HyWorks setup may fail during file extraction if the logged-in user has a roaming profile. Therefore, it is recommended to log in using local administrator credentials.

Overview

Accops HyWorks DVM Tools is an integrated software package installed on desktop virtual machines residing on hypervisors such as VMware ESXi, Microsoft Hyper-V, or Nutanix AHV. HyWorks DVM Tools provides trouble-free access to the desktop for end-users.

The DVM Tools package comprises the following components:

  • HyWorks Desktop Agent

  • HyWorks USB Cleaner (USB Disconnection/Remover Utility)

  • HyWorks USB Redirection Module [Built-In USB Redirection Driver (Server-side) module]

  • Accops Session Server Extensions

  • Accops Session Recording

  • AUEM (Accops User Experience Manager)

Refer to the Accops HyWorks DVM Tools section for details.

Check and download the latest HyWorks DVM Tools from the Accops Support portal or website.

The download link is also accessible from the HyWorks Controller Management Console > Help page.

Prerequisites

HyWorks DVM Tools for Windows requires .NET 4.7.2. Refer to the Software Requirements section for details.

Silent mode Installation steps (optional)

Use the following command to install the HyWorks DVM Tools for Windows silently:

HyWorksDVMTools.exe /S /desktopagent=1 /hyprint=1 /usbcleaner=1 /usbredirection=1 /EnableShdMode=0

Note

  • To skip the installation of any module, pass the flag as 0 instead of 1.
  • By default, the EnableShdMode is disabled. This flag is helpful to support the SHD Push feature.

Installation steps

  1. Log in using user credentials with local administrator privileges on the dedicated desktop.

  2. Download HyWorksDVMTools.exe. Verify the MD5 sum of the downloaded file.

  3. Double click and launch the Installer. Click Next to proceed.

  4. Accept the License Agreement by clicking I Agree.

  5. Select the modules to be installed and click Next.

  6. Select the destination folder and click Install to begin the installation process.

  7. Once the installation is complete, click Finish. If you're upgrading, you'll be prompted to restart the desktop VM. The installation completes once the machine restarts.

Installation Logs

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

<DVM Tools Installation Directory>\HyWorks Desktop Agent\Logs,
e.g. C:\Program Files (x86)\Accops\HyWorks Desktop Agent\Logs

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.