HP StoreOnce Backup System CLI Reference Guide

config restore keystore
Description of Command Function
Restores a saved keystore from the file specified to the device. This operation requires the password
originally given to the save command in order to decrypt the keystore.
WARNING! This command overwrites the existing system keystore. If an up-to-date backup of
the keystore is unavailable, permanent and unrecoverable access to encrypted data may occur.
Command Syntax
config restore keystore <keystorefile>
Command Authority
Administrator
Command Object Requirements
Not applicable – no objects exist within this command.
Command Parameter Requirements
keystorefile – This required parameter defines the name of the keystore file to be retrieved. List
available configuration files using the CLI command, config show list keystore.
Requirements for Command Execution
• The command entry must conform to command syntax.
• All parameter values must be valid. See the parameter descriptions for details.
Successful Command Output
Upon successful completion of the command, the following is displayed:
Command Successful
Command Operation during Abnormal Conditions
• If any of the command execution requirements fail, command execution terminates, the keystore
is not restored, and one of these error messages is displayed:
◦ Command Failed - the command does not conform to the required
syntax, SYNTAX, where SYNTAX is the command syntax as described under Command
Syntax in this section.
◦ Command Failed – The keystore file does not contain keys for
existing stores
◦ Command Failed – The keystore file connections incorrect keys
for existing stores.
WARNING! If the keystore contains incorrect keys for existing stores, they are
subsequently locked to prevent data corruption.
Example
# config restore keystore keystore_HPVM979D0769_2013-06-28T12:27:05Z.kms
Command Successful
54 Alphabetical List of Commands and Details