sysconf config restore

Restore configuration of the selected services from a backup file. This command automatically creates a backup file of the current configurations before restoring a previous configuration. You can restore the previous configurations from this backup if the new settings are not acceptable.

NOTE   If the configuration content is less than 64 KB, a single file is generated with a name that includes the creation date and time.

If the lunash:> sysconf config backup command detects that your configuration is more than 64 KB, then it breaks the config content into chunks, each of less than 64 KB. The backup chunk files get the same name, except that each has a sequential number appended. An additional generated file contains a hash of all the chunk files, and is used to reassemble the large backup when you later restore with lunash:> sysconf config restore (using Luna Appliance Software 7.8.5 or newer).

If you store your appliance configuration on an HSM (using sysconf config export) you must first use the command sysconf config import to import the configuration file from the HSM to the appliance file system before using this restore command.

The service(s) must be stopped before restoring their configuration.

You must reboot the appliance for the changes to take effect. Please check the new configurations before rebooting or restarting the services.

Certificates, if any, are added to the backup archive, and are restored to the strust store upon config restore.

NOTE   This command does not restore the HSM (crypto module) and Partition configurations (see hsm restore and partition restore for more information).

User Privileges

Users with the following privileges can perform this command:

>Admin

Syntax

sysconf config restore -file <filename> -service <service> [-force]

Argument(s) Shortcut Description
-file <filename> -fi Name of the configuration backup file to restore.
-force -fo Force the action without prompting.
-service <service> -s

The service name. This option requires Luna Appliance Software 7.8.5 or newer.

Valid values: network,ssh,ntls,ctc,syslog,ntp,snmp,users,system,webserver,all

Service syslog uses the same certificates as audit log encryption.

Example (Luna Appliance Software older than 7.8.5)

lunash:>sysconf config restore -file local_host_Config_20170301_1212.tar.gz -service ntls


WARNING !! This command restores the configuration from the backup file: local_host_Config_20170301_1212.tar.gz.
It first creates a backup of the current configuration before restoring: local_host_Config_20170301_1212.tar.gz.
If you are sure that you wish to proceed, then type 'proceed', otherwise type 'quit'.

> proceed
Proceeding...


Created configuration backup file: local_host_Config_20170301_1222.tar.gz


Restore the ntls configuration: Succeeded.

You must either reboot the appliance or restart the service(s) for the changes to take effect.
Please check the new configurations BEFORE rebooting or restarting the services.
You can restore the previous configurations if the new settings are not acceptable.



Command Result : 0 (Success)

NOTE   Noticeable changes using Luna Appliance Software 7.8.5 or newer:

>backups would have either "all" or a single service in the filename

>backups could be larger than 64 KB and therefore be spread across multiple files (that must all be stored, handled, used together).