Skip to content

AUEM / ARS Settings Support from Management Console

Supported Versions:

  • HyWorks Controller: v4.1-HF1.2 or later.

  • Desktop Platform: Windows only.

    • v4.1.0.1487 or later. (The GA release with support for this feature is pending.)

Introduction

HyWorks v4.1-HF1.2 introduces centralized ARS configuration management from the HyWorks Controller Management Console. Previously, ARS settings could only be configured individually on each virtual desktop.

This enhancement enables administrators to manage ARS connectivity for the entire environment from a single location, simplifying administration and ensuring consistent configurations across deployments.

Configurations

Location: HyWorks Controller Management Console > Settings > System > ARS Settings.

The page contains the following sections:

Section Purpose
Module Settings Determines which ARS configuration source (Desktop or Controller) each module uses, and whether a module sends data to ARS at all.
ARS Configuration Holds the actual connection parameters used to talk to the ARS server.

  • Module Settings

    • Desktop Settings: Controls which ARS configuration is used to send data to the ARS server.

      Option Behavior
      Use Desktop Configuration Backward-compatible mode. The ARS settings configured inside the VDI are used for sending data to ARS. Settings defined inside the desktop are applied automatically.
      Use Management Configuration The administrator configures and manages ARS server details directly from the HyWorks Controller. Selecting this enables the ARS Configuration section below for manual entry.

    • Send Data From: Controls which components are allowed to send data to ARS.

      Checkbox Behavior
      Desktop When enabled, data from inside the VDI is sent to ARS. When disabled, no VDI data is sent.
      Controller Nodes
      (Experimental)      		 This feature Controller nodes sending data to ARS has limited support in v4.1-HF1.2 for a specific use case. Improved support will be added in future releases.* When this setting is enabled, the HyWorks Controller and its HA nodes send data to ARS directly.

      Important

      * The data shared with ARS configurations is different from the logs sent by the Syslog server.

  • ARS Configuration: This section holds all parameters required to establish communication with the ARS server. Server Type, Server Address, and Port are always mandatory. The remaining fields shown depend on the Server Type selected.

    • Server Type: ARS 1.0: For ARS version 1.8 (based on the ELK Stack).

      • Authentication is compulsory. The Enable Authentication checkbox is shown checked and disabled.

      • When authentication is enabled, a valid Username, Password, and Confirm Password must be provided.

      • Encryption is optional.

      • If Enable Encryption is on, a Validate Certificate checkbox appears; if off, it stays hidden.

      • If Validate Certificate is checked, the administrator can upload a certificate.

    • Server Type: ARS 2.0: For ARS version 2.0 (based on the OpenSearch Stack).

      • Authentication is compulsory. Encryption is optional but enabled by default.

      • A valid Username and Password must be provided.

      • If Encryption is enabled, Validate Certificate is shown; otherwise it stays hidden.

      • Validate Certificate can be freely enabled or disabled by the administrator.

      • When enabled, a certificate can be uploaded, and a Details button lets the administrator view or verify the uploaded certificate (subject, issuer, thumbprint, expiry, chain).

        • Certificate Validation Behavior:

          • Validate Certificate = OFF → No certificate is required or used; the agent connects to the ARS server without certificate validation, and the upload field stays hidden.

          • Validate Certificate = ON → The certificate's details (name, issuer, thumbprint, expiry) are shown in the UI, the upload field becomes available (ARS 2.0 only), and the certificate is used to validate the ARS server connection.

    • Server Type: UDP: For UDP Syslog servers. Only Server Address and Port are required. No authentication or encryption fields apply.

      • All configured settings persist centrally and are automatically applied across the HyWorks Controller and all connected VDIs.

Known Limitations

  • UDP Server Type: Currently, AUEM logs are not sent when the Server Type is set to UDP, even when Server Address and Port are configured and validated.

  • Linux Virtual Desktops Not Supported: ARS settings configured on the HyWorks Controller are not applied to Linux-based desktops. The agent continues to use its own locally configured settings to send logs to ARS.

  • Legacy DVM Agents: Controller-level ARS configuration changes do not affect VDIs running an older or legacy DVM agent. These continue to operate using their existing configuration.