Configuration of a standalone PxM Virtual Appliance or leader node

Follow these configuration steps if you are either setting up a standalone PxM Virtual Appliance or this is the first node in the cluster you are configuring.

  1. Open the console window of the new PxM Virtual Appliance.

  2. Within the Console window, press ENTER when prompted to start the setup and configuration.

    Enter setup

  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. Once completed TAB down to the OK button and press ENTER.

  6. Creating a new PxM Virtual Appliance so press ENTER to Continue without restoring a backup.

    Continue without restoring a backup

  7. Within the Enter a hostname window, enter a name to identify the new PxM Virtual Appliance.

    hostname

  8. TAB down to the OK button and press ENTER.

  9. Enter the FQDN or IP Address which will be assigned to the node. The configuration entered here is used to communicate between nodes.

    FQDN or IP Address

    If the following error occurs then make sure that the hostname can be resolved and check if it has been included in the DNS A records - see Prerequisites.

    Hostname resolution error

  10. TAB down to the OK button and press ENTER.

  11. Set a password for the primary superadmin account. The username (superadmin) and the password will be used later to log into the PxM UI or PxM Client. The superadmin password set here will also be used to log into all the other nodes in the cluster so there will only be one main superadmin password for all the nodes.

    superadmin password

  12. TAB down to the OK button and press TAB.

  13. Confirm the primary superadmin account password.

  14. TAB down to the OK button and press TAB. Wait while the system is configured.

  15. As this is the first node (leader) in the cluster ENTER to Continue without joining cluster.

    Continue without joining cluster

  16. Your Master Encryption Key will be shown. MEK

    Type Description
    Master encryption key This key is VERY IMPORTANT so you MUST 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.
    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.
  17. Enter the Master Encryption Key including the dashes to verify.

  18. TAB down to the OK button and press ENTER. Wait while the system is configured.

  19. Once the setup has completed the following message will be displayed on the Console window.

    Make a note of the https address which will be required to connect to the PxM Virtual Appliance from the PxM UI. For instructions to install and configure the PxM UI click here. Console window

  20. Now the PxM Virtual Appliance has been successfully deployed and configured you will need to run through the Finalise setup steps to complete the installation.