Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

Upgrade Paragon Automation

You can upgrade your current release version of Paragon Automation to a subsequent release version using Paragon Shell. The upgrade functionality enables you to upgrade your Paragon Automation installation and all the applications running on it. The upgrade process is automated and carries out the required pre-upgrade system checks, retrieves the upgrade package, and executes the upgrade process on the cluster nodes.

The upgrade process is automated by a set of Paragon Shell commands. You can upgrade using an upgrade file that is either downloaded locally on your primary node or accessed directly from a Web page.

During an upgrade its important that no change activities including onboarding of devices, provisioning of services or changing other configuration are done in the system. The upgrade will automatically reboot all components and there will be a short unavailability during that time. The upgrade process does not affect the traffic through the network and once the upgrade is complete, the devices and services are not reconfigured.

We recommend that you back up your configuration before upgrading. For information on backing up your current configuration, see Back Up and Restore Paragon Automation.

Prerequisites to the Upgrade Process

Before you upgrade the Paragon Automation cluster, ensure the following.

  • Paragon Shell is accessible and operational.

  • The cluster nodes have the following free disk space available:

    • The primary node from which the cluster was deployed must have 15% of the total disk space + three times the upgrade file size free.

    • The other two primary and worker nodes must have 15% of the total disk space + the same amount as the upgrade file size free.

    • The worker node must have 15% of the total disk space free.

Upgrade Paragon Automation using one of the following options.

Upgrade using the local Option

Use this option for air-gapped environments where your paragon Automation installation does not have access to the Internet. However, you need to be able to copy the upgrade_paragon-release-build-id.tgz and upgrade_paragon-release-build-id.tgz.psig files to your primary node.

  1. Log in as root user to the primary node from which the current cluster was installed. You are logged in to Paragon Shell.

  2. Type exit to exit from Paragon Shell to the Linux root shell.

  3. Copy the upgrade_paragon-release-build-id.tgz and upgrade_paragon-release-build-id.tgz.psig files, of the version to which you want to upgrade, to the /root/epic/temp folder.

    You might need to download the upgrade_paragon-release-build-id.tgz and upgrade_paragon-release-build-id.tgz.psig files from the Juniper Software Download site to your local computer before copying it to the primary node.

  4. (Optional) Use the gpg --verify command to validate the digital signature of the upgrade file. For example:

    Validation takes a couple of minutes to complete.

  5. Type cli to enter Paragon Shell.

  6. Use the following command to upgrade Paragon Automation.

    request paragon cluster upgrade local filename upgrade_paragon-release-build-id.tgz

    For example:

Upgrade using the url Option

Use this option if your Paragon Automation installation has access to the Internet.

  1. Log in as root user to the primary node from which the current cluster was installed. You are logged in to Paragon Shell.

  2. Use the following command to upgrade Paragon Automation.

    request paragon cluster upgrade url "https://juniper.software.download.site/upgrade_paragon-release-build-id.tgz?query_string"

    For example:

See Also