When you stage an image on a device by using Junos Space Network
Management Platform, sometimes the device image is not completely
transferred to the device. Verifying the checksum helps validate that
the device image is staged properly and is not corrupted or altered
in any way from the device image that you staged from the Junos Space
server.
The checksum value is a 32-character hexadecimal number that
is computed for the device image file on the device. The device image
file is validated by verifying whether the checksum values stored
on the Junos Space server and the device match. If the checksum values
match, the device image is considered to be copied correctly.
Note: You can verify the checksum of satellite software packages
and Junos Continuity software packages by following the procedure
for verifying the checksum of device images.
To verify the checksum:
- On the Junos Space Network Management Platform UI, select Images and Scripts > Images.
- Select the image whose checksum you want to verify.
- Select Verify Image on Devices from the Actions
menu.
This option is unavailable if you select multiple images for
verifying the checksum. Select only one image and repeat this step.
The Verifying checksum of image on device(s) page appears. This
page displays the following information:
Image name—Name of the image, which you
have selected for verifying the checksum
MD5 Value—32-character hexadecimal number
that is computed on the selected device image file, which is stored
on the Junos Space server
Host 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.
IP Address—IP address of the discovered
device
Platform—Platform of the discovered device
Serial Number—Serial number of the device
Software Version—Operating system firmware
version running on the device
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 for verifying the checksum. 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 are 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 of the device
image on the Junos Space server and the device do not match
NA when the selected image is not staged on
the device yet
Last Checksum Time—Time when the checksum
was last verified. For a device in which the selected image is not
staged yet, this column displays NA. This column is updated
when an image is restaged to the device.
- Select the devices that have the device image staged on
them 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: Perform a validation on those devices where the Checksum
Status column shows Valid but the Last Checksum
Time column displays a time that is way past the current time.
By performing this action, you ensure that the image on the devices
is valid currently.
Note: By default, the Select by Device 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 verify the checksum.
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.
- To select all devices, select the check box in the column
header next to Host 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 on devices in the Junos Space system
appears, displaying two categories of tags—Public and Private.
Note: If no tags are displayed, then it means that none of the
devices is associated with any tag. You need to 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.
The device display table displays the devices associated with
the selected tags.
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.
To select devices by using a CSV file:
- Select the Select by CSV option.
- Click Browse to navigate to the file location
in your local system and select the CSV file containing the list of
devices on which you want to verify the device image.
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.
- 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. The
reason for exclusion is listed as an error message against each device.
- (Optional) To schedule a time for verifying the checksum,
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 Verify.
The checksum value of the device image file on the Junos Space
server is validated against the checksum value of the device image
file stored on the selected devices. An alert appears, displaying
the job ID.
To verify the devices on which the checksum status is valid,
click the job ID link or navigate
to the Job Management page and view the status of the job. If the
job is a success, then the checksum values match on all devices selected
for verification. However, if the job is a failure, double-click the
row corresponding to the job to identify the devices on which this
job is a failure. The Device Image Action Details displays the reason
for failure in the Description column. Validation may fail
if the checksum values do not match and for other reasons such as
when the image is not staged on the device.
Also, you can export information from the Device Image Action
Details page as a CSV file to your local system.
To export data from the Device Image Action Details page
to your local system:
- Click Export as CSV.
You are prompted to save the file.
- Click OK in the File Save page to save the
file to your local file system.
- Click OK in the Exporting Device Image
Job page, to return to the Job Management 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 image verification failed.
When you verify a checksum, an audit log entry is automatically
generated.
Change History Table
Feature support is determined by the platform and release you are using. Use Feature Explorer to determine if a feature is supported on your platform.
17.2
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.