Merge lp:~hrvojem/percona-xtradb-cluster/haproxydocs into lp:~percona-dev/percona-xtradb-cluster/5.5.20

[Hrvoje Matijakovic]

=== modified file 'doc/source/faq.rst'
--- doc/source/faq.rst	2012-02-20 17:05:24 +0000
+++ doc/source/faq.rst	2012-03-22 19:10:33 +0000
@@ -27,6 +27,10 @@
    * Unknown error (node is online but Galera is not connected/synced with the cluster)
    * Connection error (node is not online)
 
+Q: How does XtraDB Cluster handle big transaction?
+==================================================
+A: XtraDB Cluster populates write set in memory before replication and this sets one limit for how large transactions make sense. There are wsrep variables for max row count and max size of of write set to make sure that server is not running out of memory.
+
 Q: Is there a chance to have different table structure on the nodes? 
 =====================================================================
 What I mean is like having 4 nodes, 4 tables like sessions_a, sessions_b, sessions_c and sessions_d and have each only on one of the nodes? 

=== modified file 'doc/source/haproxy.rst'
--- doc/source/haproxy.rst	2012-03-21 03:24:04 +0000
+++ doc/source/haproxy.rst	2012-03-22 19:10:33 +0000
@@ -1,10 +1,10 @@
 =============================
- Load balancing with Haproxy
+ Load balancing with HAProxy
 =============================
 
-This section is how to configure *haproxy* to work in the front of cluster
+This section describes how to configure `HAProxy <http://haproxy.1wt.eu/>`_ to work in front of the cluster.
 
-The following is the simplest config for *haproxy* ::
+Here is the simple configuration file example for *HAProxy* ::
 
         # this config needs haproxy-1.4.20
 
@@ -39,23 +39,22 @@
             server db02 10.4.29.99:3306 check
             server db03 10.4.29.98:3306 check
 
-with this config haproxy will load balance between nodes.
-It checks only if mysqld listens on 3306 and it does not take into an account
-a state of the node. 
-
-To check the current status of a node we need a more complex checks.
-The idea is taken from
-https://groups.google.com/group/codership-team/browse_thread/thread/44ee59c8b9c458aa/98b47d41125cfae6
-
-To implement this setup you will need a script clustercheck (place to /usr/local/bin) and 
-a config for xined - mysqlchk (place to /etc/xined.d) on each node. Both scripts are available in binaries and source
-distributions.
-Also you need to make a following change on each node:
-add to /etc/services file the line ::
+With this configuration *HAProxy* will load balance between three nodes. In this case it only checks if mysqld listens on port 3306, but it doesn't take into an account state of the node. So it could be sending queries to the node that has mysqld running even if it's in "JOINING" or "DISCONNECTED" state.  
+
+To check the current status of a node we need a more complex checks. This idea was taken from `codership-team google groups <https://groups.google.com/group/codership-team/browse_thread/thread/44ee59c8b9c458aa/98b47d41125cfae6>`_.
+
+To implement this setup you will need two scripts: 
+
+  *  **clustercheck** (place to /usr/local/bin) and a config for xined and 
+  *  **mysqlchk** (place to /etc/xined.d) on each node. 
+
+Both scripts are available in binaries and source distributions of *Percona XtraDB Cluster*.
+
+You'll need to change /etc/services file by adding the following line on each node: :: 
 
         mysqlchk        9200/tcp                # mysqlchk
 
-The config for haproxy in this case may look like ::
+The configuration file for *HAProxy* in this case may look like this: ::
 
         # this config needs haproxy-1.4.20
 

=== modified file 'doc/source/installation.rst'
--- doc/source/installation.rst	2012-02-24 18:47:06 +0000
+++ doc/source/installation.rst	2012-03-22 19:10:33 +0000
@@ -20,6 +20,7 @@
    :maxdepth: 1
 
    installation/yum_repo
+   installation/apt_repo
 
 |Percona| provides repositories for :program:`yum` (``RPM`` packages for *Red Hat*, *CentOS*, *Amazon Linux AMI*, and *Fedora*) and :program:`apt` (:file:`.deb` packages for *Ubuntu* and *Debian*) for software such as |Percona Server|, |XtraDB|, |XtraBackup|, and *Percona Toolkit*. This makes it easy to install and update your software and its dependencies through your operating system's package manager.
 

=== added file 'doc/source/installation/apt_repo.rst'
--- doc/source/installation/apt_repo.rst	1970-01-01 00:00:00 +0000
+++ doc/source/installation/apt_repo.rst	2012-03-22 19:10:33 +0000
@@ -0,0 +1,48 @@
+===============================================
+ Percona :program:`apt` Experimental Repository
+===============================================
+
+*Debian* and *Ubuntu* packages from *Percona* are signed with a key. Before using the repository, you should add the key to :program:`apt`. To do that, run the following commands: ::
+
+  $ gpg --keyserver  hkp://keys.gnupg.net --recv-keys 1C4CBDCDCD2EFD2A
+  ... [some output removed] ...
+  gpg:               imported: 1
+  
+  $ gpg -a --export CD2EFD2A | sudo apt-key add -
+
+Add this to :file:`/etc/apt/sources.list`, replacing ``squeeze`` with the name of your distribution: ::
+
+  deb http://repo.percona.com/apt squeeze main experimental
+  deb-src http://repo.percona.com/apt squeeze main experimental
+
+Remember to update the local cache: ::
+
+  $ apt-get update
+
+Supported Architectures
+=======================
+
+ * x86_64 (also known as amd64)
+ * x86
+
+Supported Releases
+==================
+
+Debian
+------
+
+ * 6.0 squeeze
+
+Ubuntu
+------
+
+ * 10.04LTS lucid
+ * 11.04 natty
+ * 11.10 oneiric
+
+Install XtraDB Cluster
+=======================
+
+Following command will install Cluster packages: :: 
+
+  $ sudo apt-get install percona-xtradb-cluster-client-5.5 percona-xtradb-cluster-server-5.5 percona-xtrabackup