restore

Use the restore command to restore the system to its previous configuration. This command uses the configuration files in the /tmp folder .

Syntax

Read syntax diagramSkip visual syntax diagram svcconfig restore -f-force-q-quiet-prepare-fmt-fmtdisk-execute-startlineline_number-fmt-fmtdisk-voffon

Parameters

-f | force
(Optional) Forces continued processing where possible.
-q | quiet
(Optional) Suppresses console output (STDOUT).
-prepare -fmt | fmtdisk
(Optional) Verifies the current configuration against the information in svc.config.backup.json, prepares commands for processing in svc.config.restore.sh, and produces a log of events in svc.config.restore.prepare.
-execute
(Optional) Runs the command script svc.config.restore.sh, and produces a log of events in svc.config.restore.execute.log.
-fmt
(Optional) Specifies that the volume must be formatted before use. Includes the -fmtdisk option on all mkvdisk commands to be issued. You cannot specify -fmt with -execute.
-startline line_number
(Optional) A child parameter of -execute in the svcconfig restore which command allows recovery to resume from a specified line in the generated commands file.
-fmtdisk
(Optional) Specifies that the volume must be formatted before use. You cannot specify -fmtdisk with -execute.
-v on | off
(Optional) Produces verbose output (on); the default is regular output (off).

Description

The restore command restores the target system configuration from the svc.config.backup.xml file in the /tmp folder. If neither the -prepare nor the -execute option is specified, the command performs both phases in sequence, producing only a single event log: svc.config.restore.log.

The restore operation is also known as a T4 (Tier 4) Recovery, and can only be used on a system having just been started. The restore operation can not be used on a system having any nonautomatic objects configured, such as storage pools or volumes.

The restore operation is performed in two phases: prepare and execute.

The command pauses for eight minutes if any nodes are added during this process, informing the user of this at run-time.

An invocation example

svcconfig restore

The resulting output:

No feedback