3. Installing the PxM Virtual Appliance within VMware vSphere

This chapter provides instructions on how to install the PxM Virtual Appliance within VMware infrastructure.

3.1. PxM Software download

The software is supplied as an Open Virtual Appliance (OVA), ready for deployment into a VMware infrastructure environment.

To download the latest PxM software:

  1. Go to the PxM Platform Virtual Appliance section of the Osirium Software Releases page.

  2. Under Deploying new appliances, download PxM Osirium OVA.


    A SHA256 checksum is available to verify the download integrity.

3.2. Deploying the virtual appliance

  1. Within your existing VMware infrastructure, deploy the OVF Template.

  2. Within the Deploy OVF Template window, select the source location of the download virtual appliance OVA file.

    Deploy OVF Template

  3. Click Next.

  4. Within the Select a resource window, select where to run the deployed template.

    Select a Resource

  5. Click Next.

  6. Within the Review details window, verify the OVF template details shown.

    Review Details

  7. Click Next.

  8. Within the Accept license agreements window, read the end-user license agreement and click Accept to continue with the Installation.

    Accept License Agreements

  9. Click Next.

  10. On the Select storage page, select where you want to store the virtual appliance files. The storage options available will depend on the storage that has been configured on your VMware infrastructure.

    OVF Name and Location

  11. Click Next.

  12. On the Select networks page, select the appropriate network from the list which will allow the virtual appliance to talk to the devices it will be managing.

    OVF Select Network

  13. Click Next.

  14. Confirm the deployment settings and click Finish to start the deployment task.

  15. Wait while the virtual appliance is created.

3.3. PxM Virtual Appliance Setup and Configuration

  1. Once the installation has completed, right-click the virtual appliance in the left-hand list and click Open Console.

  2. Within the Open Console window, press ENTER when prompted.

    Press ENTER

  3. Read and accept the EULA to continue.


  4. Within the Configure Networking screen, configure the following virtual appliance settings. Press TAB to navigate between the fields.

    • IP Address: Enter the IP Address which will be used to connect to the virtual appliance.
    • Netmask: Enter the network mask.
    • Gateway: Enter the network default gateway IP address.
    • Primary DNS: Enter the network primary DNS IP address.
    • (Secondary DNS): Enter the secondary DNS IP address if relevant, else leave blank.

    Configure networking

  5. Wait while the system is configured. When prompted, hit ENTER to Continue without restoring a backup.


  6. Your Master Encryption Key will be shown, write it down as it will be needed in the next step.

    Master Encryption Key


    It is important that you remember the Master Encryption Key as it is used to encrypt and store a password which will be used to restore backups and recover device passwords in a breakglass scenario.

  7. TAB down to the OK button and hit ENTER.

  8. Enter the Master Encryption Key written down.

  9. TAB down to the OK button and hit ENTER.

  10. Within the Enter a hostname window, enter a name to identify the virtual appliance.

    Enter a hostname

  11. Set a password for the Primary SuperAdmin account. The username (superadmin) and the password will be used later to login to the PxM Client.

  12. TAB down to the OK button and hit ENTER.

  13. Confirm the Primary SuperAdmin account password.

  14. TAB down to the OK button and hit ENTER.

  15. Once the setup is complete the following message will be displayed in the Osirium Console window. Make a note of the https virtual appliance address.

    Setup complete

  16. Close the VMware vSphere Client window.