Installing and Upgrading Junos Space Software Overview
The following sections describe the primary software administration tasks for the Junos Space Network Management Platform and Junos Space applications:
Do not modify the filename of the software image that you download from the Juniper Networks support site. If you modify the filename, the installation or upgrade fails.
Juniper Networks devices require a license to activate the feature. To understand more about Junos Space Network Management Platform Licenses, see, Licenses for Network Management. Please refer to the Licensing Guide for general information about License Management. Please refer to the product Data Sheets for further details, or contact your Juniper Account Team or Juniper Partner.
Installing Junos Space Applications
Before installing an application, verify that the application is compatible with the Junos Space Network Management Platform. For more information about application compatibility, see the Knowledge Base article KB27572 at https://kb.juniper.net/InfoCenter/index?page=content&id=KB27572.
You can upload an application image file to Junos Space from the Add Application page ( Administration > Applications > Add Application). You can upload an application image file by using HTTP (Upload via HTTP) option or Secure Copy Protocol (SCP) (Upload via SCP) option. We recommend that you upload the file by using SCP, which initiates a direct transfer from an SCP server to Junos Space and is performed as a back-end job. If you choose to upload the file using SCP, you must first make the image file available on an SCP server that Junos Space can access. You must also provide the IP address of the SCP server and the login credentials needed to access this SCP server. The main advantage of using SCP is that your user interface is not blocked while the file transfer is in progress, and you can monitor the progress of the file transfer from the Jobs workspace.
A Junos Space node can also be used as an SCP server. To do this, copy the application image file (using SCP or SSH FTP [SFTP]) to the /tmp/ directory on the Junos Space node, and in the Upload Software via SCP dialog box specify the credentials (username and password), the IP address of the Junos Space node, the CLI credentials, and the file path for the software image.
After the image file for the application is uploaded successfully, you can view the application from the Add Application page. You can then select the application file and click the Install button to install the application. The application installation process does not cause any downtime for the Junos Space Network Management Platform or any applications installed on Junos Space. Junos Space Network Management Platform ensures that the application is installed on all nodes in the Junos Space fabric and access to the application is load balanced across all nodes in the Junos Space fabric.
For more information about installing Junos Space applications, see the Managing Junos Space Applications Overview topic (in the Junos Space Network Management Platform Workspaces User Guide).
Upgrading Junos Space Applications
You can easily upgrade a Junos Space application from the Junos Space Platform UI. You must download the image file for the new version of the application, navigate to the Applications page ( Administration > Applications), right-click the application that you want to upgrade, and select Upgrade Application to upload the image file into Junos Space through HTTP or SCP. We recommend that you use the SCP option, which initiates a direct transfer from an SCP server to Junos Space. After the image file is uploaded, select the uploaded file and click the Upgrade button to start the upgrade process. If you perform the upgrade by using SCP, then the upgrade process is executed as a back-end job by the Junos Space Network Management Platform, and you can monitor the progress of the upgrade from the Jobs workspace. An application upgrade does not cause downtime for the Junos Space Network Management Platform or other applications that are hosted by Junos Space.
For more information about upgrading Junos Space applications, see the Managing Junos Space Applications Overview topic (in the Junos Space Network Management Platform Workspaces User Guide).
Upgrading Junos Space Network Management Platform
Juniper Networks typically produces two major releases of the Junos Space Network Management Platform per year. In addition, one or more patch releases might accompany each major release. You can upgrade to a newer Junos Space Platform release by performing a few simple steps from the user interface in your current Junos Space Platform.
If you are upgrading to Junos Space Platform Release 16.1R1 or 16.1R2, follow the procedure outlined in the topic Upgrading to Junos Space Network Management Platform Release 16.1R1 in the Workspaces User Guide.
Upgrading to a new Junos Space Network Management Platform version might disable functionality and the ability to use the installed Junos Space applications. Before you upgrade the Junos Space Network Management Platform, take inventory of the applications installed. If Junos Space Network Management Platform is upgraded and a compatible application is not available, the installed application is deactivated and cannot be used until a compatible application has been released.
If you are upgrading Junos Space Platform to releases other than Junos Space Platform Release 16.1R1, the workflow for performing the upgrade is similar to that of installing an application. After you download the required image file, (.img extension) from the Juniper Networks software download site, navigate to the Applications page ( Administration > Applications), right-click the image file, and select Upgrade Platform to upload the image file into Junos Space through HTTP or SCP. We recommend that you use the SCP option, which initiates a direct transfer from an SCP server to Junos Space and is performed as a back-end job. If you choose the SCP option, you must first make the image file available on an SCP server that Junos Space can access. After the image file is uploaded, select the uploaded file, and click the Upgrade button to start the upgrade process. The Network Management Platform upgrade forces the system into Maintenance mode, which requires that you enter the Maintenance mode username and password to proceed with the upgrade.
During the Junos Space Network Management Platform upgrade process, all the data in the Junos Space database is migrated to the new schema that is part of the new Junos Space release. The upgrade process also seamlessly upgrades all nodes in the fabric. The upgrade process requires a restart of JBoss application servers on all nodes and might also require a reboot of all the nodes if the OS packages are also upgraded. The time required for the upgrade depends on a number of factors, including the amount of data being migrated, the number of nodes in the fabric, and the number of third-party components upgraded. You should expect an average downtime of 30 to 45 minutes for upgrade of a single-node fabric, and approximately 45 to 60 minutes for upgrade of a two-node fabric.
You can use this workflow to upgrade to Release 18.1 from Release 17.2 or Release 17.1. If you are upgrading to Release 18.1 from a release earlier than 16.1, you must first upgrade the installation to Release 16.1 and then, upgrade to Release 17.1 or Release 17.2. You must perform multistep upgrades if a direct upgrade is not supported between the version from which you want to upgrade and the version to which you want to upgrade. For detailed information about the releases from which Junos Space Platform can be upgraded, see the Junos Space Network Management Platform Release Notes.
Before you upgrade Junos Space Platform to Release 18.1, 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.
For more information about upgrading the Junos Space Network Management Platform, see the Upgrading Junos Space Network Management Platform Overview topic in the Junos Space Network Management Platform Workspaces User Guide.
Uninstalling Junos Space Applications
To uninstall a Junos Space application, navigate to the Applications page ( Administration > Applications), right-click the application that you want to uninstall, and select Uninstall Application. You are prompted to confirm the uninstallation process. Upon confirmation, the uninstallation process for the application is executed as a back-end job by Junos Space. You can monitor the progress of the job from the Job Management page (Jobs > Job Management). The uninstallation process does not cause downtime for Junos Space Network Management Platform or other applications hosted by Junos Space Network Management Platform.
For more information about uninstalling Junos Space applications, see the Uninstalling a Junos Space Application topic in the Junos Space Network Management Platform Workspaces User Guide).