Upgrading Junos Space Network Management Platform
Junos Space Network Management Platform provides the running environment for all Junos Space applications, so upgrading causes operation interruption. The Upgrade Network Management Platform action allows the administrator to upgrade the Junos Space Platform independently from one version to another without installing other Junos Space applications.
If you are upgrading to Junos Space Platform Release 16.1R1, you must follow the procedure outlined in Upgrading to Junos Space Network Management Platform Release 16.1R1.
If you are upgrading to Junos Space Platform Release 21.1R1, you must follow the procedure outlined in Upgrading to Junos Space Network Management Platform Release 21.1R1
Refer to the Upgrade Instructions section in the Junos Space Network Management Platform Release Notes for a specific release to find out the versions of Junos Space Platform that are supported for upgrade.
Before you upgrade Junos Space Platform to Release 17.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.
To upgrade Junos Space Network Management Platform:
- Ensure that the Junos Space Platform Upgrade image to
which you want to upgrade is downloaded to the local client file system
from the https://www.juniper.net/support/products/space/#sw website.
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.
- Select Administration > Applications.
The Applications page appears.
- Right-click the Network Management Platform entry in the table and select Upgrade Platform. (Alternatively,
select the Network Management Platform entry from the table
and from the Actions menu, select Upgrade Platform.)
The Upgrade Platform page appears displaying all previously uploaded versions of the Junos Space Platform image.
- Do one of the following:
If the release to which you want to upgrade is listed on the Upgrade Platform page, select the file, and click Upgrade.
The application upgrade process begins. (Go to step 8.)
If the release to which you want to upgrade is not listed on the Upgrade Platform page, you must upload the image file into Junos Space Platform. You can upload an image by using HTTP or Secure Copy Protocol (SCP):
To upload an image by using HTTP:
- Click Upload via HTTP.
The Software File dialog box appears.
- Type the name of the Junos Space Platform image file or click Browse to navigate to where the new Junos Space Platform image file is located on the local file system.
- Click Upload.
However, if the following error message appears, we recommend that you try uploading the image by using the Upload via SCP option: File size is too big, use scp to upload this file.
- Click Upload via HTTP.
To upload an image by using SCP:
- Click Upload via SCP.
The Upload Software via SCP dialog box appears. You must add the following Secure Copy remote machine credentials.
- In the Username field, enter the username to be used to log in to the SCP server.
- In the Password field, enter the password to be used for access to the SCP server.
- In the Confirm Password field, reenter the password entered in the preceding step.
- In the Machine IP field, enter the IP address
of the SCP server.
Depending on whether the Junos Space fabric is configured with only IPv4 addresses or both IPv4 and IPv6 addresses, Junos Space Platform allows you to enter an IPv4 address or either an IPv4 or IPv6 address respectively for the SCP server.
The IPv4 and IPv6 addresses that you use must be valid addresses. Refer to http://www.iana.org/assignments/ipv4-address-space for the list of restricted IPv4 addresses and http://www.iana.org/assignments/ipv6-address-space for the list of restricted IPv6 addresses.
- In the Software File Path field, enter the full path of the Junos Space Platform image file on the SCP server.
- Click Upload.
- Click Upload via SCP.
The new Junos Space Platform image file is uploaded into the Junos Space server and displayed by application name, filename, version, release type, and required Junos Space Platform version.
When the upload is completed, the Upgrade Platform Job Information dialog box appears.
- In the Upgrade Platform Job Information dialog box, click
the Job ID hyperlink.
You are taken to the Jobs Management page, where you can view the Upgrade Platform job that was triggered.
Ensure that the job is successful.
- Select Administration > Applications to continue with the upgrade process.
The Applications page appears.
- Select the Network Management Platform entry
from the table and from the Actions menu (or right-click menu) select Upgrade Platform.
The Upgrade Platform page appears displaying the Junos Space Platform image that you uploaded.
- Select the image file
to which you want to upgrade, and click Upgrade Platform.
If you have previously installed other Junos Space applications and if some applications are incompatible with the version of Junos Space Platform to which you are upgrading, an upgrade warning message appears informing you about the list of applications that might be disabled after the upgrade:
- Make a note of these applications and upgrade them after the Junos Space Platform upgrade is completed successfully.
- Click OK to close the dialog box.
Another upgrade warning message appears asking you whether you want the system to back up the database before the platform upgrade. Click YES or NO depending on whether you want the system to back up the Junos Space Platform database before the upgrade.
Backing up the database before the upgrade helps you to recover the data if the platform upgrade fails. However, the upgrade process might be prolonged depending on the database size.
When you choose to back up the database before the upgrade, you are directed to the “Database Backup and Restore” workspace. Follow the instructions specified in Backing Up the Junos Space Network Management Platform Database to back up the database.
After backing up the database, select Administration > Applications > Network Management Platform > Upgrade Platform > Upgrade action to upgrade Junos Space Platform. When prompted for the second time, whether you want the system to back up the database, click NO to proceed with the upgrade.
Junos Space Platform goes into maintenance mode and prompts you to enter a username and password to enter maintenance mode and proceed with the upgrade.
- In the Username field, enter the username (maintenance).
- In the Password field, enter the maintenance
The maintenance mode password is one that the administrator created during the initial configuration process.
- Click OK.
The Junos Space Platform upgrade process begins. The Software Install Status dialog box appears and displays status messages using which you can monitor the upgrade status. The Upgrade Status Summary field in the Software Install Status dialog box displays additional information about the upgrade status. In addition, if any error occurs during the upgrade, information about the error or warning that led to the upgrade failure and the location of the log files for troubleshooting is displayed.
This process might take a while. Wait until the Go to Maintenance Menu link appears.
- Click the Go to Maintenance Menu hyperlink.
The Maintenance Mode Options dialog box appears.
- Click Reboot Junos Space.
The installation progress dialog box appears and displays the deployment status of JBoss and various other applications as the system goes through a restart after the upgrade.
This process might take a while. Do not reboot the system for a quick recovery. This action leaves the system in a bad state and affects the upgrade operation. Wait until the login window is presented for you to log in.
During startup, the startup page first displays a message indicating that Junos Space Platform is starting up and then displays a progress bar indicating the percentage of startup completed, the estimated time left for the Junos Space Platform to start, and a list of tasks to complete (with an indication of the current task being carried out). When a task is successfully completed, a message is displayed; if a task fails, an error message is displayed indicating why the task failed.
From Junos Space Network Management Platform Release 15.1R1 onward, a reboot message is broadcast to all the fabric nodes at the same time. All nodes reboot at the same time but the VIP node is the last to finish rebooting. The reboot procedure is significantly quicker than for previous Junos Space Platform releases.
When the upgrade is completed, the Junos Space login prompt appears.
If a blank page appears instead of the login prompt, click Refresh. The login prompt is then displayed.
We recommend that you clear the Web browser cache before logging in to the upgraded software.
We recommend that you perform a functional audit on all deployed services after upgrading.
You can now log in to the upgraded Junos Space Platform software.
When you log into Junos Space Platform after the upgrade, an information dialog box with the following message is displayed: Platform/Application is upgraded, please clear your browser cache and login again.
Click OK to close the information dialog box.
For any troubleshooting, see the following logs:
/var/log/install.log—This file captures information about the Junos Space Platform upgrade and the installation of applications.
/var/log/jboss/servers/server1/server.log—This file captures information about JBoss.