The Catalogue Converter tool is used to convert BDB Server 5 catalogue files to JSON format, allowing them to be used to create new databases in BDB Server 6.
Each database in the BDB Server system uses its own set of catalogue files to control the acronyms, attributes and relationships of features that are available in the database. In BDB Server 5, catalogues are in the form of a pair of pool and profile XML format files; in BDB Server 6, catalogues are in the form of a single JSON format file. Databases that have been migrated from a previous installation of BDB Server had their catalogues converted automatically during the migration, but catalogues that were not migrated with a database must be converted manually. Once converted, these files can be used to create new databases in BDB Server 6.
The following parameters can be specified for the Catalogue Converter tool:
Parameter | Description |
|---|---|
--help | Display the help explaining the available options. |
--pool-file | The name and location of the XML pool file for the database catalogue that needs to be converted. |
--profile-file | The name and location of the XML profile file for the database catalogue that needs to be converted. |
--log-folder | The name and location of the folder in which log files will be created. This parameter is optional. |
--output | The location in which the newly-converted catalogue in JSON format will be created. The location must be specified as a file path. |
--environment | The location of the environment.xml file that contains configuration settings for BDB Server. If this parameter is not specified, the application will check for the file in a local BDB Server 5.x installation location. This parameter is optional. |
To run the Catalogue Converter tool:
1. Launch the BDB 6 Migration Tools from the Windows Start menu.
A command prompt window will be displayed.
2. Run a command similar to the following:
catalogueconverter --pool-file "C:\Program Files\CARIS\BDB Server\5.3\system\SampleCatalogues\CoveragePool.xml" --profile-file "C:\Program Files\CARIS\BDB Server\5.3\system\SampleCatalogues\CoverageProfile.xml" "C:\Install Files\BDBSVR6\bdb6Catalogue.json"
Details about the progress are displayed as the catalogue is converted.
3. Type Exit and press the Enter key to close the Migration Tools.
The JSON catalogue can now be specified as the catalogue to use when creating a new database in BDB Server 6.