icegriddb utility is a command-line tool for importing and exporting an IceGrid registry database.
On this page:
The IceGrid Database utility supports the following command-line options:
Exporting an IceGrid Database
To export an IceGrid registry database, use the
--export option to specify the output file and the
--dbpath option to specify the path name of the registry's database directory. To discover the location of your database, review the registry's configuration and look for the setting of
IceGrid.Registry.LMDB.Path. For example, the IceGrid sample programs typically use this setting:
Run the following command to export the database:
You can export an IceGrid registry database while the IceGrid registry is actively using this database. Write operations to the IceGrid registry database will block while icegriddb is reading the database.
If you want to back-up the IceGrid registry database while the IceGrid registry is running, we recommend using the mdb_copy tool.
Importing an IceGrid Database
To import an IceGrid registry database, use the
--import option to specify the input file and the -
-dbpath option to specify the path name of the registry's database directory. For example, use the following command to import a database into the
dbNew/registry directory from a file named
The target directory must be empty.
--mapsize option allows you to set the map size of the new LMDB database. See IceGrid.Registry.LMDB.MapSize for additional information.
IceGrid allows you to assign an Ice version to each server it manages. IceGrid uses this information to generate configuration files for this server that are compatible with the specified Ice version. When a server has no associated Ice version, IceGrid assumes this server uses the same version of Ice, for example, IceGrid 3.7.2 assumes such a server also uses Ice 3.7.2.
icegriddb does not change this
ice-version attribute when importing IceGrid databases: an unset attribute remains unset, and a set attribute keeps the same value. You can make
icegriddb change all unset
ice-version attributes to a specific version with the
--server-version option, as shown in the example below:
Besides importing files that it creates itself,
icegriddb can also import the files exported by the Ice 3.5 (
icegriddb35) and Ice 3.6 versions of this utility.