Skip to content

Commit 1b54c59

Browse files
djw-mjpe442github-actions[bot]Jagdish-Kewat-EDB
authored
DOCS-1256 PGD 5.8 Draft release notes redux (#6769)
* Started 5.8 branch for PGD. * changed version in index * update generated release notes * Updated rel notes to add 5.8 Signed-off-by: Dj Walker-Morgan <[email protected]> * Porting galloc content to 5.8 Signed-off-by: Dj Walker-Morgan <[email protected]> * Changes with expanded language Signed-off-by: Dj Walker-Morgan <[email protected]> * Fix up according to notes, update versions command for 5.7 Signed-off-by: Dj Walker-Morgan <[email protected]> * Redux release notes Signed-off-by: Dj Walker-Morgan <[email protected]> * Add PGD CLI release notes * Add release notes for sorted output enhancement for cli * Address review comment * Remove duplicated notes * update generated release notes * Fixed release notes to render version for PGD CLI Signed-off-by: Dj Walker-Morgan <[email protected]> * Add missing release note * update generated release notes * update generated release notes * Added Vadim's notes Signed-off-by: Dj Walker-Morgan <[email protected]> --------- Signed-off-by: Dj Walker-Morgan <[email protected]> Co-authored-by: Josh Earlenbaugh <[email protected]> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Jagdish Kewat <[email protected]>
1 parent 170be79 commit 1b54c59

File tree

3 files changed

+225
-10
lines changed

3 files changed

+225
-10
lines changed

product_docs/docs/pgd/5.8/rel_notes/index.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ The EDB Postgres Distributed documentation describes the latest version of EDB P
2727

2828
| Release Date | EDB Postgres Distributed | BDR extension | PGD CLI | PGD Proxy |
2929
|---|---|---|---|---|
30-
| 14 May 2025 | [5.8.0](./pgd_5.8.0_rel_notes) | 5.8.0 | 5.8.0 | 5.8.0 |
30+
| 22 May 2025 | [5.8.0](./pgd_5.8.0_rel_notes) | 5.8.0 | 5.8.0 | 5.8.0 |
3131
| 25 Feb 2025 | [5.7.0](./pgd_5.7.0_rel_notes) | 5.7.0 | 5.7.0 | 5.7.0 |
3232
| 25 Nov 2024 | [5.6.1](./pgd_5.6.1_rel_notes) | 5.6.1 | 5.6.1 | 5.6.1 |
3333
| 15 Oct 2024 | [5.6.0](./pgd_5.6.0_rel_notes) | 5.6.0 | 5.6.0 | 5.6.0 |

product_docs/docs/pgd/5.8/rel_notes/pgd_5.8.0_rel_notes.mdx

Lines changed: 59 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,21 +5,75 @@ originalFilePath: product_docs/docs/pgd/5.8/rel_notes/src/relnote_5.8.0.yml
55
editTarget: originalFilePath
66
---
77

8-
Released: 14 May 2025
9-
10-
Updated: 14 May 2025
8+
Released: 22 May 2025
119

1210
EDB Postgres Distributed 5.8.0 includes a number of enhancements and bug fixes.
1311

1412
## Highlights
1513

16-
* Simpler sequence management with `bdr.galloc_chunk_info()`
14+
- Highlights here
1715

1816
## Enhancements
1917

2018
<table class="table w-100"><thead><tr><th>Component</th><th>Version</th><th>Description</th><th width="10%">Addresses</th></tr></thead><tbody>
21-
<tr><td>BDR</td><td>5.8.0</td><td>Improve pgd_bench error message related to CAMO</td><td></td></tr>
19+
<tr><td>PGD CLI</td><td>5.8.0</td><td><details><summary>The <code>--summary</code> and <code>--options</code> flags for <code>pgd node show</code> CLI command.</summary><hr/><p>Add the <code>--summary</code> and <code>--options</code> flags to <code>pgd node show</code> command to filter the output of the <code>pgd node show</code> command.
20+
This also maintains symmetry with other <code>show</code> commands.</p>
21+
</details></td><td></td></tr>
22+
<tr><td>PGD CLI</td><td>5.8.0</td><td><details><summary>More GUCs verfied in <code>pgd cluster verify</code> CLI command.</summary><hr/><p>Add the <code>bdr.lock_table_locking</code> and <code>bdr.truncate_locking</code> GUCs to list of GUCs verfied in <code>pgd cluster verify</code> command.</p>
23+
</details></td><td></td></tr>
24+
<tr><td>BDR</td><td>5.8.0</td><td><details><summary>Ensure commit scope logic only runs on data nodes</summary><hr/><p>While commit scope processing does not have any direct affect on
25+
non-data nodes, by skipping it altogether we can avoid potentially
26+
confusing error messages.</p>
27+
</details></td><td></td></tr>
2228
<tr><td>BDR</td><td>5.8.0</td><td>Added `bdr.galloc_chunk_info()` function to simplify sequences</td><td></td></tr>
29+
<tr><td>PGD CLI</td><td>5.8.0</td><td><details><summary>Improve the CLI debug messages.</summary><hr/><p>Improve the formating of the log messages to be more readable and symmetrical with Postgres log messages.</p>
30+
</details></td><td></td></tr>
31+
<tr><td>PGD CLI</td><td>5.8.0</td><td><details><summary>New column for <code>pgd cluster verify --settings</code> CLI command output.</summary><hr/><p>Add the <code>recommended_value</code> column to the result of the <code>pgd cluster verify --settings</code> command.
32+
The column will not be displayed in tabular output but will be displayed in JSON output.</p>
33+
</details></td><td></td></tr>
34+
<tr><td>PGD CLI</td><td>5.8.0</td><td><details><summary>Display sorted output for CLI.</summary><hr/><p>The output for the commands with tabular output will be sorted by the resource name.
35+
For the commands that display more than one resource, the output will be sorted by each resource column in order.</p>
36+
</details></td><td></td></tr>
37+
<tr><td>BDR</td><td>5.8.0</td><td>Improve pgd_bench error message related to CAMO</td><td></td></tr>
38+
</tbody></table>
39+
40+
41+
## Bug Fixes
42+
43+
<table class="table w-100"><thead><tr><th>Component</th><th>Version</th><th>Description</th><th width="10%">Addresses</th></tr></thead><tbody>
44+
<tr><td>BDR</td><td>5.8.0</td><td><details><summary>Add safety nets for CDC failover</summary><hr/><p>CDC failover now has additional safety nets to ensure that the consumer
45+
does not start replication from a node that is not the creator of the
46+
replication slot. This is to prevent data loss or duplicate transactions.
47+
The changes also add additional checks to ensure that the consumer does
48+
not start replication from a node that does not have the required WAL
49+
files to decode the transactions that are missing on the consumer but
50+
were included in the initial snapshot that the newly joined node had
51+
obtained (physical or logical).</p>
52+
</details></td><td></td></tr>
53+
<tr><td>BDR</td><td>5.8.0</td><td>Update to non-unique index needs to compare tuple on lookup to ensure it is the same</td><td>43523, 43802, 45244, 47815, 48007</td></tr>
54+
<tr><td>BDR</td><td>5.8.0</td><td><details><summary>Use primary_conninfo GUC instead of trying to read from shared memory</summary><hr/><p>The shared memory information may get obfuscated and hence become
55+
useless. So instead of reading from there, simply use the GUC which is
56+
now available on all supported PG versions.</p>
57+
</details></td><td>41776</td></tr>
58+
<tr><td>PGD CLI</td><td>5.8.0</td><td><details><summary>Fix the CLI <code>pgd cluster show</code> command issues on a degraded cluster.</summary><hr/><p>The <code>pgd cluster show</code> command failed with error for clock drift if only one node is up and running in a N node cluster.
59+
The command is fixed to return valid output for other components viz., <code>health</code> and <code>summary</code> while reporting a valid error for <code>clock-drift</code>.</p>
60+
</details></td><td></td></tr>
61+
<tr><td>PGD CLI</td><td>5.8.0</td><td><details><summary>Fix the CLI <code>pgd node show</code> command issue if a non-existent node is specified.</summary><hr/><p>The <code>pgd node show</code> command crashed if a non-existent node is specified to the command.
62+
The command is fixed to fail gracefully with appropriate error message.</p>
63+
</details></td><td></td></tr>
64+
<tr><td>BDR</td><td>5.8.0</td><td><details><summary>Prevent segfault in bdr.taskmgr_set_leader</summary><hr/><p>Add a note in test 00200 to at least give a hint about which
65+
function may be to blame.</p>
66+
</details></td><td></td></tr>
67+
<tr><td>BDR</td><td>5.8.0</td><td><details><summary>Replacing TRUNCATEs with DELETEs from all BDR catalogs on local node drop (#3685)</summary><hr/><p>This is to avoid deadlock in bdr_init_physical IF customer happens to run monitoring
68+
queries during node joining / cleaning unwanted source node data.</p>
69+
</details></td><td>46952</td></tr>
70+
<tr><td>BDR</td><td>5.8.0</td><td><details><summary>Ensure new joiner processes watermark message in the CATCHUP phase</summary><hr/><p>Setting nci-&gt;min_lsn to XactLastCommitEnd of watermark message Tx to ensure
71+
CATCHUP phase finishes on new joiner only after watermark is processed.</p>
72+
</details></td><td></td></tr>
73+
<tr><td>BDR</td><td>5.8.0</td><td><details><summary>Fixed deadlock issue in bdr_init_physical.</summary><hr/><p>Fixed deadlock between bdr_init_physical cleaning unwanted node data and concurrent monitoring queries.</p>
74+
</details></td><td>46952</td></tr>
75+
<tr><td>BDR</td><td>5.8.0</td><td><details><summary>Fixed new cluster node consistency issue.</summary><hr/><p>Fixed an issue when new node joining the cluster finishes CATCHUP phase before getting its replication progress against all data nodes. This may cause new node being out of sync with the cluster.</p>
76+
</details></td><td></td></tr>
2377
</tbody></table>
2478

2579

product_docs/docs/pgd/5.8/rel_notes/src/relnote_5.8.0.yml

Lines changed: 165 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# yaml-language-server: $schema=https://raw.githubusercontent.com/EnterpriseDB/docs/refs/heads/develop/tools/automation/generators/relgen/relnote-schema.json
22
product: EDB Postgres Distributed
33
version: 5.8.0
4-
date: 14 May 2025
5-
updated: 14 May 2025
4+
date: 22 May 2025
5+
66
components:
77
"BDR": 5.8.0
88
"PGD CLI": 5.8.0
@@ -11,8 +11,56 @@ components:
1111
intro: |
1212
EDB Postgres Distributed 5.8.0 includes a number of enhancements and bug fixes.
1313
highlights: |
14-
* Simpler sequence management with `bdr.galloc_chunk_info()`
14+
- Highlights here
1515
relnotes:
16+
- relnote: Use primary_conninfo GUC instead of trying to read from shared memory
17+
component: BDR
18+
details: |
19+
The shared memory information may get obfuscated and hence become
20+
useless. So instead of reading from there, simply use the GUC which is
21+
now available on all supported PG versions.
22+
jira: BDR-5923
23+
addresses: "41776"
24+
type: Bug fix
25+
impact: High
26+
27+
- relnote: Ensure commit scope logic only runs on data nodes
28+
component: BDR
29+
details: |
30+
While commit scope processing does not have any direct affect on
31+
non-data nodes, by skipping it altogether we can avoid potentially
32+
confusing error messages.
33+
jira: BDR-6325
34+
addresses: ""
35+
type: Enhancement
36+
impact: Medium
37+
38+
- relnote: Prevent segfault in bdr.taskmgr_set_leader
39+
component: BDR
40+
details: |
41+
Add a note in test 00200 to at least give a hint about which
42+
function may be to blame.
43+
jira: BDR-6401
44+
addresses: ""
45+
type: Bug fix
46+
impact: Medium
47+
48+
- relnote: Add safety nets for CDC failover
49+
details: |
50+
CDC failover now has additional safety nets to ensure that the consumer
51+
does not start replication from a node that is not the creator of the
52+
replication slot. This is to prevent data loss or duplicate transactions.
53+
The changes also add additional checks to ensure that the consumer does
54+
not start replication from a node that does not have the required WAL
55+
files to decode the transactions that are missing on the consumer but
56+
were included in the initial snapshot that the newly joined node had
57+
obtained (physical or logical).
58+
component: BDR
59+
jira: BDR-6125
60+
addresses: ""
61+
type: Bug fix
62+
impact: Highest
63+
1664
- relnote: Added `bdr.galloc_chunk_info()` function to simplify sequences
1765
description: |
1866
The `bdr.galloc_chunk_info()` function provides information about the chunk
@@ -24,13 +72,126 @@ relnotes:
2472
jira: BDR-6144
2573
addresses: ""
2674
type: Enhancement
75+
76+
- relnote: Update to non-unique index needs to compare tuple on lookup to ensure it is the same
77+
component: BDR
78+
jira: BDR-5811 CP-43523 CP-43802 CP-45244 CP-47815
79+
addresses: "43523, 43802, 45244, 47815, 48007"
80+
type: Bug fix
81+
impact: Highest
82+
83+
- relnote: Replacing TRUNCATEs with DELETEs from all BDR catalogs on local node drop (#3685)
84+
component: BDR
85+
details: |
86+
This is to avoid deadlock in bdr_init_physical IF customer happens to run monitoring
87+
queries during node joining / cleaning unwanted source node data.
88+
jira: BDR-6313
89+
addresses: "46952"
90+
type: Bug fix
91+
impact: Medium
92+
93+
- relnote: Ensure new joiner processes watermark message in the CATCHUP phase
94+
component: BDR
95+
details: |
96+
Setting nci->min_lsn to XactLastCommitEnd of watermark message Tx to ensure
97+
CATCHUP phase finishes on new joiner only after watermark is processed.
98+
jira: BDR-6397
99+
addresses: ""
100+
type: Bug fix
101+
impact: Medium
102+
103+
- relnote: Improve the CLI debug messages.
104+
details: |
105+
Improve the formating of the log messages to be more readable and symmetrical with Postgres log messages.
106+
component: PGD CLI
107+
jira: BDR-6101
108+
type: Enhancement
109+
impact: Medium
110+
111+
- relnote: The `--summary` and `--options` flags for `pgd node show` CLI command.
112+
details: |
113+
Add the `--summary` and `--options` flags to `pgd node show` command to filter the output of the `pgd node show` command.
114+
This also maintains symmetry with other `show` commands.
115+
component: PGD CLI
116+
jira: BDR-6145
117+
addresses: ""
118+
type: Enhancement
119+
impact: High
120+
121+
- relnote: More GUCs verfied in `pgd cluster verify` CLI command.
122+
details: |
123+
Add the `bdr.lock_table_locking` and `bdr.truncate_locking` GUCs to list of GUCs verfied in `pgd cluster verify` command.
124+
component: PGD CLI
125+
jira: BDR-5308
126+
addresses: ""
127+
type: Enhancement
128+
impact: High
129+
130+
- relnote: New column for `pgd cluster verify --settings` CLI command output.
131+
details: |
132+
Add the `recommended_value` column to the result of the `pgd cluster verify --settings` command.
133+
The column will not be displayed in tabular output but will be displayed in JSON output.
134+
component: PGD CLI
135+
jira: BDR-5308
136+
addresses: ""
137+
type: Enhancement
138+
impact: Medium
139+
140+
- relnote: Display sorted output for CLI.
141+
details: |
142+
The output for the commands with tabular output will be sorted by the resource name.
143+
For the commands that display more than one resource, the output will be sorted by each resource column in order.
144+
component: PGD CLI
145+
jira: BDR-6094
146+
addresses: ""
147+
type: Enhancement
148+
impact: Medium
149+
150+
- relnote: Fix the CLI `pgd cluster show` command issues on a degraded cluster.
151+
details: |
152+
The `pgd cluster show` command failed with error for clock drift if only one node is up and running in a N node cluster.
153+
The command is fixed to return valid output for other components viz., `health` and `summary` while reporting a valid error for `clock-drift`.
154+
component: PGD CLI
155+
jira: BDR-6135
156+
addresses: ""
157+
type: Bug Fix
158+
impact: High
159+
160+
- relnote: Fix the CLI `pgd node show` command issue if a non-existent node is specified.
161+
details: |
162+
The `pgd node show` command crashed if a non-existent node is specified to the command.
163+
The command is fixed to fail gracefully with appropriate error message.
164+
component: PGD CLI
165+
jira: BDR-6292
166+
addresses: ""
167+
type: Bug Fix
168+
impact: High
169+
27170
- relnote: Improve pgd_bench error message related to CAMO
28171
description: |
29172
If executed with `--mode=camo`, but the provided test script is not wrapped
30173
in an explicit transaction, pgd_bench will not be able to retrieve the
31174
expected `transaction_id` value. Improve the emitted error message to
32175
contain a hint about a possible missing transaction.
33176
component: BDR
34-
impact: Minor
177+
impact: Low
35178
jira: BDR-6411
36179
type: Enhancement
180+
181+
- relnote: Fixed deadlock issue in bdr_init_physical.
182+
component: BDR
183+
details: |
184+
Fixed deadlock between bdr_init_physical cleaning unwanted node data and concurrent monitoring queries.
185+
jira: BDR-6313
186+
addresses: 46952
187+
type: Bug Fix
188+
impact: Low
189+
190+
- relnote: Fixed new cluster node consistency issue.
191+
component: BDR
192+
details: |
193+
Fixed an issue when new node joining the cluster finishes CATCHUP phase before getting its replication progress against all data nodes. This may cause new node being out of sync with the cluster.
194+
jira: BDR-6397
195+
addresses: ""
196+
type: Bug Fix
197+
impact: Low

0 commit comments

Comments
 (0)