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 Virtual Appliance software release click here PxM Platform Virtual Appliance


A SHA256 checksum is available to verify the download integrity.

3.2. Deploying the virtual appliance

  1. Within your existing VMware infrastructure, right-click an inventory object, and select Deploy OVF Template.

    The Deploy OVF Template wizard opens.

  2. On the Select an OVF template page, specify the location of the download OVA template and click Next.

    Deploy OVF Template

  3. On the Select a name and folder page, enter the unique name the virtual appliance will be identified, select a deployment location, and click Next.

    Select a name and folder

  4. Click Next.

  5. On the Select a compute resource page, select a resource on which to run the deployed virtual appliance template, and click Next

  6. On the Review details page, verify the OVF template details details and click Next.

    Review Details

  7. On the License agreements page, read the Osirium end-user license agreement. Accept and click Next.

    License Agreements

  8. On the Select storage page, define where and how to store the virtual appliance files that will be deployed through the OVA template, and click Next.

    Storage location

  9. On the Select networks page, select a source network and map it to a destination, click Next.

  10. On the Ready to complete page, review the settings selected and click Finish. Wait while the new virtual appliance is created on the selected resource.

3.3. PxM Virtual Appliance Setup and Configuration

  1. On the new virtual appliance open the console window of the PxM Virtual Appliance.

  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. Within the Enter a hostname window, enter a name to identify the new PxM Virtual Appliance.

    Enter a hostname

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

  8. Set a password for the new primary superadmin account. The username (superadmin) and the password will be used later to login to the PxM Client.

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

  10. Confirm the new primary superadmin account password.

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

  12. Your Master Encryption Key will be shown.

    Master Encryption Key

    Type Description
    Master encryption key

    This key is VERY IMPORTANT make a note of it and securely store it externally for future reference as it is not stored within the PxM Platform.

    It will be required during a backup/restore procedure to recreate the hash file and decrypt the PxM Platform database stored within the backup file.

    See PxM Virtual Appliance backup and restore guide.


    During the installation process the master encryption key is combined with the Salt to generate a hash which is stored in a file.

    The Salt is stored on the PxM Virtual Appliance and will be included in the backup file.


    Is generated during the installation process and stored on the PxM Virtual Appliance. The hash file will not be included in the backup file.

    During a backup/restore procedure the master encryption key will be used with the salt to recreate the hash and decrypt the backup database file to reinstate the PxM Virtual Appliance.

  13. Enter the Master Encryption Key including the dashes to verify.

  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.