Command Format for Invoking Hot Copy to Obtain Current State

To create a copy of the current state of a running database, invoke the hotcopy command.

Note: The hotcopy command is issued using NuoDB Command (nuocmd). For more information on NuoDB Command and other command line tools, see Command Line Tools.

For a given database, one hot copy operation at a time is allowed. The format is as follows:

nuocmd hotcopy database --db-name <database name> --type {full|incremental|journal} [--backup-dirs <archive ID backup location archiveID backup location ... >] [--default-backup-dir <backup location>] [--shared] [--timeout <timeout time in seconds>.
Option Description
db-name

Required. Specify the name of the database on which to perform the hot copy.

type

Required. The type of hotcopy to perform. Must be either full, incremental or journal.

backup-dirs

Required unless --default-backup-dir is supplied. A space separated list of '<Archive ID> <Backup Path>' pairs specifying the backup location for each archive.

default-backup-dir

Required unless --backup-dirs are supplied. Backup any archives that do not have a backup location specified in --backup-dirs to this location.

shared Optional. If a path is provided, this signifies that the backup location specified by --default-backup-dir is on shared storage exposed to multiple SMs. If a path is provided, the directory specified by --default-backup-dir must exist and each archive will backup to a subdirectory inside that directory corresponding to the archive ID of the archive.
timeout Optional. The number of seconds to wait for hot copy to complete before returning. If a value is not provided, the request is issued asynchronously and immediately returns. If the command returns before hot copy finishes, the status of the hotcopy can be checked using NuoDB Command's hotcopy-status command.