Skip to content

Commit 165e322

Browse files
djw-msonotleynidhibhammar
authored
Release 2025-01-07a (#6385)
* Clarify which values are optional. Explain that PEM will still create agent users even when pem-agent-user is provided. * Change ssl default * format N * Further improvements to wording * Update SSL mode and cert path * typo * Apply suggestions from code review Co-authored-by: nidhibhammar <[email protected]> * Update product_docs/docs/pem/9/registering_agent.mdx * Update product_docs/docs/pem/9/registering_agent.mdx * Fix lakehouse nav being out of order (#6384) Signed-off-by: Dj Walker-Morgan <[email protected]> * Patch to correct LTS status and remove backslashes (#6383) --------- Signed-off-by: Dj Walker-Morgan <[email protected]> Co-authored-by: Simon Notley <[email protected]> Co-authored-by: nidhibhammar <[email protected]>
1 parent 2121773 commit 165e322

File tree

3 files changed

+19
-16
lines changed

3 files changed

+19
-16
lines changed

Diff for: ‎advocacy_docs/edb-postgres-ai/analytics/index.mdx

+2
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ description: How EDB Postgres Lakehouse extends the power of Postgres by adding
77
navigation:
88
- concepts
99
- quick_start
10+
- external_tables
11+
- how_to_lakehouse_sync
1012
- reference
1113
---
1214

Diff for: ‎product_docs/docs/pem/9/registering_agent.mdx

+9-9
Original file line numberDiff line numberDiff line change
@@ -48,23 +48,23 @@ set PEM_SERVER_PASSWORD=edb
4848
|---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
4949
| `--pem-server` | The IP address of the PEM backend database server. This parameter is required. |
5050
| `--pem-port` | The port of the PEM backend database server. The default value is `5432`. |
51-
| `--pem-user` | The name of the database user having superuser privileges of the PEM backend database server. This parameter is required. |
52-
| `--pem-agent-user` | The agent user to connect the PEM server backend database server. |
53-
| `--pem-ssl-mode` | Type of SSL authentication used for connecting PEM agent to the PEM server. The possible values are `prefer`, `require`,`disable`,`verify-CA`, and `verify-full`. |
54-
| `--cert-path` | The complete path to the directory where certificates are created. If you don't provide a path, certificates are created in `~/.pem` on Linux and `%APPDATA%/pem` on Windows. |
51+
| `--pem-user` | The name of a database user with the `pem_admin` role and the `rolcreaterole` flag set (or a superuser) on the PEM backend database server. This user will be used to connect to the PEM server to perform agent registration. This parameter is required. |
52+
| `--pem-agent-user` | The name of a database user on the PEM backend database server. After registration, the agent will use this user to open connections to the PEM database server to write probe data, evaluate alerts, etc. This parameter is optional. If omitted, the agent will connect using a new user created during registration named `agent<N>` where `<N>` is the agent ID. Note that this user is always created and even if you specify a `pem-agent-user` the agent will use `SET ROLE agent<N>` to switch roles after the connection is made. |
53+
| `--pem-ssl-mode` | The [SSL mode](https://www.postgresql.org/docs/current/libpq-ssl.html#LIBPQ-SSL-PROTECTION) to be used by the PEM agent user (see above). The possible values are `prefer`, `require`,`disable`,`verify-CA`, and `verify-full`. The default value is `require`. |
54+
| `--cert-path` | The complete path to a directory in which certificates will be stored. If you don't provide a path, certificates are created in `~/.pem` on Linux and `%APPDATA%/pem` on Windows. |
5555
| `--config-dir` | The directory path for the configuration file. The default is `<pemworker path>/../etc`. |
5656
| `--display-name` | A user-friendly name for the agent to display in the PEM browser tree. In PEM 9.6 and later, the default is the host's fully qualified domain name (FQDN), falling back to the hostname if this option isn't set. For releases earlier than PEM 9.6, the default is the hostname. |
57-
| `--force-registration` | Include the `force_registration` clause to register the agent with the arguments provided. This clause is useful if you're overriding an existing agent configuration. The default value is `Yes`. |
58-
| `--group` | The name of the group in which the agent is displayed. |
59-
| `--team` | The name of the database role on the PEM backend database server with access to the monitored database server. |
60-
| `--owner` | The name of the database user on the PEM backend database server who owns the agent. |
57+
| `--force-registration` | Include the `force-registration` clause to register the agent with the arguments provided. This clause is useful if you're overriding an existing agent configuration. The default value is `Yes`. |
58+
| `--group` | The name of a group in which to place the agent. This parameter is optional, if omitted the agent will not be placed in a group. |
59+
| `--team` | The name of a database role on the PEM backend database server. Access to this agent will be restricted to only the named role, the owner, and the `pem_admin` role. This parameter is optional. No team will be assigned if omitted, meaning all users can access this agent. |
60+
| `--owner` | The name of a database user on the PEM backend database server. This user will be assigned as the owner of the agent. The specified `pem-user` will be assigned as the owner if omitted. |
6161
| `--allow_server_restart` | Enable the `allow_server_restart` parameter to allow PEM to restart the monitored server. The default value is `True`. |
6262
| `--allow-batch-probes` | Enable the `allow-batch-probes` parameter to allow PEM to run batch probes on this agent. The default value is `False`. |
6363
| `--batch-script-user` | The operating system user to use for executing the batch/shell scripts. The default value is none. The scripts don't execute if you leave this parameter blank or the specified user doesn't exist. |
6464
| `--enable-heartbeat-connection` | Enable the `enable-heartbeat-connection` parameter to create a dedicated heartbeat connection between the PEM agent and server to update the active status. The default value is `False`. |
6565
| `--enable-smtp` | Enable the `enable-smtp parameter` to allow the PEM agent to send the email on behalf of the PEM server. The default value is `False`. |
6666
| `--enable-snmp` | Enable the `enable-snmp parameter` to allow the PEM agent to send the SNMP traps on behalf of the PEM server. The default value is `False`. |
67-
| `-o` | Specifies whether you want to override the configuration file options. |
67+
| `-o` | Used to override the configuration file options. See the below [example](#overriding-default-configurations---examples) for usage. |
6868

6969
!!! Note Allowing the agent to restart the database server
7070
If you use any feature of PEM that requires a database server restart by the PEM agent (such as Audit Manager, Log Manager, or the Tuning Wizard), then you must set the value of `allow_server_restart` to `true` in the `agent.cfg` file or restart the server manually for changes to take effect.

Diff for: ‎product_docs/docs/postgres_for_kubernetes/1/index.mdx

+8-7
Original file line numberDiff line numberDiff line change
@@ -126,18 +126,19 @@ You need a valid EDB subscription to use EDB Postgres for Kubernetes in producti
126126
### Long Term Support
127127

128128
EDB is committed to declaring a Long Term Support (LTS) version of EDB
129-
Postgres for Kubernetes annually. 1.22 is the current LTS version. 1.18 was our
129+
Postgres for Kubernetes annually. 1.25 is the current LTS version. 1.18 was the
130130
first. Each LTS version will
131131
receive maintenance releases and be supported for an additional 12 months beyond
132132
the last community release of CloudNativePG for the same version.
133133

134-
For example, the 1.22 release of CloudNativePG will reach End-of-Life on July
134+
For example, the 1.22 release of CloudNativePG reached End-of-Life on July
135135
24, 2024, for the open source community.
136136
Because it was declared an LTS version of EDB Postgres for Kubernetes, it
137137
will be supported for an additional 12 months, until July 24, 2025.
138138

139-
In addition, customers will always have at least 6 months to move between LTS versions. This
140-
means a new LTS version will be available by January 24, 2025 at the latest.
139+
In addition, customers will always have at least 6 months to move between LTS versions.
140+
For example, the 1.25 LTS version was released on December 23 2024, giving ample
141+
time to users to migrate from the 1.22 LTS ahead of the End-of-life on July 2025.
141142

142143
While we encourage customers to regularly upgrade to the latest version of the operator to take
143144
advantage of new features, having LTS versions allows customers desiring additional stability to stay on the same
@@ -181,9 +182,9 @@ The following versions of Postgres are currently supported:
181182
- EDB Postgres Extended: 12 - 16
182183

183184
PostgreSQL and EDB Postgres Advanced are available on the following platforms:
184-
`linux/amd64`, `linux/ppc64le`, `linux/s390x`. \\
185-
In addition, PostgreSQL is also supported on `linux/arm64`. \\
186-
EDB Postgres Extended is supported only on `linux/amd64`. \\
185+
`linux/amd64`, `linux/ppc64le`, `linux/s390x`.
186+
In addition, PostgreSQL is also supported on `linux/arm64`.
187+
EDB Postgres Extended is supported only on `linux/amd64`.
187188
EDB supports operand images for `linux/ppc64le` and `linux/s390x` architectures
188189
on OpenShift only.
189190

0 commit comments

Comments
 (0)