6.12. Configuration validating and saving

6.12. Configuration validating and saving
	Chapter 6. Command language

6.12.1. VALIDATE

This command executes the validation of the configuration currently in use.

Configuration validating has been introduced to ensure correct Abilis CPX configurations.

The output of the validating procedure can be:

Positive without demanding modifications to the configuration (if the command is successful the message “VALIDATION SUCCESSFULLY EXECUTED” will be also shown);
Negative if the validation detects some incongruencies or imprecision in it (if the command is unsuccessful the message “VALIDATION FAILED” will be shown).

[11:28:08] ABILIS_CPX:validate

VALIDATION IN PROGRESS ...
WARNING: RES:Tcp Changed "SESNUM" from 12 to 22
VALIDATION SUCCESSFULLY EXECUTED

6.12.2. SAVE CONF

This command saves the current configuration in the file drivers.cfg on the disk only if validation is successful.

If the validation and saving are both successful the message “SAVE EXECUTED” will be shown. If the validation fails, the saving is NOT executed and the message “SAVE NOT EXECUTED” will be shown.

[18:09:29] ABILIS_CPX:save conf

VALIDATION IN PROGRESS ...
VALIDATION SUCCESSFULLY EXECUTED

SAVE EXECUTED

The configuration is saved and marked with a configuration state of “configuration saved but not yet loaded”. On the next restart, if the settings of the saved configuration were correct, the configuration state will become “valid configuration”.

Checking the current configuration state is done through the command d i. In the correspondence of the drivers.cfg file, in the notes dedicated section, the string “Saved” will appear.

After the system restart, in correspondence of the loaded drivers.cfg file, in the notes dedicated section, the string “Ok” will appear.

[16:23:01] ABILIS_CPX:d i

     Abilis CPX - Ver. 8.5.1/STD - Build 4238.7 - Branch 8.5 - 02/08/2017     
                            (c) 1994/2017 - Abilis                            

ABILIS-ID: 1800310

Free/Total Memory (in byte): 605,658,848/950,497,280
Free/Used/Total HD/CF space (in Kibyte): 412,200/99,320/511,520

File           Version   Date         Time             Size   Note
-------------------------------------------------------------------------------
CPX.RTB        .......   02/08/2017   17:55:08      6787484    
BM.RTB         2052      02/08/2017   17:55:04       282724    
DRIVERS.CFG    8.5       16/08/2017   13:08:14        45056   Ok
DRIVERS.BCK    8.5       03/08/2017   07:28:04        45056   Ok
...

Save Conf command can be also used with the syntax: save conf <version>.

It allows creating a copy of the configuration file DRIVERS.CFG of the specified version directory. The <version> string must correspond to an existing version directory in the form 'X.Y.Z' or 'X-Y-Z' or 'Y.Z' or 'Y-Z' or 'Y', where X, Y and Z are decimal digit [0 - 9] (E.g. 8-5-0)

It can be useful after a system update and the installation of a compatible release.

[18:09:29] ABILIS_CPX:save conf 8-5-0

VALIDATION IN PROGRESS ...
VALIDATION SUCCESSFULLY EXECUTED

SAVE EXECUTED

The command save conf backup is used to create a backup copy (file drivers.bck) of the configuration saved on disk. The backup configuration is loaded at the Abilis CPX start, every time the one, saved in drivers.cfg, isn't valid or the same file is missing or corrupted.

Indeed, it's very important that the User makes backup only of those configurations correctly working.

[11:28:08] ABILIS_CPX:save conf backup

THE CURRENT SAVED CONFIGURATION WILL BECOME THE BACKUP CONFIGURATION.
PROCEED (N/Y)?y

PROCEEDING WITH SAVE BACKUP...
SAVE BACKUP EXECUTED


6.11. Lists management		6.13. System management