PXC-5321 [DOCS] - 8.4 Update clone.md and encrypt-traffic.md - #374
patrickbirch wants to merge 1 commit into
Conversation
bda21ce to
c95f8c2
Compare
c95f8c2 to
086636f
Compare
086636f to
718f7f5
Compare
718f7f5 to
8f3e631
Compare
8f3e631 to
1252483
Compare
1252483 to
ac9b8ef
Compare
ac9b8ef to
93cc6da
Compare
jaideepkarande
left a comment
There was a problem hiding this comment.
LGTM
But 2 clarifications that may help.
| ### encrypt_threads | ||
|
|
||
| | Parameter | Description | | ||
| | -------------- | ------------------ | | ||
| | Default: | `4` | | ||
|
|
||
| Specifies the number of threads that XtraBackup should use for encrypting data | ||
| (when `encrypt=1`). | ||
| The value is passed using the `--encrypt-threads` option in XtraBackup. | ||
|
|
||
| This option affects only SST with XtraBackup | ||
| and should be specified under the `[sst]` group. | ||
|
|
There was a problem hiding this comment.
Why it has been removed?
jaideepkarande:PXC-5267-8.4:scripts$ grep encrypt_threads *
grep: firewall: Is a directory
grep: sys_schema: Is a directory
grep: systemd: Is a directory
wsrep_sst_xtrabackup-v2.sh:encrypt_threads=-1
wsrep_sst_xtrabackup-v2.sh: encrypt_threads=$(parse_cnf sst encrypt-threads -1)
wsrep_sst_xtrabackup-v2.sh: if [[ $encrypt_threads -le 0 ]]; then
wsrep_sst_xtrabackup-v2.sh: encrypt_threads=4
There was a problem hiding this comment.
encrypt_threads was removed because it only applied to encrypt=1, and that SST mode is gone in 8.4.
It came out in 93cc6da (PXC-5321 [DOCS] - 8.4 Update clone.md and encrypt-traffic.md) from docs/xtrabackup-sst.md. The old text said the option was passed as XtraBackup --encrypt-threads only when encrypt=1.
On this branch, [sst] encrypt is documented as 0 or 4 only. 4 is SSL (ssl-ca / ssl-cert / ssl-key), which is also the default via pxc-encrypt-cluster-traffic. Payload encryption with an XtraBackup key (encrypt, encrypt-key, encrypt-key-file) is already called out as not allowed for SST and will error.
So the section was leftover from the old key-based path. With encrypt=1 unsupported, --encrypt-threads is not used for SST, and documenting a default of 4 would be misleading.
In wsrep_sst_xtrabackup-v2.sh the value is parsed and defaulted to 4, then never passed on. There is no --encrypt-threads=$encrypt_threads anywhere in the 8.4 script. Compare that with backup_threads, which is appended as --parallel=.
PXC no longer supports encrypt=1,2,3
These are no longer supported (since we no longer support encrypt=1)
They were used to encrypt the backup as it's being transferred, this is now done using SSL (encrypt=4)
modified: docs/clone-sst.md modified: docs/encrypt-traffic.md modified: docs/xtrabackup-sst.md
93cc6da to
f71b53a
Compare
Uh oh!
There was an error while loading. Please reload this page.