Command Format for Identifying Snapshots to Remove

To identify snapshots to remove from a snapshot storage manger’s snapshot archive, execute the nuodbmgr prune snapshots command. The format for invoking this command is as follows:

prune snapshots database db_name 
   [host host[:port]]
   [pid ssm_id]
   file path
   [maxStorage bytes]
   [maxAge duration]
   [timeout timeout_value]
Option Description

database db_name

Required. Specify the name of the database in which you want to prune snapshots.

host host[:port]

Optional. The default is the host machine of the specified database's SSM. If you specify the host then you can optionally specify the port on which the SSM is listening. In this release, a database can have only one SSM and NuoDB Manager can identify the host of that process. In a future release, a database is expected to be able to have more than one SSM and then this argument might be required.

pid ssm_id

Optional. The default is the process ID of the SSM that serves the specified database. In this release, a database can have only one SSM and NuoDB Manager can identify the SSM's PID. In a future release, a database is expected to be able to have more than one SSM and then this argument might be required.

file path

Required. Specify a file system path. The prune snapshots operation writes a new file to the specified path. This file lists the albumA snapshot storage manager uses albums to efficiently manage snapshots. An album refers to a set of snapshots taken during some period of time. Also, an album provides a place to store additional state required to use snapshots.s that can be removed. The newest album is never listed.

maxStorage bytes

Optional but you must specify maxStorage or maxAge. See Specifying the Snapshot Retention Policy

Specify an integer. The default unit is bytes. You can specify a suffix to indicate the unit: B for bytes, K for kilobytes, M for megabytes, G for gigabytes. For example: 32000, 1000K, 250M, 1G

maxAge duration

Optional but you must specify maxAge or maxStorage .See Specifying the Snapshot Retention Policy

Specify an integer immediately followed by a suffix that indicates the time unit: s for seconds, m for minutes, h for hours, d for days, w for weeks. For example: 600s, 10m, 3h, 2d, 1w

timeout timeout_value Optional. Specify an amount of time to wait for the prune snapshots command to complete. The default is 60000 milliseconds. A value of 0 means that nuodbmgr does not wait. The default timeout is the value of the NuoDB Manager property, pruneSnapshotsTimeout. A timeout value is in milliseconds, seconds, minutes, hours, days or weeks and must end with the appropriate suffix: ms, s, m, h, d or w.