The trepctl backup command performs a backup of the
corresponding database for the selected service.
trepctl backup [
-backup agent ] [
-limit s ] [
-storage agent ]
Without specifying any options, the backup uses the default configured
backup and storage system, and will wait indefinitely until the backup
process has been completed:
Backup completed successfully; URI=storage://file-system/store-0000000002.properties
The return information gives the URI of the backup properties file. This
information can be used when performing a restore operation as the
source of the backup. See
Section 18.104.22.168, “trepctl restore Command”. Different
backup solutions may require that the replicator be placed into the
OFFLINE state before the backup is
A log of the backup operation will be stored in the replicator log
directory, if a file corresponding to the backup tool used (e.g.
If multiple backup agents have been configured, the backup agent can be
selected on the command-line:
trepctl backup -backup mysqldump
If multiple storage agents have been configured, the storage agent can
be selected using the
trepctl backup -storage file
A backup will always be attempted, but the timeout to wait for the
backup to be started during the command-line session can be specified
-limit option. The
default is to wait indefinitely. However, in a scripted environment you
may want to request the backup and continue performing other operations.
-limit option specifies
how long trepctl should wait before returning.
For example, to wait five seconds before returning:
trepctl -service alpha backup -limit 5
Backup is pending; check log for status
The backup request has been received, but not completed within the
allocated time limit. The command will return. Checking the logs shows
... management.OpenReplicatorManager Backup request timed out: seconds=5
Followed by the successful completion of the backup, indicated by the
URI provided in the log showing where the backup file has been stored.
... backup.BackupTask Storing backup result...
... backup.FileSystemStorageAgent Allocated backup location: »
... backup.FileSystemStorageAgent Stored backup storage file: »
... backup.FileSystemStorageAgent Stored backup storage properties: »
... backup.BackupTask Backup completed normally: »
The URI can be used during a restore.