Ice Docs

IceStorm Database Utility

2 min read

2 min read

2 min read

2 min read

2 min read

2 min read

2 min read

2 min read

2 min read

The icestormdb utility is a command-line tool for importing and exporting IceStorm databases.

The IceStorm Database utility supports the following command-line options:

Usage: icestormdb <options>
Options:
 -h, --help             Show this message.
 -v, --version          Display version.
 --import FILE          Import database from FILE.
 --export FILE          Export database to FILE.
 --dbpath DIR           Source or target database environment.
 --mapsize VALUE        Set LMDB map size in MB (optional, import only).
 -d, --debug            Print debug messages.

To export an IceStorm database, use the --export option to specify the output file and the --dbpath option to specify the path name of the database. For example, use the following command to export a database found in the db directory to a file named db.ixp:

Shell
icestormdb --export db.ixp --dbpath db

To import an IceStorm database, use the --import option to specify the input file and the --dbpath option to specify the path name of the database. For example, use the following command to import a database into the dbNew directory from a file named db.ixp:

Shell
icestormdb --import db.ixp --dbpath dbNew

The target directory must be empty.

The --mapsize option allows you to set the map size of the new LMDB database. See IceStorm.LMDB.MapSize for additional information.

Besides importing files that it creates itself, icestormdb can also import the files exported by older versions of this utility.