The dicfg restore command restores settings in the DiveLine configuration in the specified DiveLine dataroot with settings from files in the specified source directory. Note however, that the restore of DiveLine_ACL.cfg does not behave the same way as the restore of DiveLine_Groups.cfg or DiveLine_Users.cfg. That is, when restoring a DiveLine_ACL.cfg file, existing ACL entries are not touched, but new ones are added. Usage of the restore command is described in the following table.
Restore
| Command | Description |
|---|---|
| dicfg restore | |
|
-remote <username>:<password>@<server:port>
|
Specifies the DiveLine server to connect to and the user name and password for logon. |
|
-dataroot <path to diveline dataroot>
|
Specifies the dataroot that the updated DiveLine configuration flat files should be restored to. |
|
<source directory>
|
Required. Specifies the source directory that contains one or more configuration files to be restored to the named dataroot. |
NOTE: You can specify a dataroot on the local machine or a remote DiveLine connection, but not both.
Sample restore command:
dicfg.exe -remote admin:admin@localhost:2130 restore c:\di\solution\dataroot\flatfiles
When invoking the restore command, any users or groups that do not exist in the input files are deleted from DiveLine.
For example, if an existing DiveLine installation has the following users:
- Alice
- Bob
- Carol
And the input configuration only has:
- Alice
- Carol
Then, the restore operation will delete the user Bob.
The restore command will commit blank attribute column values.
For example, if the input contained:
| User | |
|---|---|
| Bob |
And the existing configuration had:
| User | |
|---|---|
| Bob | [email protected] |
Then the restore command would set Bob's email address to blank ("").