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.

    • Related Articles

    • Planned Retirement of Hosted Apps and Desktops Service

      Overlap between existing Atria service modules Atria has two core service modules used for managing Desktops, Applications and associated Resources.  These are known as “Citrix” Service, (CITRIX) and “Hosted Apps and Desktops” Service (HAAD) These ...

    • Hosted Apps and Desktops - How to Fix Duplicate Offering Names

      Overview This article provides steps on how to fix the specific error message below when discovering offerings on the HAaD Offering Management Page. Error Messages Scan duplicate offerings in Citrix server Use the Powershell script below and compare ...

    • How to Migrate from Hosted Exchange to Exchange Online

      Overview This article provides an example of how to migrate from the Atria Hosted Exchange Service to the Microsoft Online Service.  It will cover the change in service as well as data migration.  The process will use the following free Microsoft ...

    • Hosted Exchange Version Migration

      Overview Atria supports multi-Exchange version coexistence. There will be a time where you may want to upgrade/migrate a customer’s assigned version to a higher one. This article gives an overview of how Atria interacts with Exchange, considerations ...

    • Hosted Exchange Service Deployment

      Objective This article provides a guide to installing the Hosted Exchange service into the Atria Platform. Web Service and Schema Installation The first step for deployment of any new Service is to install the Web Service (if required) and its ...