Upgrading Standalone PRA Engine to the Delinea Platform Engine

This feature is currently available only to customers participating in a Public Preview. For details, see Public Preview

This topic describes how to upgrade a standalone PRA engine to the Delinea Platform engine.

Prerequisites

  • The Platform Engine firewall settings introduce additional requirements compared to the existing standalone PRA engines. See Customer Firewall Requirements for more information.

  • Ensure that Linux engine host UUIDs remain the same, even when the host is restarted. See The Engine Shows as "Offline" for more information.

  • Make sure that you have the latest version of the PRA standalone engine installed prior to upgrading. See Update PRA Engines for more information.

Failure to meet these prerequisites may lead to upgrade failures.

Recommended Best Practices

  • Remove Empty PRA Sites:It is important to delete legacy PRA sites with no remaining standalone engines. This ensures that PRA uses the correct engines when connecting to remote machines. This step is particularly important after engine upgrades, as engines are moved from legacy PRA sites to Platform sites.

  • Retain Automatic Site-Selection: To maintain existing automatic site-selection behavior, customers should create and select Platform sites with the same name as the current legacy PRA site during engine upgrades.

Automatically Upgrading PRA Engines to the Delinea Platform Engine

If you would like to upgrade your legacy PRA engine to the Delinea Engine, follow the steps below: 

  1. Inside the Delinea Platform, navigate to Administration > Remote Access.

  2. Click on the Sites and Engines tab.

  3. Click on a (legacy) site to view all of the engines associated with that site.

  4. Find the standalone engine you would like to upgrade and click the three-dot symbol next to the engine.

  5. Click Upgrade.

  6. Select a Platform Engine site to include the upgraded engine and click Next.

    If a Platform engine site with the same name as the deprecated PRA site is found, it will be automatically pre-selected. You also have the option to create a new Platform site.

  7. Verify that the engine upgrade information is correct. If yes, click Automatic Upgrade.

  8. The automatic engine upgrade will begin.

    You have the option to dismiss this window while the standalone engine is being upgraded in the background. You can view the progress of the engine upgrade in the Notifications section:

  9. When the engine upgrade completed successfully, you will see a confirmation message like the one below:

    If the engine upgrade was not successful, click Retry. Alternately, you may also try to manually upgrade the engine as described below.

Manually Upgrading a Standalone PRA Engine to the platform Engine

  1. Click the "More Options" menu next to the engine

  2. Click Upgrade.

  3. Select a Delinea Platform site for the engine and click Next.

    If a matching Delinea Platform site is found, it will be automatically pre-selected. You also have the option to create a new Platform site.

  4. Verify that the engine upgrade information is correct. If yes, click Offline Upgrade.

  5. Follow the instructions in the upgrade engine window.

    When manually upgrading the engine, ensure the server is hosting the same standalone engine that is being upgraded.

Upgrading the Standalone PRA Engine While Working in an Active Session

When upgrading the legacy PRA engine to the Platform Engine, any existing remote sessions being tunneled through the engine, will be disconnected and the engine will not support any new connections for the duration of the upgrade.