Staging Satellite Software Packages on Aggregation Devices
Junos Space Network Management Platform enables you to stage satellite software packages to one or more Juniper Networks devices functioning as aggregation devices. Staging a package enables you to hold the package on a device, ready to be deployed when needed. At any given time, you can stage only a single satellite software package to an aggregation device. After you stage a satellite software package, you can verify the checksum to ensure that the package is transferred completely. For more information about aggregation devices and satellite devices, refer to the Junos Fusion documentation.
Satellite software packages have names prefixed with
satellite- and must be downloaded and imported to
Junos Space Platform before you can stage them. You can download satellite
software packages from https://www.juniper.net/support/downloads/?p=fusion#sw.
To stage a satellite software package:
- 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
stage by selecting the check box beside the package name and select Stage Image on Satellite Device from the Actions menu.
The Stage Image on Satellite Device option is available on the Actions menu only if you select a satellite software package for staging.
The Stage Image on Satellite Devices page appears. The aggregation devices that are compatible with the selected package are listed.
This page displays the following information:
Image name—Filename of the satellite software package that you have selected for staging
MD5 Value—32-character hexadecimal number that is computed on the selected package, which is stored on the Junos Space server
Device Name—Name of the discovered aggregation device, which is an identifier used for network communication between Junos Space Network Management Platform and the Junos OS device.
Domain—Domain to which the aggregation device is assigned
IP Address—IP address of the discovered aggregation device. For example, 10.1.1.1.
Platform—Platform of the discovered aggregation device. For example, MX480.
Software Version—Operating system firmware version running on the aggregation device. For example, 13.1X49D29.1.
Staged Status—Indicates whether the selected package is staged on the discovered 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 is the same. The status can be one of the following:
Valid when the checksum values of the package on the Junos Space server and the aggregation device match
Invalid when the checksum values do not match
NA when the selected package is not staged on the aggregation device yet
You can restage a package whose checksum status is “Invalid” to ensure that you stage the package onto the aggregation devices correctly, thereby making the checksum status “Valid.” You can deploy a package only when the checksum status is “Valid.”
Last Checksum Time—Time when the checksum was last verified. For an aggregation device to which the selected package is not staged yet, this column displays NA.
You can verify the checksum for a satellite software package by selecting the Verify Image on Devices option from the Actions menu. For more information about how to verify the checksum, see Verifying the Checksum.
You can sort the data displayed in the following columns of the Stage Image on Satellite Devices page: Device Name, IP Address, Platform, Software Version, Staged Status, Checksum Status, and Last Checksum Time.
You can also filter the list of devices on the basis of the data in the following columns: Device Name, IP Address, Platform, and Software Version.
- Select the aggregation device or devices to stage 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.
By default, the Select Device Manually option is selected and the list of aggregation devices is displayed.
To select devices manually:
- Click the Select Device Manually option, if it is not selected previously.
- Select the aggregation devices on which you want to stage
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.
- (Optional) To select all devices, select the check box in the column header next to Device Name.
To select devices on the basis of tags:
- Click the Select by Tags option.
The Select by tags list is activated.
- 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.
If no tags are displayed, then it means that none of the aggregation devices is associated with any tag. You must first tag the aggregation devices on the Device Management page before you can use the Select by Tags option.
- 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:
- Select the Select by CSV option.
- Click Browse and select the file in the CSV
format containing the list of aggregation devices to which you want
to stage the package.
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.
- 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 remove existing device images or satellite
software packages from the device, expand the Staging Options section and select the Delete any existing image before download check box.
When you delete a previously staged image, an audit log entry is automatically generated.
- (Optional) To schedule a time for staging the satellite software package, 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 Stage Image.
The package is staged on the selected aggregation device or devices and a confirmation message appears, displaying the job ID. However, if the device on which you are trying to stage the satellite software package does not have sufficient disk space to accommodate the package, then Junos Space displays an error message and the staging job fails.
The time taken to stage a package depends on the size of the package, network connectivity, and the number of devices on which the package is staged. You can monitor the progress of the staging job by viewing 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 staged successfully, click the job ID link or navigate to the Job Management page and view the status of the job. If staging 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 appears, which displays the reason for failure in the Description column. However, if the package is staged successfully, then this column displays a success message.
You can export the information on the Device Image Action Details page as a comma-separated values (CSV) file.
To export data on the Device Image Action Details page as a CSV file:
- Click Export as CSV.
You are prompted to save the file.
- Click OK in the File Save dialog box to save the file to your computer.
- 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 computer. If you are using Microsoft Excel, you can filter data in the Status column to identify the devices on which the staging of packages failed.
- Click Export as CSV.
You can verify the checksum of the staged satellite software package to ensure that the package is transferred completely to the device. For more information about how to verify the checksum, see Verifying the Checksum.