Skip to content

Inline upgrade procedure

This section covers:

Upgrade procedure

The diagram provides a high-level overview of the process for upgrading your PAM Server.

Inline upgrade procedure flowchart

Upgrade procedure


Before starting your upgrade make sure that all prerequisites have been met.

Upgrading the PAM Server

  1. Transfer the downloaded upgrade kit onto the PAM Server using the Osirium Support account username and password enabled and set earlier.

    If you are upgrading a cluster then start with the leader node.

  2. From your virtual environment, open the PAM Server console window.

    Console window

  3. Within the PAM Server Console window, press ALT + F2. The server login prompt appears.


    Alternatively, you could use an SSH connection to the PAM Server.

  4. At the login prompt, type osirium_support and press ENTER.

  5. In the Password prompt, type the password set for the Osirium Support account and press ENTER. The account will be verified and you will be logged onto the PAM Server.

    SSH login

  6. Extract the upgrade kit copied to the server using the following command:

    sudo bash Osirium_PAM_Server_vA.B.C_upgrade.bin

    Where A.B.C is the version you are upgrading to.

  7. Enter the Osirium Support account password when prompted and press ENTER. The upgrade kit will be extracted.

  8. When the extraction completes, type the command specified on the screen and press ENTER. For example:

    sudo /data/kits/0.0.0-0/

  9. When the below screen is displayed press ENTER to start the setup.

    Start setup

  10. The EULA screen will be displayed. Press ENTER once you have read and accepted.

    If you are upgrading a cluster goto step 11.
    If you are installing a standalone virtual appliance goto step 15.

  11. The following message appears:

    Press enter

    This node will now wait for all remaining nodes in the cluster to reach this stage before starting to upgrade the cluster.

    Repeat steps 1 - 10 for all remaining nodes in the cluster. Only continue with the below steps once all nodes in the cluster have reached this stage. Once reached goto step 12.

  12. Once all nodes in the cluster have reached the required stage the cluster co-ordinator will disable replication on all nodes and pause the upgrade process to allow you to take a VM level backup/snapshot of all nodes if you have not already done so.

    Press enter

  13. When ready re-run the installer using the same arguments as in step 8 on all nodes.

    Once the installer has been re-run on all nodes the cluster co-ordinator will manage the process of performing the upgrade one node at a time and it will keep you updated with its progress as to the number of nodes remaining to be upgraded.

    Press enter

  14. Once all nodes have been upgraded the cluster co-ordinator will automatically restart each of the nodes one at a time. Once restarted each node will show the below screen.

    Press enter

    To continue please goto step 19.

  15. The system configures and the following screen appears:

    Continue without restore

  16. Press ENTER to Continue without restoring a backup. The system configures and the following screen appears:

    Continue without joining cluster

  17. Press ENTER to Continue without joining cluster.

  18. Wait while the upgrade completes and PAM Server is rebooted.


  19. Close your virtual environment session.

Upgrading the PAM UI

This step is only required if you have an existing PAM UI Server. The PAM UI must be on the same version as the PAM Server to benefit from all the enhancements..

Upgrading using different supported infrastructures may vary, therefore click on a link below to be navigated to the correct upgrade steps.

Post upgrade tasks

Before opening any device connections that use an Active Directory account, an audit needs to be manually triggered on all provisioned Active Directories. You can do this by right clicking the named Active Directory from the Manage Active Directory page, and select Trigger audit from the menu. This will allow additional fields on the Active Directory account page to be populated.

Once the backup has successfully installed, log onto the PAM Server using the PAM UI.

Before allowing users to connect back onto the PAM Server:

  • Ensure the devices are running successfully.

  • Ensure the devices are still accessible through the PAM UI.

  • Within the Admin Interface, re-enable scheduled Regenerate Account Credentials for all devices tasks.

  • Take a backup of the new PAM Server.