Shared Desktop Management

The VDI > Desktops > Shared section on the management console lists all deployed session host servers. Administrators can perform various operations on these shared desktops from here. The VDI > Desktops > Shared section provides the following information and actions to the administrator:

• Viewing Desktops and Details

  • Desktops List

  • View Desktop Details

  • Filtering

• Power Operations

• Actions

  • Refresh Desktop Information

  • Reset desktop

  • Mark Active

  • Mark Inactive

  • Move to version

  • Send Message

  • Remove from Pool: Desktop Pool Related Operations

• Advanced

  • Upgrade agent: Only for Linux.

  • Nutanix Flow Categories

  • Import/ Export

• Diagnose

  • Download Logs

  • Fix desktop

  • Troubleshooting

Each of these operations is explained in detail here.

View, Filter, and Export Desktop List

Shared Desktops List

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

Column Name	Description
Desktop Name & Version DVM Agent Version SHD Agent Version	Name of the shared desktop on the session provider. The VM version is shown, indicating the current provisioned version of the VM. Details of the VM version can be found here. Installed the HyWorks DVM agent and Session Host Agent versions on the Desktop VM.
OS Type	Operating system type of desktop VM, displayed with Windows or Linux icon. The information is fetched from the session provider.
Pool Name & Version Display Name	Desktop Pool Name, including its display name information and the current pool version in which this desktop is configured. Comparing the version with the VM version from the first column can suggest if any deployed shared desktop is running a different version than the pool version.
IP Address and FQDN	IP Address and FQDN of the personal desktops as shared by the 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 fetched, the display will be 'NA' (Not Available).
Active	Showing if the shared desktop is active or not. HyWorks does not give sessions from inactive session servers.
Power State	The shared desktop's current power state can be one of the following: powered off, powered on, suspended, not synced, syncing, creating, etc..
Server Status	Showing if the shared desktop is ready for connection or not. Possible values could be Ready (Green icon) or Not Ready (Red Icon).
Session Mode	The column indicates the current server mode as cordoned or uncordoned. Accops HyWorks does not allow new sessions from cordoned servers. Servers being deployed via a capacity plan can be put in cordoned mode to restrict users from accessing them.
Connectivity DVM and SHD Agent Status and Monitoring Service Status	Uses green dots to indicate the reachability of the attributes. Connectivity encompasses server availability on the remote desktop connection port, agent status, and monitoring service status. An example of a server working fine is four green dots, indicating Connectivity, with both DVM and SHD agents responding and monitoring the service as reachable.

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

Filtering Desktop List

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

Filter Type: Explanation	Filter Type: Explanation	Filter Type: Explanation
Desktop Name: Filter by the virtual machine's name (VM).	Version: Filter by the desktop version.	Pool Name: Filter by the name of the desktop pool.
Pool Display Name: Filter by the display name of the desktop pool.	Pool Version: Current version of the desktop pool.	IP Address: Filter by the desktop's IP address.
FQDN Name: Filter by the Fully Qualified Domain Name of the desktop.	Gold Master Name: Name of the Gold Master VM used in the deployment.	Snapshot Name: The snapshot used for deploying the desktop pool.
Team Name: The name of the associated server team.	Power State: Current power state of the shared hosted desktop VMs.	Customization Type: Customization mechanism used to deploy the pool.
Customization Status: The status of customizing the deployed virtual machines (VMs).	OS Type: OS types of the deployed VMs.	Pool Type: Dynamic shared hosted desktop pool or non-persistent shared hosted desktop pool.
Server Status: The server status can be: ready, not ready, or draining.	Session Mode: Session mode can be either cordoned or uncordoned.	Connectivity: If the server is reachable on a remote connection port.
DVM Agent Status: Status of the desktop agent service on the desktop VM.	Session Host Agent Status: The session host agent service status is on the desktop VM.	Monitor Service Status: Status of the monitoring service on the desktop VM.
Active: The active status of the VM.	Sessions: Number of sessions (providing a range of sessions) to filter out VMs.	Score: Current score of the session host server.
Weight: Weight of the session host server.
CPU: To filter out session host servers that consume CPU within a particular range.	RAM: To filter out session host servers that consume memory within a given range.	Disk: To filter out session host servers with disk usage in a given range.

Viewing Desktop Details

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

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

Section Name	Configuration	Description
Basic Info	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. For Linux-based shared-hosted desktops, it also displays details of installed assistive packages.
	OS Version	Version of the operating system on the desktop VM.
	Version info	Current version of the deployed VM with the Gold Master and the Snapshot name used for deployment
	Assigned Client Name	Not available for the shared desktop type.
	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 can 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 fails on the selected 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.

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:

• Already powered on: Power Off, Shutdown, Restart, and Suspend operations will be enabled

• Powered-off: Power on or Saved state (On Hyper-V only), power operations will be enabled.

• Shut down: Power On.

• Suspended: Resume power operation will be enabled.

• Resume: Power On, Restart

Performing Power Operation

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

1. Select one or more desktops from the list.

2. Select the Power On option from the dropdown.

3. Appropriate power operations will be displayed based on the number of selected desktops and their current power state. e.g.,

   • If a single desktop is selected, the available option will be displayed according to the current power state.

   • All power operations will be available if multiple desktops are selected.

4. Select the required option, e.g., Suspend.

5. On the Confirm Action dialog box:

   • Provide an appropriate reason for the power operation.

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

6. The HyWorks Controller will initiate power operation and be forwarded to the session provider.

7. Once the initiated operation is successfully executed, the desktop status will be updated on the Desktops > Shared 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, 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, and in such cases, performing power operations may fail.

Power operations are forced and can affect running sessions. Administrators must be cautious, as shared desktops may run multiple user sessions simultaneously.

Actions

This section of the document will provide details of the following management operations kept under the Actions dropdown:

Move to Version

The Move to Version feature allows administrators to revert desktops to earlier versions. Each re-composition increments the version number, starting from 1 and continuing sequentially. This functionality is handy for restoring one or multiple desktops 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(s): To revert to an earlier version, select the desktop you wish to restore.

   • If the administrator selects multiple desktops, choose the Recompose Type as Only Free VMs (Graceful) or All VMs Now (Forceful).

     1. Only free VMs option: Only 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. 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.

3. Click on Move.

4. HyWorks will initiate the Move to version operation.

Note

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.

Refresh

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 option refreshes the information display for the selected desktops.

The refresh operation performs the following tasks:

1. Obtain the latest details, including the power state, IP address, or fully qualified domain name (FQDN), for desktops without any sessions if they are part of a Windows-based desktop virtual machine (VM) 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. Select a Desktop from the list.

2. Select Action > Refresh.

3. Desktop status will be refreshed.

Remove from Pool

Desktops can be removed from the HyWorks configuration from the Desktop section by following the steps below:

1. Navigate to VDI > Desktops > Shared 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 the session provider as well: 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.

Restore Desktop

Desktop virtual machines (VMs) from a non-persistent desktop pool or a deployed desktop pool with the Enable DVM Reset option will be able to restore them to a fresh state.

To reset a desktop, follow the steps below:

1. Select a desktop from the list.

2. Select Action > Restore Desktop.

3. On the prompt Confirm Action dialog.

   1. Provide the restore reason and click Continue.

   2. Type ResetDVM and click OK to proceed.

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

Mark Active

This option helps convert the inactive virtual desktops to an active state.

To mark a desktop active, follow the steps below:

1. Select a desktop from the list.

2. Select Action > Mark Active.

3. On the prompt Confirm Action dialog.

   1. Provide the reason and click Continue.

   2. Type Active and click OK to proceed.

The Desktop will be transitioned to an active state.

Mark inactive

This option helps convert the active virtual desktops to an inactive state.

To mark a desktop inactive, follow the steps below:

1. Select a desktop from the list.

2. Select Action > Mark Inactive.

3. On the prompt Confirm Action dialog.

   1. Provide the reason and click Continue.

   2. Type Inactive and click OK to proceed.

The Desktop will be transitioned to an inactive state.

Send Message

The Send Message feature lets administrators directly notify users logged into specific desktops where the notification listener is enabled. 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) to which you wish to send a message.

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: For 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 not having any sessions if the desktops 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, appearing 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:

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

      1. DisplayNotificationUsingTrayAgent: Keep it accurate to use this method. The default value is True. If the Terminal server method is to be used, this can be set as False.

      2. 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

Log out of the session and connect again.

Advance Operations

Upgrade DVM Agent (Linux Only)

The administrator can upgrade the DVM agent for a specific desktop from VDI > Desktops > Shared section.

Note

• The Upgrade option is not available for Windows based shared desktops here. Refer section .

File Location for Upgrading DVM Agent

For pushing the upgrade, HyWorks must have the appropriate version file placed in the proper directory. Below are the details of placing Linux DVM Tools:

• 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 the information of 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. Upgrade process is defined below

Upgrade Process

To upgrade the DVM agent, follow the steps below:

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

2. Click on Advanced > Upgrade Agent (Linux) based on the current running tool version, the following options will be displayed:

   1. DVMs running a lower version:

      1. Select appropriate options and click the Upgrade button.

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

   2. DVMs running a greater version

      1. Upgrade is not possible.

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

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

      1. Select the appropriate options and click Upgrade.

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

      3. 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 if Micro-segmentation is enabled on it, this option will be visible to configure categories on the desktop.

The primary purpose of providing this option is to configure specific categories that are applied to a desktop. By default, the categories that are configured on the Pool will be applied to the desktop.

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

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: By default, this option is selected, and categories configured on the Pool are displayed in the Pool categories dropdown. The categories will be displayed in a read-only manner, no changes allowed.

   2. Specify categories to apply to DVM: All categories available on Nutanix (Prism Central) will be populated in the Selected Categories dropdown. Multiple categories can be selected and configured on the desktop.

2. Applied Categories on DVM: The categories that are currently used on desktop will be displayed.

Import/Export Operations

Administrators can perform the following import/ export operations on shared hosted desktops:

• Export Data: Exporting a list of all shared hosted desktops.

• Export Active Status: Exporting a list of shared hosted desktops with minimal columns and active status.

• Export Active Status Template: To download a sample active status CSV file for importing back.

• Import Active Status: Importing the shared hosted desktop CSV to mark multiple session host servers as active or inactive.

Export Data

Follow the steps below to export the shared hosted desktop list:

1. Navigate to VDI > Desktops > Shared section on the management console.

2. Click on Advanced > Import/Export > Export Data:

   • A dialog will prompt the administrator to select the encoding type and the fields to include in the CSV file.

   • Select Encoding Type: The administrator can choose from the following encoding options: UTF-8, ANSI, Unicode, or Shift_JIS.

   • Select fields to export: The following fields can be selected for inclusion in the .CSV file: Desktop Name, DNS Name, OS Name, OS version, Assigned Client Name, Desktop Status, Connection Status, Pool Name, MAC ID, IP Address, Enable DVM Reset, SnapshotStatus, SnapshotName, 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, PoolType, Pool Entitlement Type, Eltima Version, SEP Version.

3. Confirm Export:

   • 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.

From now on, HyWorks will also support exporting Active Status to a CSV file. This file can be modified and reimported to mark multiple session host servers as active or inactive at a time. More details of this feature will be provided later.

Mark Session Servers Active/Inactive using CSV Import/Export

Multiple configured session host servers can be marked as active or inactive using the CSV import operation. The following steps can be used:

1. Go to VDI > Desktops > Shared section on the management console.

2. Click on Advanced > Import/Export > Import Active Status.

3. The Import dialog will be displayed. Select the appropriate Encoding Type and click Import.

4. Select the Shared Hosted Desktop CSV file with the appropriate entries for desktops in the expected CSV format. (The CSV preparation steps are provided below.) Click Import.

5. If the CSV file contains any errors, they will be displayed for correction. If no errors are present, a dialog box will be shown to update the Import Shared Desktops, and then click Save.

   1. Dialog will be updated with a list of desktops that it failed to process, with the option to download the failed records. Click on OK to dismiss the dialog.

   2. If no records fail, a dialog will display a success message indicating the number of records processed. Click OK to dismiss the dialog.

6. The updated status should now be reflected.

Prepare CSV for Active Status Update

Rules: The CSVs must be prepared with the following rules:

1. To update the records, either the server name, IP address, or DNS Name is required.

2. Do not edit or delete the sequence of any row or column (Team Name, Desktop Name, IP Address, FQDN, Active).

   1. The CSV Import function starts reading entries from the third row onwards; therefore, the first row (rules) and the second row (column headers) can be kept unchanged.

Process to prepare CSV:

1. Recommended and easy method: Download the Active Status CSV directly and modify it.

   1. Go to VDI > Desktops > Shared section on the management console.

   2. Click on Advanced > Import/Export > Export Active Status.

   3. A CSV file with a complete list of session host servers and their active status will be downloaded.

   4. Update this CSV according to the requirements.

2. An alternative method for downloading the template and manually adding entries.

3. Go to VDI > Desktops > Shared section on the management console.

4. Click on Advanced > Import/Export > Download Active Status Template.

5. Add entries for the servers as required.

Diagnose

This section helps administrators isolate and diagnose issues.

Download Logs

It can be downloaded from VDI > Desktops > Shared page itself. Select the desktop to download the logs, then click Download Logs.

• Windows Shared Desktops:

  • Click on DVM Agent to download desktop agent logs.

  • Click on SHD Agent to download the session server agent logs.

• Linux Shared Desktops:

  • Click on DVM Agent to download desktop agent logs.

• 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 (DVM Agent):

  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 the tasks executed during preparation.

• Windows Desktops (SHD Agent):

  1. Session Server Agent Logs: Detailed information about sessions on shared desktops.

• Linux Desktops:

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

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. Matters on the desktop can be like:

• The desktop is not powered on.

• No IP address is available.

• The agent is not responding.

• Internal OS issue.

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

1. Select a Desktop from the list.

2. Observe that the Fix Desktop button is displayed; click it.

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

   • Desktop Name.

   • The error identified by the controller.

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

   • Pool Version: Current version of the desktop pool.

   • 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.

4. To proceed, click on the appropriate option: Fix Soft Errors, Fix All Errors, Recreate Desktop, or Reset.

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

Troubleshoot

Note

Available for Windows-based Shared Desktops only.

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

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

1. DVM Agent: To troubleshoot issues related to the Desktop Agent.

2. SHD Agent: To troubleshoot issues related to the Session Host Server Agent.

Clicking on any of these options will display the following options:

1. Download: If troubleshooting has been performed previously, the most recent report, including the 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.

   • 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:

• DVM Extracted Log Folder: Contains logs from the desktop agent, Sysprep (Panther logs), Hyprep logs, AUEM logs, and installation logs.

• EventViewerLogs Folder: System, Application, Setup and TerminalServices-RemoteConnectionManager events.

• Report Folder: Contains details for the HTML report.

• TroubleshootLog.txt document: Detailed logs of agent troubleshooting.

• VMBlueprint.json file: Contains detailed information about installed programs, services, processes, registry entries, and certificates in storage, among other items.

While troubleshooting the SHD agent, the following extra folder is downloaded:

• SHDExtractedLog: Having session host server agent and monitoring service logs. It will also have desktop agent and AUEM logs.

Set the Communication IP Address

If a provisioned desktop has multiple IP addresses (from one or more network adapters), HyWorks may select any of those IP addresses for communication.

If a specific IP address is required for communication with the Controller, select Diagnose > Set Communication IP Address.

• The configuration will be saved for the desktop, and HyWorks Controller will now use the configured IP address for future communications.

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 chooses desktops that do not satisfy the conditions for action, those desktops may be omitted.

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

• Power Operations

  • Shutdown

  • Reboot

  • Power off

  • Power on

  • Suspend

  • Resume

• Actions

  • Remove from Pool

  • Refresh

  • Move to version

  • Restore Desktop

  • Send Message

  • Mark Active

  • Mark Inactive

Advanced Configurations Related to Session Host Servers

Refer to the Advanced Configuration section in the HyWorks controller.