Upgrade Instructions
This section provides information about upgrading the Junos Space Network Management Platform installations running versions earlier than Release 21.3R1.
- Supported Upgrade Path
- Upgrade Notes
- Instructions for Validating the Junos Space Network Management Platform OVA Image
Supported Upgrade Path
Table 1 provides information about the supported upgrade path across Junos Space Network Management Platform releases.
Upgrade from Junos Space Release | Upgrade to Junos Space Release | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
Junos Space Release | 18.4 | 19.1 | 19.2 | 19.3 | 19.4 | 20.1 | 20.3 | 21.1 | 21.2 | 21.3 |
18.2 | Yes | |||||||||
18.3 | Yes | Yes | ||||||||
18.4 | Yes | Yes | ||||||||
19.1 | Yes | Yes | ||||||||
19.2 | Yes | Yes | ||||||||
19.3 | Yes | Yes | Yes | |||||||
19.4 | Yes | Yes | ||||||||
20.1 | Yes | |||||||||
20.3 | Yes | |||||||||
21.1 | Yes | Yes | ||||||||
21.2 | Yes |
Related Information
- Upgrading Junos Space Network Management Platform Overview
- Juniper Networks Devices Supported by Junos Space Network Management Platform
- Upgrading Junos Space Network Management Platform
Before you upgrade Junos Space Platform to Release 21.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.
You can upgrade to Junos Space Network Management Platform 21.3R1 from the following earlier release:
- Junos Space Network Management Platform Release 21.1R1 and 21.2R1
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
-
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.3, 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.3R1, all previously installed applications are disabled until the applications are upgraded to a version compatible with Junos Space Platform 21.3R1. You must upgrade the applications to releases that are compatible with Junos Space Platform Release 21.3R1, by using the Junos Space Platform UI. For information about application versions compatible with Junos Space Platform 21.3R1, see Application Compatibility.
Starting from Junos Space Network Management Platform release 21.1R1, ethernet interface order is changed for JA2500.
See Junos Space Ethernet Interfaces Overview for more details.
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.
- 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:
-
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.
-
(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.
-
Navigate to the directory containing the OVA image.
Unpack the OVA image by executing the following command:
tar xf ova-filename
where ova-filename is the filename of the downloaded OVA image.
-
Verify that the unpacked OVA image contains a certificate chain file (
junos-space-certchain.pem
) and a signature file (.cert extension). -
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. 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:
-bash-4.1$ ls JuniperRootRSACA.pem space-16.1R1.3.ova -bash-4.1$ mkdir tmp -bash-4.1$ cd tmp -bash-4.1$ tar xf ../space-16.1R1.3.ova -bash-4.1$ ls junos-space-certchain.pem space-16.1R1.3.cert space-16.1R1.3-disk1.vmdk.gz space-16.1R1.3.mf space-16.1R1.3.ovf -bash-4.1$ ovftool space-16.1R1.3.ovf OVF version: 1.0 VirtualApp: false Name: viso-space-16.1R1.3 Download Size: 1.76 GB Deployment Sizes: Flat disks: 250.00 GB Sparse disks: 4.68 GB Networks: Name: VM Network Description: The VM Network network Virtual Machines: Name: viso-space-16.1R1.3 Operating System: rhel5_64guest Virtual Hardware: Families: vmx-04 Number of CPUs: 4 Cores per socket: 1 Memory: 8.00 GB Disks: Index: 0 Instance ID: 7 Capacity: 250.00 GB Disk Types: SCSI-lsilogic NICs: Adapter Type: E1000 Connection: VM Network Adapter Type: E1000 Connection: VM Network Adapter Type: E1000 Connection: VM Network Adapter Type: E1000 Connection: VM Network -bash-4.1$ openssl verify -CAfile JuniperRootRSACA.pem -untrusted junos-space-certchain.pem space-16.1R1.3.cert space-16.1R1.3.cert: OK -bash-4.1$
-
(Optional) If the validation is not successful, perform the following tasks:
- 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.
- 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.
- Retry the preceding validation steps by using one or both of the new files.