Configuration File Format

The functionality described in this section is of interest only to those users running a 6.3x software version which pre-dates S-C630F1 who want to downgrade to an earlier release. Other users can safely ignore this section.

Configuration files, referred to as config files, are stored in XML format. Releases prior to C630F1 saved certain special characters in a non-standard XML format. From release C630F1 and forward, these characters are saved in formats compliant with current W3C XML standards. Character formats are shown below.

Character Standard XML C63F1 (and after) Non-Standard XML Pre C63F1
ASCII hard tab &#xp; value 0x9
ASCII line feed 
 value 0xA
ASCII carriage return 
 value 0xD
Ampersand & &
Less than &lt; <
Greater than &gt; >
Double quote &quote; "
Single quote &apos; '

By default config files are now saved using standard XML coding. Consequently pre-C630F1 software images are unable to parse such config files, complicating the software downgrade process.

To address these complications, the save-config and backup-config ACLI commands has been enhanced to allow the saving of config files and backup configuration files in either standard XML or legacy, non-standard XML format.

save-config ACLI Command

By default, config files are saved in standard XML format that is non-parsable by a pre-C63F1 software image.

ORACLE# save-config
checking configuration
--------------------------------------------------------------------
Results of config verification:
2 configuration warnings
Run 'verify-config' for more details
---------------------------------------------------------------------
Save-Config received, processing.
waiting for request to finish
Request to 'SAVE-CONFIG' has Finished,
Save complete
Currently active and saved configurations do not match!
To sync & activate, run 'activate-config' or 'reboot activate'.
ORACLE# verify-config
---------------------------------------------------------------------
WARNING: security-policy [SP] local-ip-addr-match has 0.0.0.0. This is an acceptable configuration if intended.
WARNING: security-policy [SP] remote-ip-addr-match has 0.0.0.0. This is an acceptable configuration if intended.
---------------------------------------------------------------------
Total:
2 warnings
ORACLE#

save-config, when used in conjunction with a newly supported argument, standard, also saves config files in standard XML format that is non-parsable by a pre-C63F1 software image.

ORACLE# save-config standard
checking configuration
--------------------------------------------------------------------
Results of config verification:
2 configuration warnings
Run 'verify-config' for more details
---------------------------------------------------------------------
Save-Config received, processing.
waiting for request to finish
Request to 'SAVE-CONFIG' has Finished,
Save complete
Currently active and saved configurations do not match!
To sync & activate, run 'activate-config' or 'reboot activate'.
ORACLE# verify-config
---------------------------------------------------------------------
WARNING: security-policy [SP] local-ip-addr-match has 0.0.0.0. This is an acceptable configuration if intended.
WARNING: security-policy [SP] remote-ip-addr-match has 0.0.0.0. This is an acceptable configuration if intended.
---------------------------------------------------------------------
Total:
2 warnings
ORACLE#

save-config, when used in conjunction with a newly supported argument, non-standard, saves config files in legacy XML format that is parsable by a pre-C63F1 software image.

ORACLE# save-config non-standard
checking configuration
--------------------------------------------------------------------
Results of config verification:
2 configuration warnings
Run 'verify-config' for more details
---------------------------------------------------------------------
Save-Config received, processing.
waiting for request to finish
Request to 'SAVE-CONFIG' has Finished,
Save complete
Currently active and saved configurations do not match!
To sync & activate, run 'activate-config' or 'reboot activate'.
ORACLE# verify-config
---------------------------------------------------------------------
WARNING: security-policy [SP] local-ip-addr-match has 0.0.0.0. This is an acceptable configuration if intended.
WARNING: security-policy [SP] remote-ip-addr-match has 0.0.0.0. This is an acceptable configuration if intended.
---------------------------------------------------------------------
Total:
2 warnings
ORACLE#

backup-config ACLI Command

By default, backup config files are saved in standard XML format that is non-parsable by a pre-C63F1 software image.

ORACLE# backup-config testBU
task done
ORACLE#

backup-config <filename> standard also saves backup config files in standard XML format that is non-parsable by a pre-C630F1 software image.

ORACLE# backup-config standardBU standard
task done
ORACLE#

backup-config <filename> non-standard saves backup config files in legacy XML format that is parsable by a pre-C63F1 software image.

ORACLE# backup-config nonStandardBU non-standard
task done
ORACLE#

Note:

The standard and non-standard optional arguments are not supported by the backup-config <filename> saved command, which takes the last saved version of config (whatever the XML format), and saves a copy of that file as the backup.