Skip to content

HyWorks Session Host Server - in Maintenance Mode

The section describes options to upgrade, repair or uninstall session host server from system.

Note

  • Running HyWorks setup from from UNC path is not supported and will result in setup failure. It is needed to copy HyWorks setups locally on target servers instead of running them from UNC path.
  • Running HyWorks setup may also fail during file extraction, if logged-in user is having roaming profile. In this case, login with local administrator user will be required.

Upgrade HyWorks Session Host Server

Important

  • Session Host Server setup installs RDP extensions, upgrade might fail if active remote desktop sessions are running.

  • Session host server can be upgraded before or after HyWorks Controller upgrade, the sequence does not have any impact. But it is recommended to understand the compatibility between HyWorks Controller and Session Host Server before upgrade.

    • Having incompatible versions will result in session/ functionality failures.
  1. Log in to Windows Server as a user with local administrator privileges.

  2. Copy the Accops HyWorks Controller installation setup or independent HyWorks Session Host Server setup on Windows server

  3. Launch the Installation wizard

  4. Select Upgrade and click Next

  5. You will be navigated to the confirmation screen displaying the components being upgraded

  6. Click Upgrade to proceed

  7. All the HyWorks Session Host Server components will be upgraded, and success screen will be displayed, click Close to exit the setup.

Repair HyWorks Session Host Server

  1. Go to Control Panel > Programs and Features

  2. Select HyWorks Session Host Server Module > Click Uninstall/ Change. This will open HyWorks Session Host Server installation wizard in maintenance mode

  3. Selection Repair and click Next to proceed

  4. All Session Host Server components that will be repaired will be listed. Click Repair to continue

  5. Wait for repair process to be completed. After completion click Close.

  6. Click Yes if prompted to reboot the session host server

This completes reapiring of Session host server repair.

Uninstall HyWorks Session Host Server

  1. Go to Control Panel > Programs and Features

  2. Select HyWorks Session Host Server Module > Click Uninstall

  3. HyWorks Session Host Server installation wizard will open in maintenance mode

  4. Selection Uninstall and click Next to proceed. It will list all the components that will be uninstalled

  5. Click Uninstall to continue. This will remove all HyWorks Session Host Server modules from system.

Important

  • HyWorks Session Host Server uninstallation does not remove installed remote desktop server role from system

  • If same server is also having Controller Service component installed, HyWorks Monitoring Service will not be uninstalled, as the same component is also used by HyWorks Controller for resource consumption details collection.

Installation Logs

For any troubleshooting or verification purpose, HyWorks installation logs can be used. Installation logs are created at following location:

C:\ProgramData\HyWorksSessionHost\Logs