quasardb database tool

Introduction

The quasardb database tool enables you to analyze, dump, repair, backup, restore and verify backups of your quasardb node.

Quick Reference

Option	Usage	Default
-h, --help	display help
-v, --version	display qdb_dbtool version
--database	path to the database
-a, --analyze	analyzes the database
-r, --repair	repairs the database
-b, --backup	performs a database backup
--restore	restores a database backup
--verify_backup	verifies database backups

Parameters reference

Parameters can be supplied in any order and are prefixed with --. The arguments format is parameter dependent.

-h, --help

Displays basic usage information.

-v, --version

Displays the version of the quasardb database tool.

--database=<path>

Specifies the path to the database on which to work.

Arguments

A string representing the path to the database, may be relative or absolute.

Default value

None

Example

Work on a database in the current directory:

qdb_dbtool --database=.

Work on a database in the /var/quasardb/db directory:

qdb_dbtool --database=/var/quasardb/db directory

-a, --analyze

Requests an analysis of the database. A report will be printed to the standard output.

Example

Analyze the database in the current directory:

qdb_dbtool --database=. --analyze

-r, --repair

Attempts to repair the database. All data may not be recovered. Note that the quasardb daemon daemon automatically attempts to repair the database if needed; this option is intended for offline operations.

Example

Repairs the database in the current directory:

qdb_dbtool --database=. --repair

-b=<path>, --backup=<path>

Performs an incremental database backup. The daemon must not be running.

Arguments

A string representing the path to the backup, may be relative or absolute.

Default value

None

Example

Backup a database in /var/lib/db/qdb to /mnt/backups/qdb:

qdb_dbtool --database=/var/lib/db/qdb --backup=/mnt/backups/qdb

--restore=<path>

Restores a database backup. The daemon must not be running. Data in the destination directory may be destroyed.

Arguments

A string representing the path to the backup from which do the restoration. May be relative or absolute.

Default value

None

Example

Restore a backup in /var/lib/db/qdb to /mnt/backups/qdb:

qdb_dbtool --database=/var/lib/db/qdb --restore=/mnt/backups/qdb

--verify_backup=<path>

Verifies a database backup.

Arguments

A string representing the path to the backup to verify. May be relative or absolute.

Default value

None

Example

Verify a backup in /mnt/backups/db:

qdb_dbtool --verify_backup=/mnt/backups/qdb