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 21.2R1.

Supported Upgrade Path

Table 1 provides information about the supported upgrade path across Junos Space Network Management Platform releases.

Table 1: Supported Upgrade Path
Upgrade from Junos Space Release Upgrade to Junos Space Release
Junos Space Release Release 16.1 Release 16.2 Release 17.1 Release 17.2 Release 18.1 Release 18.2 Release 18.3 Release 18.4 Release 19.1 Release 19.2 Release 19.3 Release 19.4 Release 20.1 Release 20.3 Release 21.1 Release 21.2
Release 16.1   Yes Yes                          
Release 16.2     Yes Yes                        
Release 17.1       Yes Yes                      
Release 17.2         Yes Yes                    
Release 18.1           Yes Yes                  
Release 18.2             Yes Yes                
Release 18.3               Yes Yes              
Release 18.4                 Yes Yes            
Release 19.1                   Yes Yes          
Release 19.2                     Yes Yes        
Release 19.3                       Yes Yes Yes    
Release 19.4                         Yes Yes    
Release 20.1                           Yes    
Release 20.3                             Yes  
Release 21.1                               Yes

Related Information

Note:

Before you upgrade Junos Space Platform to Release 21.2, 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.

You can upgrade to Junos Space Network Management Platform 21.2R1 from the following earlier release:

  • Junos Space Network Management Platform Release 21.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.

Upgrade Notes

CAUTION:

It is mandatory to install Junos Space Network Management Platform 21.1 Hotpatch-V2 before upgrading to Junos Space Network Management Platform 21.2R1. If the Junos Space Network Management Platform 21.1 Hotpatch-V2 is not installed, the upgrade will fail.

  • 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.

  • To upgrade to Junos Space Network Management Platform Release 21.2, follow the procedure mentioned in Upgrading Junos Space Network Management Platform.
  • 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.
  • After you upgrade Junos Space Platform to Release 21.2R1, all previously installed applications are disabled until the applications are upgraded to a version compatible with Junos Space Platform 21.2R1. You must upgrade the applications to releases that are compatible with Junos Space Platform Release 21.2R1, by using the Junos Space Platform UI. For information about application versions compatible with Junos Space Platform 21.2R1, see Application Compatibility.

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/downloads/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.