diff --git a/man/CMakeLists.txt b/man/CMakeLists.txt index 5570557d3b2..5f85eb950ab 100644 --- a/man/CMakeLists.txt +++ b/man/CMakeLists.txt @@ -1,14 +1,14 @@ # Copyright (c) 2012, 2020, MariaDB -# +# # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; version 2 of the License. -# +# # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. -# +# # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1335 USA @@ -26,7 +26,7 @@ SET(MAN1_SERVER innochecksum.1 my_print_defaults.1 myisam_ftdump.1 myisamchk.1 mysqld_safe_helper.1 wsrep_sst_common.1 wsrep_sst_mysqldump.1 wsrep_sst_rsync.1 galera_recovery.1 galera_new_cluster.1 - mysql_ldb.1 + mysql_ldb.1 myrocks_hotbackup.1 wsrep_sst_mariabackup.1 mbstream.1 mariabackup.1 wsrep_sst_rsync_wan.1) SET(MAN8_SERVER mysqld.8) diff --git a/man/myrocks_hotbackup.1 b/man/myrocks_hotbackup.1 new file mode 100644 index 00000000000..4784239c689 --- /dev/null +++ b/man/myrocks_hotbackup.1 @@ -0,0 +1,82 @@ +.TH MYROCKS_HOTBACKUP "1" "March 2020" "MariaDB 10\&.5" "MariaDB Database System" +.SH NAME +myrocks_hotbackup \- streaming backup for MariaDB MyRocks +.SH DESCRIPTION +Usage: +.PP +Backup: set \fB\-o\fR pipefail; myrocks_hotbackup \fB\-\-user\fR=\fI\,root\/\fR \fB\-\-password\fR=\fI\,pw\/\fR \fB\-\-port\fR=\fI\,3306\/\fR \fB\-\-checkpoint_dir=\fR | ssh \fB\-o\fR NoneEnabled=yes remote_server 'tar \fB\-xi\fR \fB\-C\fR ' . You need to execute backup command on a server where you take backups. +.PP +Backup using WDT: myrocks_hotbackup \fB\-\-user\fR=\fI\,root\/\fR \fB\-\-password\fR=\fI\,pw\/\fR \fB\-\-stream\fR=\fI\,wdt\/\fR \fB\-\-checkpoint_dir=\fR \fB\-\-destination=\fR \fB\-\-backup_dir=\fR. This has to be executed at the src host. +.PP +Move\-Back: myrocks_hotbackup \fB\-\-move_back\fR \fB\-\-datadir=\fR \fB\-\-rocksdb_datadir=\fR \fB\-\-rocksdb_waldir=\fR \fB\-\-backup_dir=\fR . You need to execute move\-back command on a server where backup files are sent. +.SH OPTIONS +.TP +\fB\-h\fR, \fB\-\-help\fR +show this help message and exit +.TP +\fB\-i\fR CHECKPOINT_INTERVAL, \fB\-\-interval\fR=\fI\,CHECKPOINT_INTERVAL\/\fR +Number of seconds to renew checkpoint +.TP +\fB\-c\fR CHECKPOINT_DIRECTORY, \fB\-\-checkpoint_dir\fR=\fI\,CHECKPOINT_DIRECTORY\/\fR +Local directory name where checkpoints will be +created. +.TP +\fB\-d\fR DATADIR, \fB\-\-datadir\fR=\fI\,DATADIR\/\fR +backup mode: src MySQL datadir. move_back mode: dest +MySQL datadir +.TP +\fB\-s\fR OUTPUT_STREAM, \fB\-\-stream\fR=\fI\,OUTPUT_STREAM\/\fR +Setting streaming backup options. Currently tar, WDT +and xbstream are supported. Default is tar +.TP +\fB\-\-destination\fR=\fI\,DESTINATION\/\fR +Remote server name. Only used for WDT mode so far. +.TP +\fB\-\-avg_mbytes_per_sec\fR=\fI\,AVG_MBYTES_PER_SEC\/\fR +Average backup rate in MBytes/sec. WDT only. +.TP +\fB\-\-extra_wdt_sender_options\fR=\fI\,EXTRA_WDT_SENDER_OPTIONS\/\fR +Extra options for WDT sender +.TP +\fB\-\-extra_wdt_receiver_options\fR=\fI\,EXTRA_WDT_RECEIVER_OPTIONS\/\fR +Extra options for WDT receiver +.TP +\fB\-u\fR MYSQL_USER, \fB\-\-user\fR=\fI\,MYSQL_USER\/\fR +MySQL user name +.TP +\fB\-p\fR MYSQL_PASSWORD, \fB\-\-password\fR=\fI\,MYSQL_PASSWORD\/\fR +MySQL password name +.TP +\fB\-P\fR MYSQL_PORT, \fB\-\-port\fR=\fI\,MYSQL_PORT\/\fR +MySQL port number +.TP +\fB\-S\fR MYSQL_SOCKET, \fB\-\-socket\fR=\fI\,MYSQL_SOCKET\/\fR +MySQL socket path. Takes precedence over \fB\-\-port\fR. +.TP +\fB\-m\fR, \fB\-\-move_back\fR +Moving MyRocks backup files to proper locations. +.TP +\fB\-r\fR ROCKSDB_DATADIR, \fB\-\-rocksdb_datadir\fR=\fI\,ROCKSDB_DATADIR\/\fR +RocksDB target data directory where backup data files +will be moved. Must be empty. +.TP +\fB\-w\fR ROCKSDB_WALDIR, \fB\-\-rocksdb_waldir\fR=\fI\,ROCKSDB_WALDIR\/\fR +RocksDB target data directory where backup wal files +will be moved. Must be empty. +.TP +\fB\-b\fR BACKUPDIR, \fB\-\-backup_dir\fR=\fI\,BACKUPDIR\/\fR +backup mode for WDT: Remote directory to store backup. +move_back mode: Locations where backup files are +stored. +.TP +\fB\-f\fR, \fB\-\-skip_check_frm_timestamp\fR +skipping to check if frm files are updated after +starting backup. +.TP +\fB\-D\fR DEBUG_SIGNAL_FILE, \fB\-\-debug_signal_file\fR=\fI\,DEBUG_SIGNAL_FILE\/\fR +debugging purpose: waiting until the specified file is +created +.SH "SEE ALSO" +For more information, please refer to the MariaDB Knowledge Base, available online at https://mariadb.com/kb/ +.SH AUTHOR +MariaDB Foundation (http://www.mariadb.org/).