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 existing older version of Paragon Automation to a later version of the same release using Paragon Shell. The upgrade functionality enables you to upgrade your Paragon Automation installation and all the applications running on it.

Note:

We do not support upgrading from Paragon Automation Release 2.0.0 to Release 2.1.0.

The upgrade process is automated by a set of Paragon Shell commands and carries out the required pre-upgrade system checks, retrieves the upgrade package, and executes the upgrade process on the cluster nodes. You can upgrade using an upgrade file that is either downloaded locally on your primary node or downloaded directly from a Web page.

During an upgrade, it's important that no change activities including onboarding of devices, provisioning of services or changing other configurations are done in the system. The upgrade will automatically reboot all components and there will be 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.

Note:

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.

To upgrade your Paragon Automation cluster:

  1. Upgrade your installation and all the applications running on it using either the local option or the url option.

  2. Upgrade Paragon Shell and the OVA System Files.

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:

    Here primary1 is the installer primary node. 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:

    Your Paragon Automation installation and all the applications running on it are upgraded.

    You can now upgrade Paragon Shell and the OVA system files. Go to Upgrade Paragon Shell and the OVA System Files.

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:

    Here primary1 is the installer primary node.

    Your Paragon Automation installation and all the applications running on it are upgraded.

    You can now upgrade Paragon Shell and the OVA system files. Go to Upgrade Paragon Shell and the OVA System Files.

Upgrade Paragon Shell and the OVA System Files

When your Paragon Automation installation and all the applications running on it are succesfully upgraded, you must upgrade Paragon Shell and the OVA system files.

  1. Exit from the installer primary node to the Linux root shell by typing exit.

  2. Copy the upgrade_paragon-shell_ova-system.sh shell script and the run script from the upgrade directory to the /root/epic/ directory.

  3. Execute the Paragon Shell upgrade shell script.

    Paragon Shell and the OVA system files are upgraded.

Note that, if you are rerunning upgrade on a node that has already been upgraded, you won't need to copy the upgrade_paragon-shell_ova-system.sh shell script and the run script to the /root/epic/ directory, since the scripts must already be present and updated in the directory. You can directly run the bash /root/epic/upgrade_paragon-shell_ova-system.sh command. When rerunning upgrade, the CLI output is slightly different than when you are upgrading a version for the first time. For example:

Related Documentation