- General Information
- Server Administration
- Mission Database
- Data Management
- Data Links
- Processors
- Commanding
- Services
- Security
- Web Interface
- Programs
Extending Yamcs
Yamcs HTTP API
Yamcs Release Notes
Source Code Documentation
yamcsadmin backup¶
Synopsis¶
Description¶
Use yamcsadmin backup when you want to save and restore Yamcs data.
Backups are performed at the level of a tablespace, which (unless otherwise configured) corresponds with an instance name. A special tablespace _global
contains data that is not specific to an instance.
The backup directory is in binary format and can contain multiple restore points, one for each time the create
command was used. Use the list
command to see all restore points in a backup directory.
Commands¶
- create --backup-dir <DIR> [--data-dir <DIR>] [--url <HOST:PORT>] <TABLESPACE>
Create either a hot or a cold backup of a Yamcs tablespace. For cold backups, specify the
--data-dir
property, for hot backups specify the--host
property.
- delete --backup-dir <DIR> <ID>...
Delete one or more backups.
- list --backup-dir <DIR>
List the existing backups.
- purge --backup-dir <DIR> --keep <N>
Purge old backups.
- restore --backup-dir <DIR> --restore-dir <DIR> [<ID>]
Restore a backup by its ID.
If unspecified
<ID>
defaults to the last backup.Note that backups can only be restored when Yamcs is not running.
Options¶
- --backup-dir <DIR>¶
Directory containing backups.
When used with the
create
command, the directory is automatically created if it does not yet exist.
- --data-dir <DIR>¶
This option is only valid for the
create
command.Path to a Yamcs data directory. This must be specified when performing a cold backup.
- --restore-dir <DIR>¶
This option is only valid for the
restore
command.Directory where to restore the backup.
- --host <HOST:PORT>¶
This option is only valid for the
create
command.Perform a hot backup. This allows to take a consistent backup while Yamcs is running. Backup are currently triggered using a JMX operation.
- --keep <N>¶
This option is only valid for the
purge
command.The number of backups to keep.
- <ID>¶
A unique identifier for a restore point. You can find existing identifiers using the
list
command.