Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Manage Cloud-Native Router Software

This topic provides information on the available upgrade, downgrade and uninstall options for JCNR.

Upgrade from Cloud-Native Router Release 23.4 and Earlier

Upgrading to this release from Cloud-Native Router release 23.4 and earlier is not supported. You must uninstall your existing Cloud-Native Router release before you can install this Cloud-Native Router release. We show you how to do this below.

Note:

Starting with Cloud-Native Router release 23.2, the Cloud-Native Router license format has changed. Request a new license key from the JAL portal if your existing Cloud-Native Router release is earlier than release 23.2.

  1. Save your current configuration.
    1. Save the Cloud-Native Router Helm chart values.yaml customizations that you made.
    2. Access the cRPD pods and save the Junos cRPD CLI configuration.
      To see the set of commands used to create the current configuration,
      To save the configuration, use the Junos CLI save command.
  2. Uninstall JCNR.
    See Uninstall JCNR but don't delete the jcnr namespace or the jcnr-secrets.
  3. Download the <sw_package>.tar.gz tarball to the directory of your choice. See Cloud-Native Router Software Download Packages for the available package options.
  4. Expand the downloaded package.
  5. Change directory to the main installation directory.
    If you're installing Cloud-Native Router only, then:This directory contains the Helm chart for Cloud-Native Router only.
    If you're installing Cloud-Native Router and cSRX at the same time, then: This directory contains the combination Helm chart for both Cloud-Native Router and cSRX.
    Note:

    All remaining steps in the installation assume that your current working directory is now either Juniper_Cloud_Native_Router_<release> or Juniper_Cloud_Native_Router_CSRX_<release>.

  6. View the contents in the current directory.
  7. Change to the helmchart directory and expand the Helm chart.
    The Helm chart is located in the jcnr directory.
  8. Modify the Helm chart helmchart/jcnr/values.yaml file to match the Helm chart configuration you saved earlier.
  9. Install the Cloud-Native Router Helm chart.
    Navigate to the helmchart/jcnr directory and run the following command:
  10. Check that the Cloud-Native Router Helm chart is being installed.

    Sample output:

    If the new version of Cloud-Native Router fails to install, troubleshoot the installation as you normally do. Look at the Cloud-Native Router deployer logs and see Troubleshoot Deployment.

  11. Reconfigure cRPD with the saved Junos CLI commands.
    Access the cRPD CLI and use the Junos CLI load command to load the previously saved configuration.

Upgrade from Cloud-Native Router Release 24.2 and Later

  1. Download the <sw_package>.tar.gz tarball to the directory of your choice. See Cloud-Native Router Software Download Packages for the available package options.
  2. Expand the downloaded package.
  3. Change directory to the main installation directory.
    If you're installing Cloud-Native Router only, then:This directory contains the Helm chart for Cloud-Native Router only.
    If you're installing Cloud-Native Router and cSRX at the same time, then: This directory contains the combination Helm chart for both Cloud-Native Router and cSRX.
    Note:

    All remaining steps in the installation assume that your current working directory is now either Juniper_Cloud_Native_Router_<release> or Juniper_Cloud_Native_Router_CSRX_<release>.

  4. View the contents in the current directory.
  5. Change to the helmchart directory and expand the Helm chart.
    The Helm chart is located in the jcnr directory.
  6. Modify the Helm chart helmchart/jcnr/values.yaml file to match the Helm chart configuration in your current installation.
  7. Upgrade JCNR.
    Navigate to the helmchart/jcnr directory and run the following command:
  8. Check that the Cloud-Native Router Helm chart is being installed.

    Sample output:

    If the new version of Cloud-Native Router fails to install, troubleshoot the installation as you normally do. Look at the Cloud-Native Router deployer logs and see Troubleshoot Deployment.

Downgrade/Rollback JCNR

To downgrade or roll back from the current version to an older or previous version, uninstall the current version and install the older or previous version.

Uninstall JCNR

Uninstalling Cloud-Native Router restores interfaces to their original state by unbinding from DPDK and binding back to the original driver. It also deletes contents of Cloud-Native Router directories, deletes cRPD created interfaces and removes any Kubernetes objects created for JCNR. (See the restoreInterfaces attribute in the Helm chart.)

Note:

Uninstalling Cloud-Native Router using Helm does not delete the jcnr namespace or the jcnr-secrets. Delete these manually if needed.

  1. Uninstall JCNR.
  2. Wait for all Cloud-Native Router resources to be fully deleted before attempting reinstallation.
    Premature re-installation can lead to installation issues and may require manual steps for recovery. If this occurs, use one or more of the following commands to clean up the uninstallation: