HP StoreOnce Backup System CLI Reference Guide

config restore devices
Description of Command Function
Restores StoreOnce system devices to the condition detailed in the defined device’s configuration
file.
NOTE: For more information about the configuration save and restore process, see the HP
StoreOnce Backup System User Guide (single-node or multi-node, depending on your product).
See also “config save devices” (page 55).
Command Syntax
config restore devices SETX[,X] <ConfigFile> [force]
Command Authority
Administrator
Command Object Requirements
• ConfigFile – This required object defines the device configuration file detailing the configuration
to which the devices in the system are restored.
• SET X – This required object defines the service set(s) to which the drive is added. X is the
numeric index of the service set. Include more than one service set, if necessary. If no service
sets are defined, the restore is performed on all the service sets in the cluster.
Command Parameter Requirements
force – This optional parameter overrides any digital signatures or sumchecks.
Requirements for Command Execution
• The command entry must conform to command syntax.
• All object values must be valid. See object requirements for details.
• The parameter value must be valid. See the parameter description 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
configurations are 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 configuration file does not exist
◦ Command Failed – The configuration file is not a device
configuration file
◦ Command Failed – Duplicate service sets
◦ Command Failed – The service set(s) are invalid
◦ The software version of the configuration file [configuration
software version] does not match system software version [system
software version]
◦ Command Failed – The system hardware does not match the
configuration file (difference in number of nodes)
52 Alphabetical List of Commands and Details