Migrate to a new Hosted Apps and Desktops Delivery Controller

Migrate to a new Hosted Apps and Desktops Delivery Controller

Prerequisite tools 

For each server that will have core components or web services installed, the below prerequisite items must be installed.  From version v12.11+ the database installation should be run from the Provisioning Server, so prerequisite items are not required on the SQL Server.
  1. Powershell 5.1 (if on Windows 2012 R2), Otherwise this is the standard version on Windows Server 2016/2019
  2. .NET Framework 4.8
  3. Install Windows RSAT Features on the VM
  4. Copy across the Root CA Certificate - https://docs.getatria.com/docs/installation/transfer-certification

Prerequisite for the Atria Setup

During the process, allow any install/config changes related to PATH Environment Variable Change, NuGet Provider, PSRepository
  1. [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  2. Install-Script Atria.Tools.Setup-Bootstrap

Install Atria.Tools module from the script

  1. cd 'C:\Program Files\WindowsPowershell\Scripts'
  2. .\Atria.Tools.Setup-Bootstrap.ps1 -username 'any username' -PersonalAccessToken 'access token provided by Automate101'
      This will install 2 Atria modules: Atria.Tools and Atria.Platform
        

Install XenApp Component(s) on the new Delivery Controller

After this is installed, we need to Install the Atria Component of XenDesktopWS, or  XenAppWS if Applicable.
On the new XenDesktop Controller, run the below command via PowerShell

Install-AtriaHostedAppsAndDesktops -HostedAppsAndDesktops -HostedAppsVersion  'XenDesktop' 

OR

Install-AtriaHostedAppsAndDesktops -HostedAppsAndDesktops -HostedAppsVersion 'XenApp'

Once this is installed, you should be able to switch the delivery controllers over in the UI with the below steps
  1. Enable the server:
    1. From the Atria menu bar, choose Configuration > System Manager > Servers.
    2. If the server on which you installed the service is not listed, click Refresh Server List.
    3. Expand the entry for the server and verify that Server Enabled is selected.

  2. Assign server roles:
    1. From the Atria menu bar, choose Configuration > System Manager > Server Roles, and then expand the entry for the server.
    2. Under Server Connection Components, select Hosted Apps and Desktops, and then click Save.

  3. Add a server connection:
    1. From the Atria menu bar, choose Configuration > System Manager > Server Connections, select a Location Filter if applicable,
      1. Server: Select the server where the web service is installed.
        You should see the previous server in the Server Connections, drop down the “Server” and select the new setup in step 2.1.


      2. Credentials: Select or type the credentials for the server.
      3. URL Base: Select or type /CSMXenAppWS/v1 for XenApp, /CSMXenDesktopWS/v1 for XenDesktop.
      4. Protocol: Select http for XenApp and XenDesktop.
      5. Port: Type 8095 for XenApp or XenDesktop.
      6. Timeout: Defaults to 200000 milliseconds.
      7. Version: Select the installed service component: XenDesktop Direct for the XenDesktop web service, or XenApp Direct for the XenApp web service.
    2. Click Save.
    3. On the Server Connections page, click the icon in the Test column for the server. The icon turns green for a successful connection. A red icon indicates an unsuccessful connection. Mouse over it for information about the failed connection.