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.

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

    Warning

    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

  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.

    Warning

    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.

    netconf

  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.

    netconf_confirm

  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.

Note

Additional keys can be added after setup.

Adding the first SSH public key

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

    Note

    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

    Note

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

  4. Open your preferred SSH tool and enter the following:

    • Enter IP address of the PAM UI Server.
    • Enter the setup-xxxxxxxx username as displayed in the Console window as the login username.
    • Select the private key file (.ppk file) for authentication.

  5. Click Open.

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

  7. The connection window will only remain open for a few seconds and then disappear. You may see an error on disconnect. This is okay and expected.

  8. This connection has now set the SSH key of the support user for your PAM UI Server. All future SSH connections to the PAM UI Server should be made using the support username and the private key file.

  9. To test, open your preferred SSH tool and enter the following:

    • IP address of the PAM UI Server.
    • Enter support as the login username.
    • Select the private key file (.ppk file) for authentication.

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

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