Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Upgrade Instructions

 

This section provides information about upgrading the Junos Space Network Management Platform installations running versions earlier than Release 18.3R1.

Supported Upgrade Path

You can upgrade Junos Space Network Management Platform installations running Release 18.1R1 and 18.2R1 to Junos Space Network Management Platform Release 18.3R1.

Junos Space Platform upgrade from Release 18.1 or Release 18.2 to 18.3 follows the standard upgrade procedure. For information about the upgrade procedure from Junos Space Platform Release 18.1 or 18.2 to Junos Space Platform Release 18.3, see Upgrading Junos Space Network Management Platform Overview and Upgrading Junos Space Network Management Platform.

Note

Some Junos Space applications may not support a direct upgrade of Junos Space Platform from Release 16.1R1, Release 16.1R2, or Release 16.1R3 to Release 17.2R1; upgrading to Junos Space Platform Release 17.1R1 may be required before upgrading to Release 17.2R1 for some upgrade scenarios. Therefore, review the release notes for all installed Junos Space applications prior to upgrading Junos Space Platform.

Before you upgrade Junos Space Platform to Release 18.3, ensure that the time on all Junos Space nodes is synchronized. For information about synchronizing time on Junos Space nodes, see Synchronizing Time Across Junos Space Nodes.

If the Junos Space Platform installation is running a version earlier than Release 16.1, you must first upgrade the installation to Release 16.1R3, and then upgrade from Release 16.1R3 to Release 17.2R1. Upgrade from Release 17.2R1 to Release 18.1 or 18.2, and then upgrade to Release 18.3R1. To upgrade from Junos Space Platform Release 15.2R2 to Junos Space Platform Release 16.1R3, you must follow the procedure outlined in Upgrading to Junos Space Network Management Platform Release 16.1R1.

Caution

During the Junos Space Network Management Platform upgrade process, do not modify the filename of the software image that you download from the Juniper Networks support site. If you modify the filename, the upgrade fails.

Instructions for Validating the Junos Space Network Management Platform OVA Image

From Junos Space Network Management Platform Release 14.1R1 onward, the Junos Space Platform open virtual appliance (OVA) image is securely signed.

Note
  • Validating the OVA image is optional; you can install or upgrade Junos Space Network Management Platform without validating the OVA image.

  • Before you validate the OVA image, ensure that the PC on which you are performing the validation has the following utilities available: tar, openssl, and ovftool (VMWare Open Virtualization Format [OVF] Tool). You can download VMWare OVF Tool from the following location: https://my.vmware.com/web/vmware/details? productId=353&downloadGroup=OVFTOOL351.

To validate the Junos Space Network Management Platform OVA image:

  1. Download the Junos Space Platform OVA image and the Juniper Networks Root CA certificate chain file (JuniperRootRSACA.pem) from the Junos Space Network Management Platform - Download Software page at https://www.juniper.net/support/downloads/space.html.Note

    You need to download the Juniper Networks Root CA certificate chain file only once; you can use the same file to validate OVA images for future releases of Junos Space Network Management Platform.

  2. (Optional) If you downloaded the OVA image and the Root CA certificate chain file to a PC running Windows, copy the two files to a temporary directory on a PC running Linux or Unix. You can also copy the OVA image and the Root CA certificate chain file to a temporary directory (/var/tmp or /tmp) on a Junos Space node.Note

    Ensure that the OVA image file and the Juniper Networks Root CA certificate chain file are not modified during the validation procedure. You can do this by providing write access to these files only to the user performing the validation procedure. This is especially important if you use a generally accessible temporary directory, such as /tmp or /var/tmp, because such directories can be accessed by several users.

  3. Navigate to the directory containing the OVA image.
  4. Unpack the OVA image by executing the following command:

    tar xf ova-filename

    where ova-filename is the filename of the downloaded OVA image.

  5. Verify that the unpacked OVA image contains a certificate chain file (junos-space-certchain.pem) and a signature file (.cert extension).
  6. Validate the signature in the unpacked OVF file (extension .ovf) by executing the following command:

    ovftool ovf-filename

    where ovf-filename is the filename of the unpacked OVF file.

  7. Validate the signing certificate with the Juniper Networks Root CA certificate chain file by executing the following command:

    openssl verify -CAfile JuniperRootRSACA.pem -untrusted Certificate-Chain-File Signature-file

    where JuniperRootRSACA.pem is the Juniper Networks Root CA certificate chain file, Certificate-Chain-File is the filename of the unpacked certificate chain file (extension .pem), and Signature-file is the filename of the unpacked signature file (extension .cert).

    If the validation is successful, a message indicating that the validation is successful is displayed.

    A sample of the validation procedure is as follows:

  8. (Optional) If the validation is not successful, perform the following tasks:
    1. Determine whether the contents of the OVA image are modified. If the contents are modified, download the OVA image from the Junos Space Network Management Platform - Download Software page.

    2. Determine whether the Juniper Networks Root CA certificate chain file is corrupted or modified. If it is corrupted or modified, download the Root CA certificate chain file from the Junos Space Network Management Platform - Download Software page.

    3. Retry the preceding validation steps by using one or both of the new files.

Upgrade Notes

  • During the upgrade process, do not manually reboot the nodes if the Junos Space user interface does not come up for an extended period of time. Contact the Juniper Networks Support team for help in resolving this issue.

  • Before the upgrade, ensure that the latest backups are available in a location other than the Junos Space server. For more information about backups, see Backing Up the Junos Space Network Management Platform Database.

  • After you upgrade Junos Space Platform to Release 18.3R1, all previously installed applications are disabled until the applications are upgraded to a version compatible with Junos Space Platform 18.3R1. You must upgrade the applications to releases that are compatible with Junos Space Platform Release 18.3R1, by using the Junos Space Platform UI. For information about application versions compatible with Junos Space Platform 18.3R1, see Supported Junos Space Applications and Adapters.