Loading

×Sorry to interrupt
Uncaught ReferenceError: addCTracking is not defined
throws at https://kb.vmware.com/resource/KM_TealiumTrackingJS?v=0.5:100:1

Refresh

Cookie Preference Center

General Information on cookies

When you visit our website, we use cookies to ensure that we give you the best experience. This information does not usually directly identify you, but it can give you a more personalized web experience. Because we respect your right to privacy, you can choose not to allow some types of cookies by clicking on the different category headings to find out more and change your settings. However, blocking some types of cookies may impact your experience on the site and the services we are able to offer. Further information can be found in our

Cookie Policy.

Strictly Necessary

Strictly Necessary

Always Active

Strictly Necessary

Strictly necessary cookies are always enabled since they are essential for our website to function. They enable core functionality such as security, network management, and website accessibility. You can set your browser to block or alert you about these cookies, but this may affect how the website functions. For more information please visit www.aboutcookies.org or www.allaboutcookies.org.

Cookie Details‎

Performance

Performance

Performance

Performance cookies are used to analyze the user experience to improve our website by collecting and reporting information on how you use it. They allow us to know which pages are the most and least popular, see how visitors move around the site, optimize our website and make it easier to navigate.

Cookie Details‎

Please confirm your settings by refreshing the page.

Functional

Functional

Functional

Functional cookies help us keep track of your past browsing choices so we can improve usability and customize your experience. These cookies enable the website to remember your preferred settings, language preferences, location and other customizable elements such as font or text size. If you do not allow these cookies, then some or all of these services may not function properly.

Cookie Details‎

Advertising

Advertising

Advertising

Advertising cookies are used to send you relevant advertising and promotional information. They may be set through our site by third parties to build a profile of your interests and show you relevant advertisements on other sites. These cookies do not directly store personal information, but their function is based on uniquely identifying your browser and internet device.

Cookie Details‎

Advertising Cookies

Consent Leg.Interest

Select All Vendors

Select All Vendors

Select All Hosts

Select All

Clear Filters

Information storage and access

Apply

Confirm My Choices Reject All Allow All

My Subscriptions

Loading

Knowledge Base

Upgrading a Horizon 7.7 Workload Domain to 7.9 in VMware Cloud Foundation (74620)

Last Updated: 3/21/2024Categories: How toTotal Views: 2660Language:
English

Subscribe to get an email
newsletter with new updates

Please provide article feedback:

Details

This article provides the steps necessary required to upgrade a VMware Cloud Foundation Horizon Workload Domain from Horizon 7.7 to 7.9.

Versioning:

VCF

PSC / vCenter

Horizon

App Volumes

UAG

UEM

3.7.x and 3.8.0

6.7 U1

7.7

2.14

3.4

9.5

3.8.1

6.7.U3

7.9

2.17

3.6

9.8

Upgrade order:

The recommended way is Horizon Client to be upgraded before the infrastructure.

Horizon Client

Horizon Infrastructure

vSphere Infrastructure

Agents

Horizon Infrastructure
The following is the general recommended order. User Environment Manager Console and App Volumes can completed earlier or later.

Composer Server

Connection Servers

Unified Access Gateways

User Environment Manager Console

App Volumes Managers

Solution

Upgrade Resource vCenters
For upgrading Workload Domain vCenters, use LCM within SDDC Manager UI to upgrade VI domains.

Upgrade Composer servers

Important: During an upgrade, Horizon 7 does not support View Composer provisioning and maintenance operations. Operations such as provisioning and recomposing linked-clone desktops are not supported during the transitional period when any Horizon 7 servers are still running the earlier version. Perform these operations only when all instances of Horizon Connection Server and View Composer have been upgraded

Before proceeding, please ensure to take a backup of the SQL database and take a snapshot of the VM. TO prepare for the Compose Server upgrade, pleas see https://docs.vmware.com/en/VMware-Horizon-7/7.9/horizon-upgrades/GUID-25246C90-5DF0-474B-A7B8-259765EAD5D9.html

Ensure a snapshot of the Composer Server VM(s) are taken before upgrading.

On the virtual or physical machines where View Composer is installed, download and run the installer for View Composer. The installer can be downloaded from the VMware web site. Step-by-step instructions for running the installer appear in the Horizon 7 Installation document.

Specify whether to upgrade the database schema, if a schema upgrade is required.

If a dialog box appears with the message "Database upgrade completed with warnings", safely ignore the message and click OK.

When the wizard prompts for the View Composer port number, verify that the port number is set to 18443.

Note: For details about upgrading Composer servers use the approved by EUC guidance here

Upgrade Connection Servers
In place upgrade of the Connection servers is supported.

Optionally, export the ldap database using vdmexport.exe tool on the server. For detailed instructions on how to use the tool check the official documentation.

Ensure a snapshot of the Connection Server VM(s) are taken before upgrading.

Log on Connection Servers Edge Load Balancer and disable the server that hosts the Connection Server instance that is about to upgraded:

Log on Management vCenter Web Client.

Go to Menu->Network and Security->NSX Edges.

Select the Edge used for Connection servers load balancer and go to Load Balancer

Go to Pools, select the existing pool and click Edit.

Go to Members, select the member you want to disable, click Edit and change its state to Disable.

Log in to Horizon Administrator UI.

Go to View Configuration > Servers and click the Connection Servers tab.

Select the Connection Server instance in the list and click the Disable button above the table.

Click OK to confirm disabling the server.

On the host of the Connection Server instance, download and run the installer for the new version of Connection Server.

Enable the server from the Horizon Administrator and load balancer.

Repeat the points above for all Connection servers.

Note: For details about upgrading Connection servers use the EUC guidance here

Upgrade Unified Access Gateway (UAG)
UAG does not support in-place upgrade.

Procedure

Disable UAG that is going to be upgraded in the DMZ load balancer. Refer the Upgrade Connection servers section for details.

Log on UAG appliance using URL: https://<management IP>:9443/admin, select Configure Manually and export the setting in a json format.

Shutdown the old UAG. Optionally, rename the VM if the it needs to be retained.

Import the new UAG appliance using the OVF template wizard. Use the same original UAG IP addresses for DMZ, Internal and Management interfaces.

Log in to the new UAG appliance and import the exported settings.

Re-enable UAG on the Load Balancer.

Upgrade View Clients

For environments deploying instant clones or View Composer linked clones, upgrade the agent software on a parent virtual machine and create a desktop pool for testing purposes.

Download and run the new version of the Horizon Agent installer on a parent virtual machine. The installer can be downloaded from the VMware website.

Create a small desktop pool from this virtual machine.

Test a virtual machine desktop from the desktop pool to verify that all the usage scenarios function properly. For example, create a desktop pool that contains one virtual machine desktop, and verify that you can use Horizon Client to log in to that desktop.

Step-by-step instructions for running the Horizon Agent installer and creating desktop pools appear in Setting Up Virtual Desktops in Horizon 7, available by clicking the Help button in Horizon Administrator.

For details about upgrading View agents use the officially approved by EUC guidance here.

Upgrade User Environment Manager UEM
As EUM is a console, simply uninstall the old EUM and install the new version.

Upgrade App Volumes Manager
An in-place upgrade is supported for App Volumes 2.14 to 2.17 upgrade.

Prerequisites:

Detach all volumes.

In the Windows Start menu, open Control Panel and click Administrative Tools > ODBC data source. Note down the database and server name defined in the system ODBC source svmanager.

Back up the App Volumes database using SQL Server tools.

Create a full server back up or snapshot of the App Volumes Manager Server VM.

Procedure

Disable App Volumes connection in the load balancer. Refer the Upgrade Connection Servers section for details.

Log in as the administrator on the VM where App Volumes Manager is installed.

Locate the App Volumes installer and double-click the setup.exe file.

Select the App Volumes Manager component and click Install. A notification window with the upgrade process details is displayed.

Click Next to confirm the upgrade.

Click Install to begin the installation. A Status Bar shows the progress of the installation. The installation process takes 5 to 10 minutes to complete. During this time, configuration information is first backed-up, new files are installed, and the configuration information is restored.

Click Finish to complete the installation.

Re-enable App Volumes connection in the load balancer.

For details about upgrading App Volumes Manager use the officially approved by EUC guidance here

Import Horizon 7.9 bundle
To import the new Horizon bundle use the LCM functionality within SDDC Manager to download the bundle.

Change Horizon version of the binaries used for deployment in the VCF database

Obtain the Horizon domain ID by logging into the SDDC Manager and navigate to Workload Domains then the Horizon Domain. In the browser URL note the ID as below:

https://sddc-manager.vcf.corp.local/ui/sddc-manager/inventory/domains/horizon-domains/{horizon-domain-id}/summary(monitoring-panel:monitor/tasks)

Check current Horizon bundle version for domain with ID {horizon_id}:

curl -k -H 'Content-type: application/json' -H 'Accept: application/json' -X GET http://localhost/vdi-domains/bundle/{horizon-domain-id}

Confirm the command returns: {"version":"7.7.0"}

Upgrade Horizon bundle version to 7.9.0 for domain with the noted ID from Step 1.

curl -k -H 'Content-type: application/json' -H 'Accept: application/json' -X PUT http://localhost/vdi-domains/bundle/{horizon-domain-id} -d '{"version": "7.9.0"}'

Verify the Horizon bundle version for domain:

curl -k -H 'Content-type: application/json' -H 'Accept: application/json' -X GET http://localhost/vdi-domains/bundle/{horizon_id}

Upgrade VM Agents

The Virtual Machine agents need to be installed and upgraded in a strict order. For upgrading any agent, the the agents should be uninstalled the reverse of the order below and then re-installed in the below order.

VM Tools

Horizon Agent

User Environment Manager FlexEngine

App Volumes Agent

Detectable by VMware SkylineTM

Actions

Copy

link to clipboard
copied!

Print

Language:
English

Attachments

Additional Resources

KB
•
End Of General Availability of the Free vSphere Hypervisor (ESXi 7.x and 8.x) (2107518)

KB
•
vSphere 6.7 Update 3 へのアップグレード後、HTML5 クライアントを介して vSAN 関連情報を取得できない (74731)

KB
•
「ネイティブ Active Directory IDS または LDAP Active Directory IDS がすでに登録されています (There is already a native AD IDS or LDAP AD IDS registered)」エラーが表示され、Active Directory ドメインからの vCenter Server Appliance の分離または離脱ができない (71083)

KB
•
Download and Install VMware Fusion (2014097)

Results 1-4 of 4

Ask The Community

Get answers quickly from VMware experts in the community

Post Subject

CONTINUE IN COMMUNITIES

Related Products:

VMware Cloud Foundation

Related Versions:

VMware Cloud Foundation 3.8.x

Take Our Survey

Support Assistant