6.12. Configuration validating and saving

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.

[16:23:01] ABILIS_CPX:d i

    Abilis CPX - Ver. 8.9.0/STD - Build 4665.39 - Branch 8.9 - 03/07/2020     
                            (c) 1994/2020 - Abilis                                       

ABILIS-ID: 1800310

Free/Total Memory (in byte): 447,666,616/950,497,280
Free/Used/Total HD/CF space (in Kibyte): 327,284/170,152/497,436

File           Version   Date         Time             Size   Note
-------------------------------------------------------------------------------
CPX.RTB        .......   25/06/2020   18:10:40      7066528    
BM.RTB         2054      25/06/2020   18:10:38       292294    
DRIVERS.CFG    8.9       26/06/2020   06:55:36        51200   Saved
DRIVERS.BCK    8.9       25/06/2020   19:07:08        51200   Ok
...

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.9.0/STD - Build 4665.39 - Branch 8.9 - 03/07/2020     
                            (c) 1994/2020 - Abilis                                    

ABILIS-ID: 1800310

Free/Total Memory (in byte): 447,666,616/950,497,280
Free/Used/Total HD/CF space (in Kibyte): 327,284/170,152/497,436

File           Version   Date         Time             Size   Note
-------------------------------------------------------------------------------
CPX.RTB        .......   25/06/2020   18:10:40      7066528    
BM.RTB         2054      25/06/2020   18:10:38       292294    
DRIVERS.CFG    8.9       26/06/2020   16:23:01        51200   Ok
DRIVERS.BCK    8.9       26/06/2020   16:23:01        51200   Ok
...

6.12.2.1. SAVE CONF <ver>

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

If your Abilis is currently running version 8.8.2 or newer you can save DRIVERS.CFG directly in 8.9.0 version, you will just be warned, otherwise you have to copy it there by some other way, e.g. using file copy command or FTP.

Example of save conf from 8.8.2 to 8.9.0, when 8.9.0 does not contain a correct drivers.cfg.

[20:12:57] ABILIS_CPX:save conf 8.9.0
 
TARGET VERSION IS INCOMPATIBLE WITH THE RUNNING VERSION
BUT THE CONFIGURATION WILL BE CONVERTED WHEN TARGET VERSION WILL START.
PROCEED ANYWAY (N/Y)?y
 
VALIDATION IN PROGRESS ...
VALIDATION SUCCESSFULLY EXECUTED

SAVE EXECUTED 
 
[20:13:41] ABILIS_CPX:

In the system log of 8.9.0 you will find messages like these:

30/10/2019 09:54:53 [00640] CONF: CFG CONVERTED (from v.8.8)
30/10/2019 09:54:53 [00079] CONF: SAVED DRIVERS_8-8.CFG  

6.12.2.2. SAVE CONF BACKUP

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