Command Line

Backup Ninja agent, also known as a bartender, is an application that runs as a service on a database host and as a command-line interface to Backup Ninja API servers.

Configuration File

The command-line interface will look for the default configuration file at /etc/bartender.yaml. This path can be customized with -c or --config flag. As you can tell by looking at the file extension name, the configuration lines follow the YAML structure and it is automatically generated by a periodic pull from Backup Ninja API servers.

Command-Line Options

To get the list of supported command-line arguments and flags, simply run the command with --help flag:

$ bartender --help
bartender

  Usage:
    bartender [install|uninstall|deleteservice|upgrade|restart|decrypt|get-file]

  Subcommands:
    install (i) - Initialize the agent on the first installation and set it up as a service
    uninstall (u) - Uninstall the agent service & package
    deleteservice - Delete the agent service
    upgrade (p) - Upgrade the agent to the latest version
    restart (r) - Restart the agent service
    decrypt (d) - Decrypt encrypted backup
    get-file (g) - Download/Decrypt/Decompress/Copy a backup file

  Flags:
       --version  Displays the program version string.
    -h --help  Displays help with available flag, subcommand, and positional value parameters.
    -c --config  Path to the configuration file. "/etc/bartender.yaml" by default. (default: /etc/bartender.yaml)
    -d --db  Database connection string, eg.
    mysql://user:pass@localhost:3306
    postgres://user:pass@localhost
    mysql:/var/run/mysqld/mysqld.sock

Looking at the output above, there are a number of subcommands and global flags available. For every subcommand, you can get further details on the available options and arguments positioning by appending help, for example:

$ bartender decrypt help

Global Flags

The following table explains the global flags available for bartender:

Subcommand Usage and Examples

install (i)

Initialize the agent on the first installation and set it up as a service. The shorthand for this subcommand is I and it does not accept any argument.

Example:

$ bartender install

uninstall (u)

Uninstall the agent service and package on the database node. The shorthand for this subcommand is u and it does not accept any argument.

Example:

$ bartender uninstall

delete service

Delete the agent service on the database node. It neither does have shorthand nor accept any argument.

Example:

$ bartender deleteservice

upgrade (p)

Upgrade the agent to the latest version. The upgrade procedure will include an automatic agent restart. The shorthand for this subcommand is p and it does not accept any argument.

Example:

$ bartender upgrade

restart (r)

Restart the agent service. This command is similar to the OS system restart, for example systemctl restart bartender. The shorthand for this subcommand is r and it does not accept any argument.

Example:

$ bartender restart

decrypt (d)

Decrypts encrypted backup file using a schedule name or encryption key. The shorthand for this subcommand is u and it accepts the following flags:

Example:

$ bartender decrypt -k 14ca46fc2d501eac6381034e8158c19dxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx -f /storage/backups/backup.tar.gz -x -o my_backup_decrypted.tar

get-file (g)

Download/Decrypt/Decompress/Copy a backup file. This option is mainly built to download backup from cloud storage (if enabled) onto the backup host, for restoration or copying purposes. Using get-file a local storage backup will decrypt and decompress if required. The shorthand for this subcommand is g and it accepts the following flags:

Example:

$ bartender get-file -f bsil9dkbhbisfb90hrag -o mysqldump_all_2019-10-15_051000_.sql