Upgrade and Redeploy the Commander VM Access Proxy
If you are upgrading to Commander Release 8.5.3, and you currently use a Commander VM Access Proxy, it's recommended that you also upgrade to Commander VM Access Proxy Version 3.4.
Although you may be able to use your existing Commander VM Access Proxy, Version 3.4 offers the following improvements:
- A container-based installation process, which is simpler and will provide easier upgrades in the future.
- Security enhancements.
- Improved copy/paste functionality in Secure RDP, Secure SSH, and Secure VNC connections.
- The ability to install the VM Access Proxy on a machine with a Linux distribution of your choice that complies with your company's best practices and security requirements.
To download the VM Access Proxy version 3.4 package, go to the Downloads page.
Version 3.4 of the VM Access Proxy is recommended for use with Commander 8.4.x or higher.
Versions 3.0-3.3 of the VM Access Proxy are compatible with vCommander releases 8.3.x, 8.2.x, 8.1.x, 7.5.x, 7.1.x, 7.0.x, 6.1.x, and 6.0.x.
Note: Although versions 3.0-3.3 of the VM Access Proxy are also compatible with Commander 8.4.x and 8.5.x, for new installations, it's recommended that you use VM Access Proxy 3.4. VM Access Proxy 3.0-3.3 is deprecated and will be removed in a future release.
If you use the VM Access Proxy (formerly the Console Proxy), you can also upgrade to Commander VM Access Proxy Version 3.4. See Upgrade and Redeploy the Commander VM Access Proxy for more general information about upgrading the VM Proxy and to ensure that you perform the steps for both upgrade tasks in the proper order.
To deploy a version 3.4 VM Access Proxy that will replace an existing version 3.3.x or lower VM Access Proxy, perform the following steps:
- If you want to be able to access the old VM Access Proxy to copy configuration or roll back the upgrade, keep the old server running.
- Disable or disconnect the network card on the old VM Access Proxy server.
- Deploy the new version of the VM Access Proxy alongside your old version. For details, see Deploying VM Access Proxies.
Tip: Use the same IP address and DNS/FQDN name for the version 3.x VM Access Proxy server.
- Apply the SSL and customized configurations that you applied to the old server to the new server.
Note: On 3.3 and lower VM Access Proxies, the configuration folder is
/var/lib/tomcat/conf; on 3.4 VM Access Proxies, the configuration folder is
- Restart the new VM Access Proxy server with the following command:
sudo docker-compose restart
- In Commander, configure the VM Access Proxy to point to the FQDN of the new VM Access Proxy server. See Adding VM Access Proxies to Commander.
- Make sure you can open a secure console session through the VM Access Proxy.
- Power off the old VM Access Proxy server until you're ready to decommission it.