Skip to content

Managing Personal Desktops

The VDI > Desktops > Personal section lists all the personal desktops configured in the desktop pools.

The page enables administrators to perform various administrative tasks, such as power operations and assignment modifications.

The VDI > Desktops > Personal section provides the following information and actions to the administrator:

Each of these operations is explained in detail in this document.

View, Filter, and Export Desktop List

Personal Desktops List

The VDI > Desktops > Personal section lists all the personal desktops with the following details shown in tabular format:

Column Name Description
Alert Green indicates no action required. Red alert indicates upgrade pending.
OS Operating system of desktop VM, displayed with Windows or Linux icon. The information is fetched from the session provider.
Desktop and DVMTools Version [VM Version] Name of DVM on session provider and the installed HyWorks DVM agent version on Desktop VM.
In the bracket, the VM version is shown, indicating the current provisioned version of the VM. Details of the VM version can be found here.
IP Address and FQDN IP Address and FQDN of the personal desktops as provided by the service provider. FQDN information is not available for VMs from Microsoft Azure, Amazon Web Services (AWS), Oracle Cloud Infrastructure (OCI), Nutanix, and Hyper-V.
For VMware/vCenter Server: Desktops must have VMware Tools installed to obtain this information.
For powered-off or Desktops whose IP and DNS information cannot be retrieved, the display will be ‘NA’ (not available).
Pool Name and Display Name Desktop Pool Name and its display name information in which this Desktop is configured.
Pool Type and Entitlement Type Pool Type: The pool type that indicates the disk type of Desktop VMs, which can be either Persistent or Non-persistent.
Entitlement Type: Desktop can be assigned to registered endpoints or users. The field will show possible values accordingly, which can be Device-based or User-based.
Assigned Client and Type Assigned Client: A desktop can be assigned to a user or client and it displays the assigned client information accordingly, which can be username or the device name.
Assignment Type: A desktop can be assigned permanently or floating to a client, and the field will display possible values accordingly, which include Permanent, Floating, On Demand, or Floating-On-Connect.
Connection Status Indicates whether the session is connected or not; possible values are Connected or Disconnected, and is displayed using icons.
State DVM's current Power State, which can be powered off, powered on, suspended, not synced, syncing, creating, etc.
Network Ready Checking if the desktop is configured for a network-ready status check, and if configured, the current status of connection readiness. Possible values could be 'Ready' or 'Not Ready'.
Agent Status Displays the HyWorks Desktop Agents status as responding, not responding, or not available.
Responding: This indicates that the HyWorks Desktop Agent is running and the HyWorks Controller can communicate with the HyWorks Desktop Agent’s mouse.
Not Responding: Either the HyWorks Desktop Agent is not running, or issues are preventing a connection from being established with the HyWorks Desktop Agent. When Agent status is in Not Responding state then mouse hover on Agent Status will also displays the details status with possible cause of the status.
Not available: DVMs in powered-off or suspended state.

The desktop section provides valuable information on Desktop Virtual machines (VMs). Administrators can also click on Desktop Name (which functions as a link) to open the Desktop Details dialog, displaying additional information about the selected desktop.

Filtering Desktop List

HyWorks v3.4-SP2 or later allows administrators to filter the desktop list using filters. The following filtering options are available:

  • Pool Name: Filter by the name of the desktop pool.

  • Pool Display Name: Filter by the display name of the desktop pool.

  • Version: Filter by the desktop version.

  • VM Name: Filter by the virtual machine’s name (VM).

  • IP Address: Filter by the desktop's IP address.

  • DNS Name: Filter by the Fully Qualified Domain Name of the desktop.

  • Pool Type: Dedicated Desktop or Shared Desktop.

  • Entitlement Type: Device-Based or User-Based.

  • State: The states can be - Not Synced, Powered Off, Powered On, Suspended, Powering On, Powering Off, Missing, Syncing, Restarting, Suspending, Resuming, Shutting Down, Creating Desktop, Pending Desktop Creation, Deleting..., Recomposing, Saved, Un-provisioned, Not Available.

Viewing Desktop Details

To open the Desktop Details dialog, click on Desktop Name in Desktops > Personal section.

The desktop Details dialog provides the following details of the selected Desktop:

Section Name Configuration Description
Basic Info Desktop Name Name of the Desktop on the Provider.
DNS Name DNS Name as gathered from the Dedicated Session Provider
OS Name Operating system on desktop VM.
OS Version Version of the operating system on the desktop VM.
Assigned Client Name: Device Name or Username assigned to this desktop.
Desktop Status Current Power State of the desktop.
Connection Status If connected or not.
Pool Name The name of the Desktop Pool to which this desktop belongs
Networks Network configuration of the desktop as collected from the Session Provider. Displaying Adapter Name, MAC ID, and IP Address.
Enable DVM Reset If reset is enabled on DVM during deployment or not
Restore Point Statue Name of the restore point if DVM Reset is enabled; otherwise, values may be required or not required.
VM Path Full path of VM location
Agent Info Status Responding or Not Responding
Message Detailed status of desktop e.g. if Desktop Agent Status is responding then message will be Desktop is Ready.
If it's not responding, then a relevant message suggesting why the agent is not responding
Version HyWorks DVM Tools version
Installed On Date on which HyWorks DVM Tools was installed
Info Last Updated On Date and time information when Desktop Information was last updated.
Desktop Agent Info Version Version of HyWorks Desktop Agent.
Built-in Driver Inf - Version number of the Built-in USB redirection driver software installed on a desktop, or displayed as ‘not installed’ if not installed.
Enhanced Driver Info - Version number of the Enhanced USB Redirection driver software on the Desktop, or 'Not Installed' if not installed.
Customization Inf - Type of customization, i.e., HyPrep or Sysprep. Status flag of Sysprep, possible values can be:
Required: Suggesting customization was performed on the Desktop during provisioning and is needed, but has not yet been run.
Running: Customization is in progress. Completed: Customization is completed
Not Required: Customization was not enabled while provisioning and thus customization won't be run, when Desktop will be powered on.
Unknown: When a Desktop is selected that is not provisioned and is an existing VM from a dedicated session provider. Failed: When provisioning is failed on the chosen desktop VM.
Completed: If customization is completed.
Hypervisor Tool Info Version Some number as 9354.
Status As shared by the Dedicated Session Provider, E.g., Running(Current).

Administrators can use the above details to verify if the Desktop is ready for user access.

Exporting Desktops List

Administrators can click the Export button to export details of all registered VMs in CSV format. This feature enables you to select different encoding types (UTF-8, ANSI, Unicode, Shift_JIS) and customize the fields to be included in the exported file.

Steps to Export VM Details:

  1. Click the Export button shown on VDI > Desktops > Personal page:

    1. A dialog will appear, prompting the administrator to select the encoding type and the fields to include in the CSV file.

    2. Select Encoding Type: Choose from the following encoding options: UTF-8, ANSI, Unicode, or Shift_JIS.

    3. Select fields to export: The following fields can be selected for inclusion in the CSV: OS Name, OS Version, Assigned Client Name, Desktop Status, Connection Status, Pool Name, MAC ID, IP Address, Enable DVM Reset, Snapshot Status, Snapshot Name, Agent Status, Agent Message, Agent Version, Agent Installed On, Agent Last Updated On, Hypervisor Tool Version, Hypervisor Tool Status, Organization Name, Customization Type, Customization Status, Pool Type, Pool Entitlement Type, Eltima Version, Sep Version.

  2. Confirm Export:

  3. Once the desired encoding and fields are selected, click the Export button to initiate the process.

  4. Export Completion:

  5. A CSV file containing the selected information for all desktops will be downloaded upon successful export.

This functionality provides a comprehensive overview of the desktop environment, enabling easy data manipulation and reporting.

Power Operations

The administrator can perform the following power operations on selected desktops . The power operations will be enabled or disabled as per the current power state of the chosen desktops:

  • The desktop is powered off. Power operations will be enabled in the Power On or Saved state (on Hyper-V only).

  • The desktop is already powered on. Power Off, Shutdown, Restart, and Suspend operations will be enabled.

  • The Desktop is in a suspended state. Resume power operation will be enabled.

Performing Power Operation

To perform any power operation on the desktop(s):

  1. Select one or more desktops from the list.

  2. Click on the Power Operations dropdown button.

  3. Appropriate power operations will be displayed based on several selected desktops and their current power state. E.g.,

    1. The available option will be displayed per the current power state if a single desktop is selected.

    2. All power operations will be shown as available if multiple desktops are selected.

  4. Click the button for the necessary power operations. A mismatch may occur between the desktop VM's power state in the HyWorks Controller and the Desktop's actual power state in the Dedicated Session Provider, such as when suspending.

  5. In the Confirm Action dialog box:

  6. Provide an appropriate reason for the power operation.

  7. Type the power operation as part of the challenge to avoid unintentional power operation.

  8. The HyWorks Controller initiates power operation and forwards it to the session provider.

  9. Once the initiated operation is successfully executed, the desktop status will be updated on the Desktops > Personal page.

The above example considers the Desktop's power state as Powered On. The same steps can perform other operations, such as Resume, Restart, Shutdown, and Power Off.

Important

The HyWorks Controller communicates periodically with the Dedicated Session Provider for updated Desktop status. Sometimes, there might be a mismatch between the desktop VM's power state in the HyWorks Controller and the Desktop's actual power state in the Dedicated Session Provider, and in similar cases, performing power operations may fail.

Remove from Pool

Desktops can be removed from the HyWorks configuration and their respective desktop pool from the Desktop section by following the steps below:

  1. Go to from VDI > Desktops > Personal page and select the desktop(s) to be removed from the pool.

  2. Click on Remove from Pool.

  3. Confirm action dialog will be displayed. Provide the reason for the action and click Continue.

    1. Delete the desktop from session provider also? Select this check box if DVM is no longer required and should be deleted from the respective provider. Keep this unchecked if it needs to be removed from the HyWorks configurations.

      Warning

      The action is irreversible, and the deleted VM cannot be restored. Administrators should choose this option only when they are sure about the deletion of DVM from the provider.

    2. To proceed with removal, the administrator must type Delete.

    3. Click on OK to proceed. The dialog will be dismissed, and HyWorks will start the desktop removal process according to the selected options.

  4. Desktops will be removed from the Desktops section and the respective desktop pool.

Client Assignment Operations

Like Power Options, appropriate Assignment options will be enabled or disabled, e.g.

  • Desktop is in an assigned state: The following options should be enabled.

    • Assign: To reassign the Desktop to any other client.

    • Unassign: To remove the current client assignment from the Desktop

  • Desktop is in an unassigned state: The following options will be available.

    • Assign: To assign a client to this Desktop

Unassign Client from a Desktop

Unassigning a client from a selected desktop will only remove the association between the client and the desktop, making the desktop available for assignment to any other client.

The Unassign option will be available when the administrator selects any desktop assigned to a client.

  • Unassign in Manual Assignment Pool: In a Desktop Pool, where auto Assignment is not selected, and manual assignment is done, then Unassigning will:

    • Remove the association of the desktop and the client.

    • The desktop will not be automatically assigned to any other client as it is a manually assigned pool; thus, the administrator must make the assignment manually again.

    • When logging in from the client, which is not assigned to a desktop, the error message "No Desktop is assigned to this client" will appear.

  • Unassign in Auto Assignment Pool: In a Desktop Pool, where Auto Assignment was checked, and- Remove the association of the Desktop and the client(user or device)

    • The desktop will be assigned automatically to any other client or this one on the very next login.

Important

  • The Unassign operation does not remove client entries from the desktop pool. Thus, if any specific client must be removed, then it should be done from the Edit Desktop Pool wizard

  • As explained above, unassigning a desktop from the Auto Assignment pool makes it available to all the clients in the Desktop Pool.

  • If a Desktop is unassigned while a session is in progress, it will be made available for another client. The session will not be affected.

  • The current user session might be disconnected if another client logs on.

Assign Client to a Desktop

The administrator can assign a Desktop from the Desktops > Personal section to an already assigned Desktop or to an unassigned Desktop.

Assigning a client to a desktop not only assigns the client to a desktop but also adds the client to the pool configuration.

The client can be a user or device, and as per the pool type, an appropriate dialog will be displayed, i.e.

  • Device-Based Pool: Selecting a desktop that belongs to a Device-based pool and clicking the Assign button displays a desktop Assignment dialog listing the devices to be assigned.

  • User-Based Pool: Selecting a desktop that belongs to a User-based pool and clicking the Assign button displays a desktop assignment dialog listing users to be assigned.

Assignment Process

Follow the steps below to perform the assignment on Desktops > Personal section:

  1. Select a Desktop from the Desktops > Personal section.

  2. Click on the Assign button.

  3. Select the desired client (Device or User, depending on the Pool Type) from the list of clients displayed in the Desktop Assignment dialog.

  4. Click the Assign button.

    1. If the selected client is already assigned to another desktop in the pool, the Confirm Action dialog will be displayed. Click OK to continue.

    2. Suppose the selected client has not yet been assigned a desktop in the pool. In that case, no such dialog will be presented; the Desktop Assignment dialog will be dismissed, and the selected desktop will now be shown as assigned to the selected client (Device or User, depending on the Pool Type).

Impact of assignment on several types of pools

  1. Case #1: Unassigned client to unassigned desktop:

    1. Floating pool: Though temporary assignment pools require auto-assignment to be enabled, administrators can also do one-time desktop assignments for any device. This assignment will only be active for the next login from the client and will be removed upon session disconnect. As the client was not assigned to any Desktop, the client will be connected to this assigned Desktop on the next login.

    2. Permanent pool: In a permanent pool, if a client was not previously assigned to a desktop and is then assigned to a free desktop, the assignment becomes permanent. From the next logon, the client will be provided with a session on the newly assigned desktop.

  2. Case #2: Unassigned client to already assigned desktop:

    1. If the Desktop is currently assigned to a client, assigning it to a new client will remove the current assignment and assign it to the new client.

    2. If a session is in progress with an old client, it will not be disconnected. However, when a new client logs on, the session will be either notified and disconnected, or disconnected directly.

  3. Case# 3: An assigned client to an unassigned desktop:

    • Suppose the selected client (say Client-1) is already assigned to another desktop (Say Desktop-1) and is now being chosen to be assigned to a new, unassigned desktop (Say Desktop-2). In that case, the existing assignment of Desktop-1 to Client-1 will be removed, and only one assignment, Client-1 to Desktop-2, will be made. Thus, on the next login from Client-1, the session for Desktop-2 will be given.

  4. Case #4: An assigned client to an already assigned desktop:

    1. Suppose the selected client (say Client-1) is already assigned to another desktop (Say Desktop-1) and is now being chosen to be assigned to a new desktop (Say Desktop-2, assigned to Client-2). In that case, the existing assignments of Desktop-1 to Client-1 and Desktop-2 to Client-2 will be removed, and only one assignment, Client-1 to Desktop-2, will be made.

    2. On the next login from Client-1, a session of Desktop-2 will be given, whereas the next login from Client-2 will display the error 'No Desktop is assigned to this client.'

More Desktop Management Operations

Reset Desktop

Desktop VMs from a Non-persistent desktop pool or a deployed desktop pool with the option Enable DVM Reset enabled will have the option to restore them to a fresh state.

To reset a desktop, follow the steps below:

  1. Search and select a desktop from the list of DVMs.

  2. The Observe button is Reset.

  3. Click Reset.

  4. On the prompt Confirm Action dialog.

    1. Provide the reset reason and click Continue.

    2. Type ResetDVM and click on OK to proceed.

  5. The Desktop will be reset to its fresh state.

Refresh Desktop

If a desktop VM's power state, IP, or other aspects are not synced or do not show the latest information at any time, the administrator can initiate a refresh operation.

The Refresh operation performs the following tasks:

  1. Obtain the latest details of the desktop VM’s power state, IP address, or fully qualified domain name (FQDN) from the provider.

  2. Initiate agent communication to check agent status.

  3. Update desktop VM information based on the refresh operation result.

Follow the steps below to refresh a desktop:

  1. Search and select a Desktop from the list of DVMs.

  2. Click Refresh.

  3. Desktop status will be refreshed.

Fix Desktop/ Recreate Desktop

If a provisioned desktop has any issues preventing the user from accessing it, the administrator can resolve these issues. This option will be enabled only on the provisioned desktop. Issues on the desktop can be:

  • The desktop is not powered on.

  • The IP address is not available.

  • The agent is not responding.

  • Internal OS issue.

To fix the desktop, the following steps can be followed:

  1. Search and select a Desktop from the list of DVMs.

  2. Observe that the button to fix the desktop is displayed; click on Fix Desktop.

  3. On the Fix Desktop prompt, the following options will be shown:

    1. Desktop Name.

    2. The controller identifies the error.

    3. Desktop Version: The current version of the desktop virtual machine.

    4. Pool Version: Current version of the desktop pool.

    5. Fix options:

      1. Fix soft errors: The system can try to resolve soft errors by refreshing the desktop status (power state, IP address, agent communication) or rebooting the DVM.

      2. Fix all errors: The controller will first attempt to fix soft errors, and then, if it fails to improve the desktop's status, it will recreate it. It may take several minutes for the desktop to become ready.

      3. Recreate Desktop: (Only for Persistent type pool) The Data and configuration stored in the desktop VM will be lost. The desktop will be deleted, and a new desktop will be created. This process requires time to clone and customize the OS.

      4. Reset Desktop: (Only for non-Persistent type pool) The desktop VM's Data and configuration will be lost. The desktop will be reverted to a snapshot taken by HyWorks.

      5. Update Domain Credentials (Optional): This option is only supported for HyWorks v3.4-SP2 or later. It is not a desktop-fixing option. It is an optional mechanism to update the credentials used in the desktop pool to join machines to the domain if any changes have occurred in the Active Directory for the configured user (e.g., the user's password has changed, the user has been deleted, etc.). This option will be covered in detail later.

    6. To proceed, click on the appropriate option (Fix soft errors, Fix all errors, Recreate Desktop, or Reset).

    7. Check the logs for the actions required to fix the errors according to the selected options.

Troubleshoot

The Troubleshoot button is used to diagnose issues with the DVM Agent (if any). The latest DVM Tools include an integrated troubleshooter. When clicked, the Troubleshoot option sends a message to the Desktop Agent, initiating the troubleshooting process. This tool can retrieve the machine's blueprint and gather general parameters to identify underlying issues.

Options Available: When clicking the Troubleshoot button, the following options will be displayed:

  1. Download: If troubleshooting has been performed previously, the most recent report (including date and time) will be available for download.

  2. Run the Troubleshooter: If no report is available or the administrator wants to generate a new report, this option initiates troubleshooting on the controller machine and automatically downloads the report once troubleshooting is complete.

    1. The report can help identify possible causes, and if further analysis is required, it can be shared with the Accops Support Team.

Upon completion of the troubleshooting process, a zip file named TroubleshootLog will be automatically downloaded. This zip file contains various folders, including:

  • DVMExtracted Log Folder

  • EventViewerLogs Folder

  • Report Folder

  • TroubleshootLog.txt document

  • VMBlueprint.json file

Important

This option is not available for Linux-based desktops.

Upgrade DVM Agent

The administrator can upgrade the DVM agent for specific desktops from the Desktops > Personal section.

File Location for Upgrading DVM Agent

For pushing the upgrade, HyWorks must have the appropriate version file placed in the appropriate directory; below are the details of placing Windows and Linux DVM Tools:

  • Windows DVM Tools:

    1. Place the latest HyWorks DVM Tools for Windows in the following directory:

      C:\Program Files (x86)\Accops\HyWorks\HyWorksUpgradeService\Updates\Windows

    2. HyWorks will automatically pick the version from the setup and will update the details. The upgrade process is defined below.

  • Linux DVM Tools:

    1. Place the latest HyWorks DVM Tools for Linux in the following directory:

      C:\Program Files (x86)\Accops\HyWorks\HyWorksUpgradeService\Updates\Firmware

    2. Update information on DVM Tools in the following file:

      C:\Program Files (x86)\Accops\HyWorks\HyWorksUpgradeService\Updates\Linux\info.inf

      The following information must be passed:

      1. FileName=\<Name of file placed in step#1> e.g. FileName=HyWorksDvmTools_Linux_merged_3.3.2.24.tgz

      2. Version=\<Version of placed DVM tools> e.g. Version=3.3.2.24

    3. Save the file.

    4. HyWorks will read the latest DVM Tools version information, and desktops running lower versions can be upgraded accordingly.

To upgrade the DVM agent, follow the steps below:

  1. Search for and select a desktop from the list of desktop VMs. Desktops running a lower version of DVM Tools are shown with a red alert.

  2. Click on the button Upgrade Agent. Based on the current running tool version, the following options will be displayed:

    1. DVMs running a lower version:

      1. Option to upgrade components:

        • HyWorks Desktop Agent

        • HyWorks Built-in USB Redirection Driver

        • HyWorks Printing Module (Session Server Extensions)

        • HyWorks USB Cleaner.

      2. Option to reboot DVM.

      3. Select appropriate options and click on the Upgrade button.

  3. The upgrade will be initiated, and the respective DVM will get upgraded to the latest version.

  4. DVMs running a greater version

    1. An upgrade is not possible.

    2. An appropriate message should be displayed, stating that the version running on DVM is already higher and cannot be upgraded.

  5. DVMs running the same version: This can be treated as

    1. Option to upgrade components:

      • HyWorks Desktop Agent

      • HyWorks Built-in USB Redirection Driver

      • HyWorks Printing Module (Session Server Extensions)

      • HyWorks USB Cleaner.

        • Option to reboot DVM.

  6. Select appropriate options and click on the Upgrade button.

    1. The upgrade will be initiated, and respective desktops will be upgraded to the latest version.

  7. Controller logs can be checked for detailed information on the upgrade.

Nutanix Flow Categories

If the desktop is from the Nutanix (Prism Central) desktop provider and Micro-segmentation is enabled, this option will be visible when configuring categories on the desktop.

This option is primarily provided to configure specific categories that do not apply to a desktop. The categories configured on the Pool will be applied to the desktop by default.

Refer to the following link for Categories on the Pool under deployment settings.

The following options will be displayed when clicking on the Nutanix Flow Categories button:

  1. Nutanix Flow categories: Option to choose pool setting or specify different settings for DVMs.

    1. Use Pool Settings: This option is selected by default, and the categories configured on the Pool will be displayed in the Pool categories dropdown. The categories will be displayed read-only; no changes are allowed.

    2. Specify categories to apply on DVM: The Selected Categories dropdown will populate with all the categories available on Nutanix (Prism Central). Multiple categories can be selected and configured on the desktop.

  2. Applied Categories on DVM: The categories currently applied on the desktop will be displayed.

Move to Version

The Move to Version feature allows administrators to revert desktops to an earlier version within a desktop pool. Each recomposition increments the version number, starting from 1 and continuing sequentially. This functionality is handy for restoring a desktop to a previous state.

The version represents the logical state of the deployment and is derived from the combination of Desktop customization, Gold Master, Gold Master (Snapshot/Checkpoint), and VM Name Prefix. By upgrading to the version, the administrator can choose to recreate the desktop with a specific set of deployment settings.

Steps to Use the Move to Version Option:

  1. Select the Desktop: To revert to an earlier version, select the desktop you wish to restore.

    1. If the administrator selects multiple desktops, the Recompose Type must be set to either Only Free VMs (Graceful) or All VMs Now (Forceful).

      1. Only free VMs option: Free desktops without remote sessions will be recomposed. This option is selected by default when the Move to Version prompt launches.

      2. All VMs Now: It will ignore the presence of sessions on selected desktops and initiate forceful recompose.

  2. Click on Move to Version: Initiate the process by clicking the Move to Version button.

  3. Select the Version: The administrator must choose the desired version to which the selected desktop should be reverted. A list of available versions (Version Number, Gold Master Name, Snapshot name, Date & Time) will be displayed for selection.

  4. Click on Move.

  5. HyWorks will initiate the Move to version operation.

    1. HyWorks may skip the Move to version for one or more selected desktops for various reasons. The reason will be provided in the logs. An example of a reason could be that the Move to version and the current version are the same.

Update the Password of the Selected Version

The Move to version action recreates the desktop and then customizes the desktop OS using the selected Hyprep or Sysprep mechanism. However, in cases where the user credentials used to domain join the deployed desktops change, and after recreation, HyWorks should use the new credentials. The following method can be used to update the password for the version.

Download Logs

It can be downloaded from VDI > Desktops > Personal page itself. Select the desktop to download the logs and click the Download Logs button.

  • Logs will be downloaded if the desktop is powered on and the controller can communicate with the agent.

    • Name Format of the downloaded logs: HyWorks-DVM-Log-[IP Address of the desktop].zip

  • An error will be shown if the controller cannot communicate with the agent.

Contents of the Downloaded ZIP File
Inside the downloaded folder, the following logs will be included:

  • Windows Desktops:

    1. Desktop Agent Logs: These logs contain comprehensive information about user desktop sessions, including connection, disconnection, and logout events, as well as other related details.

    2. Hyprep Logs: These logs provide information about the Hyprep process during the desktop pool's cloning, detailing the steps taken and any relevant outcomes.

    3. Sysprep Logs: These logs contain information about the Sysprep process performed during desktop pool cloning, including configuration details and preparation tasks executed.

  • Linux Desktops:

    • All log files are located in the log folder (/etc/edcdvm/linuxDVM/Logs).

Send Message

The Send Message feature lets administrators directly notify users logged into specific desktops. This functionality is essential for conveying important real-time information or alerts to users.

The prerequisites and details of this feature are outlined in this section.

Steps to Use the Send Message Option:

  1. Select the desktop(s): Begin by selecting the desktop(s) you wish to send a message to.

  2. Click Send Message: Initiate the messaging process by clicking the Send Message button.

  3. Enter Message Details:

    1. Title of the Message: Enter a concise title that summarizes the message.

    2. Actual Message: Write the entire message to the user.

    3. Severity Level: Choose the severity of the message from the following options:

      1. Critical: For urgent messages requiring immediate attention.

      2. Warning: For messages that are important but not urgent.

      3. Information: This is general information that may be useful to the user.

  4. Select Message Delivery Option:

    1. Send Outside the Desktop Session: If you select this option, the message will be sent to the client’s base machine and displayed there, allowing the user to see it outside their desktop session.

    2. Send Inside Desktop Session: If this option is chosen, the message will only be delivered within the desktop session. The user will see the message while working inside the virtual desktop environment.

Note

  • The feature does not work for Linux-based desktops.

  • The method of sending messages outside of desktops depends on the endpoint client. It currently works with Windows-based desktop clients only and will not work for Linux-based endpoints, Android, MAC, or HyLite.

  • The send message will skip the desktops that do not have any sessions and are not powered on.

Message Delivery Methods

Messages can be sent to the desktop session or outside the desktop session using the following three methods:

  1. AUEM Tray: Messages sent via the AUEM tray will appear inside the desktop session.

  2. Terminal Server: This method also delivers messages inside the desktop session.

  3. Virtual Channel: Messages sent through this method will be delivered outside the desktop session and appear on the client’s base machine.

To change the message delivery method inside the session: Inside the session, the administrator can set either of the message display mechanisms (AUEM Tray or Terminal Server) using the following configurations:

  1. On the desktop, configure the following registry values:

    • Registry Location: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Accops\DVMAgent\DVM PUSH SETTINGS

    • DisplayNotificationUsingTrayAgent: Use this method if you want to keep it true. The default value is True. If the Terminal server method is to be used, this can be set as False.

    • DisplayNotificationUsingTerminalServer: The default value is false. If this method has to be used, it can be set to True, and then the Tray Agent method can be set to False.

  2. Save the registry settings with the appropriate values as required.

  3. Restart the following services:

    1. Accops HyWorks Desktop Agent

    2. Accops User Experience Manager

  4. Log out of the session and connect again.

Multi-select and Allowed Operations

HyWorks v3.4-SP2 enables administrators to perform multiple actions simultaneously across multiple desktops.

  • From VDI > Desktops > Personal section, select multiple desktops.

  • Click on the list actions.

  • HyWorks will queue up the desktops and will perform actions on them.

Note

If the administrator selects some desktops that do not satisfy the conditions to perform the actions, those desktops may be skipped.

Allowed Actions: The Following actions are allowed while selecting multiple desktops:

  • Power Operations

    • Shutdown

    • Reboot

    • Those that do not have any sessions or are powered off

    • Power on

    • Suspend

    • Resume

  • Remove from Pool

  • Refresh Desktop Status

  • Move to version

  • Restore Desktop

  • Send Message

Advance Configurations

Refer to the section for Advance Configuration for VMs on the HyWorks controller.