keyring reset

Reset a keyring to its initial conditions (erase all objects, reset label and password). You must then re-initialize the keyring and set a new KRCO password.

NOTE   Thales recommends Luna Appliance Software 7.8.3 with cluster package 1.0.3, Luna HSM Firmware 7.8.2, and Luna HSM Client 10.6.0 to use clusters.

This command is functionally equivalent to the hsm group partition reinit command on Luna IS HSMs, but it is not supported for use with migrated Luna IS keyrings in this release.

User Privileges

Users with the following privileges can perform this command:

>Admin

Syntax

keyring reset [-copassword <password>] [-keyringid <string>] [-label <name>] [-force]

Argument(s) Shortcut Description
-copassword -c Specifies the keyring CO password. If this option is omitted on a password-authenticated HSM, LunaSH prompts for the password. If this option is included on a multifactor quorum-authenticated HSM and the partition is not activated, it is ignored.
-force -f Reset the keyring without asking for confirmation.
-keyringid -k Specifies the UUID of the keyring to be reset. Use lunash:> keyring list to display a list of available keyrings and their UUIDs.
-label -l Specifies the label of the keyring to be reset.

Example

lunash:>keyring reset -label keyring00 -co IamtheKRCO

WARNING !! This command will reset keyring keyring00.
This will delete all objects belonging to the keyring.
If you are sure that you wish to proceed, then type 'proceed', otherwise type 'quit'

proceed
Proceeding...

Keyring 728e8b21-81d5-49fc-ba77-2ebb22e7e25e was successfully reset.

Command Result : 0 (Success)