You are here: Installation > Installing the Management Node > Running the installation wizard

Running the Pexip Infinity installation wizard

To run the installation wizard, which configures the Management Node, you must open a console window on the Management Node VM.

Opening a console window

Open the console window using the appropriate method for your hypervisor.

Opening a console window in vSphere

  1. Using either the vSphere desktop or web client, log in to the Management Node's VM Manager (vCenter Server or, for stand-alone deployments, the ESXi host).
  2. Power on the new Management Node VM (if it is not already powered on).
  3. Right-click on the new Management Node VM and select Open Console.

Opening a console window in Hyper‑V

  1. Log in to Hyper‑V.
  2. Start the new Management Node VM (if it is not already running).
  3. Right-click on the new Management Node VM and select Connect....

Opening a console window in KVM or Xen

  1. Connect to Virtual Machine Manager (virt-manager) that is managing the Management Node's VM.
  2. Ensure that the Management Node VM is Running.
  3. Select the new Management Node VM and then, from the toolbar, select the Show the virtual machine console and details icon .

    A new window for that VM is opened.

  4. If necessary, select View > Console to display the console.

Running the installation wizard

When you have opened a console window on the Management Node VM, the following prompt will appear:
pexipmcumgr login:

To run the installation wizard:

  1. At the prompt, enter the username admin.

    The display will read:

    You are required to change your password immediately (root enforced)
    Enter new UNIX password:

  2. Create a password for the Management Node operating system by typing the password, pressing enter, retyping the password, and pressing enter again.
  3. Ensure you record the password in a secure location. After you have finished running the installation wizard you will not need the password again unless you need to access the Management Node using SSH.

    You will be presented with another login prompt:

    Running Pexip installation wizard...
    [sudo] password for admin:

  4. Log in again with the password you just created.

    The Pexip installation wizard will begin.

    You can re-run the installation wizard manually at any point - see Re-running the installation wizard.

  5. Follow the prompts to set the following configuration for the Management Node.

    If you press enter, the default value will be applied:

    Setting Default value Multiple entries allowed? Can be changed via Pexip Infinity Administrator interface?
    IP address 192.168.0.100 * No No ‡
    Network mask 255.255.255.0 * No No ‡
    Gateway 192.168.0.1 * No No ‡
    Hostname <no default> No No ‡
    Domain suffix <no default> No No ‡
    DNS server 8.8.8.8 Yes, if separated by a space Yes
    NTP server †

    Two of the following:

    • 0.pexip.pool.ntp.org
    • 1.pexip.pool.ntp.org
    • 2.pexip.pool.ntp.org
    • 3.pexip.pool.ntp.org
    Yes, if separated by a space Yes
    Web administration username admin No No ‡
    Web administration password <no default> No Yes
    Enable incident reporting (yes/no) <no default>   Yes
    Send deployment and usage statistics to Pexip (yes/no) <no default>   Yes

    * These defaults apply only if your network does not have DHCP enabled. If DHCP is enabled, the defaults will be those allocated by the DHCP server. The addresses you enter using this wizard will be assigned as static IP addresses.

    † The NTP server must be accessible by the Management Node at the time the startup wizard is run. Installation will fail if the Management Node is unable to synchronize its time with an NTP server.

    ‡ After they have been configured, do not attempt to change these settings by any other means. To change these settings, you must re-run the installation wizard.

    The installation will begin and the Management Node will restart using the values you have configured.

    When the Management Node has restarted the console will display a login prompt:
    <hostname> login:

    At this point you can close the console. All further configuration should now be done Using the Pexip Infinity Administrator interface (if you encounter SSL connection errors when using the Administrator interface, wait a few seconds to allow the relevant services to start before trying again).

Re-running the installation wizard

If you enter the wrong information during initial configuration using the installation wizard, or if you exit the wizard before completing all the steps, you can re-run it. However, this will overwrite any existing Management Node configuration and lose all connections to existing Conferencing Nodes. Therefore, if you re-run the installation wizard after deploying any Conferencing Nodes, you must delete any existing Conferencing Nodes and then redeploy them from the updated Management Node.

If you re-run the installation wizard to only reset the Pexip Infinity Administrator interface password then you will not lose your configuration data and you will not need to delete and redeploy your Conferencing Nodes, providing you re-enter exactly the same hostname/addressing information as before. However, after completing the wizard you must then edit every system location (Platform configuration > Locations) and reselect the DNS and NTP servers for that location.

If you want to change the IP address of the Management Node you must first return your licenses from your current Management Node. If you do not return your licenses before re-running the installation wizard you will lose your licenses from your new Management Node (with the new IP address) and you will not be able to add them back to that new Management Node. See Moving a license (e.g. when redeploying a Management Node) for instructions on how to do this.

To re-run the installation wizard:

  1. Open a console window on the Management Node VM.

    If your Management Node is deployed on AWS, use an SSH client to access the Management Node, supplying your private key file as appropriate.

  2. At the login prompt, enter the password created in step 2 of Running the installation wizard. If you did not get as far as creating a new password, you will be asked to create one now.
  3. Type installwizard.

    The Pexip installation wizard will begin.