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 Osirium PxM Virtual Appliance OVA.

    Note

    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 downloaded virtual appliance OVA file.

    Deploy OVF Template

  3. Click Next.

  4. Within the Select a name and folder window, select where to run the deployed template.

    Select a name and folder

  5. Click Next.

  6. Within the Select a compute resource window, select a destination resource.

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

    Review Details

  8. Click Next.

  9. Within the License agreements window, read the Osirium end-user license agreement and accept to continue with the installation.

    License Agreements

  10. Click Next.

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

    Storage location

  12. Click Next.

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

    Select Network

  14. Click Next.

  15. Confirm the deployment settings and click Finish to start the deployment task. Wait while the virtual appliance is created.

3.3. PxM Virtual Appliance Setup and Configuration

  1. Once the installation has completed, 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.

    EULA

  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.

    Restore

  6. Within the Enter a hostname window, enter a name to identify the

    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 so make sure it is securely stored externally for future reference as it is not stored within 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.

    Salt

    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.

    Hash

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