Upgrading the disconnected VM Manager Tool

9.2.20 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.

Before you begin

To upgrade the VM Manager Tool, you must have the following privileges.
  • Linux root
  • Windows User with administrative privileges

About this task

The following procedure applies to the disconnected VM Manager Tool. If you use the central or distributed VM Manager Tool, see: Upgrading the central or distributed VM Manager Tool.

Procedure

  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.
    • Linux ./vmman.sh -stop
    • Windows vmman.bat -stop
    Tip: If you do not remember where the VM Manager Tool is installed, search the computer for the following file.
    • Linux vmman.sh
    • Windows 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.
    • Linux ./vmman.sh -remove
    • Windows 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.
  7. Starting from application update 9.2.26, the keystore format that is used by the VM Manager Tool is changed from JCEKS to PKCS12. If you are upgrading the VM Manager Tool from version earlier than 9.2.26, run the following command to change the keystore format.
    • Linux ./vmman.sh -convertkeystore
    • Windows vmman.bat -convertkeystore
  8. To upgrade the VM Manager Tool, run the following command.
    • Linux ./vmman.sh -upgrade
    • Windows vmman.bat -upgrade
  9. Start the VM Manager Tool.