Upgrading the disconnected VM Manager Tool

Available from 9.2.20.

To upgrade the disconnected VM Manager Tool, back up the VM Manager Tool configuration files and remove the old version of the VM Manager Tool. Then, install a new version of the tool and restore the configuration files.

1. To stop the VM Manager Tool, open the command line interface, go to the directory in which you installed the tool, and run the following command.
   • ./vmman.sh -stop
   • vmman.bat -stop

   Tip: If you do not remember where the VM Manager Tool is installed, search the computer for the following file.

   • vmman.sh
   • vmman.bat
2. Back up the following folders from the directory in which you installed the VM Manager Tool.
   • config
     Important: Do not back up the following files from this directory.

     • vmmconf_template.properties
     • vmmlmtconf.properties
   • keydb
3. To uninstall the VM Manager Tool, run the following command.
   • ./vmman.sh -remove
   • vmman.bat -remove
4. Remove the entire folder of the VM Manager Tool.
5. Install a new version of the VM Manager Tool.
6. Restore the files that you backed up in step 2.
   Important:

   • Do not overwrite the entire config and keydb folders. Copy files from the backed up folders to the folders that were created after you installed the new version of the VM Manager Tool. Otherwise, you might lose files that were added in the new version of the VM Manager Tool. For example, starting from application update 9.2.26, a new keystore is added to the keydb folder: vmman_store.p12.
   • In case you would still like to use the insecure protocol (HTTP), you need to manually add the following line vmm_insecure_connection_allowed=true to the config/vmmmainconf.properties file. This action is required only once when upgrading the VM Manager Tool from version 9.2.35 or below to version 9.2.36 or higher.

   Do not overwrite the entire config and keydb folders. Copy files from the backed up folders to the folders that were created after you installed the new version of the VM Manager Tool. Otherwise, you might lose files that were added in the new version of the VM Manager Tool.
7. Starting from application update 9.2.26, the VM Manager Tool keystore format is changed from JCEKS to PKCS#12. If you are upgrading the VM Manager Tool from version earlier than 9.2.26, run the following command to change the VM Manager Tool keystore format.
   • ./vmman.sh -convertkeystore
   • vmman.bat -convertkeystore
8. To upgrade the VM Manager Tool, run the following command.
   • ./vmman.sh -upgrade
   • vmman.bat -upgrade
9. Start the VM Manager Tool.