To run the product installer graphical interface, log on to the machine and then insert the media or mount the ISO drive for the new release. Double-click AutoSelect. To use the command-line interface, see Install using the command line.
Step 1. If more than one core component is installed on the same server (for example, the Controller, Studio, and License Server) and several of those components have new versions available, they will all be upgraded when you run the installer on that server.
If any core components are installed on machines other than the Controller, run the installer on each of those machines. The recommended order is: License Server, StoreFront, and then Director.
Step 2. If you use Provisioning Services, upgrade the PVS servers and target devices, using the guidance in the
Provisioning Services documentation.
Step 3. Run the product installer on machines containing VDAs. (See Step 12 if you use master images and Machine Creation Services.)
Step 4. Run the product installer on half of the Controllers. (This also upgrades any other core components installed on those servers.) For example, if your Site has four Controllers, run the installer on two of them.
- Leaving half of the Controllers active allows users to access the Site. VDAs can register with the remaining Controllers. There may be times when the Site has reduced capacity because fewer Controllers are available. The upgrade causes only a brief interruption in establishing new client connections during the final database upgrade steps. The upgraded Controllers cannot process requests until the entire Site is upgraded.
- If your Site has only one Controller, the Site is inoperable during the upgrade.
Step 5. If Studio is installed on a different machine than one you've already upgraded, run the installer on the machine where Studio is installed.
Step 7. From the newly upgraded Studio, select Citrix Studio site-name in the navigation pane. Select the Common Tasks tab. Select Upgrade remaining Delivery Controllers.
Step 8. After completing the upgrade and confirming completion, close and then reopen Studio.
Step 9. In the Site Configuration section of the Common Tasks page, select Perform registration. Registering the Controllers makes them available to the Site.
Step 10. After you select Finish when the upgrade completes, you are offered the opportunity to enroll in the Citrix telemetry programs, which collect information about your deployment. That information is used to improve product quality, reliability, and performance.
Step 11. After upgrading components, the database, and the Site, test the newly-upgraded Site. From Studio, select Citrix Studio site-name in the navigation pane. Select the Common Tasks tab and then select Test Site. These tests were run automatically after you upgraded the database, but you can run them again at any time.
The Test Site functionality might fail for a Controller installed on Windows Server 2016, when a local SQL Server Express is used for the Site database, if the SQL Server Browser service is not started. To avoid this, complete the following tasks.
1. Enable the SQL Server Browser service (if required) and then start it.
2. Restart the SQL Server (SQLEXPRESS) service.
Step 12. If you use Machine Creation Services and want to use upgraded VDAs: After you upgrade and test the deployment, update the VDA used in the master images (if you haven't done that already). Update master images that use those VDAs. See
Update or create a new master image. Then update machine catalogs that use those master images, and upgrade Delivery Groups that use those catalogs.
After upgrading the core components and VDAs, use the newly upgraded Studio to initiate an automatic or manual database and Site upgrade.
Remember: Check the
Preparation section above for permission requirements.
- For an automatic database upgrade, the Studio user's permissions must include the ability to update the SQL Server database schema.
- For a manual upgrade, the Studio user runs some of the generated scripts from Studio. The database administrator runs other scripts, using either the SQLCMD utility or the SQL Server Management Studio in SQLCMD mode. Otherwise, inaccurate errors can result.
Important: Citrix strongly recommends that you back up the database before upgrading. See
CTX135207.
During a database upgrade, product services are disabled. During that time, Controllers cannot broker new connections for the Site, so plan carefully.
After the database upgrade completes and product services are enabled, Studio tests the environment and configuration, and then generates an HTML report. If problems are identified, you can restore the database backup. After resolving issues, you can upgrade the database again.
Upgrade the database and Site automatically:
Launch the newly upgraded Studio. After you choose to start the Site upgrade automatically and confirm that you are ready, the database and Site upgrade proceeds.
Upgrade the database and Site manually:
Step 1. Launch the newly-upgraded Studio. After you choose to manually upgrade the Site, the wizard checks for License Server compatibility and requests confirmation. After you confirm that you have backed up the database, the wizard generates and displays the scripts and a checklist of upgrade steps.
Step 2. Run the following scripts in the order shown.
Script
|
Description
|
DisableServices.ps1
|
PowerShell script to be run by the Studio user on a Controller to disable product services.
|
UpgradeSiteDatabase.sql
|
SQL script to be run by the database administrator on the server containing the Site database.
|
UpgradeMonitorDatabase.sql
|
SQL script to be run by the database administrator on the server containing the Monitor database.
|
UpgradeLoggingDatabase.sql
|
SQL script to be run by the database administrator on the server containing the Configuration Logging database. Run this script only if this database changes (for example, after applying a hotfix).
|
EnableServices.ps1
|
PowerShell script to be run by the Studio user on a Controller to enable product services.
|
Step 3. After completing the checklist tasks. click Finish upgrade.
