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.