Deploying Satellite Software Packages on Aggregation and Satellite Devices

Junos Space Network Management Platform enables you to deploy satellite software packages to one or more Juniper Networks devices functioning as aggregation devices and to the satellite devices connected to these aggregation devices simultaneously. When you deploy a satellite software package, the package is installed on the selected aggregation devices and connected satellite devices. If the satellite software package is already staged on the devices, the time taken to load the package is eliminated and Junos Space Platform directly installs the package. Junos Space Platform also enables you to schedule the deployment of a package at a later time.

You can deploy a satellite software package only onto devices or platforms supported by that package. When you select a satellite software package for deployment, only those devices that are supported by the selected package are displayed on the list of aggregation devices.

Satellite software packages have names prefixed with satellite- and must be downloaded and imported to Junos Space Platform before you can deploy them. You can download satellite software packages from https://www.juniper.net/support/downloads/?p=fusion#sw.

Note:

Junos Space deploys satellite package onto a satellite device through an aggregation device by upgrading all software upgrade groups on the aggregation device rather than the corresponding satellite software upgrade group.

To deploy satellite software packages:

On the Junos Space Platform UI, select Images and Scripts > Images.
The Images page appears, displaying the software images imported to Junos Space Platform.
Select the satellite software package that you want to deploy by selecting the check box beside the package name.
The selected package is highlighted.

Select Deploy Satellite Device Image from the Actions menu.

Note:

The Deploy Satellite Device Image option is available on the Actions menu only if you select a satellite software package for staging.

The Deploy Image on Satellite Devices dialog box appears. The Select Devices table in the Deploy Image on Satellite Devices dialog box displays the aggregation devices that are supported by the selected satellite software package. For a description of the fields in this table, see Table 1.

Table 1: Select Devices Table Fields
Field	Description
Image name	Filename of the satellite software package. (This field is above the devices table.)
MD5 Value	32-character hexadecimal number that is computed on the selected satellite software package, which is stored on the Junos Space server
Device Name	Identifier used for network communication between Junos Space Platform and the device running Junos OS
IP Address	IP address of the aggregation device
Platform	Model number of the aggregation device
Software Version	Operating system firmware version running on the aggregation device
Staged Status	Indicates whether the selected package is staged on the aggregation device. This column displays either Staged (if the package is staged) or Not Staged (if the package is not yet staged).
Checksum Status	Indicates whether the satellite software package on the Junos Space server and the aggregation device are the same: Valid means that the checksum values of the package on the Junos Space server and the device match. Invalid means that the checksum values of the package on the Junos Space server and the device do not match. NA means that the selected package is not staged on the device yet.
Last Checksum Time	Time when the checksum was last verified. For a device in which the selected package is not staged yet, this column displays NA.
Domain	Domain to which the aggregation device belongs

Select the devices on which you want to deploy the satellite software package by using one of the following selection modes—manually, on the basis of tags, or by using a comma-separated values (CSV) file. These options are mutually exclusive. If you select one, the others are disabled.
Tip:
Some points to consider when you select devices for deploying a package:
- Using a device on which the selected satellite software package is already staged eliminates the time taken to load the package on a device. However, if you select a device on which the package is not previously staged, then the deployment action stages the package first and then installs the package on the device. Use the Staged and Not Staged statuses in the Staged Status column to identify the devices on which the packages are staged and not staged, respectively.
- If the Last Checksum Time value shows that the checksum is not verified recently, it is better to verify the checksum again before deploying the package so as to ensure that the package is valid. The deployment fails if the checksum values of the satellite software package file on the Junos Space server and the device do not match. For more information about verifying the checksum, see Verifying the Checksum.
Note:
By default, the Select Device Manually option is selected and the list of aggregation devices is displayed.

To select devices manually:
1. Click the Select Device Manually option, if it is not selected previously.
2. Select the devices on which you want to deploy the satellite software package.
  The Select Devices status bar shows the total number of aggregation devices that you selected. The status bar is dynamically updated as you select the devices.
3. To select all devices, select the check box in the column header next to Device Name.
To select devices on the basis of tags:
1. Click the Select by Tags option.
  The Select by tags list is activated.
2. Click the arrow on the Select by Tags list.
  A list of tags defined for devices in Junos Space Platform appears, categorized into two—Public and Private.
  
  Note:
  If no tags are displayed, then it means that none of the devices is associated with any tag. You must tag the devices on the Device Management page before you can use the Select by Tags option.
3. To select tags, perform one of the following actions :
  - Select the check boxes next to the tag names to select the desired tags and click OK.
  - To search for a specific tag, enter the first few letters of the tag name in the Select by Tags field to the left of the OK button. If a match is found, a suggestion is made. Select the suggested match and click OK.
  As you select the tags, the total number of aggregation devices associated with the selected tags appears just above the device display table. For example, if there are six aggregation devices associated with the selected tags, then 6 items selected is displayed.
  
  The selected tags appear next to the Tags Selected label. An [X] icon appears after each tag name. You can click the [X] icon to clear any tag from the list. The device count decrements accordingly.
To select devices by using a CSV file:
1. Select the Select by CSV option.
2. Click Browse and select the file in the CSV format containing the list of aggregation devices on which you want to deploy the satellite software package.
  Tip:
  For a sample CSV file, click the Sample CSV link. You are prompted to save the file. Save the file to your local system and open it by using an application, such as Microsoft Excel.
3. Click Upload to upload the CSV file.
  From Release 16.1R2 onward, when you upload a CSV file to select devices from, Junos Space Platform verifies the devices in the CSV file. If the CSV file contains devices to which the changes do not apply, a warning message appears which says "Few devices are not selected due to precondition failure. Please click "View inapplicable devices" for more details.” You can click the View inapplicable devices link to review the list of devices that are excluded from the update.

(Optional) To specify common deployment options, expand the Common Deployment Options section and select one or more check boxes. See Table 2 for a description of the common deployment options.

Table 2: Common Deployment Options Descriptions
Common Deployment Options	Description
Use image already downloaded to device	Use the satellite software package that is staged on the devices for deployment.
Archive data (Snapshot)	Collect and save device data and executable areas to the snapshot locations for the device, such as /altroot, /altconfig, /config, and so on.
Remove the package after successful installation	Delete the satellite software package from the devices after the successful installation of the package.
Delete any existing image before download	Delete all satellite software packages with the same filename from the device before deploying the selected package.

(Optional) To schedule a time for deployment, select the Schedule at a later time check box and use the calendar icon and drop-down list to specify the date and time respectively.
Click Deploy.
The selected package is deployed on the selected aggregation devices and the connected satellite devices, with the deployment options that you specified, and an alert appears, displaying the job ID.

Note:
You can monitor the progress of completion from the Percent column of the particular job on the Job Management page. If Junos Space Platform detects an SSH fingerprint mismatch between that on the device and that in the Junos Space Platform database, the connection is dropped and the job fails. Connection Status displays Down and Authentication Status displays Fingerprint Conflict on the Device Management page.

To verify whether the package is deployed successfully, click the job ID link or navigate to the Job Management page and view the status of the job. If the deployment fails on any of the devices, the job is a failure. You can double-click the job to view the reason for failure and the devices on which the job failed. The Device Image Action Details page displays the reason for failure in the Description column. However, if the package is deployed successfully, then this column displays a success message.

Also, you can export information from the Device Image Action Details page as a comma-separated values (CSV) file to your local file system.

To export data from the Device Image Action Details page to your local file system:
1. Click Export as CSV.
  You are prompted to save the file.
2. Click OK in the File Save dialog box to save the file to your local file system.
3. After you save the file, to return to the Job Management page, click OK in the Exporting Device Image Job dialog box.
Use an application such as Microsoft Excel to open the downloaded file from your local system. If you are using Microsoft Excel, you can filter data in the Status column to identify the devices on which the package deployment failed. See the associated Description column to understand the reasons for failure.

You can also view the result of deployment from the View Deploy Results page. For more information, see Viewing Device Image Deployment Results.

Deploying Satellite Software Packages on Aggregation and Satellite Devices

Related Documentation