Skip to content

Deploying and install configuration using VMware vSphere

This section covers.

Deploying

The following steps walk you through deploying the PAM UI Server within a VMware vSphere infrastructure.

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

    Actions menu

  2. The Deploy OVF Template wizard opens. On the Select an OVF template page, specify the location of the OVA template and click Next.

    Select OVA template

  3. On the Select a name and folder page, enter the unique name the PAM UI Server will be identified by, select a deployment location and click Next.

  4. On the Select a compute resource page, select a resource on which to run the deployed PAM UI Server template and click Next.

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

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

  7. On the Select storage page, define where and how to store the PAM UI Server files that will be deployed through the OVA template and click Next.

  8. On the Select networks page, select a network the PAM UI will connect to and click Next.

  9. On the Ready to complete page, review the settings selected and click Finish. Wait while the new PAM UI Server is created on the selected resource.

Power on the PAM UI Server

Initially the PAM UI Server will be in a powered off state by default. Once the PAM UI Server has finished deploying, right-click and select Power On.

Power on

First time boot

The PAM UI Server will boot and first show a splash screen followed by a loader screen while the system is being booted.

PAM UI splash screen PAM UI loader screen

Warning

DO NOT turn off the PAM UI Server during the boot stage as this may cause the machine to become corrupted.

When the console becomes available, the machine is fully booted and online.

PAM UI getty first start

Network Configuration

To set the network configuration of the PAM UI Server:

  1. Within VMware vSphere open the Console window of the deployed PAM UI Server.

  2. At the command type sudo netconf and press ENTER.

  3. Within the Configure Static Networking window enter the network configuration to be assigned to the PAM UI Server. Press TAB to navigate between the fields.
    netconf

  4. When completed TAB down to the Save button and press ENTER. The network configuration is saved and you are navigated back to the command prompt.

  5. At the command prompt type sudo reboot to apply the configuration. Wait while the system is rebooted.

    Hint

    You might want to wait to reboot the system until the next configuration step is done.

Configure SSH Access

SSH access configuration is required to allow administrators to SSH onto the PAM UI Server.

When the first SSH connection is made to the PAM UI Server a master key will be set. The server will generate a unique username for this initial connection which will be deleted once the initial setup has been completed.

Note

Additional keys can be added after setup.

Prerequisites

The following are required before you start the SSH access configuration:

  • PowerShell client.

  • SSH private key.

If you don't have an SSH private key then one can be generated as follows:

  1. Open the powershell client.

  2. At the command prompt type ssh-keygen -t rsa and press ENTER.
    Generate ssh private key

  3. You will be asked to enter a file in which to save the key, press ENTER to accept the default.

  4. You will be asked to enter a passphrase, this can be left blank, press ENTER and again to confirm. Your public key will be saved.

Adding the first SSH public key

  1. Open the console window of the PAM UI Server.
    SSH Initial Screen

    Note

    Make sure that the text in the box matches your screen.

  2. At the command prompt type:

    sshconf

  3. Follow the instructions displayed on the screen.
    SSH username

  4. On your workstation open up a PowerShell client.

  5. Within the PowerShell client window type the highlighted command in the picture above (your command will differ from the example).

    In the above example it would be:

    ssh setup-HwyrHRn@10.0.2.15

  6. On connecting, the PAM UI Server will report that your public key has been added:
    SSH connection

    The PAM UI Server will add your public key to /var/disk/config/authorized_keys. Append public keys to this file to allow additional administrators access.

Note

Future SSH connections should be made using the support username.

You are now ready to configure your PAM UI Server. See System configuration of the PAM UI.