Skip to content

Deploying and install configuration using Microsoft Hyper-V

This section covers.

Deploying the virtual machine

The following steps walk you through deploying the PAM UI Server within a Microsoft Hyper-V infrastructure.


The PAM UI Server must be deployed on a Generation 1 virtual machine.

  1. Download the PAM UI Server ISO file. The latest download can be found here.

  2. Within your existing Hyper-V infrastructure, create a New Virtual Machine. The New Virtual Machine Wizard will be displayed. Click Next >.

    New Virtual Machine Wizard

  3. Enter a name for the virtual machine and click Next >.

    Specify Name and Location

  4. Select Generation 1 and click Next >.


    Do not select Generation 2 as it is not supported.

    Specify Generation

  5. Set the memory to 8192MB and click Next >.

    Assign Memory

  6. Configure the network to connect to and click Next >.

    Configure Networking

  7. Set the virtual hard disk size to 32GB and click Next >.

    Connect Virtual Hard Drive

  8. Set the virtual machine to boot from the downloaded ISO file and click Next >.

    Installation Options


    The ISO file must remain attached to the virtual machine even after the installation has been completed.

    The file contains the system OS, and the PAM UI Server will break if it is detached.

  9. Review the summary and click Finish.

    Summary and Review

  10. By default, the wizard only sets 1 CPU. The virtual machine settings need to be changed to 4 CPUs.

    Configure CPUs

  11. Click OK.

Network Configuration Settings

To setup the network configuration on the PAM UI Server:

  1. Once the PAM UI Server has finished deploying, right-click and select Power On. Wait while the server is booted.


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

  2. Within your Microsoft Hyper-V infrastructure open the Console window of the deployed PAM UI Server.

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

  4. Within the Configure Networking screen, configure the following server settings. Press TAB to navigate between the fields.

    • IP Address: Enter the IP Address which will be used to connect to the PAM UI Server.
    • Netmask: Enter the network mask.
    • Default Gateway: Enter the network default gateway IP address.
    • Domain Name Servers: Enter the network DNS IP address. Enter multiple servers as a comma separated list.
    • Search Domains: Enter the domain to be used as part of a domain search list. Can be left empty.


  5. When completed TAB down to the Save button and press ENTER. The network configuration is saved and you are navigated to a confirmation screen.

  6. When prompted select Save and press ENTER.


  7. You MUST reboot before continuing. At the command prompt type sudo reboot to apply the configuration. Wait while the system is rebooted.

SSH Access Configuration

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 private key is set. The server will generate a unique username for this initial connection which will be deleted once the initial setup has been completed.


Additional keys can be added after setup.

Adding the first SSH public key

  1. Generate an RSA key pair using your preferred method.


    Instructions for generating an RSA key pair using PuTTY can be found here.

  2. Open the Console window of the PAM UI Server.

  3. At the command prompt type sshconf and press ENTER. This will display a one-time username that you will use to setup the SSH key for the support user account.

    SSH username


    The setup-xxxxxxxx username displayed will be unique to each PAM UI Server install.

  4. Open PuTTY or your preferred SSH tool and enter the IP address of the PAM UI Server.

    SSH ip address

  5. Next under Connection -> Data enter the one-time username displayed by 'sshconf' in the Auto-login username field.

    SSH ip address

  6. Next under Connection -> SSH -> Auth -> Credentials, click Browse... and select the private key file (.ppk file) that you created at the start (i.e. pam_ui_support.ppk).

    SSH ip address

  7. Click Open to connect.

  8. As this is the first time you are connecting you will see a fingerprint alert box, accept the fingerprint.

  9. The connection window will now only remain open for a few seconds and then disappear. PuTTY may display an error on disconnect. This is okay and expected.

  10. This connection has now set the SSH key of the 'support' user for the PAM UI Server.

  11. Now to SSH to the PAM UI Server open PuTTY, set the IP address, set the private key file (.ppk file) but now set the auto-login username to be 'support' (without the quotes).

  12. Click Open and you will be connected to the PAM UI Server.

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