Support Catalogue
This section describes the Support Catalogue and its important features. It contains the following topics:
Overview
The Support Catalogue is a tab introduced in CCC to upload a secure package downloaded from the Luna Network HSM support portal. The Support Catalogue is displayed with a white banner underneath the main navigation that displays the support catalogue items and the upload package button on the Support Catalogue page.
NOTE If no secure packages are uploaded to the Support Catalogue, an empty state text displays prompting the CCC administrator to upload secure packages to this page.
Upload Package
The Upload Package feature allows the user to upload a secure package file downloaded from the Luna Network HSM support portal to the Support Catalogue. The package is uploaded to Support Catalogue as a .tar file.
To upload a secure package
1.Navigate to the Support Catalogue.
2.Click Upload Package. A modal window to upload the package displays.
3.Browse for a .tar file to upload.
4.Select the .tar file downloaded from the support portal.
NOTE The upload button is disabled until a .tar file is selected. An error message displays if a file type other than .tar is uploaded or the selected file is missing a usable SPKG file or auth file.
5.Click Upload to upload the selected .tar file.
NOTE If the package is uploaded , an 'Upload successful' message displays. If the package upload fails, an 'Upload failed' message displays.
To validate checksum of uploaded secure package
1.When the secure package uploads successfully to CCC, a Verify package modal window displays.
2.Click the text box to enter the checksum retrieved from the Luna Network HSM support portal.
3.Click Verify.
NOTE If the checksum value is not entered in the text box, the Verify button remains disabled.
4.A verify package indeterminate progress bar displays.
NOTE If the package verification completes, a 'package successfully verified' message displays.
5.Click Ok. An 'Upload successful' modal window displays.
6.Click Close to close the modal window.
NOTE If the package verification fails, a 'package verification failed' message displays.
7.Click Try Again to enter a new checksum retrieved from the Luna Network HSM support portal or click Cancel verification to abort the package verification.
To cancel uploading a secure package
The user can cancel the uploading of the secure package.
1.Click Cancel Upload to abort the upload process. A modal window to cancel the process displays.
2.Click Yes, Cancel to cancel the package upload process.
3.Click No, return to upload to continue the package upload process.
NOTE If the package upload process is canceled, any artifacts of the uploaded package is deleted from CCC.
To list the uploaded secure packages
User can view the list of uploaded secure packages as tiles on Support Catalogue.
To view the list of uploaded secure packages:
1.Navigate to the Support Catalogue.
The uploaded secure packages are displayed as tiles with following information:
a.Name of the secure package
b.Apply package button
c.View Details button
NOTE All the uploaded secure packages are displayed as tiles on the Support Catalogue page and are sorted by their upload date in descending order.
To view details of an uploaded secure package
1.Click View Details.
A Package Details modal window with following information about the uploaded secure package displays:
Name | The name of uploaded secure package. |
Uploaded On | The date and time of the uploaded secure package. |
Uploaded By |
User Email ID. |
File size | The file size of the uploaded secure package. |
Auth Code | The auth code of the uploaded secure package. |
Delete Package | Specifies a button to delete a secure package |
You can select an individual device to view more detailed information.
To delete a secure package
1.Click Delete Package. A confirmation modal window displays.
2.Click Delete to delete the secure package from the CCC server or click Cancel to close the confirmation modal window.
3.A Deleting Package progress bar displays.
NOTE When the secure package is deleted successfully, a pop up message, "Package successful deleted" displays.
If the secure package deletion fails, an error message displays in a modal window with two options:
a.Try Again
b.Cancel
4.Select Try Again to re-initiate the secure package deletion process or Cancel to abort the secure package deletion process.
Apply Package
The Apply Package feature allows user to apply a secure package to a device. User can select a device from the device selection list.
The device selection list includes the following details:
Device Name | The name of the device. |
Host Name | The Hostname or IP address of the device. |
Appliance |
The software version of the device. |
Firmware | The Firmware of the device. |
Serial Number | The serial number of the device. |
To apply a secure package
To apply a secure package, following prerequisites are required:
>The device version should be 7.3 or above.
>Rest API version should be 7 or above.
Once the prerequisites are met, following steps are performed to apply a secure package to a device:
1.Click APPLY PACKAGE. A modal window displays.
NOTE If the selected secure package is validated, the CCC administrator skips the step number 2, 3,4,5 and proceeds to step number 6 .
NOTE If the selected secure package is not validated, the Verify package modal window displays.
2. Copy and paste the checksum retrieved from the Luna Network HSM support portal.
3.Click Verify to proceed with checksum verification or click Cancel to abort the apply package process.
NOTE The verification continues to check if the secure package downloaded from the support portal is successfully transferred to the Support Catalogue.
4.When the checksum verification completes, the package successfully verified message displays.
5.Click Ok. The Select Device wizard displays.
To select a device and display device info
1.Select a device from the device selection list or Cancel to close the modal window without applying the secure package to the selected device.
NOTE To apply a secure package, only one device is selected at a time.
2.Click Next.If CCC successfully connects to the device, the Device Info wizard displays with the following information:
Host Name |
Specifies host name. |
Appliance Version | Specifies version of Appliance or device. |
Firmware Version | Specifies version of the firmware installed on the device. |
Serial No | Specifies serial number of the device. |
Partitions List | Specifies list of the partitions available on the device. |
Warning Notification | Specifies a message, "Applying a package to this device will temporarily interrupt service to the partitions listed below as well as any unmanaged partitions that are on the device". |
Cancel | Specifies a button to close the modal window. |
Previous | Specifies a button to return to step 1 of the modal window. |
Continue | Specifies a button to display step 3 of the modal window. |
NOTE If there are no partitions listed on the device, CCC administrator can proceed with applying the secure package to the device. However, if CCC administrator wants to create a partition before proceeding, you should create a service in the Crypto Services tab.
3.If CCC cannot successfully connect to the device, the Device Info Error wizard displays with the following information:
Error message | Specifies a message, "Thales Crypto Command Center could not connect to this device". |
Cancel | Specifies a button to close the modal window. |
Previous | Specifies a button to return to step 1 of the modal window. |
Continue |
This button is disabled. |
NOTE
1. If a device is not selected, the Next button is disabled.
2. The user is restricted from performing any actions on CCC GUI during the package update process.
3. The user can apply the secure package to both PED or Password type devices.
To confirm package application
1.Click Continue. A confirmation wizard for package application displays.
It includes three steps:
a.Upload package to the device
b.Verify package and update the device
c.Reboot the device
2.Type Proceed.
3.Click Apply Package.
4.The Upload package to the device step highlights and a loading bar appears.
If the secure package upload process fails, an Upload failed modal window displays with two options:
a.Try Again
b.Cancel Upload
5.Select Try Again to re-initiate the upload secure package process or Cancel Upload to abort the upload secure package process.
NOTE When user selects Cancel Upload, the Upload failed modal window closes and a red cross (x) displays with respect to step 1.
If upload package to the device completes successfully, a green check displays with respect to step 1.
6.The verify package and update the device step highlights and a loading bar appears.
NOTE If verifying and updating the device process fails, an Update failed modal window displays and the device remains offline until the verify and update process is re-initiated.
7.Click Close to close the Update failed modal window.
NOTE If the verifying and updating the device process completes successfully, a green check displays with respect to step 2.
8.The Reboot the device step highlights and a loading bar appears.
NOTE The device is rebooted only if apply a secure package completes successfully.
9.Click Done to close the apply package modal window.
When an unknown error occurs in any of the three steps during secure package application to the selected device, a"Package application failed" modal window displays and the device remains offline until the secure package update process is re-initiated.
To apply a secure package by adding a device
1.Click APPLY PACKAGE. A modal window displays.
When devices are not available, the modal window displays the following information:
Text |
Specifies a message, "There are currently no devices being managed by Crypto Command Center to apply this package to". |
Add a device button | Specifies a button to add a device. |
Close button | Specifies a button to close the modal window. |
2.Click Add a device to open Devices page and Add device modal windowor click Close button to close the APPLY PACKAGE modal window.
To update Firmware on a single device
1.Click Devices tab. A list of devices displays.
2.Select a device to update firmware. The device information displays.
In the General tab, the Current Firmware Version and the Available Firmware Version Update options are available.
3.Click Update to X.X.X available under Available Firmware Version Update. A modal window to update device firmware displays.
NOTE X.X.X is the new firmware version available for update. If there is no firmware version available for update, No updates available displays under Available Firmware Version Update.
4.Type Proceed.
5.Click Update to continue the firmware update process or Cancel to abort the firmware update process.
NOTE When the firmware update process is successful, a confirmation message with a green check displays.
6.Click Ok.
If the firmware update process is not successful, a Firmware update failed modal window displays.
7.Click Close to close the modal window.
NOTE The firmware upgrade is supported on devices' version 7.2 or above.