NAME
plakar-restore —
Restore files from a Plakar
snapshot
SYNOPSIS
plakar restore |
[-name name]
[-category category]
[-environment environment]
[-perimeter perimeter]
[-job job]
[-tag tag]
[-latest] [-before
date] [-since
date] [-concurrency
number] [-quiet]
[-to directory]
[-skip-permissions]
[snapshotID:path ...] |
DESCRIPTION
The plakar restore command is used to
restore files and directories at path from a specified
Plakar snapshot to the local file system. If path is
omitted, then all the files in the specified
snapshotID are restored. If no
snapshotID is provided, the command attempts to
restore the current working directory from the last matching snapshot.
The options are as follows:
-namestring- Only apply command to snapshots that match name.
-categorystring- Only apply command to snapshots that match category.
-environmentstring- Only apply command to snapshots that match environment.
-perimeterstring- Only apply command to snapshots that match perimeter.
-jobstring- Only apply command to snapshots that match job.
-tagstring- Only apply command to snapshots that match tag.
-concurrencynumber- Set the maximum number of parallel tasks for faster processing. Defaults
to
8 * CPU count + 1. -skip-permissions- Skip restoring file permissions and ownership during restore, defaulting to 0750 for directories and 0640 for files. It Fl to Ar directory Specify the base directory to which the files will be restored. If omitted, files are restored to the current working directory.
-quiet- Suppress output to standard input, only logging errors and warnings.
EXAMPLES
Restore all files from a specific snapshot to the current directory:
$ plakar restore abc123
Restore to a specific directory:
$ plakar restore -to /mnt/ abc123
Restore latest snapshot to a specific directory:
$ plakar restore -latest -to /mnt/ abc123
Restore specific path to a specific directory:
$ plakar restore -to /mnt/ abc123:/etc/apache2
Restore to a specific destination:
$ plakar restore -to @s3target abc123
Restore specific path to a specific destination :
$ plakar restore -to @s3target abc123:/etc/apache2
DIAGNOSTICS
The plakar-restore utility exits 0
on success, and >0 if an error occurs.
- 0
- Command completed successfully.
- >0
- An error occurred, such as a failure to locate the snapshot or a destination directory issue.