Manage Farm RDSH Session Hosts

You can perform certain actions on the individual RDSH session hosts in a farm.

Procedure

1. Click Inventory > Farms.

   The Farms page displays.

2. Click the name of a farm on the list.

   The farm details page displays.

3. Click Session Hosts at the top of the page.

   The Session Hosts tab displays, showing a list of the RDSH session host virtual machines (VMs) in the farm. You can filter, refresh, and export the list using the controls to the top right of the page.

   You can perform the following actions by selecting one or more session host VMs and clicking one of the buttons at the top of the page.

   Note: The VM status must be green to perform these actions.

   Option	Description
   Power Off	Shuts down the selected VMs. You can select more than one VM at a time. You can only shut down VMs that do not have active user sessions.
   Power On	Starts up the selected powered-off VMs.
   Delete	Deletes the selected VM. To reduce the size of the farm when the VM is deleted, select Yes under 'Reduce farm size' in the dialog box.
   Reset Agent Pairing	Repairs the agent pairing state when a pairing failure has occurred. You can select multiple VMs. The action is only applied to those selected VMs that are currently powered on. You can view progress on the Monitor > Activity page or on the System Activity tab of the farm's detail page.
   User Login Mode	Controls user logins for maintenance purposes. Settings are described below. Note: You can only change this setting if the VM has the latest agent. Allow Logins (Active) <ul> <li>Allows new connections to the VM. </li> <li>Allows reconnections to the VM. </li> <li>Agent Status is Active. </li> </ul> </li> Prevent New Logins and Reconnections (Disabled) <ul> <li>Does not send new connection requests to the VM. </li> <li>Routes new connections to other available VMs in the farm. </li> <li>Denies reconnections to the VM. </li> <li>Agent Status is Disabled. </li> </ul> <strong>Note:</strong> You must log in or reconnect to the VM before selecting this option. </li> Prevent New Logins Only (Drain) <ul> <li>Does not send new connection requests to the VM. </li> <li>Routes new connections to other available VMs in the farm. </li> <li>Allows reconnections to the VM. </li> <li>Agent Status is Draining. </li> </ul> <strong>Note:</strong> You must have an existing session on the VM before selecting this option. </li> Prevent New Logins (Drain) Until Restart <ul> <li>Does not send new connection requests to the VM until the VM is restarted. </li> <li>Routes new connections to other available VMs in the farm until the VM is restarted. </li> <li>Allows reconnections to the VM. </li> <li>Agent Status is Draining Until Restart. </li> <li>Reverts to Allow Logins setting after VM restart. </li> </ul> <strong>Note:</strong> You must have an existing session on the VM before selecting this option. </li>
   Launch Console	Launches a console so that you can log in to the virtual machine.
   Generate Logs	Generates logs for the session host. Logs are listed on the Logs tab of the Reports page. If you have configured a VMs file share, the system places log files in that file share. For more information, see Managing File Shares. Note: This feature requires Horizon Agent Installer 19.1 or later.