.. _config-mariabackup:

Mariabackup Provider Configuration [mariabackup]
================================================

Backs up a MySQL instance using ``mariabackup`` tool.

[mariabackup]
-------------

**global-defaults** = <path> (default: /etc/my.cnf)

    The MySQL configuration file for mariabackup to parse.  This is !include'd
    into the my.cnf the mariabackup plugin generates

**innobackupex** = <name> (default: innobackupex-1.5.1)

    The path to the innobackupex script to run. If this is a relative path
    this will be found in holland's environment PATH as configured in
    /etc/holland/holland.conf.


**ibbackup** = <name>

    The path to the ibbackup command to use.  By default, no --ibbackup option
    is passed to the innobackupex script.  Usually innobackupex will detect this
    by itself and this should not need to be set.

**stream** = mbstream (default: mbstream)

    Placeholder

**apply-logs** = yes | no (default: yes)

    Whether to run ``innobackupex --apply-logs`` at the end of the backup. This
    is only supported when performing a non-streaming, non-compressed backup.
    In this case, even if apply-logs = yes (the default), the prepare stage
    will be skipped.  Even with an uncompressed, non-streaming backup you may
    want to disable apply-logs if you wish to use incremental backups.

**slave-info** = yes | no (default: yes)

    Whether to enable the --slave-info innobackupex option

**safe-slave-backup** = yes | no (default: yes)

    Whether to enable the --safe-slave-backup innobackupex option.

**no-lock** = yes | no (default: no)

    Whether to enable the --no-lock innobackupex option

**tmpdir** = <path> (default: ``${backup_directory}``)

    The path for the innobackupex --tmpdir option.

**additional-options** = <option>[, <option>...]

    A list of additional options to pass to innobackupex.  This is a comma
    separated list of options.

**pre-command** = <command-string>

    A command to run prior to running this mariabackup run.  This can be used,
    for instance, to generate a mysqldump schema dump prior to running
    mariabackup.  instances of ${backup_directory} and ${backupdir} will be replaced with the
    current holland backup directory where the mariabackup data will be stored.

.. include:: compression.txt

.. include:: mysqlconfig.txt
