Merge lp:~hrvojem/percona-xtrabackup/bug1066978-2.1 into lp:percona-xtrabackup/2.1

Proposed by Hrvoje Matijakovic
Status: Merged
Approved by: Alexey Kopytov
Approved revision: no longer in the source branch.
Merged at revision: 455
Proposed branch: lp:~hrvojem/percona-xtrabackup/bug1066978-2.1
Merge into: lp:percona-xtrabackup/2.1
Diff against target: 408 lines (+126/-115)
9 files modified
BUILD.txt (+1/-2)
doc/Makefile (+1/-1)
doc/source/innobackupex/innobackupex_option_reference.rst (+110/-90)
doc/source/installation/compiling_xtrabackup.rst (+4/-9)
doc/source/percona-theme/layout.html (+1/-8)
doc/source/release-notes/2.0/2.0.3.rst (+1/-1)
doc/source/xtrabackup_bin/configuring.rst (+1/-1)
innobackupex (+6/-2)
utils/build.sh (+1/-1)
To merge this branch: bzr merge lp:~hrvojem/percona-xtrabackup/bug1066978-2.1
Reviewer Review Type Date Requested Status
Alexey Kopytov (community) Approve
Review via email: mp+135200@code.launchpad.net
To post a comment you must log in.
Revision history for this message
Alexey Kopytov (akopytov) wrote :

Everything looks good, except a couple of 2.1-specific things:

- The 2.1 MP should have "lp:percona-xtrabackup/2.1" instead of
"lp:percona-xtrabackup/2.0" in compiling_xtrabackup.rst.

- --remote-host was removed in 2.1, so it shouldn't be mentioned in
    innobackupex help

review: Needs Fixing
Revision history for this message
Alexey Kopytov (akopytov) wrote :

Text conflict in doc/source/innobackupex/innobackupex_option_reference.rst
Text conflict in utils/build.sh

review: Needs Fixing
Revision history for this message
Alexey Kopytov (akopytov) wrote :

hmm, not sure what happened, but where did the "rearrange alphabetically" changes go?

and this one is probably unintentional:

=== modified file 'utils/build.sh' (properties changed: +x to -x)

Revision history for this message
Alexey Kopytov (akopytov) :
review: Approve

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
=== modified file 'BUILD.txt'
--- BUILD.txt 2012-06-04 10:29:26 +0000
+++ BUILD.txt 2012-11-22 09:58:24 +0000
@@ -30,8 +30,7 @@
30 ================== ========= =============================================30 ================== ========= =============================================
31 Value Alias Server31 Value Alias Server
32 ================== ========= =============================================32 ================== ========= =============================================
33 innodb51_builtin 5.1 build against built-in InnoDB in MySQL 5.133 innodb51 plugin build against InnoDB plugin in MySQL 5.1
34 innodb51 plugin build agsinst InnoDB plugin in MySQL 5.1
35 innodb55 5.5 build against InnoDB in MySQL 5.534 innodb55 5.5 build against InnoDB in MySQL 5.5
36 xtradb51 xtradb build against Percona Server with XtraDB 5.135 xtradb51 xtradb build against Percona Server with XtraDB 5.1
37 xtradb55 xtradb55 build against Percona Server with XtraDB 5.536 xtradb55 xtradb55 build against Percona Server with XtraDB 5.5
3837
=== modified file 'doc/Makefile'
--- doc/Makefile 2012-08-03 12:12:02 +0000
+++ doc/Makefile 2012-11-22 09:58:24 +0000
@@ -38,7 +38,7 @@
3838
39html:39html:
40 @echo "Downloading percona-theme ..."40 @echo "Downloading percona-theme ..."
41 @wget -O percona-theme.tar.gz http://percona.com/docs/theme/percona-xtrabackup/2.041 @wget -O percona-theme.tar.gz http://percona.com/docs/theme/percona-xtrabackup/2.1
42 @echo "Extracting theme."42 @echo "Extracting theme."
43 @tar -zxf percona-theme.tar.gz43 @tar -zxf percona-theme.tar.gz
44 @rm -rf source/percona-theme44 @rm -rf source/percona-theme
4545
=== modified file 'doc/source/innobackupex/innobackupex_option_reference.rst'
--- doc/source/innobackupex/innobackupex_option_reference.rst 2012-11-13 05:25:19 +0000
+++ doc/source/innobackupex/innobackupex_option_reference.rst 2012-11-22 09:58:24 +0000
@@ -10,106 +10,69 @@
10Options10Options
11=======11=======
1212
13.. option:: --help
14
15 This option displays a help screen and exits.
16
17.. option:: --version
18
19 This option displays the |innobackupex| version and copyright notice and then exits.
20
21.. option:: --apply-log13.. option:: --apply-log
2214
23 Prepare a backup in ``BACKUP-DIR`` by applying the transaction log file named :file:`xtrabackup_logfile` located in the same directory. Also, create new transaction logs. The InnoDB configuration is read from the file :file:`backup-my.cnf` created by |innobackupex| when the backup was made.15 Prepare a backup in ``BACKUP-DIR`` by applying the transaction log file named :file:`xtrabackup_logfile` located in the same directory. Also, create new transaction logs. The InnoDB configuration is read from the file :file:`backup-my.cnf` created by |innobackupex| when the backup was made.
2416
25.. option:: --redo-only17.. option:: --compact
2618
27 This option is passed directly to xtrabackup's :option:`xtrabackup --apply-log-only` option. This forces :program:`xtrabackup` to skip the "rollback" phase and do a "redo" only. This is necessary if the backup will have incremental changes applied to it later. See the |xtrabackup| :doc:`documentation <../xtrabackup_bin/incremental_backups>` for details.19 Create a compact backup with all secondary index pages omitted. This option is passed directly to xtrabackup. See the :program:`xtrabackup` :doc:`documentation <../xtrabackup_bin/xtrabackup_binary>` for details.
20
21.. option:: --compress
22
23 This option instructs xtrabackup to compress backup copies of InnoDB data files. It is passed directly to the xtrabackup child process. See the :program:`xtrabackup` :doc:`documentation <../xtrabackup_bin/xtrabackup_binary>` for details.
24
25.. option:: --compress-threads
26
27 This option specifies the number of worker threads that will be used for parallel compression. It is passed directly to the xtrabackup child process. See the :program:`xtrabackup` :doc:`documentation <../xtrabackup_bin/xtrabackup_binary>` for details.
2828
29.. option:: --copy-back29.. option:: --copy-back
3030
31 Copy all the files in a previously made backup from the backup directory to their original locations.31 Copy all the files in a previously made backup from the backup directory to their original locations.
3232
33.. option:: --move-back33.. option:: --databases=LIST
3434
35 Move all the files in a previously made backup from the backup directory to their original locations. As this option removes backup files, it must be used with caution.35 This option specifies the list of databases that |innobackupex| should back up. The option accepts a string argument or path to file that contains the list of databases to back up. The list is of the form "databasename1[.table_name1] databasename2[.table_name2] . . .". If this option is not specified, all databases containing |MyISAM| and |InnoDB| tables will be backed up. Please make sure that --databases contains all of the |InnoDB| databases and tables, so that all of the innodb.frm files are also backed up. In case the list is very long, this can be specified in a file, and the full path of the file can be specified instead of the list. (See option --tables-file.)
36
37.. option:: --include=REGEXP
38
39 This option is a regular expression to be matched against table names in ``databasename.tablename`` format. It is passed directly to :program:`xtrabackup` 's :option:`xtrabackup --tables` option. See the :program:`xtrabackup` documentation for details.
4036
41.. option:: --defaults-file=[MY.CNF]37.. option:: --defaults-file=[MY.CNF]
4238
43 This option accepts a string argument that specifies what file to read the default MySQL options from. It is also passed directly to :program:`xtrabackup` 's defaults-file option. See the :program:`xtrabackup` :doc:`documentation <../xtrabackup_bin/xtrabackup_binary>` for details.39 This option accepts a string argument that specifies what file to read the default MySQL options from. It is also passed directly to :program:`xtrabackup` 's defaults-file option. See the :program:`xtrabackup` :doc:`documentation <../xtrabackup_bin/xtrabackup_binary>` for details.
4440
45.. option:: --databases=LIST41.. option:: --defaults-group=GROUP-NAME
4642
47 This option specifies the list of databases that |innobackupex| should back up. The option accepts a string argument or path to file that contains the list of databases to back up. The list is of the form "databasename1[.table_name1] databasename2[.table_name2] . . .". If this option is not specified, all databases containing |MyISAM| and |InnoDB| tables will be backed up. Please make sure that --databases contains all of the |InnoDB| databases and tables, so that all of the innodb.frm files are also backed up. In case the list is very long, this can be specified in a file, and the full path of the file can be specified instead of the list. (See option --tables-file.)43 This option accepts a string argument that specifies the group which should be read from the configuration file. This is needed if you use mysqld_multi.
48
49.. option:: --tables-file
50
51 This option accepts a string argument that specifies the file in which there are a list of names of the form ``database.table``, one per line. The option is passed directly to :program:`xtrabackup` 's :option:`--tables-file` option.
52
53.. option:: --throttle
54
55 This option accepts an integer argument that specifies the number of I/O operations (i.e., pairs of read+write) per second. It is passed directly to xtrabackup's :option:`xtrabackup --throttle` option.
5644
57.. option:: --export45.. option:: --export
5846
59 This option is passed directly to :option:`xtrabackup --export` option. It enables exporting individual tables for import into another server. See the |xtrabackup| documentation for details.47 This option is passed directly to :option:`xtrabackup --export` option. It enables exporting individual tables for import into another server. See the |xtrabackup| documentation for details.
6048
61.. option:: --use-memory49.. option:: --extra-lsndir=DIRECTORY
6250
63 This option accepts a string argument that specifies the amount of memory in bytes for :program:`xtrabackup` to use for crash recovery while preparing a backup. Multiples are supported providing the unit (e.g. 1MB, 1GB). It is used only with the option :option:`--apply-log`. It is passed directly to |xtrabackup| 's :option:`xtrabackup --use-memory` option. See the |xtrabackup| documentation for details.51 This option accepts a string argument that specifies the directory in which to save an extra copy of the :file:`xtrabackup_checkpoints` file. It is passed directly to |xtrabackup|'s :option:`--extra-lsndir` option. See the :program:`xtrabackup` documentation for details.
6452
65.. option:: --password=PASSWORD53.. option:: --galera-info
6654
67 This option accepts a string argument specifying the password to use when connecting to the database. It is passed to the :command:`mysql` child process without alteration. See :command:`mysql --help` for details.55 This options creates the ``xtrabackup_galera_info`` file which contains the local node state at the time of the backup. Option should be used when performing the backup of Percona-XtraDB-Cluster.
6856
69.. option:: --user=USER57.. option:: --help
7058
71 This option accepts a string argument that specifies the user (i.e., the *MySQL* username used when connecting to the server) to login as, if that's not the current user. It is passed to the mysql child process without alteration. See :command:`mysql --help` for details.59 This option displays a help screen and exits.
72
73.. option:: --port=PORT
74
75 This option accepts a string argument that specifies the port to use when connecting to the database server with TCP/IP. It is passed to the :command:`mysql` child process. It is passed to the :command:`mysql` child process without alteration. See :command:`mysql --help` for details.
76
77.. option:: --defaults-group
78
79 This option accepts a string argument that specifies the group which should be read from the configuration file. This is needed if you use mysqld_multi.
80
81.. option:: --socket
82
83 This option accepts a string argument that specifies the socket to use when connecting to the local database server with a UNIX domain socket. It is passed to the mysql child process without alteration. See :command:`mysql --help` for details.
8460
85.. option:: --host=HOST61.. option:: --host=HOST
8662
87 This option accepts a string argument that specifies the host to use when connecting to the database server with TCP/IP. It is passed to the mysql child process without alteration. See :command:`mysql --help` for details.63 This option accepts a string argument that specifies the host to use when connecting to the database server with TCP/IP. It is passed to the mysql child process without alteration. See :command:`mysql --help` for details.
8864
89.. option:: --no-timestamp65.. option:: --ibbackup=IBBACKUP-BINARY
9066
91 This option prevents creation of a time-stamped subdirectory of the ``BACKUP-ROOT-DIR`` given on the command line. When it is specified, the backup is done in ``BACKUP-ROOT-DIR`` instead.67 This option accepts a string argument that specifies which |xtrabackup| binary should be used. The string should be the command used to run *XtraBackup*. The option can be useful if the :program:`xtrabackup` binary is not in your search path or working directory and the database server is not accessible at the moment. If this option is not specified, :program:`innobackupex` attempts to determine the binary to use automatically. By default, :program:`xtrabackup` is the command used. When option :option:`--apply-log` is specified, the binary is used whose name is in the file :file:`xtrabackup_binary` in the backup directory, if that file exists, or will attempt to autodetect it. However, if :option:`--copy-back` or :option:`--move-back` is used, :program:`xtrabackup` is used unless other is specified.
9268
93.. option:: --galera-info69.. option:: --include=REGEXP
9470
95 This options creates the ``xtrabackup_galera_info`` file which contains the local node state at the time of the backup. Option should be used when performing the backup of Percona-XtraDB-Cluster.71 This option is a regular expression to be matched against table names in ``databasename.tablename`` format. It is passed directly to |xtrabackup|'s :option:`xtrabackup --tables` option. See the :program:`xtrabackup` documentation for details.
96
97.. option:: --slave-info
98
99 This option is useful when backing up a replication slave server. It prints the binary log position and name of the master server. It also writes this information to the :file:`xtrabackup_slave_info` file as a ``CHANGE MASTER`` command. A new slave for this master can be set up by starting a slave server on this backup and issuing a ``CHANGE MASTER`` command with the binary log position saved in the :file:`xtrabackup_slave_info` file.
100
101.. option:: --no-lock
102
103 Use this option to disable table lock with ``FLUSH TABLES WITH READ LOCK``. Use it only if ALL your tables are InnoDB and you **DO NOT CARE** about the binary log position of the backup.
104 If you are considering to use :option:`--no-lock` because your backups are failing to acquire the lock, this could be because of incoming replication events preventing the lock from succeeding. Please try using :option:`--safe-slave-backup` to momentarily stop the replication slave thread, this may help the backup to succeed and you then don't need to resort to using :option:`--no-lock`.
105
106.. option:: --ibbackup = 'autodetect'
107
108 This option accepts a string argument that specifies which xtrabackup binary should be used. The string should be the command used to run *XtraBackup*. The option can be useful if the :program:`xtrabackup` binary is not in your search path or working directory and the database server is not accessible at the moment. If this option is not specified, :program:`innobackupex` attempts to determine the binary to use automatically. By default, :program:`xtrabackup` is the command used. When option :option:`--apply-log` is specified, the binary is used whose name is in the file :file:`xtrabackup_binary` in the backup directory, if that file exists, or will attempt to autodetect it. However, if :option:`--copy-back` or :option:`--move-back` is used, :program:`xtrabackup` is used unless other is specified.
10972
110.. option:: --incremental73.. option:: --incremental
11174
112 This option tells :program:`xtrabackup` to create an incremental backup, rather than a full one. It is passed to the :program:`xtrabackup` child process. When this option is specified, either :option:`--incremental-lsn` or :option:`--incremental-basedir` can also be given. If neither option is given, option :option:`--incremental-basedir` is passed to :program:`xtrabackup` by default, set to the first timestamped backup directory in the backup base directory.75 This option tells |xtrabackup| to create an incremental backup, rather than a full one. It is passed to the |xtrabackup| child process. When this option is specified, either :option:`--incremental-lsn` or :option:`--incremental-basedir` can also be given. If neither option is given, option :option:`--incremental-basedir` is passed to :program:`xtrabackup` by default, set to the first timestamped backup directory in the backup base directory.
11376
114.. option:: --incremental-basedir=DIRECTORY77.. option:: --incremental-basedir=DIRECTORY
11578
@@ -121,23 +84,40 @@
12184
122.. option:: --incremental-lsn85.. option:: --incremental-lsn
12386
124 This option accepts a string argument that specifies the log sequence number (:term:`LSN`) to use for the incremental backup. It is used with the :option:`--incremental` option. It is used instead of specifying :option:`--incremental-basedir`. For databases created by *MySQL* and *Percona Server* 5.0-series versions, specify the as two 32-bit integers in high:low format. For databases created in 5.1 and later, specify the LSN as a single 64-bit integer. 87 This option accepts a string argument that specifies the log sequence number (:term:`LSN`) to use for the incremental backup. It is used with the :option:`--incremental` option. It is used instead of specifying :option:`--incremental-basedir`. For databases created by *MySQL* and *Percona Server* 5.0-series versions, specify the as two 32-bit integers in high:low format. For databases created in 5.1 and later, specify the LSN as a single 64-bit integer.
12588
126.. option:: --extra-lsndir=DIRECTORY89.. option:: --move-back
12790
128 This option accepts a string argument that specifies the directory in which to save an extra copy of the :file:`xtrabackup_checkpoints` file. It is passed directly to |xtrabackup|'s :option:`--extra-lsndir` option. See the :program:`xtrabackup` documentation for details.91 Move all the files in a previously made backup from the backup directory to their original locations. As this option removes backup files, it must be used with caution.
12992
130.. option:: --stream=STREAMNAME93.. option:: --no-lock
13194
132 This option accepts a string argument that specifies the format in which to do the streamed backup. The backup will be done to ``STDOUT`` in the specified format. Currently, supported formats are `tar` and `xbstream`. Uses :doc:`xbstream <../xbstream/xbstream>`, which is available in *XtraBackup* distributions. If you specify a path after this option, it will be interpreted as the value of :option:`tmpdir`.95 Use this option to disable table lock with ``FLUSH TABLES WITH READ LOCK``. Use it only if ALL your tables are InnoDB and you **DO NOT CARE** about the binary log position of the backup.
13396 If you are considering to use :option:`--no-lock` because your backups are failing to acquire the lock, this could be because of incoming replication events preventing the lock from succeeding. Please try using :option:`--safe-slave-backup` to momentarily stop the replication slave thread, this may help the backup to succeed and you then don't need to resort to using :option:`--no-lock`
134.. option:: --tmpdir=DIRECTORY97
13598.. option:: --no-timestamp
136 This option accepts a string argument that specifies the location where a temporary file will be stored. It should be used when :option:`--stream` is specified. For these options, the transaction log will first be stored to a temporary file, before streaming. This option specifies the location where that temporary file will be stored. If the option is not specifed, the default is to use the value of ``tmpdir`` read from the server configuration.99
100 This option prevents creation of a time-stamped subdirectory of the ``BACKUP-ROOT-DIR`` given on the command line. When it is specified, the backup is done in ``BACKUP-ROOT-DIR`` instead.
137101
138.. option:: --parallel=NUMBER-OF-THREADS102.. option:: --parallel=NUMBER-OF-THREADS
139103
140 This option accepts an integer argument that specifies the number of threads the :program:`xtrabackup` child process should use to back up files concurrently. Note that this option works on file level, that is, if you have several .ibd files, they will be copied in parallel. If you have just single big .ibd file, it will have no effect. It is passed directly to xtrabackup's :option:`xtrabackup --parallel` option. See the :program:`xtrabackup` documentation for details.104 This option accepts an integer argument that specifies the number of threads the :program:`xtrabackup` child process should use to back up files concurrently. Note that this option works on file level, that is, if you have several .ibd files, they will be copied in parallel. If you have just single big .ibd file, it will have no effect. It is passed directly to xtrabackup's :option:`xtrabackup --parallel` option. See the :program:`xtrabackup` documentation for details
105
106.. option:: --password=PASSWORD
107
108 This option accepts a string argument specifying the password to use when connecting to the database. It is passed to the :command:`mysql` child process without alteration. See :command:`mysql --help` for details.
109
110.. option:: --port=PORT
111
112 This option accepts a string argument that specifies the port to use when connecting to the database server with TCP/IP. It is passed to the :command:`mysql` child process. It is passed to the :command:`mysql` child process without alteration. See :command:`mysql --help` for details.
113
114.. option:: --redo-only
115
116 This option is passed directly to xtrabackup's :option:`xtrabackup --apply-log-only` option. This forces :program:`xtrabackup` to skip the "rollback" phase and do a "redo" only. This is necessary if the backup will have incremental changes applied to it later. See the |xtrabackup| :doc:`documentation <../xtrabackup_bin/incremental_backups>` for details.
117
118.. option:: --rsync
119
120 Uses the :program:`rsync` utility to optimize local file transfers. When this option is specified, :program:`innobackupex` uses :program:`rsync` to copy all non-InnoDB files instead of spawning a separate :program:`cp` for each file, which can be much faster for servers with a large number of databases or tables. This option cannot be used together with :option:`--stream`.
141121
142.. option:: --safe-slave-backup122.. option:: --safe-slave-backup
143123
@@ -147,6 +127,46 @@
147127
148 How many seconds :option:`--safe-slave-backup`` should wait for ``Slave_open_temp_tables`` to become zero. Defaults to 300 seconds.128 How many seconds :option:`--safe-slave-backup`` should wait for ``Slave_open_temp_tables`` to become zero. Defaults to 300 seconds.
149129
150.. option:: --rsync130.. option:: --scpopt = SCP-OPTIONS
151131
152 Use the :program:`rsync` utility to optimize local file transfers. When this option is specified, :program:`innobackupex` uses :program:`rsync` to copy all non-InnoDB files instead of spawning a separate :program:`cp` for each file, which can be much faster for servers with a large number of databases or tables. This option cannot be used together with :option:`--stream`.132 This option accepts a string argument that specifies the command line options to pass to :command:`scp` when the option :option:`--remost-host` is specified. If the option is not specified, the default options are ``-Cp -c arcfour``.
133
134.. option:: --sshopt = SSH-OPTIONS
135
136 This option accepts a string argument that specifies the command line options to pass to :command:`ssh` when the option :option:`--remost-host` is specified.
137
138.. option:: --slave-info
139
140 This option is useful when backing up a replication slave server. It prints the binary log position and name of the master server. It also writes this information to the :file:`xtrabackup_slave_info` file as a ``CHANGE MASTER`` command. A new slave for this master can be set up by starting a slave server on this backup and issuing a ``CHANGE MASTER`` command with the binary log position saved in the :file:`xtrabackup_slave_info` file.
141
142.. option:: --socket
143
144 This option accepts a string argument that specifies the socket to use when connecting to the local database server with a UNIX domain socket. It is passed to the mysql child process without alteration. See :command:`mysql --help` for details.
145
146.. option:: --stream=STREAMNAME
147
148 This option accepts a string argument that specifies the format in which to do the streamed backup. The backup will be done to ``STDOUT`` in the specified format. Currently, supported formats are `tar` and `xbstream`. Uses :doc:`xbstream <../xbstream/xbstream>`, which is available in *XtraBackup* distributions. If you specify a path after this option, it will be interpreted as the value of :option:`tmpdir`
149
150.. option:: --tables-file=FILE
151
152 This option accepts a string argument that specifies the file in which there are a list of names of the form ``database.table``, one per line. The option is passed directly to :program:`xtrabackup` 's :option:`--tables-file` option.
153
154.. option:: --throttle=IOS
155
156 This option accepts an integer argument that specifies the number of I/O operations (i.e., pairs of read+write) per second. It is passed directly to xtrabackup's :option:`xtrabackup --throttle` option.
157
158.. option:: --tmpdir=DIRECTORY
159
160 This option accepts a string argument that specifies the location where a temporary file will be stored. It should be used when :option:`--stream` is specified. For these options, the transaction log will first be stored to a temporary file, before streaming or copying to a remote host. This option specifies the location where that temporary file will be stored. If the option is not specified, the default is to use the value of ``tmpdir`` read from the server configuration.
161
162.. option:: --use-memory
163
164 This option accepts a string argument that specifies the amount of memory in bytes for :program:`xtrabackup` to use for crash recovery while preparing a backup. Multiples are supported providing the unit (e.g. 1MB, 1GB). It is used only with the option :option:`--apply-log`. It is passed directly to |xtrabackup| 's :option:`xtrabackup --use-memory` option. See the |xtrabackup| documentation for details.
165
166.. option:: --user=USER
167
168 This option accepts a string argument that specifies the user (i.e., the *MySQL* username used when connecting to the server) to login as, if that's not the current user. It is passed to the mysql child process without alteration. See :command:`mysql --help` for details.
169
170.. option:: --version
171
172 This option displays the |innobackupex| version and copyright notice and then exits.
153173
=== modified file 'doc/source/installation/compiling_xtrabackup.rst'
--- doc/source/installation/compiling_xtrabackup.rst 2012-06-04 10:29:26 +0000
+++ doc/source/installation/compiling_xtrabackup.rst 2012-11-22 09:58:24 +0000
@@ -4,11 +4,7 @@
44
5The source code is available from the *Launchpad* project `here <https://launchpad.net/percona-xtrabackup>`_. The easiest way to get the code is with :command:`bzr branch` of the desired release, such as the following: ::5The source code is available from the *Launchpad* project `here <https://launchpad.net/percona-xtrabackup>`_. The easiest way to get the code is with :command:`bzr branch` of the desired release, such as the following: ::
66
7 bzr branch lp:percona-xtrabackup/1.67 bzr branch lp:percona-xtrabackup/2.0
8
9or ::
10
11 bzr branch lp:percona-xtrabackup
128
13You should then have a directory named after the release you branched, such as ``percona-xtrabackup``.9You should then have a directory named after the release you branched, such as ``percona-xtrabackup``.
1410
@@ -23,8 +19,8 @@
2319
24In Debian-based distributions, you need to: ::20In Debian-based distributions, you need to: ::
2521
26 $ apt-get install build-essential flex bison automake autoconf bzr \22 $ apt-get install debhelper autotools-dev libaio-dev wget automake \
27 libtool cmake libaio-dev mysql-client libncurses-dev zlib1g-dev23 libtool bison libncurses-dev libz-dev cmake bzr
2824
29In ``RPM``-based distributions, you need to: ::25In ``RPM``-based distributions, you need to: ::
3026
@@ -41,8 +37,7 @@
41 ================== ========= ============================================37 ================== ========= ============================================
42 Value Alias Server38 Value Alias Server
43 ================== ========= ============================================39 ================== ========= ============================================
44 innodb51_builtin 5.1 build against built-in InnoDB in MySQL 5.140 innodb51 plugin build against InnoDB plugin in MySQL 5.1
45 innodb51 plugin build agsinst InnoDB plugin in MySQL 5.1
46 innodb55 5.5 build against InnoDB in MySQL 5.541 innodb55 5.5 build against InnoDB in MySQL 5.5
47 xtradb51 xtradb build against Percona Server with XtraDB 5.142 xtradb51 xtradb build against Percona Server with XtraDB 5.1
48 xtradb55 xtradb55 build against Percona Server with XtraDB 5.543 xtradb55 xtradb55 build against Percona Server with XtraDB 5.5
4944
=== modified file 'doc/source/percona-theme/layout.html'
--- doc/source/percona-theme/layout.html 2012-09-19 11:35:43 +0000
+++ doc/source/percona-theme/layout.html 2012-11-22 09:58:24 +0000
@@ -74,14 +74,7 @@
74 </div>74 </div>
75 </div>75 </div>
7676
77 <div class="side-column-block">77
78 <div class="a-btn-container">
79 <a title="Download PDF Manual for Percona XtraBackup 2.0" href="http://form.percona.com/Percona_XtraBackup_2_0_Operations_Manual.html" class="a-btn-new">
80 <span class="a-btn-text">Download Manual</span>
81 <span class="a-btn-fixed-slide-text">PDF for version 2.0</span>
82 <span class="a-btn-icon-right"><span></span></span>
83 </a>
84 </div></div>
85 78
86 <div class="percona_com_ad" style="width:220px;"><script type="text/javascript" src="http://www.percona.com/ads.php?size=220x120"></script></div>79 <div class="percona_com_ad" style="width:220px;"><script type="text/javascript" src="http://www.percona.com/ads.php?size=220x120"></script></div>
87 80
8881
=== modified file 'doc/source/release-notes/2.0/2.0.3.rst'
--- doc/source/release-notes/2.0/2.0.3.rst 2012-10-01 09:22:03 +0000
+++ doc/source/release-notes/2.0/2.0.3.rst 2012-11-22 09:58:24 +0000
@@ -18,7 +18,7 @@
1818
19 * |XtraBackup| 2.0.2 was not backwards compatible which caused incremental backups created with previous versions to fail on prepare. Bug fixed :bug:`1038127` (*Sergei Glushchenko*).19 * |XtraBackup| 2.0.2 was not backwards compatible which caused incremental backups created with previous versions to fail on prepare. Bug fixed :bug:`1038127` (*Sergei Glushchenko*).
2020
21 * Fix for bug :bug:`1022562` introduced a regression that may potentially lead to a 5x increase in disk space occupied by incremental backups. Bug fixed :bug:`1028949` (*Laurynas Biveinis*).21 * Fix for bug :bug:`1022562` introduced a regression that may potentially lead to a 5x increase in disk space occupied by incremental backups. Bug fixed :bug:`1043762` (*Laurynas Biveinis*).
2222
23 * A regression was introduced in fix for bug :bug:`932623` which caused incorrect handling of compressed tablespaces with the page size of 16K, that were created between the last full or incremental and the next incremental backup. Bugs fixed :bug:`1049174` and :bug:`1044398` (*Laurynas Biveinis*).23 * A regression was introduced in fix for bug :bug:`932623` which caused incorrect handling of compressed tablespaces with the page size of 16K, that were created between the last full or incremental and the next incremental backup. Bugs fixed :bug:`1049174` and :bug:`1044398` (*Laurynas Biveinis*).
2424
2525
=== modified file 'doc/source/xtrabackup_bin/configuring.rst'
--- doc/source/xtrabackup_bin/configuring.rst 2011-07-07 05:32:50 +0000
+++ doc/source/xtrabackup_bin/configuring.rst 2012-11-22 09:58:24 +0000
@@ -3,7 +3,7 @@
33
4All of the |xtrabackup| configuration is done through options, which behave exactly like standard |MySQL| program options: they can be specified either at the command-line, or through a file such as :file:`/etc/my.cnf`.4All of the |xtrabackup| configuration is done through options, which behave exactly like standard |MySQL| program options: they can be specified either at the command-line, or through a file such as :file:`/etc/my.cnf`.
55
6The |xtrabackup| binary reads the ``[myslqd]`` and ``[xtrabackup]`` sections from any configuration files, in that order. That is so that it can read its options from your existing |MySQL| installation, such as the :term:`datadir` or some of the |InnoDB| options. If you want to override these, just specify them in the ``[xtrabackup]`` section, and because it is read later, it will take precedence.6The |xtrabackup| binary reads the ``[mysqld]`` and ``[xtrabackup]`` sections from any configuration files, in that order. That is so that it can read its options from your existing |MySQL| installation, such as the :term:`datadir` or some of the |InnoDB| options. If you want to override these, just specify them in the ``[xtrabackup]`` section, and because it is read later, it will take precedence.
77
8You don't need to put any configuration in your :file:`my.cnf` if you don't want to. You can simply specify the options on the command-line. Normally, the only thing you might find convenient to place in the ``[xtrabackup]`` section of your :file:`my.cnf` file is the ``target_dir`` option to default the directory in which the backups will be placed, for example,8You don't need to put any configuration in your :file:`my.cnf` if you don't want to. You can simply specify the options on the command-line. Normally, the only thing you might find convenient to place in the ``[xtrabackup]`` section of your :file:`my.cnf` file is the ``target_dir`` option to default the directory in which the backups will be placed, for example,
99
1010
=== modified file 'innobackupex'
--- innobackupex 2012-11-21 13:51:49 +0000
+++ innobackupex 2012-11-22 09:58:24 +0000
@@ -2769,6 +2769,10 @@
27692769
2770This option is passed directly to xtrabackup's --apply-log-only option. This forces xtrabackup to skip the "rollback" phase and do a "redo" only. This is necessary if the backup will have incremental changes applied to it later. See the xtrabackup documentation for details. 2770This option is passed directly to xtrabackup's --apply-log-only option. This forces xtrabackup to skip the "rollback" phase and do a "redo" only. This is necessary if the backup will have incremental changes applied to it later. See the xtrabackup documentation for details.
27712771
2772=item --rsync
2773
2774Uses the rsync utility to optimize local file transfers. When this option is specified, innobackupex uses rsync to copy all non-InnoDB files instead of spawning a separate cp for each file, which can be much faster for servers with a large number of databases or tables. This option cannot be used together with --stream.
2775
2772=item --safe-slave-backup2776=item --safe-slave-backup
27732777
2774Stop slave SQL thread and wait to start backup until Slave_open_temp_tables in "SHOW STATUS" is zero. If there are no open temporary tables, the backup will take place, otherwise the SQL thread will be started and stopped until there are no open temporary tables. The backup will fail if Slave_open_temp_tables does not become zero after --safe-slave-backup-timeout seconds. The slave SQL thread will be restarted when the backup finishes.2778Stop slave SQL thread and wait to start backup until Slave_open_temp_tables in "SHOW STATUS" is zero. If there are no open temporary tables, the backup will take place, otherwise the SQL thread will be started and stopped until there are no open temporary tables. The backup will fail if Slave_open_temp_tables does not become zero after --safe-slave-backup-timeout seconds. The slave SQL thread will be restarted when the backup finishes.
@@ -2785,7 +2789,7 @@
27852789
2786This option specifies the socket to use when connecting to the local database server with a UNIX domain socket. The option accepts a string argument. It is passed to the mysql child process without alteration. See mysql --help for details.2790This option specifies the socket to use when connecting to the local database server with a UNIX domain socket. The option accepts a string argument. It is passed to the mysql child process without alteration. See mysql --help for details.
27872791
2788=item --stream=[tar|. . .]2792=item --stream=STREAMNAME
27892793
2790This option specifies the format in which to do the streamed backup. The option accepts a string argument. The backup will be done to STDOUT in the specified format. Currently, the only supported formats are tar and xbstream. This option is passed directly to xtrabackup's --stream option.2794This option specifies the format in which to do the streamed backup. The option accepts a string argument. The backup will be done to STDOUT in the specified format. Currently, the only supported formats are tar and xbstream. This option is passed directly to xtrabackup's --stream option.
27912795
@@ -2799,7 +2803,7 @@
27992803
2800=item --tmpdir=DIRECTORY2804=item --tmpdir=DIRECTORY
28012805
2802This option specifies the location where a temporary file will be stored. The option accepts a string argument. It should be used when --stream is specified. For these options, the transaction log will first be stored to a temporary file, before streaming. This option specifies the location where that temporary file will be stored. If the option is not specifed, the default is to use the value of tmpdir read from the server configuration.2806This option specifies the location where a temporary file will be stored. The option accepts a string argument. It should be used when --stream is specified. For these options, the transaction log will first be stored to a temporary file, before streaming. This option specifies the location where that temporary file will be stored. If the option is not specified, the default is to use the value of tmpdir read from the server configuration.
28032807
2804=item --use-memory=B2808=item --use-memory=B
28052809
28062810
=== modified file 'utils/build.sh'
--- utils/build.sh 2012-11-14 01:02:10 +0000
+++ utils/build.sh 2012-11-22 09:58:24 +0000
@@ -43,7 +43,7 @@
43 echo43 echo
44 echo "Usage: `basename $0` CODEBASE"44 echo "Usage: `basename $0` CODEBASE"
45 echo "where CODEBASE can be one of the following values or aliases:"45 echo "where CODEBASE can be one of the following values or aliases:"
46 echo " innodb51 | plugin build agsinst InnoDB plugin in MySQL 5.1"46 echo " innodb51 | plugin build against InnoDB plugin in MySQL 5.1"
47 echo " innodb55 | 5.5 build against InnoDB in MySQL 5.5"47 echo " innodb55 | 5.5 build against InnoDB in MySQL 5.5"
48 echo " xtradb51 | xtradb build against Percona Server with XtraDB 5.1"48 echo " xtradb51 | xtradb build against Percona Server with XtraDB 5.1"
49 echo " xtradb55 | xtradb55 build against Percona Server with XtraDB 5.5"49 echo " xtradb55 | xtradb55 build against Percona Server with XtraDB 5.5"

Subscribers

People subscribed via source and target branches