token backup update capability
Update Backup Token Capability, using a capability update package that you have acquired from SafeNet and transferred via scp to the SafeNet appliance. Before you can use this command, you must:
>Acquire the secure package update file from SafeNet and send the file to the SafeNet Luna Network HSM (using scp or pscp)
>Open the file on the SafeNet Luna Network HSM with the LunaSH command package update <filename> -authcode <authcode>
WHEN to USE LunaSH "token backup" commands:
LunaSH token backup commands operate a SafeNet Luna Backup HSM attached directly to SafeNet Luna Network HSM via USB, and are not intended for use with remotely connected backup devices.
You might have a locally-connected backup HSM (connects directly to a SafeNet Luna Network HSM via USB cable) and a locally connected serial terminal and be walking them from SafeNet Luna Network HSM to SafeNet Luna Network HSM in your server room to perform backups. Or you might be administering remotely via SSH and lunash:> commands, while a technician in your server center carries the backup HSM from one SafeNet Luna Network HSM to the next. In either case, these token backup commands are the method to use. The important distinction is where the backup HSM is physically connected - from the SafeNet Luna Network HSM perspective, those are both local backup operations to a backup HSM that is locally connected to the appliance.
For true, hands-off, lights-out operation of your SafeNet appliances, use a SafeNet Luna Backup HSM located in your administrator's office (or other convenient location), connected to a computer acting as a Remote Backup server (this could be your administrative workstation, or it could be a completely separate computer). This means the computer and Backup HSM are located near you and remote/distant from your SafeNet Luna Network HSM appliance(s). For that application, use the backup commands in the lunacm utility supplied with the SafeNet Luna Network HSM Client software (which must be installed on the computer that is acting as Remote Backup server) - the appliance token backup commands are not designed to work for Remote Backup.
A capability update or a firmware update is meant to be applied just one time to an HSM. If you attempt to re-apply a capability update to an HSM that already has the capability installed, the system throws an error like " C0000002 : RC_GENERAL_ERROR ". A similar result occurs if you attempt to install a particular firmware update more than once on one HSM. This is expected behavior.
User Privileges
Users with the following privileges can perform this command:
>Admin
>Operator
Syntax
token backup update capability -serial <serialnum> -capability <capabilityname> [-force]
| Argument(s) | Shortcut | Description |
|---|---|---|
| -capability <capabilityname> | -c | Specifies the capability name. |
| -force | -f | Force the action without prompting. |
| -serial <serialnum> | -s | Specifies the token serial number. |
Example
lunash:>token backup update capability -serial 667788 -capability newcapability CAUTION: This command updates the Token Capability. This process cannot be reversed. Type 'proceed' to continue, or 'quit' to quit now. > proceed This is a NON-destructive capability update Update Result :0 (Capability newcapability added) Command Result : 0 (Success)
