{"id":65809,"date":"2025-06-17T09:00:25","date_gmt":"2025-06-17T07:00:25","guid":{"rendered":"https:\/\/nolabnoparty.com\/?p=65809"},"modified":"2025-06-19T16:43:34","modified_gmt":"2025-06-19T14:43:34","slug":"omnissa-horizon-2503-upgrade-guide-uag-pt-3","status":"publish","type":"post","link":"https:\/\/nolabnoparty.com\/en\/omnissa-horizon-2503-upgrade-guide-uag-pt-3\/","title":{"rendered":"Omnissa Horizon 2503 upgrade guide: UAG - pt.3"},"content":{"rendered":"<p><img decoding=\"async\" class=\"aligncenter wp-image-66062 size-full\" title=\"upgrade-omnissa-uag-01\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-01.jpg\" alt=\"upgrade-omnissa-uag-01\" width=\"602\" height=\"202\" \/><\/p>\n<p>Following the upgrade sequence, the <a href=\"https:\/\/nolabnoparty.com\/en\/vmware-uag-okta-saml-integration-pt-1\/\">Unified Access Gateway<\/a> (UAG) is the next component to be upgraded.<\/p>\n<p>Currently, <strong>there is no direct upgrade<\/strong> for the UAG but instead, the correct method is to <strong>reinstall the new version<\/strong>.<\/p>\n<p><!--more--><\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-full wp-image-66064\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-02.jpg\" alt=\"\" width=\"600\" height=\"358\" title=\"\"><\/p>\n<p>&nbsp;<\/p>\n<h2>Blog serie<\/h2>\n<p><a href=\"https:\/\/nolabnoparty.com\/en\/omnissa-horizon-2503-upgrade-guide-app-volumes-manager-pt-1\/\">Omnissa Horizon 2503 upgrade guide: App Volumes Manager - pt.1<\/a><br \/>\n<a href=\"https:\/\/nolabnoparty.com\/en\/omnissa-horizon-2503-upgrade-guide-connection-server-pt-2\/\">Omnissa Horizon 2503 upgrade guide: Connection Server - pt.2<\/a><br \/>\nOmnissa Horizon 2503 upgrade guide: UAG - pt.3<br \/>\n<a href=\"https:\/\/nolabnoparty.com\/en\/omnissa-horizon-2503-upgrade-guide-dem-and-templates-pt-4\/\">Omnissa Horizon 2503 upgrade guide: DEM and Templates - pt.4<\/a><\/p>\n<p>&nbsp;<\/p>\n<h2>Before the upgrade<\/h2>\n<p>Since the upgrade of the Unified Access Gateway requires the deletion of the old version of the UAG, before proceeding you need to <strong>save the current configuration<\/strong> that will be imported to the new UAG later.<\/p>\n<p>Using your preferred browser, access the <strong>UAG login page<\/strong>, enter the required credentials and click <strong>Sign in<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-full wp-image-66066\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-03.jpg\" alt=\"\" width=\"427\" height=\"477\" title=\"\"><\/p>\n<p>In the <strong>Configuration Manually<\/strong> pane, click <strong>Select<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66068\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-04-600x314.jpg\" alt=\"\" width=\"600\" height=\"314\" title=\"\"><\/p>\n<p>In the <strong>Advanced Settings<\/strong> area, click the <strong>gear icon<\/strong> for <strong>System Configuration<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66070\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-05-600x353.jpg\" alt=\"\" width=\"600\" height=\"353\" title=\"\"><\/p>\n<p>Enable the <strong>Quiesce Mode<\/strong> to show the <strong>UAG\u00a0as not available<\/strong> when the load balancer checks the health of the appliance. Click <strong>Save<\/strong> at the bottom to save the setting.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66072\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-06-600x524.jpg\" alt=\"\" width=\"600\" height=\"524\" title=\"\"><\/p>\n<p>Now go to <strong>Support Settings<\/strong> area and click <strong>JSON<\/strong> to <strong>Export Unified Access Gateway Settings<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66074\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-07-600x196.jpg\" alt=\"\" width=\"600\" height=\"196\" title=\"\"><\/p>\n<p>The configuration is saved to the <strong>Download<\/strong> folder in your computer.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-full wp-image-66076\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-08.jpg\" alt=\"\" width=\"449\" height=\"149\" title=\"\"><\/p>\n<p>Now shutdown the UAG to upgrade. Right click the appliance and select <strong>Power &gt; Shut Down Guest OS<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66078\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-09-600x343.jpg\" alt=\"\" width=\"600\" height=\"343\" title=\"\"><\/p>\n<p>When the appliance has been powered off, delete the appliance. Right click the appliance and select <strong>Delete from Disk<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66080\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-10-600x311.jpg\" alt=\"\" width=\"600\" height=\"311\" title=\"\"><\/p>\n<p>Click <strong>Yes<\/strong> to confirm.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-full wp-image-66082\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-11.jpg\" alt=\"\" width=\"576\" height=\"242\" title=\"\"><\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<h2>Upgrade the UAG<\/h2>\n<p>Right click the Resource Pool in which you want to deploy the new UAG and select <strong>Deploy OVF Template<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66084\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-12-600x405.jpg\" alt=\"\" width=\"600\" height=\"405\" title=\"\"><\/p>\n<p>Click <strong>Upload Files<\/strong> and select the OVA (currently <em>euc-unified-access-gateway-25.03.0.0-14396117930_OVF10.ova<\/em>) to install the new version. Click <strong>Next<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66086\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-13-600x362.jpg\" alt=\"\" width=\"600\" height=\"362\" title=\"\"><\/p>\n<p>Enter the <strong>Virtual machine name<\/strong> and the folder to store the appliance. Click <strong>Next<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66088\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-14-600x362.jpg\" alt=\"\" width=\"600\" height=\"362\" title=\"\"><\/p>\n<p>Select the compute resource to use and enable the <strong>Automatically power on deployed VM<\/strong>. Click <strong>Next<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66090\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-15-600x362.jpg\" alt=\"\" width=\"600\" height=\"362\" title=\"\"><\/p>\n<p>Click <strong>Ignore<\/strong> then click <strong>Next<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66092\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-16-600x362.jpg\" alt=\"\" width=\"600\" height=\"362\" title=\"\"><\/p>\n<p>Select the required <strong>Configuration<\/strong> (<em>Single NIC<\/em> in the example). Click <strong>Next<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66094\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-17-600x362.jpg\" alt=\"\" width=\"600\" height=\"362\" title=\"\"><\/p>\n<p>Select the <strong>storage<\/strong> to use and click <strong>Next<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66096\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-18-600x362.jpg\" alt=\"\" width=\"600\" height=\"362\" title=\"\"><\/p>\n<p>Select the <strong>Destination Network<\/strong> for each source network then click <strong>Next<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66098\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-19-600x362.jpg\" alt=\"\" width=\"600\" height=\"362\" title=\"\"><\/p>\n<p>Enter the parameters to customize the installation then click <strong>Next<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66100\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-20-600x362.jpg\" alt=\"\" width=\"600\" height=\"362\" title=\"\"><\/p>\n<p>Click <strong>Finish<\/strong> to begin the deployment.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66102\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-21-600x362.jpg\" alt=\"\" width=\"600\" height=\"362\" title=\"\"><\/p>\n<p>The appliance is being installed.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66104\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-22-600x474.jpg\" alt=\"\" width=\"600\" height=\"474\" title=\"\"><\/p>\n<p>When the appliance has been installed, select the new Unified Access Gateway and click <strong>Power On<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66106\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-23-600x227.jpg\" alt=\"\" width=\"600\" height=\"227\" title=\"\"><\/p>\n<p>Using your preferred browser, enter the credentials set during the configuration then click <strong>Sign In<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-full wp-image-66108\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-24.jpg\" alt=\"\" width=\"427\" height=\"477\" title=\"\"><\/p>\n<p>Click <strong>Select<\/strong> in the <strong>Import Settings<\/strong> pane to import the configuration saved earlier.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66110\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-25-600x321.jpg\" alt=\"\" width=\"600\" height=\"321\" title=\"\"><\/p>\n<p>Click <strong>Browse<\/strong> to select the JSON configuration file.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66112\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-26-600x169.jpg\" alt=\"\" width=\"600\" height=\"169\" title=\"\"><\/p>\n<p>Click <strong>Import<\/strong> to import the configuration.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66114\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-27-600x169.jpg\" alt=\"\" width=\"600\" height=\"169\" title=\"\"><\/p>\n<p>The configuration has been imported successfully.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66116\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-28-600x178.jpg\" alt=\"\" width=\"600\" height=\"178\" title=\"\"><\/p>\n<p>After few seconds, the <strong>connectivity to the Connection Server is restored<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66118\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-29-600x407.jpg\" alt=\"\" width=\"600\" height=\"407\" title=\"\"><\/p>\n<p>&nbsp;<\/p>\n<h4>Import the SSL certificate<\/h4>\n<p>The import of the JSON file is <strong>not enough to restore the full functionality<\/strong> of the UAG. The <strong>SSL certificate must be re-imported<\/strong> to complete the upgrade. This is required because the JSON file <strong>cannot contain private keys<\/strong> associated with an SSL server certificate since private keys cannot be exported due to <strong>security reasons<\/strong>.<\/p>\n<p>In the <strong>Advanced Settings<\/strong>, click the <strong>gear icon<\/strong> for the <strong>TLS Server Certificate Settings<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66120\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-30-600x281.jpg\" alt=\"\" width=\"600\" height=\"281\" title=\"\"><\/p>\n<p>Select <strong>Internet interface<\/strong>, select the <strong>Certificate Type<\/strong> (<em>PEM<\/em> in the example) then specify the <strong>Private Key<\/strong> and the <strong>Certificate Chain<\/strong> if PEM was selected. Click <strong>Save<\/strong> to import the certificate.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66122\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-31-600x235.jpg\" alt=\"\" width=\"600\" height=\"235\" title=\"\"><\/p>\n<p>The certificate has been imported successfully.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66124\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-32-600x200.jpg\" alt=\"\" width=\"600\" height=\"200\" title=\"\"><\/p>\n<p>The Omnissa <a href=\"https:\/\/docs.omnissa.com\/category\/Unified_Access_Gateway\" target=\"_blank\" rel=\"noopener\">Unified Access Gateway<\/a> appliance is now upgraded to the 2503 version.<\/p>\n<p>&nbsp;<\/p>\n<h4>Upgrade the other UAGs<\/h4>\n<p>If other appliances are configurated in your Horizon infrastructure, you must repeat the same procedure to the other UAGs to complete the upgrade procedure.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-large wp-image-66126\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-33-600x374.jpg\" alt=\"\" width=\"600\" height=\"374\" title=\"\"><\/p>\n<p>When all the installed appliances have been upgraded to the new version, the UAGs are fully working and <strong>ready to be used for production<\/strong>.<\/p>\n<p><img decoding=\"async\" class=\"aligncenter size-full wp-image-66128\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/2025\/06\/upgrade-omnissa-uag-34.jpg\" alt=\"\" width=\"427\" height=\"477\" title=\"\"><\/p>\n<p>The Horizon infrastructure <strong>upgrade process is nearly complete<\/strong>. The final step is to upgrade the <a href=\"https:\/\/nolabnoparty.com\/en\/vmware-dynamic-environment-manager-dem-configuration\/\">Dynamic Environment Manager<\/a> tool if installed and used for VDI management.<\/p>\n<p><img decoding=\"async\" title=\"signature\" src=\"https:\/\/nolabnoparty.com\/wp-content\/uploads\/images\/firma.jpg\" alt=\"signature\" \/><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Following the upgrade sequence, the Unified Access Gateway (UAG) is the next component to be upgraded. Currently, there is no direct upgrade for the UAG but instead, the correct method is to reinstall the new version.<\/p>\n","protected":false},"author":3,"featured_media":66062,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"rop_custom_images_group":[],"rop_custom_messages_group":[],"rop_publish_now":"initial","rop_publish_now_accounts":{"facebook_2879994398731222_17841400390232720":"","mastodon_115463926174894442_115463926174894442":"","linkedin_93tdZWzMZc_93tdZWzMZc":"","bluesky_did:plc:tkabz5kl2rukzdwtuongv3kz_did:plc:tkabz5kl2rukzdwtuongv3kz":""},"rop_publish_now_history":[],"rop_publish_now_status":"pending","footnotes":""},"categories":[1025,2905],"tags":[1711,2250,876,2239],"class_list":["post-65809","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-horizon-en","category-omnissa-en","tag-horizon","tag-uag","tag-upgrade-en","tag-vdi-en","has_thumb"],"_links":{"self":[{"href":"https:\/\/nolabnoparty.com\/en\/wp-json\/wp\/v2\/posts\/65809","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nolabnoparty.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/nolabnoparty.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/nolabnoparty.com\/en\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/nolabnoparty.com\/en\/wp-json\/wp\/v2\/comments?post=65809"}],"version-history":[{"count":0,"href":"https:\/\/nolabnoparty.com\/en\/wp-json\/wp\/v2\/posts\/65809\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/nolabnoparty.com\/en\/wp-json\/wp\/v2\/media\/66062"}],"wp:attachment":[{"href":"https:\/\/nolabnoparty.com\/en\/wp-json\/wp\/v2\/media?parent=65809"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/nolabnoparty.com\/en\/wp-json\/wp\/v2\/categories?post=65809"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/nolabnoparty.com\/en\/wp-json\/wp\/v2\/tags?post=65809"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}