Merge lp:~hrvojem/percona-xtradb-cluster/rn-5.5.34-25.9 into lp:percona-xtradb-cluster/percona-xtradb-cluster-5.5

Proposed by Hrvoje Matijakovic
Status: Merged
Approved by: Raghavendra D Prabhu
Approved revision: no longer in the source branch.
Merged at revision: 589
Proposed branch: lp:~hrvojem/percona-xtradb-cluster/rn-5.5.34-25.9
Merge into: lp:percona-xtradb-cluster/percona-xtradb-cluster-5.5
Diff against target: 256 lines (+91/-49)
10 files modified
doc-pxc/source/conf.py (+5/-5)
doc-pxc/source/errata.rst (+0/-4)
doc-pxc/source/howtos/kewpietests.rst (+0/-35)
doc-pxc/source/index.rst (+0/-1)
doc-pxc/source/installation.rst (+1/-1)
doc-pxc/source/installation/apt_repo.rst (+7/-1)
doc-pxc/source/installation/yum_repo.rst (+1/-1)
doc-pxc/source/manual/xtrabackup_sst.rst (+7/-0)
doc-pxc/source/release-notes/Percona-XtraDB-Cluster-5.5.34-25.9.rst (+68/-0)
doc-pxc/source/release-notes/release-notes_index.rst (+2/-1)
To merge this branch: bzr merge lp:~hrvojem/percona-xtradb-cluster/rn-5.5.34-25.9
Reviewer Review Type Date Requested Status
Raghavendra D Prabhu (community) Approve
Review via email: mp+197212@code.launchpad.net
To post a comment you must log in.
Revision history for this message
Raghavendra D Prabhu (raghavendra-prabhu) wrote :

Approved after discussion.

review: Approve
Revision history for this message
Raghavendra D Prabhu (raghavendra-prabhu) wrote :

Following need to be removed from errata:
=======================================================

wsrep_causal_reads being ON can introduce temporary stalls due to MDL lock conflicts.

bug #1226185: percona-xtrabackup-20 may get installed as a dependency instead of latest percona-xtrabackup during a fresh install due to certain yum issues. Workaround is documented here - https://bugs.launchpad.net/percona-xtradb-cluster/+bug/1226185/comments/2.

bug #1217426: When empty test directory is present on donor, it is not created on joiner, so when tables are created after SST on donor, the joiner later on will fail with inconsistency. Workaround is to either drop the test database or populate it with a table before SST. This is currently a limitation of Xtrabackup itself, hence, needs to be fixed there.

bug #1098566: innodb_data_home_dir is not supported. Depends on bug #1164945 for the fix.

589. By Hrvoje Matijakovic

- release notes for PXC-5.5.34-25.9
- removed kewpie because it isn't used anymore
- fixed bug #1255619
- errata update

Preview Diff

[H/L] Next/Prev Comment, [J/K] Next/Prev File, [N/P] Next/Prev Hunk
1=== modified file 'doc-pxc/source/conf.py'
2--- doc-pxc/source/conf.py 2013-09-16 10:28:41 +0000
3+++ doc-pxc/source/conf.py 2013-12-03 12:55:58 +0000
4@@ -53,9 +53,9 @@
5 # built documents.
6 #
7 # The short X.Y version.
8-version = '5.5.33'
9+version = '5.5.34'
10 # The full version, including alpha/beta/rc tags.
11-release = '5.5.33-23.7.6'
12+release = '5.5.34-25.9'
13
14 # The language for content autogenerated by Sphinx. Refer to documentation
15 # for a list of supported languages.
16@@ -168,10 +168,10 @@
17
18 # The name for this set of Sphinx documents. If None, it defaults to
19 # "<project> v<release> documentation".
20-html_title = 'Percona XtraDB Cluster Documentation'
21+html_title = 'Percona XtraDB Cluster 5.5 Documentation'
22
23 # A shorter title for the navigation bar. Default is the same as html_title.
24-html_short_title = 'XtraDB Cluster Docs'
25+html_short_title = 'Percona XtraDB Cluster 5.5 Documentation'
26
27 # The name of an image file (relative to this directory) to place at the top
28 # of the sidebar.
29@@ -244,7 +244,7 @@
30 # Grouping the document tree into LaTeX files. List of tuples
31 # (source start file, target name, title, author, documentclass [howto/manual]).
32 latex_documents = [
33- ('index', 'PerconaXtraDBCluster.tex', u'Percona XtraDB Cluster Documentation',
34+ ('index', 'PerconaXtraDBCluster-5.5.tex', u'Percona XtraDB Cluster 5.5 Documentation',
35 u'2012-2013, Percona LLC and/or its affiliates', 'manual'),
36 ]
37
38
39=== modified file 'doc-pxc/source/errata.rst'
40--- doc-pxc/source/errata.rst 2013-11-25 14:54:46 +0000
41+++ doc-pxc/source/errata.rst 2013-12-03 12:55:58 +0000
42@@ -8,12 +8,8 @@
43 -------------
44
45 Following are issues which may impact you while running PXC:
46- - wsrep_causal_reads being ON can introduce temporary stalls due to MDL lock conflicts.
47 - Create Table As Select (CTAS) can cause deadlocks and server hang when used with explicit TEMPORARY tables.
48- - bug :bug:`1226185`: percona-xtrabackup-20 may get installed as a dependency instead of latest percona-xtrabackup during a fresh install due to certain yum issues. Workaround is documented here - https://bugs.launchpad.net/percona-xtradb-cluster/+bug/1226185/comments/2.
49 - bug :bug:`1192834`: Joiner may crash after SST from donor with compaction enabled. Workaround is to disable the index compaction (compact under [xtrabackup]), if enabled. This crash requires specific configuration, hence you may not be affected. Also, this doesn't require any fix from PXC, but Xtrabackup with the fix included should do.
50- - bug :bug:`1217426`: When empty test directory is present on donor, it is not created on joiner, so when tables are created after SST on donor, the joiner later on will fail with inconsistency. Workaround is to either drop the test database or populate it with a table before SST. This is currently a limitation of Xtrabackup itself, hence, needs to be fixed there.
51- - bug :bug:`1098566`: :variable:`innodb_data_home_dir` is not supported. Depends on bug :bug:`1164945` for the fix.
52 - For Debian/Ubuntu users: |Percona XtraDB Cluster| :rn:`5.5.33-23.7.6` onwards has a new dependency, the ``socat`` package. If the ``socat`` is not previously installed, ``percona-xtradb-cluster-server-5.5`` may be held back. In order to upgrade, you need to either install ``socat`` before running the ``apt-get upgrade`` or with the following command: ``apt-get install percona-xtradb-cluster-server-5.5``. For *Ubuntu* users the ``socat`` package is in the universe repository, so the repository will have to be enabled in order to install the package.
53
54
55
56=== removed file 'doc-pxc/source/howtos/kewpietests.rst'
57--- doc-pxc/source/howtos/kewpietests.rst 2012-06-27 10:05:05 +0000
58+++ doc-pxc/source/howtos/kewpietests.rst 1970-01-01 00:00:00 +0000
59@@ -1,35 +0,0 @@
60-===========================
61-How to Execute Kewpie Tests
62-===========================
63-
64-To use kewpie for testing it's recommended to use `this MP <https://code.launchpad.net/~patrick-crews/percona-xtradb-cluster/qp-integrate/+merge/93648>`_. As it removes dbqp and integrates kewpie (and cuts size down to 25MB from 400+).
65-To execute tests:
66-
67-.. code-block:: bash
68-
69- cd kewpie ; ./kewpie.py [--force ] [--libeatmydata] [--wsrep-provider-path=...]
70-
71-The defaults are to run the cluster_basic and cluster_randgen suites against a 3 node cluster. Cluster_basic is used for small atomic tests like ADD/DROP single/multiple columns on a table and ensuring the change is replicated. cluster_randgen is used for high stress transactional loads. There are single and multi-threaded variants. The load is a mix of INSERT/UPDATE/DELETE/SELECT statements. This includes both regular transactions, single queries, ROLLBACK's and SAVEPOINTs, and a mix of good and bad SQL statements.
72-
73-To view all options, one may look at "./kewpie.py --help". Basic documentation is also available as sphinx docs in kewpie/docs folder. Here are the some of the most used options:
74-
75-.. option:: --force
76-
77- Run all tests despite failures (default is to stop test execution on first failure)
78-
79-.. option:: --libeatmydata
80-
81- Use libeatmydata if installed. This can greatly speed up testing in many cases. Can be used in conjunction with:
82-
83-.. option:: --libeatmydata-path to specify where the library is located.
84-
85-.. option:: --wsrep-provider-path
86-
87- By default, we expect / look for it in /usr/lib/galera/libgalera_smm.so (where it ends up via 'make install'...at least on Ubuntu). If one has an alternate library/location, specify it with this option.
88-
89-Any additional suites may be run this way:
90-
91-.. code-block:: bash
92-
93- ./kewpie.py [options] --suite=any/suitedir/from/kewpie/percona_tests
94- ./kewpie.py --suite=crashme
95
96=== modified file 'doc-pxc/source/index.rst'
97--- doc-pxc/source/index.rst 2013-09-17 12:05:56 +0000
98+++ doc-pxc/source/index.rst 2013-12-03 12:55:58 +0000
99@@ -86,7 +86,6 @@
100 howtos/3nodesec2
101 howtos/haproxy
102 howtos/virt_sandbox
103- howtos/kewpietests
104 howtos/bugreport
105
106 Reference
107
108=== modified file 'doc-pxc/source/installation.rst'
109--- doc-pxc/source/installation.rst 2013-11-22 03:47:13 +0000
110+++ doc-pxc/source/installation.rst 2013-12-03 12:55:58 +0000
111@@ -33,7 +33,7 @@
112
113 Once the repository is set up, use the following commands: ::
114
115- $ yum install Percona-XtraDB-Cluster-server Percona-XtraDB-Cluster-client
116+ $ yum install Percona-XtraDB-Cluster-server-55 Percona-XtraDB-Cluster-client-55 Percona-XtraDB-Cluster-galera-2
117
118 More detailed example of the |Percona XtraDB Cluster| installation and configuration can be seen in :ref:`centos_howto` tutorial.
119
120
121=== modified file 'doc-pxc/source/installation/apt_repo.rst'
122--- doc-pxc/source/installation/apt_repo.rst 2013-11-22 03:47:13 +0000
123+++ doc-pxc/source/installation/apt_repo.rst 2013-12-03 12:55:58 +0000
124@@ -48,7 +48,13 @@
125 Following command will install Cluster packages: ::
126
127 $ sudo apt-get install percona-xtradb-cluster-client-5.5 \
128- percona-xtradb-cluster-server-5.5 percona-xtrabackup percona-xtradb-cluster-galera-2.x
129+ percona-xtradb-cluster-server-5.5 percona-xtradb-cluster-galera-2.x
130+
131+.. note::
132+
133+ When doing the package upgrade on debian, you need to specify the all the packages or do the ``dist-upgrade``, otherwise some packages will be held back during the upgrade: ::
134+
135+ $ apt-get install percona-xtradb-cluster-galera-2.x percona-xtradb-cluster-server-5.5 percona-xtradb-cluster-client-5.5
136
137 Percona `apt` Experimental repository
138 =====================================
139
140=== modified file 'doc-pxc/source/installation/yum_repo.rst'
141--- doc-pxc/source/installation/yum_repo.rst 2013-03-12 09:32:01 +0000
142+++ doc-pxc/source/installation/yum_repo.rst 2013-12-03 12:55:58 +0000
143@@ -30,7 +30,7 @@
144
145 Following command will install Cluster packages: ::
146
147- $ yum install Percona-XtraDB-Cluster-server Percona-XtraDB-Cluster-client xtrabackup
148+ $ yum install Percona-XtraDB-Cluster-server-55 Percona-XtraDB-Cluster-client-55 Percona-XtraDB-Cluster-galera-2
149
150 Percona `yum` Experimental repository
151 =====================================
152
153=== modified file 'doc-pxc/source/manual/xtrabackup_sst.rst'
154--- doc-pxc/source/manual/xtrabackup_sst.rst 2013-11-04 12:43:19 +0000
155+++ doc-pxc/source/manual/xtrabackup_sst.rst 2013-12-03 12:55:58 +0000
156@@ -151,6 +151,13 @@
157
158 **NOTE:** This option can only be used when :variable:`wsrep_sst_method` is set to xtrabackup-v2.
159
160+.. option:: sst_special_dirs
161+
162+ :Values: 0,1
163+ :Default: 0
164+
165+In order for XtraBackup SST to support :variable:`innodb_data_home_dir` and :variable:`innodb_log_home_dir` variables in the configuration file this option was introduced in |Percona XtraDB Cluster| :rn:`5.5.34-25.9`. This requires sst-special-dirs to be set under [sst] in the configuration file to either 0 or 1. Also, :variable:`innodb-data-home-dir` and/or :variable:`innodb-log-group-home-dir` need to be defined in :file:`my.cnf` under [mysqld]. |Percona Xtrabackup| 2.1.6 or higher is required in order for this to work.
166+
167 .. _tar_ag_xbstream:
168
169 Tar against xbstream
170
171=== added file 'doc-pxc/source/release-notes/Percona-XtraDB-Cluster-5.5.34-25.9.rst'
172--- doc-pxc/source/release-notes/Percona-XtraDB-Cluster-5.5.34-25.9.rst 1970-01-01 00:00:00 +0000
173+++ doc-pxc/source/release-notes/Percona-XtraDB-Cluster-5.5.34-25.9.rst 2013-12-03 12:55:58 +0000
174@@ -0,0 +1,68 @@
175+.. rn:: 5.5.34-25.9
176+
177+======================================
178+ |Percona XtraDB Cluster| 5.5.34-25.9
179+======================================
180+
181+Percona is glad to announce the release of |Percona XtraDB Cluster| on December 3rd, 2013. Binaries are available from `downloads area <http://www.percona.com/downloads/Percona-XtraDB-Cluster/5.5.34-25.9/>`_ or from our :doc:`software repositories </installation>`.
182+
183+This is an General Availability release. We did our best to eliminate bugs and problems during the testing release, but this is a software, so bugs are expected. If you encounter them, please report them to our `bug tracking system <https://bugs.launchpad.net/percona-xtradb-cluster/+filebug>`_.
184+
185+
186+New Features
187+============
188+
189+ |Percona XtraDB Cluster| is now based on wsrep API 25 and Galera 25.2.x.
190+
191+ Limited support for Query Cache has been implemented. Query cache cannot still be fully enabled during the startup. To enable query cache, ``mysqld`` should be started with ``query_cache_type=1`` and ``query_cache_size=0`` and then query_cache_size should be changed to desired value during runtime.
192+
193+ ``RPM`` packages are now made `relocatable <http://rpm5.org/docs/api/relocatable.html>`_ which means they now support installation to custom prefixes.
194+
195+ XtraBackup SST now supports :variable:`innodb_data_home_dir` and :variable:`innodb_log_home_dir` in the configuration file.
196+
197+ The binaries are now statically linked with regard to ``Galera`` library which depended on ``OpenSSL`` library.
198+
199+Bugs fixed
200+==========
201+
202+ Product suffix has been added to the |Percona XtraDB Cluster| ``rpm`` packages, which means that packages have been renamed from ``Percona-XtraDB-Cluster-server`` to ``Percona-XtraDB-Cluster-server-55``. Bug fixed :bug:`1255616`.
203+
204+ Fixed the dependency issue which caused Percona XtraDB Cluster 5.5 installation to fail on *Ubuntu* 12.04. Bug fixed :bug:`1247861`.
205+
206+ When installing first ``Percona-XtraDB-Cluster-client`` and then ``Percona-XtraDB-Cluster-server`` on two single statements or a single statement with both packages , yum would install ``percona-xtrabackup-20`` instead ``percona-xtrabackup`` package as dependency of ``Percona-XtraDB-Cluster-server``. Bug fixed :bug:`1226185`.
207+
208+ If ``SELECT FOR UPDATE...`` query was aborted due to multi-master conflict, the client wouldn't get back the deadlock error. From client perspective the transaction would be successful. Bug fixed :bug:`1187739`.
209+
210+ Temporary tables are not replicated, but any DDL on those tables were (in this case it was ``TRUNCATE``), which would generates error messages on other nodes. Bug fixed :bug:`1194156`.
211+
212+ When setting the :variable:`gcache.size` to a larger value than the default 128M, the mysql service command did not allow enough time for the file to be preallocated. Bug fixed :bug:`1207500`.
213+
214+ ``CREATE TABLE AS SELECT`` would fail with explicit temporary tables, when binlogging was enabled and :variable:`autocommit` was set to ``0``. Bug fixed :bug:`1240098`.
215+
216+ Write set flags defined in wsrep API are now exposed to application side appliers too. Bug fixed :bug:`1247402`.
217+
218+ Local brute force aborts are counted accurately. Bug fixed :bug:`1247971`.
219+
220+ Certain combinations of transaction rollbacks could leave stale transactional ``MDL`` locks and cause deadlocks. Bug fixed :bug:`1247978`.
221+
222+ After turning ``UNIV_SYNC_DEBUG`` on, node that was started from clean state would crash immediately at startup. Bug fixed :bug:`1248908`.
223+
224+ Server built with ``UNIV_SYNC_DEBUG`` would assert if SQL load has ``DELETE`` statements on tables with foreign key constraints with ``ON DELETE CASCADE`` option. Bug fixed :bug:`1248921`.
225+
226+ Xtrabackup SST dependencies have been added as ``Suggested`` dependencies for *DEB* packages. Bug fixed :bug:`1250326`.
227+
228+ ``init stop`` script on *CentOS* didn't wait for the server to be fully stopped. This would cause unsuccessful server restart because the ``start`` action would fail because the daemon would still be running. Bug fixed :bug:`1254153`.
229+
230+ Memory leak in ``mem_root`` has been fixed. Bug fixed :bug:`1249753`.
231+
232+ Galera is now packaged with garbd init script. Bug fixed :bug:`1256769`.
233+
234+Other bugs fixed: bug fixed :bug:`1247980`, bug fixed :bug:`891476`, bugs fixed :bug:`1250805`, bug fixed :bug:`1253923`.
235+
236+.. note::
237+
238+ Because some package names have been changed with the product suffix and and additional dependencies being added please check the :ref:`manual <installation>` before starting new installations. *Debian* users are requested to use ``apt-get dist-upgrade`` or ``apt-get install`` for upgrade, for more refer to installation :ref:`guide <apt-repo>`.
239+
240+Based on `Percona Server 5.5.34-32.0 <http://www.percona.com/doc/percona-server/5.5/release-notes/Percona-Server-5.5.34-32.0.html>`_ including all the bug fixes in it, `Galera Replicator <https://launchpad.net/galera/+milestone/25.2.8>`_ and on `Codership wsrep API 5.5.34-25.9 <https://launchpad.net/codership-mysql/+milestone/5.5.34-25.9>`_, |Percona XtraDB Cluster| `5.5.34-25.9 <https://launchpad.net/percona-xtradb-cluster/+milestone/5.5.34-25.9>`_ is now the current stable release. All of |Percona|'s software is open-source and free.
241+
242+|Percona XtraDB Cluster| `Errata <http://www.percona.com/doc/percona-xtradb-cluster/errata.html>`_ can be found in our documentation.
243
244=== modified file 'doc-pxc/source/release-notes/release-notes_index.rst'
245--- doc-pxc/source/release-notes/release-notes_index.rst 2013-11-04 10:19:08 +0000
246+++ doc-pxc/source/release-notes/release-notes_index.rst 2013-12-03 12:55:58 +0000
247@@ -5,7 +5,8 @@
248 .. toctree::
249 :maxdepth: 1
250 :glob:
251-
252+
253+ Percona-XtraDB-Cluster-5.5.34-25.9
254 Percona-XtraDB-Cluster-5.5.34-23.7.6
255 Percona-XtraDB-Cluster-5.5.33-23.7.6
256 Percona-XtraDB-Cluster-5.5.31-23.7.5

Subscribers

People subscribed via source and target branches