Staging Device Images
Junos Space Network Management Platform enables you to stage an image or a Junos Continuity software package (JAM package) on one device or multiple devices of the same device family simultaneously. Staging an image enables you to hold a device image on a device, ready to be deployed when needed. At any given time, you can stage only a single device image. Staging images repeatedly on a device merely replaces the previously staged device image. While staging device images, you can also delete existing device images from the device. After you stage a device image, you can verify the checksum to ensure that the device image is transferred completely.
You can stage Junos Continuity software packages on devices by following the procedure for staging device images.
To stage a device image on devices:
- On the Junos Space Platform UI, select Images and
Scripts > Images.
The Images page appears.
- Select the device image and select Stage Image on
Device from the Actions menu. The Stage Image on Devices page
appears. The devices that are listed belong to the device family that
supports this image.
This page displays the following information:
Image name—Filename of the device image that you have selected for staging
MD5 Value—32-character hexadecimal number that is computed on the selected device image file, which is stored on the Junos Space server
Device Name—Name of the discovered device, which is an identifier used for network communication between Junos Space Network Management Platform and the Junos OS device.
Device Alias—Value of the Device Alias custom label for the device. This field is empty if the Device Alias custom label is not added or no value is assigned to the Device Alias custom label for the device.
Domain—Domain to which the device is assigned
IP Address—IP address of the discovered device. For example, 10.1.1.1.
Platform—Platform of the discovered device. For example, MX480.
Software Version—Operating system firmware version running on the device. For example, 13.1X49D29.1.
Staged Status—Indicates whether the selected image is staged on the discovered device. This column displays either Staged (if the image is staged) or Not Staged (if the image is not yet staged).
Deployed Status—Indicates whether the selected Junos Continuity software package is deployed on the device. This column appears only when you select a Junos Continuity software package to be staged. The column displays either Deployed (if the Junos Continuity software package is deployed) or Undeployed (if the Junos Continuity software package is not deployed).
Checksum Status—Indicates whether the device image on the Junos Space server and the device is the same. The status can be one of the following:
Valid when the checksum values of the device image on the Junos Space server and the device match
Invalid when the checksum values do not match
NA when the selected image is not staged on the device yet
You can restage an image whose checksum status is “Invalid” to ensure that you stage the image onto the device correctly, thereby making the checksum status “Valid.” You can deploy an image only when the checksum status is “Valid.”
Last Checksum Time—Time when the checksum was last verified. For a device on which the selected image is not staged yet, this column displays NA.
You can verify the checksum for a device image 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 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 based on the data in the following columns: Device Name, IP Address, Platform, and Software Version.
- Select the device or devices on which you want to stage
the device image 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
By default, the Select Device Manually option is selected and the complete list of devices is displayed.
To select devices manually:
- Click the Select Device Manually option, if it is not selected previously.
- Select the devices on which you want to stage the device
The Select Devices status bar shows the total number of 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 devices is associated with any tag. You must first tag the 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 devices associated with the selected tags appears just above the device display table. For example, if there are six 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.
From Junos Space Platform Release 17.2R1 onward, when you select devices by CSV, you can choose to select all managed devices. Select the Include All Managed Devices check box to list all managed devices for selection.
By default, the Include All Managed Devices check box is not selected. Selecting the check box lists all device managed by Junos Space Platform.
To select devices by using a CSV file:
- Select the Select by CSV option.
- Click Browse and select the file in CSV format
containing the list of devices on which you want to stage the device
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.
- (Optional) To remove existing device images 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 device image, 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 image is staged on the selected device or devices and an alert appears, displaying the job ID. However, if the device on which you are trying to stage the device image does not have sufficient disk space to accommodate the image, then Junos Space displays an error message and the staging job fails.
The time taken to stage an image depends on the size of the image, network connectivity, and the number of devices on which the image 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. The Connection Status displays Down and Authentication Status displays Fingerprint Conflict on the Device Management page. The View Job Details page displays an error message.
To verify whether the image is staged successfully, click the job ID link or navigate to the Job Management page and view the status of the job. If the job is a failure, you can double-click the row corresponding to the job to view the reason for failure. The Device Image Action Details page appears, which displays the reason for failure in the Description column. If there is an error, the View Job Details page displays an error message. For more information about the error messages, see Common Error Messages in Device-Related Operations. However, if the image is staged successfully, then this column displays a success message.
Also, 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 on the File Save page to save the file to your local file system.
- After you save the file, to return to the Job Management page, click OK on the Exporting Device Image Job page.
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 staging of images failed.
- Click Export as CSV.
You can verify the checksum of the staged device image to ensure that the image is transferred completely to the device. For more information about how to verify the checksum, see Verifying the Checksum.