Hotfix Management

Hotfix deployment and management for Horizon DaaS has been streamlined by combining multiple hotfixes into a single package, called an update. For example, a Horizon DaaS 9.2.0 Update 2 package would contain all fixes from Horizon DaaS 9.2.0 Update 1, along with additional fixes found only in Update 2.

Horizon DaaS hotfixes and updates are deployed using Horizon Version Manager (HVM), and it is advised to use the latest HVM version available. HVM hotfix management includes uploading the updates, refreshing the list of available hotfixes and updates, applying them to appliances, detecting the presence of previously deployed updates on appliances, and reverting appliances to a previous state.

Install Updated Horizon Version Manager and Horizon Air Link (if necessary)

Upload Hotfix Artifacts

Refresh the Hotfix List

Apply a Hotfix

Detect Hotfixes on DaaS Appliances

Revert Appliances to a Pre-Hotfix State

Install Updated Horizon Version Manager and Horizon Air Link (if necessary)

Check the most recent version of the Horizon DaaS 9.2.x Release Notes to see if updated Horizon Version Manager (HVM) and Horizon Air Link (HAL) must be deployed along with the hotfixes you are installing. If updated HVM and HAL are not required, proceed to Upload Hotfix Artifacts. If updated HVM and HAL are required, follow the steps below to deploy the updated appliances and resync the HAL APIKey.

1. Power off HVM/HAL appliances and add the suffix -bak to them.
2. Make a note of the existing appliance configuration, such as IP addresses, storage, and port group.
3. Follow steps in Install Horizon Version Manager to deploy the newer appliances.
4. If necessary, log into the Horizon Version Manager RunDeck, proceeding past any SSL warnings.
5. In a browser, navigate to https://<HVM_IPADDRESS>:4443/.
6. Log in with user name rundeck and the password you set previously.
7. Click Projects > Horizon-DaaS.
8. Click Jobs > Horizon-Air-Link Resync.
9. Fill out the required fields and click Run Job Now.

Upload Hotfix Artifacts

Note: Hotfixes are uploaded to the Horizon Version Manager appliance, not to a DaaS appliance.

There are two different procedures for uploading artifacts, depending on the source machine from which you are performing the upload.

• To upload hotfix artifacts from a jump host running Unix or macOS:

  1. Log into the Horizon Version Manager portal.

  2. Click Projects > Horizon-DaaS-Artifact-Upload.

  3. Click Jobs > Upload Artifacts to Horizon Version Manager.

  4. Enter information as described in the following table.

     Field	Description
     Artifact-Type	Select hotfixes.
     File	Click New Value + and paste the UNIX absolute path of the file to upload. For example, /home/guest/file1.tgz. Repeat for each hotfix file you want to upload.
     IP-Address	IP address of the machine where the file is located.
     User-Name	User name for the machine where the file is located.
     User-Password	User password for the machine where the file is located.

  5. Click the Run Job Now button on the top right of the page.

     Rundeck shows the progress of the file transfer, followed by a message indicating that the transfer has been successful.

• To upload hotfix artifacts from a Microsoft Windows machine:

  1. Upload the file to your Horizon Version Manager appliance using a file transfer client such as WinSCP for Microsoft Windows or Filezilla for Mac.

  2. Change permissions for the file. For example:

     chmod 744 file1.tgz
     

  3. Change ownership for the file.

     $ chown -R rundeck:rundeck file1.tgz
     

Refresh the Hotfix List

If you have uploaded hotfix artifacts since the last time you ran the Refresh Hotfix List job, run that job now. Running the Refresh Hotfix List job makes your recently uploaded hotfixes available when you want to apply them to your appliances.

1. In Rundeck, click Projects > Horizon-DaaS-HotFix-Management.

2. Click Jobs > Refresh Hotfix List.

3. Click the Run Job Now button.

   Rundeck shows the progress of the refresh, followed by a message in the top right of the page indicating that the refresh has been successful.

Apply a Hotfix

There are two different jobs for applying hotfixes to appliances. The job you use depends on whether you are applying hotfixes to Tenant appliances in a "pre-migrated" state. These are Tenants for which you have run the Upgrade task but not yet run the Migrate task. For more information on this distinction, see Upgrading a Tenant.

• To apply hotfixes to Tenant appliances that have been upgraded but not yet migrated:

  1. In Rundeck, click Projects > Horizon-DaaS-HotFix-Management.

  2. Click Jobs > Apply Hotfix to Pre-Migrated Tenant Appliances.

  3. For Org-DaaS-Version, select the current version of Horizon DaaS that is running on the appliances.

     Available hotfixes for that version appear next to Hotfix.

     Note: If you see hotfixes marked as only applying to certain types of appliances, it is not something with which you need to be concerned. The system applies all hotfixes to the appropriate appliances without any additional action on your part.

  4. Select hotfixes to install.

  5. Fill in the rest of the required information and click Run Job Now.

     Rundeck shows the progress of the job, followed by a message in the top right of the page indicating that the hotfix has been successful.

• To apply a hotfix to DaaS management (Service Provider and Resource Manager) appliances and to Tenant appliances that are not in the "pre-migrated" state described above

  1. In Rundeck, click Projects > Horizon-DaaS-HotFix-Management.

  2. Click Jobs > Apply Hotfix to DaaS Appliances.

  3. For Org-DaaS-Version, select the current version of Horizon DaaS that is running on the appliances.

     Available hotfixes for that version appear next to Hotfix.

     Note: If you see hotfixes marked as only applying to certain types of appliances, it is not something with which you must be concerned. The system applies all hotfixes to the appropriate appliances without any additional action on your part.

  4. Select hotfixes to install.

  5. If you are reapplying hotfixes following a previous failed attempt, select Yes in the Force drop-down menu. Otherwise, leave the default value of No.

  6. Fill in the rest of the required information and click Run Job Now.

     Rundeck shows the progress of the job, followed by a message in the top right of the page indicating that the hotfix has been successful.

Detect Hotfixes on DaaS Appliances

1. In Rundeck, click Projects > Horizon-DaaS-HotFix-Management.

2. Click Jobs > Detect Hotfixes on DaaS Appliances.

3. Fill in the required information and click Run Job Now.

   When the job is finished, you can view the output on the Activity page. The output includes a list of all appliances in the organizations you selected and the hotfixes installed on each appliance.

Revert Appliances to a Pre-Hotfix State

Horizon Version Manager automatically takes snapshots of your appliances before and after you apply a hotfix. To revert an appliance, navigate to it in your vCenter Server and select the desired snapshot.