restore

You can use the restore command to take information from configuration files in the "/tmp" directory and restore the cluster to that configuration. You can enter this command only immediately after a cluster has been created.

Syntax

Read syntax diagramSkip visual syntax diagram>>- svcconfig -- -- restore -- --+----------+-- ---------------->
                                 +- -f -----+
                                 '- -force -'

>--+----------+-- --+----------------------------+-- ----------->
   +- -q -----+     +- -prepare --+------------+-+
   '- -quiet -'     |             +- -fmt -----+ |
                    |             '- -fmtdisk -' |
                    +- -execute -----------------+
                    +- -fmt ---------------------+
                    '- -fmtdisk -----------------'

>--+-----------------+-----------------------------------------><
   '- -v --+- on --+-'
           '- off -'

Parameters

-prepare
Checks the current configuration against the information held in "svc.config.backup.xml" on the configuration to be restored. Prepares commands for execution in "svc.config.restore.sh", and produces a log of events in "svc.config.restore.prepare.log".
-fmt | fmtdisk
Includes the -fmtdisk option an all mkvdisk commands to be issued.
-execute
Executes the command script "svc.config.restore.sh". Produces a log of events in "svc.config.restore.execute.log".
-f | force
Forces continued execution where possible.
-q | quiet
Suppresses console output (STDOUT).
-v on | off
Produces verbose output (on); the default is regular output (off).

Description

This command restores the target cluster configuration from the "svc.config.backup.xml" file, and associated ".key" files (if present) in the configuration files directory. If neither the "prepare" nor "-execute" option is specified, then only a single event log "svc.config.restore.log" is produced.

This command will pause for 5 minutes if any nodes are added during this process. You will be informed of this at run-time.

After restoration, a VDisk will comprise a specific list of MDisks. If the relevant MDisk group comprises a larger list, either now or in the future, the restored VDisk will not be able to exploit any MDisks that are not presently in its own list.

The configuration files directory is "/tmp."

Possible failures

Examples

An invocation example

svcconfig restore -prepare
svcconfig restore -execute