IceGrid Database Utility
The icegriddb
utility is a command-line tool for importing and exporting an IceGrid registry database. This tool is especially useful when migrating to Ice 3.7, where IceGrid uses a different database implementation and storage format. Using icegriddb
, you can export your existing IceGrid 3.6 registry database and then import the data using the Ice 3.7 version of icegriddb
.
On this page:
Usage
The IceGrid Database utility supports the following command-line options:
Usage: icegriddb <options> Options: -h, --help Show this message. -v, --version Display version. --import FILE Import database from FILE. --export FILE Export database to FILE. --dbhome DIR The database directory. -d, --debug Print debug messages.
Exporting an IceGrid Database
To export an IceGrid registry database, use the --export
option to specify the output file and the --dbhome
option to specify the path name of the registry's database environment. To discover the location of your database environment, review the registry's configuration and look for the setting of IceGrid.Registry.Data
. For example, the IceGrid sample programs typically use this setting:
IceGrid.Registry.Data=db/registry
Run the following command to export the database:
$ icegriddb --export registry.ixp --dbhome db/registry
The utility will fail with an error message if the given path does not contain a registry database.
Importing an IceGrid Database
To import an IceGrid registry database, use the --import
option to specify the input file and the --dbhome
option to specify the path name of the registry's database environment. For example, use the following command to import a database into the dbNew/registry
directory from a file named registry.ixp
:
$ icegriddb --import registry.ixp --dbhome dbNew/registry
The target directory must be empty.