Skip to content

Commit 4a6caca

Browse files
committed
PXC-5194 [DOCS] - clean up expected outcomes 8.4
modified: docs/configure-cluster-rhel.md modified: docs/data-at-rest-encryption.md modified: docs/faq.md modified: docs/garbd-howto.md modified: docs/load-balance-proxysql.md modified: docs/virtual-sandbox.md modified: docs/wsrep-provider-index.md modified: docs/wsrep-system-index.md
1 parent a94d125 commit 4a6caca

9 files changed

Lines changed: 178 additions & 222 deletions

docs/configure-cluster-rhel.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,9 +32,9 @@ to ports 3306, 4444, 4567 and 4568.
3232

3333
* SELinux on all nodes is disabled.
3434

35-
!!! admonition "Different from previous versions"
35+
Percona XtraDB Cluster {{vers}} creates the internal MySQL account [`mysql.pxc.internal.session`](glossary.md#mysqlpxcinternalsession), which the SST process uses to run the SQL needed for node synchronization.
3636

37-
The variable `wsrep_sst_auth` has been removed. Percona XtraDB Cluster {{vers}} automatically creates the system user [`mysql.pxc.internal.session`](glossary.md#mysqlpxcinternalsession). During [SST](glossary.md#sst), the user `mysql.pxc.sst.user` and the role [`mysql.pxc.sst.role`](glossary.md#mysqlpxcsstrole) are created on the donor node.
37+
During [SST](glossary.md#sst), that account creates the user `mysql.pxc.sst.user` on the donor node and assigns it the role [`mysql.pxc.sst.role`](glossary.md#mysqlpxcsstrole).
3838

3939
## Step 1. Install
4040

docs/data-at-rest-encryption.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -231,11 +231,9 @@ Run the migration server:
231231
--component_keyring_vault_config=/dev/shm/pxc80/vault/component_keyring_vault.cnf &
232232
```
233233

234-
??? example "Expected output"
234+
??? example "Expected log output"
235235

236236
```{.text .no-copy}
237-
... [Warning] TIMESTAMP with implicit DEFAULT value is deprecated. Please use
238-
--explicit_defaults_for_timestamp server option (see documentation for more details).
239237
... [Note] --secure-file-priv is set to NULL. Operations related to importing and
240238
exporting data are disabled
241239
... [Warning] WSREP: Node is not a cluster node. Disabling pxc_strict_mode

docs/faq.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -159,7 +159,7 @@ To be precise, the commits are “virtually” synchronous, which means that the
159159
160160
## Does Percona XtraDB Cluster work with regular MySQL replication?
161161
162-
Yes. On the node you are going to use as source, enable binary logging and replica updates: set `log_bin` and `log_replica_updates` (or the deprecated `log_slave_updates`) in your configuration.
162+
Yes. On the node you are going to use as source, set a unique non-zero `server_id`, enable binary logging (`log_bin`), and enable `log_replica_updates` (or the deprecated `log_slave_updates`) so cluster-applied writes are recorded in the binary log for downstream replicas.
163163
164164
## Why the MySQL init script does not start?
165165

docs/garbd-howto.md

Lines changed: 28 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -55,22 +55,26 @@ socket.ssl_cipher=AES128-SHA256"
5555

5656
To avoid entering the options each time you start `garbd`, edit the options in the configuration file. To configure *Galera Arbitrator* on *Ubuntu/Debian*, edit the `/etc/default/garb` file. On RedHat or derivative distributions, the configuration can be found in `/etc/sysconfig/garb` file.
5757

58-
The configuration file should look like this after the installation and before you have added your parameters:
58+
After installation, before you add your cluster settings, **`/etc/default/garb`** (Debian/Ubuntu) from **Percona XtraDB Cluster** {{vers}} packages matches the following template:
5959

6060
```{.text .no-copy}
61-
Copyright (C) 2013-2015 Codership Oy
62-
This config file is to be sourced by garb service script.
63-
REMOVE THIS AFTER CONFIGURATION
64-
A comma-separated list of node addresses (address[:port]) in the cluster
65-
GALERA_NODES=""
66-
Galera cluster name, should be the same as on the rest of the nodes.
67-
GALERA_GROUP=""
68-
Optional Galera internal options string (e.g. SSL settings)
69-
see http://galeracluster.com/documentation-webpages/galeraparameters.html
70-
GALERA_OPTIONS=""
71-
Log file for garbd. Optional, by default logs to syslog
72-
Deprecated for CentOS7, use journalctl to query the log for garbd
73-
LOG_FILE=""
61+
# Copyright (C) 2012 Codership Oy
62+
# This config file is to be sourced by garb service script.
63+
64+
# REMOVE THIS AFTER CONFIGURATION
65+
66+
# A comma-separated list of node addresses (address[:port]) in the cluster
67+
# GALERA_NODES=""
68+
69+
# Galera cluster name, should be the same as on the rest of the nodes.
70+
# GALERA_GROUP=""
71+
72+
# Optional Galera internal options string (e.g. SSL settings)
73+
# see http://galeracluster.com/documentation-webpages/galeraparameters.html
74+
# GALERA_OPTIONS=""
75+
76+
# Log file for garbd. Optional, by default logs to syslog
77+
# LOG_FILE=""
7478
```
7579

7680
Add the parameter information about the cluster. For this document, we use the cluster information from [Configuring Percona XtraDB Cluster on Ubuntu](configure-cluster-ubuntu.md#configure-a-cluster-on-debian-or-ubuntu).
@@ -90,7 +94,6 @@ Optional Galera internal options string (e.g. SSL settings)
9094
see http://galeracluster.com/documentation-webpages/galeraparameters.html
9195
GALERA_OPTIONS="socket.ssl_key=/etc/ssl/mysql/server-key.pem;socket.ssl_cert=/etc/ssl/mysql/server-cert.pem;socket.ssl_ca=/etc/ssl/mysql/ca.pem;socket.ssl_cipher=AES128-SHA256"
9296
Log file for garbd. Optional, by default logs to syslog
93-
Deprecated for CentOS7, use journalctl to query the log for garbd
9497
LOG_FILE="/var/log/garbd.log"
9598
```
9699

@@ -99,57 +102,49 @@ You can now start the *Galera Arbitrator* daemon (`garbd`). Run the following co
99102
=== "On Debian or Ubuntu"
100103

101104
```shell
102-
service garbd start
105+
systemctl start garb
103106
```
104107

105108
??? example "Expected output"
106109

107110
```{.text .no-copy}
108-
[ ok ] Starting /usr/bin/garbd: :.
109-
```
110-
111-
!!! note
112-
113-
On systems that run `systemd` as the default system and service manager, use `systemctl` instead of `service` to invoke the command. Currently, both are supported.
114-
115-
```shell
116-
systemctl start garb
111+
# No output on success
117112
```
118113

119-
=== "On Red Hat Enterprise Linux or CentOS"
114+
=== "On Red Hat Enterprise Linux"
120115

121116
```shell
122-
service garb start
117+
systemctl start garb
123118
```
124119

125120
??? example "Expected output"
126121

127122
```{.text .no-copy}
128-
[ ok ] Starting /usr/bin/garbd: :.
123+
# No output on success
129124
```
130125

131126
Additionally, you can check the `arbitrator` status by running:
132127

133128
=== "On Debian or Ubuntu"
134129

135130
```shell
136-
service garbd status
131+
systemctl is-active garb
137132
```
138133

139134
??? example "Expected output"
140135

141136
```{.text .no-copy}
142-
[ ok ] garb is running.
137+
active
143138
```
144139

145-
=== "On Red Hat Enterprise Linux or CentOS"
140+
=== "On Red Hat Enterprise Linux"
146141

147142
```shell
148-
service garb status
143+
systemctl is-active garb
149144
```
150145

151146
??? example "Expected output"
152147

153148
```{.text .no-copy}
154-
[ ok ] garb is running.
149+
active
155150
```

0 commit comments

Comments
 (0)