Metadata database operations
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

1. Create new database

./hyconfdbutil.pl -n -o config.sdb

Creates a new database with name specified by the -o option. If it exists, it is deleted first.

-j option can be used to add entries to a journal file and backup the database before modifying (backup by copying to config.sdb.backupNN where NN=01,02,...99,00)


2. Add XML metadata to the database

./hyconfdbutil.pl -a -o config.sdb -i HydraMeta.xml

Adds metadata from the XML file specified by the -i option to the database specified by the -o option.

-j option can be used as above


3. Add a system description to the database

./hyconfdbutil.pl -s -o config.sdb -i system.txt

The system description in the text file specified by the -i option is added to the database specified by the -o option.
-j option can be used as above

The format of the system description text file is defined in CS-213274-SP section 7.6


4. Export to XML

./hyconfdbutil.pl -e -i config.sdb -o out.xml -f xml -v "chip_name=CSR9800"
./hyconfdbutil.pl -e -i config.sdb -o out.xml -f xml -v "subsystem_name=bt and version=123"
./hyconfdbutil.pl -e -i config.sdb -o out.xml -f xml -v "*"

Generates an XML file for each subsystem / layer selected.

-u option (unfiltered) can be used to include CSR internal information
-v option specifies a string which is used to select the relevant subsystem and version (using SQL SELECT WHERE ...).
The selection can be on one or more elements from the subsystem_firmware_versions table or from the system_versions table, but not both.
Only one version of each subsystem should be selected.
"*" may be used to select all (e.g. for testing)

5. Export to HTML

./hyconfdbutil.pl -e -i config.sdb -o out.html -f html -v "chip_name=CSR9800"

Generates an HTML file for each subsystem selected.

Options as above

6. Create a release bundle

./hydra_release.pl -i config.sdb -r test_release.rcf -o test_release

This script is described in CS-218470-SP.
The release control file is described in section 6.2 of CS-218470-SP.


