Skip to content

Monitoring Desktops

Desktop VMs sub-section under Monitoring section lists all the dedicated desktops currently configured in any of the desktop pool and cloned SHD in HyWorks.

Desktop VMs sub-section also enables the administrator to perform various administrative tasks such as power operations, assignment modification etc.

Desktops VMs tab provides following information and actions to administrator:

  • Viewing Desktop Information

  • Power Operations

    • Power Off

    • Shutdown

    • Power On

    • Restart

    • Suspend

    • Resume

  • Desktop Related Operations

    • Refresh desktop and DVM agent tool version

    • Reset desktop

    • Fix desktop

    • Download logs

    • Upgrade DVM agent

  • Desktop Pool Related Operations

    • Remove from Pool

  • Client Assignment Operations

    • Assign

    • Unassign

Each of these operations is explained in detail on this page.

Viewing Desktop Information

All Desktops configured in created Desktop Pools are displayed in Desktops VMs tab. Following information is available in Desktops VMs tab:

  • OS: Operating system of desktop VM. The information is fetched from session provider.

  • Desktop and DVMTools Version: Name of DVM on session provider and Installed HyWorks DVM agent version on Desktop VM

  • IP Address and DNS Name: IP Address and DNS Name of the Desktops as shared by Dedicated Session Provider.

    • VMware/ vCenter Server: Desktops must be installed a VMware Tools in order to get this information

    • For Powered off or Desktops whose IP and DNS information can not be fetched will be displayed with NA (as 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 and Assignment Type information

    • Pool Type: Pool type which shows Desktop VMs disk type. which can be

      • Persistent

      • Non-persistent

    • Entitlement Type: Desktop can be assigned to registered endpoints or to users and field will show possible values accordingly, which can be

      • Device based

      • 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 device name

      • User

      • Device

    • Assignment Type: A desktop can be assigned permanently or floating to a client and the field will show possible values accordingly, which can be

      • Permanent

      • Floating- On Demand

      • Floating- On Connect

  • Connection Status: Reflects if session is connected or not, possible values can be

    • Connected

    • Not Connected

  • State: DVM's current Power State, which can have following values:

    • Powered Off; If the Desktop is in Powered off state

    • Powered On: If Desktop is in Powered on State

    • Suspended: If Desktop is in Suspended state

    • Not Synced: This can be a temporary state shown when performing power operations e.g. Shutdown or when Dedicated Session Provider is gone unreachable etc.

    • Syncing: The Desktop details are being synchronized with the dedicated session provider

    • Creating

  • Network Ready: Showing if desktop is configured for network ready status check or not and if configured and current status of connection readiness, possible values could be:

    • Ready

    • Not ready

  • Agent Status: Displays the HyWorks Desktop Agents status as

    • Responding: Means, HyWorks Desktop Agent is running, and HyWorks Controller can communicate with HyWorks Desktop Agent

    • Not Responding: Either HyWorks Desktop Agent is not running or some issues while establishing connection with 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.

This is how different columns in Desktops VMs tab provide valuable information about the Desktops. Administrator can also click on Desktop Name (Works as a link) to open Desktop Detail dialog which displays above and some additional information of selected desktop.

Desktop Details Dialog

To open Desktop Details dialog, click on Desktop Name in Desktops VMs tab.

Desktop Details dialog provides following details of selected Desktop:

  • Basic Info:

    • Desktop Name: Name of the Desktop

    • DNS Name: DNS Name as gathered from Dedicated Session Provider

    • OS Name: Operating system on DVM

    • OS Version: Version of operating system on DVM

    • Assigned Client Name: Device Name or Username assigned to this Desktop

    • Desktop Status: Current Power State of Desktop

    • Connection Status: If connected or not.

    • Pool Name: The name of Desktop Pool to which this Desktop belongs

    • Networks: Network configuration of Desktop as collected from Session Provider

      • Adapter Name
      • MAC Id
      • IP Address: IP Address

    • Enable DVM Reset: If reset is enabled on DVM during deployment or not

    • Restore Point Statue: Name of restore point if DVM Reset is enabled, else values could be required or not required.

    • VM Path: Full path of VM location

  • Agent Info: For displaying details information regarding HyWorks Desktop Agent on selected Desktop

    • 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 and if it's not responding then 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 Info: Version number of Built-in USB redirection driver software installed on Desktop or shown as not installed if not installed

    • Enhanced Driver Info: Version number of Enhanced USB redirection driver software on Desktop or shown as not installed if not installed

    • Sysprep Info: Status flag of Sysprep, possible values can be

      • Required: Suggesting customization was done on the Desktop during provisioning and is required but not yet 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 selected Desktop is not a provisioned one and is an existing VM from dedicated session provider

      • Failed: When provisioning is failed on selected desktop VM

  • Hypervisor Tool Info: Displaying information of Hypervisor tools on selected Desktop. E.g. in case of Desktop is coming from VMware then following information can be displayed

    • Version: Some number as 9354

    • Status: As shared by Dedicated Session Provider E.g. Running(Current)

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

Desktop Management Operations

In Desktop VMs tab, administrators will be able to perform multiple power, pool, assignment operations on registered DVMs. This section will provide detailed information about these actions:

Power Operations

Administrator can perform following power operations on selected Desktop. The power operations will be enabled or disabled as per current power state of the Desktops:

  • Desktop is in powered Off state: Following power operation will be enabled:

    • Power On

    • Saved state (On Hyper-V only)

  • Desktop is already in powered on state: Following power operation will be enabled:

    • Power Off

    • Shutdown

    • Restart

    • Suspend

  • Desktop is in suspended state: Following power operation will be enabled:

    • Resume

Performing Power Operation

To perform any power operation on Desktop:

  1. Select the Desktop in Desktops page

  2. Based on its current power state appropriate power operations will be displayed (e.g. Desktop is in Power on State and thus Power Off, Shutdown, Reboot and Suspend buttons will be displayed)

  3. Click on button as per required power operations e.g. Suspend

  4. Click on OK button on Confirm Action dialog box (if displayed, based on the initiated operation) to continue performing operation

  5. Power operation will be initiated by HyWorks Controller and will be forwarded to Dedicated Session Provider, meanwhile wait dialog will be displayed

    a. Please wait until the operation is completed; the dialog will be dismissed automatically

    Or

    b. Click on OK button to dismiss the dialog, the task will be completed, and desktop's status will be updated automatically.

  6. Once initiated operation is successfully executed, Desktop status will be updated in Desktops VMs tab

Above example considers the Desktop power state as Powered On, other operations Resume, Restart, Shutdown, power off can also be performed using same steps.

Important Note for Desktop Power Operations

HyWorks Controller communicates with Dedicated Session Provider for updated Desktop status, but this is periodic and sometimes there might be some mismatch between desktop VM's power state in HyWorks Controller and Desktop's actual power state in Dedicated Session Provider and in similar cases, performing power operation may fail.

Desktops can be removed from HyWorks Configuration and from its respective desktop pool from Desktop section, by following the below steps:

  1. Select the Desktop in Desktops page

  2. Click on Remove from Pool button

  3. Confirm action dialog will be displayed, where an option to delete DVM will be displayed,

    a. Delete the desktop from session provider also? Select this check box if DVM is no longer required and should be deleted

    Warning

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

  4. Desktop will be removed from Desktops VMs tab and respective Desktop Pool.

Client Assignment Operations

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

  • Desktop is in assigned state: Following options should be enabled

    • Assign: To re-assign the Desktop to any other client

    • Unassign: To remove current client assignment from Desktop

  • Desktop is in unassigned state: Following options will be available

    • Assign: To assign a client to this Desktop

Unassign Client from a Desktop

Unassigning a client from selected Desktop will only removes the association of client and Desktops, which means the Desktop is now will be available for assignment to any other client.

Unassign option will be available when administrator selects any Desktop which is currently assigned to a client.

Unassign in Manual Assignment Pool

In a Desktop Pool, where Auto Assignment was not checked and manual assignment was done, then Unassigning will

  • Remove the association of Desktop and the client

  • Desktop will be available

  • Desktop will not be assigned automatically to any other client as it was a manually assigned pool

  • Logon from the client, which was unassigned from Desktop, will be displayed with error No Desktop is assigned to this client

Important

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

Unassign in Auto Assignment Pool

In a Desktop Pool, where Auto Assignment was checked and

  • Remove the association of Desktop and the client(user or device)

  • Desktop will be available

  • Desktop will be assigned automatically to any other or this client on very next logon

Important

As explained above, Unassigning a Desktop in Auto Assignment pool, makes Desktop available for all the clients in Desktop Pool and thus

  • If a Desktop is being unassigned when session is in progress will make it available for some other client. The session will not be affected

  • If some other client logs on, then the current user session might be disconnected

Assign Client to a Desktop

Administrator can perform Desktop Assignment from Desktops VMs tab and it can be done to already assign Desktop or an unassigned Desktop.

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

Client can be a user or device and as per the pool type appropriate dialog will be displayed i.e.

  • Device Based Pool: Selecting the Desktop which belongs to a device-based pool and clicking on Assign button will display, Desktop Assignment dialog listing devices to be assigned

  • User Based Pool: Selecting the Desktop which belongs to a User based pool and clicking on Assign button will display, Desktop Assignment dialog listing users to be assigned

Assignment Process

Follow the below steps to perform assignment on Desktops VMs tab:

  1. Select a Desktop from Desktops VMs tab

  2. Click on Assign button

  3. Select a desired client (Device or User as per Pool Type) from list of clients displayed in Desktop Assignment dialog

  4. Click on Assign button

    a. If the selected client is already assigned to any other Desktop in the pool then Confirm Action dialog will be displayed, click on OK button to continue

    b. If selected client is not yet assigned with any Desktop in the pool, then no such dialog will be presented, and Desktop Assignment dialog will be dismissed, and selected desktop will now be shown as assigned to selected client (Device or User as per Pool Type)

Impact of assignment on several types of pools

  1. Case #1: Unassigned client to unassigned Desktop

    a. Floating pool

    Though temporary assignment pools require auto assignment to be enabled but administrator can also do one-time assignment of Desktops to any device. This assignment will work only for the next logon from the client and will be removed on session disconnect.

    As the client was not assigned to any Desktop, thus client will be connected to this assigned Desktop on next logon.

    b. Permanent pool

    In permanent pools if the client was not assigned to any Desktop earlier and then it is assigned to any free Desktop then the assignment will be permanent and from next logon, session of newly assigned Desktop will be provided to the client.

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

    In case if the Desktop is currently assigned with a client then assigning it with new client will remove the current assignment and new client will be assigned.

    If any session is in progress from old client, then the session will not be disconnected however on logon from new client this session will be notified and disconnected or may get disconnected directly.

  3. Case# 3: An assigned client to unassigned Desktop

    In case if the selected client (say Client-1) is already assigned to any other Desktop (Say Desktop-1) and now it is being selected to be assigned to new Desktop (Say Desktop-2 unassigned) then existing assignment of Desktop-1 to Client-1 will be removed and only one assignment that is Client-1 to Desktop-2 will be made.

    Thus, on next logon from Client-1 will be given session of Desktop-2.

  4. Case #4: An assigned client to already assigned Desktop

    In case if the selected client (say Client-1) is already assigned to any other Desktop (Say Desktop-1) and now it is being selected to be assigned to new Desktop (Say Desktop-2 assigned to Client-2) then existing assignments of Desktop-1 to Client-1 and Desktop-2 to Client-2 will be removed and only one assignment that is Client-1 to Desktop-2 will be made.

    Thus, on next logon from Client-1 will be given session of Desktop-2; whereas next logon from Client-2 will be displayed with error 'No Desktop is assigned to this client'.

Reset Desktop

Desktop VMs which are deployed in Non-persistent desktop pool or deployed in desktop pool with option Enable DVM Reset, have specific restore point of fresh state. Administrator can reset desktop VM from Desktop VMs tab.

Option to reset will be displayed for those desktops only, which are deployed in HyWorks with Enable DVM Reset option enabled. To reset a desktop, follow the below step:

  1. Search and select desktop from list of DVMs

  2. Observe button to reset is shown

  3. Click Reset

  4. Confirm reset operation by clicking on Ok button shown on Confirm Action dialog

  5. Desktop will be reset to its fresh state

Refresh Desktop

If anytime a desktop VM power state, IP or other aspects are not synced or not showing latest information, administrator can initiate refresh operation.

Refresh operation performs following tasks:

  1. Get the latest details of power state, IP or DNS name of desktop VM

  2. Initiate agent communication to check agent status

  3. Updates desktop VM information as per refresh operation result.

Follow below steps to refresh a desktop:

  1. Search and select desktop from list of DVMs

  2. Click Refresh

  3. Desktop status will be refreshed

Fix Desktop/Recreate Desktop

If desktop having any issues by which user cannot access desktop, for this, administrator can fix these issues. This option will be enabled on provisioned desktop only. Issues on desktop like - Desktop is not powered on

  • IP address is not available

  • Agent is not responding

  • Internal OS issue

Following are options to fix issues:

  1. Fix soft errors: The system can try to resolve the soft errors by restarting the desktop related service or by rebooting the DVM.
  2. Fix all errors : If the desktop can not be repaired by rebooting, the system can recreate the desktop. It can take several minutes before desktop will be ready.
  3. Recreate Desktop : (Only for Persistent type pool) Data and configuration will be lost that is store in the Desktop. The desktop will be deleted and new desktop will be created. This process require time for cloning and customization OS(Sysprep).
  4. Reset Desktop : (Only for non-Persistent type pool) Data and configuration will be lost that is store in the Desktop. The desktop will be reverted to snapshot taken by HyWorks.

Upgrade DVM Agent

Administrator can upgrade DVM agent for specific desktop from Desktop VMs tab.

File Location for Upgrading DVM Agent

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

  • Windows DVM Tools:

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

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

    2. HyWorks will automatically pick the version from setup and will update details.

    3. Respective desktops can be upgraded as described below.

  • Linux DVM Tools:

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

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

    2. Update information of DVM Tools in following file:

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

      Following information must be passed:

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

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

    3. Save the file.

    4. HyWorks will read latest DVM Tools version information and desktops running lower versions can be upgraded accordingly. Upgrade process is defined below

To upgrade DVM agent, follow below steps:

  1. Search and select desktop from list of DVMs

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

    1. DVMs running lower version:

      1. Option to upgrade components:

        1. HyWorks Desktop Agent

        2. HyWorks Built-in USB Redirection Driver

        3. HyWorks Printing Module (Session Server Extensions)

        4. HyWorks USB Cleaner

          a. Option to reboot DVM

      2. Select appropriate options and click on Upgrade button

      3. Upgrade will be initiated and respective DVM will get upgraded with latest version

    2. DVMs running greater version

      1. Upgrade is not possible

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

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

      1. Option to upgrade components:

        1. HyWorks Desktop Agent

        2. HyWorks Built-in USB Redirection Driver

        3. HyWorks Printing Module (Session Server Extensions)

        4. HyWorks USB Cleaner

          1. Option to reboot DVM

      2. Select appropriate options and click on Upgrade button

      3. Upgrade will be initiated and respective DVM will get upgraded with latest version

Advance Configuration

Refer section for Advance Configuration For Desktop