Skip to content

Commit c1dd123

Browse files
authored
Merge pull request #6545 from EnterpriseDB/2025-02-25a
Production release - 2025/02/25a
2 parents ed3391b + f105319 commit c1dd123

File tree

99 files changed

+3458
-6545
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

99 files changed

+3458
-6545
lines changed

advocacy_docs/edb-postgres-ai/ai-accelerator/models/openai-api-compatibility.mdx

+10-4
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ The starting point for this process is creating a model. When you create a model
2222
select aidb.create_model(
2323
'my_local_ollama',
2424
'embeddings',
25-
'{"model":"llama3.1", "url":"http://llama.local:11434/v1/embeddings", "dimensions":2000}'::JSONB);
25+
'{"model":"llama3.2", "url":"http://llama.local:11434/v1/embeddings", "dimensions":3072}'::JSONB);
2626
```
2727

2828
### Model name and model provider
@@ -36,10 +36,10 @@ We specify the model provider as “embeddings” which is the provider that def
3636
The next parameter is the configuration. This is a JSON string, which when expanded has three parameters, the model, the url and the dimensions.
3737

3838
```json
39-
'{"model":"llama3.1", "url":"http://llama.local:11434/v1/embeddings", "dimensions":2000}'::JSONB
39+
'{"model":"llama3.2", "url":"http://llama.local:11434/v1/embeddings", "dimensions":3072}'::JSONB
4040
```
4141

42-
In this case, we are setting the model to [“llama3.3](https://ollama.com/library/llama3.3), a relatively new and powerful model. Remember to run `ollama run llama3.3` to pull and start the model on the server.
42+
In this case, we are setting the model to [“llama3.2](https://ollama.com/library/llama3.2), a relatively new and powerful model. Remember to run `ollama run llama3.2` to pull and start the model on the server.
4343

4444
The next json setting is the important one, overriding the endpoint that the aidb model will use.
4545

@@ -49,12 +49,18 @@ The next json setting is the important one, overriding the endpoint that the aid
4949

5050
Putting those components together we get `http://llama.local:11434/v1/embeddings` as our end point.
5151

52-
The last JSON parameter in this example is “dimensions” which is a hint to the system about how many vector values to expect from the model. If we [look up llama3.3’s properties](https://ollama.com/library/llama3.3/blobs/4824460d29f2) we can see the `llama.embedding_length` value is 8192. The provider defaults to 1536 (with some hard-wired exceptions depending on model) but it doesn’t know about llama3.3's max. Another factor is [pgvector is limited to 2000 dimensions](https://github.com/pgvector/pgvector?tab=readme-ov-file#what-if-i-want-to-index-vectors-with-more-than-2000-dimensions). So we pass a dimension value of 2000 in the configuration, to get the maximum dimensions available with pgvector.
52+
The last JSON parameter in this example is “dimensions” which is a hint to the system about how many vector values to expect from the model. If we [look up llama3.2’s properties](https://ollama.com/library/llama3.2/blobs/dde5aa3fc5ff) we can see the `llama.embedding_length` value is 3072. The provider defaults to 1536 (with some hard-wired exceptions depending on model) but it doesn’t know about llama3.2's embedding length. So in this case, we need to pass `"dimensions":3072` to configure aidb accordingly.
5353

5454
That completes the configuration parameter.
5555

5656
If the endpoint requires an API key, that would be passed in the credentials parameter. As this is a local model, we don’t need to pass any credentials.
5757

58+
59+
!!!Note Note
60+
When using indexing in pgvector, consider the [pgvector indexing limitations](https://github.com/pgvector/pgvector?tab=readme-ov-file#what-if-i-want-to-index-vectors-with-more-than-2000-dimensions). Aidb does not automatically configure an index today but if you add one manually, make sure it supports the number of dimensions your model uses.
61+
62+
!!!
63+
5864
## Using the model
5965

6066
Use the model name you created earlier to use the model just like any other Pipelines model. Here is an example of how to use the model to get an embedding:

advocacy_docs/edb-postgres-ai/ai-accelerator/rel_notes/ai-accelerator_2.1.2_rel_notes.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ originalFilePath: advocacy_docs/edb-postgres-ai/ai-accelerator/rel_notes/src/rel
55
editTarget: originalFilePath
66
---
77

8-
Released: 25 February 2025
8+
Released: 24 February 2025
99

1010
In this maintenance release, we fix two bugs and improve the model provider listing output.
1111

advocacy_docs/edb-postgres-ai/ai-accelerator/rel_notes/index.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ The EDB Postgres AI - AI Accelerator describes the latest version of AI Accelera
1818

1919
| AI Accelerator version | Release Date |
2020
|---|---|
21-
| [2.1.2](./ai-accelerator_2.1.2_rel_notes) | 25 Feb 2025 |
21+
| [2.1.2](./ai-accelerator_2.1.2_rel_notes) | 24 Feb 2025 |
2222
| [2.1.1](./ai-accelerator_2.1.1_rel_notes) | 03 Feb 2025 |
2323
| [2.0.0](./ai-accelerator_2.0.0_rel_notes) | 13 Jan 2025 |
2424
| [1.0.7](./ai-accelerator_1.0.7_rel_notes) | 10 Dec 2024 |

advocacy_docs/edb-postgres-ai/ai-accelerator/rel_notes/src/rel_notes_2.1.2.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# yaml-language-server: $schema=https://raw.githubusercontent.com/EnterpriseDB/docs/refs/heads/develop/tools/automation/generators/relgen/relnote-schema.json
22
product: AI Accelerator - Pipelines
33
version: 2.1.2
4-
date: 25 February 2025
4+
date: 24 February 2025
55
intro: |
66
In this maintenance release, we fix two bugs and improve the model provider listing output.
77
highlights: |

advocacy_docs/edb-postgres-ai/cloud-service/references/distributed_high_availability/pgd_cli_ba.mdx

+34-40
Original file line numberDiff line numberDiff line change
@@ -6,21 +6,22 @@ redirects:
66
- /biganimal/latest/using_cluster/pgd_cli_ba/ #generated for BigAnimal URL path removal branch
77
---
88

9-
When running a distributed high-availability cluster on Cloud Service, you can use the [PGD CLI](/pgd/latest/cli/) to manage cluster operations. Examples of these operations include switching over write leaders, performing cluster health checks, and viewing various details about nodes, groups, or other aspects of the cluster.
9+
When running a distributed high-availability cluster on Cloud Service, you can use the [PGD CLI](/pgd/latest/cli/) to manage cluster operations.
10+
Examples of these operations include switching over write leaders, performing cluster health checks, and viewing various details about nodes, groups, or other aspects of the cluster.
1011

1112
## Installing the PGD CLI
1213

1314
To [install the PGD CLI](/pgd/latest/cli/installing/), for Debian and Ubuntu machines, replace `<your-token>` with your EDB subscription token in the following command:
1415

1516
```bash
16-
curl -1sLf 'https://downloads.enterprisedb.com/&lt;your-token&gt;/postgres_distributed/setup.deb.sh' | sudo -E bash
17+
curl -1sLf 'https://downloads.enterprisedb.com/<your-token>/postgres_distributed/setup.deb.sh' | sudo -E bash
1718
sudo apt-get install edb-pgd5-cli
1819
```
1920

2021
For RHEL, Rocky, AlmaLinux, or Oracle Linux machines, make the replacement in this command:
2122

2223
```bash
23-
curl -1sLf 'https://downloads.enterprisedb.com/&lt;your-token&gt;/postgres_distributed/setup.rpm.sh' | sudo -E bash
24+
curl -1sLf 'https://downloads.enterprisedb.com/<your-token>/postgres_distributed/setup.rpm.sh' | sudo -E bash
2425
sudo yum install edb-pgd5-cli
2526
```
2627

@@ -48,70 +49,63 @@ Without a properly configured `.pgpass`, you receive a database connection error
4849
To use the PGD CLI with your database connection string, use the `--dsn` flag with your PGD CLI command:
4950

5051
```bash
51-
pgd show-nodes --dsn "<your_connection_string>"
52+
pgd nodes list --dsn "<your_connection_string>"
5253
```
5354

5455
## PGD commands in Cloud Service
5556

56-
!!!Note
57-
58-
Three EDB Postgres Distributed CLI commands don't work with distributed high-availability Cloud Service clusters: `create-proxy`, `delete-proxy`, and `alter-proxy-option`. These commands are managed by Cloud Service, as Cloud Service runs on Kubernetes. It's a technical best practice to have the Kubernetes operator handle these functions.
59-
!!!
60-
6157
The examples that follow show the most common PGD CLI commands with a Cloud Service cluster.
6258

63-
### `pgd check-health`
59+
### `pgd cluster show --health`
6460

65-
`pgd check-health` provides statuses with relevant messaging regarding the clock skew of node pairs, node accessibility, the current raft leader, replication slot health, and versioning consistency:
61+
`pgd cluster show --health` provides statuses with relevant messaging regarding the clock skew of node pairs, node accessibility, the current raft leader, replication slot health, and versioning consistency:
6662

6763
```
68-
$ pgd check-health --dsn "postgres://edb_admin@p-mbx2p83u9n-a.pg.biganimal.io:5432/bdrdb?sslmode=require"
64+
pgd cluster show --health --dsn "postgres://edb_admin@p-w75f4ib1pu-a.vmk31wilqpjeopka.biganimal.io:5432/bdrdb?sslmode=require"
6965
__OUTPUT__
70-
Check Status Message
71-
----- ------ -------
72-
ClockSkew Ok All BDR node pairs have clockskew within permissible limit
73-
Connection Ok All BDR nodes are accessible
74-
Raft Warning There is no RAFT_LEADER, an election might be in progress
75-
Replslots Ok All BDR replication slots are working correctly
76-
Version Ok All nodes are running same BDR versions
77-
```
66+
Check Status Details
67+
----------------- ------ -----------------------------------------------
68+
Connections Ok All BDR nodes are accessible
69+
Raft Ok Raft Consensus is working correctly
70+
Replication Slots Ok All PGD replication slots are working correctly
71+
Clock Skew Ok Clock drift is within permissible limit
72+
Versions Ok All nodes are running the same PGD version```
7873
79-
### `pgd show-nodes`
74+
### `pgd nodes list`
8075
81-
`pgd show-nodes` returns all the nodes in the distributed high-availability cluster and their summaries, including name, node id, group, and current/target state:
76+
`pgd nodes list` returns all the nodes in the distributed high-availability cluster and their summaries, including name, node id, group, and current/target state:
8277
8378
```
84-
$ pgd show-nodes --dsn "postgres://edb_admin@p-mbx2p83u9n-a.pg.biganimal.io:5432/bdrdb?sslmode=require"
79+
pgd nodes list --dsn "postgres://edb_admin@p-w75f4ib1pu-a.vmk31wilqpjeopka.biganimal.io:5432/bdrdb?sslmode=require"
8580
__OUTPUT__
86-
Node Node ID Group Type Current State Target State Status Seq ID
87-
---- ------- ----- ---- ------------- ------------ ------ ------
88-
p-mbx2p83u9n-a-1 3537039754 dc1 data ACTIVE ACTIVE Up 1
89-
p-mbx2p83u9n-a-2 3155790619 p-mbx2p83u9n-a data ACTIVE ACTIVE Up 2
90-
p-mbx2p83u9n-a-3 2604177211 p-mbx2p83u9n-a data ACTIVE ACTIVE Up 3
81+
Node Name Group Name Node Kind Join State Node Status
82+
---------------- -------------- --------- ---------- -----------
83+
p-w75f4ib1pu-a-1 p-w75f4ib1pu-a data ACTIVE Up
84+
p-w75f4ib1pu-a-2 p-w75f4ib1pu-a data ACTIVE Up
85+
p-w75f4ib1pu-a-3 p-w75f4ib1pu-a data ACTIVE Up
9186
```
9287
93-
### `pgd show-groups`
88+
### `pgd groups show`
9489
95-
`pgd show-groups` returns all groups in your distributed high-availability Cloud Service cluster. It also notes the node that's the current write leader of each group:
90+
`pgd groups show` returns all groups in your distributed high-availability Cloud Service cluster.
9691
9792
```
98-
$ pgd show-groups --dsn "postgres://edb_admin@p-mbx2p83u9n-a.pg.biganimal.io:5432/bdrdb?sslmode=require"
93+
pgd groups show --dsn "postgres://edb_admin@p-w75f4ib1pu-a.vmk31wilqpjeopka.biganimal.io:5432/bdrdb?sslmode=require"
9994
__OUTPUT__
100-
Group Group ID Type Parent Group Location Raft Routing Write Leader
101-
----- -------- ---- ------------ -------- ---- ------- ------------
102-
world 3239291720 global true true p-mbx2p83u9n-a-1
103-
dc1 4269540889 data p-mbx2p83u9n-a false false
104-
p-mbx2p83u9n-a 2800873689 data world true true p-mbx2p83u9n-a-3
95+
Group Name Parent Group Name Group Type Nodes
96+
-------------- ----------------- ---------- -----
97+
world global 0
98+
p-w75f4ib1pu-a world data 3
10599
```
106100
107-
### `pgd switchover`
101+
### `pgd group set-leader`
108102
109-
`pgd switchover` manually changes the write leader of the group and can be used to simulate a [failover](/pgd/latest/quickstart/further_explore_failover).
103+
`pgd group set-leader` manually changes the write leader of the group and can be used to simulate a [failover](/pgd/latest/quickstart/further_explore_failover).
110104
111105
```
112-
$ pgd switchover --group-name world --node-name p-mbx2p83u9n-a-2 --dsn "postgres://edb_admin@p-mbx2p83u9n-a.pg.biganimal.io:5432/bdrdb?sslmode=require"
106+
pgd group p-w75f4ib1pu-a set-leader p-w75f4ib1pu-a-2 --dsn "postgres://edb_admin@p-w75f4ib1pu-a.vmk31wilqpjeopka.biganimal.io:5432/bdrdb?sslmode=require"
113107
__OUTPUT__
114-
switchover is complete
108+
Command executed successfully
115109
```
116110
117111
See the [PGD CLI command reference](/pgd/latest/cli/command_ref/) for the full range of PGD CLI commands and their descriptions.

advocacy_docs/edb-postgres-ai/cloud-service/references/supported_cluster_types/distributed_highavailability.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ The witness node/witness group doesn't host data but exists for management purpo
1919

2020
!!!Note
2121

22-
Operations against a distributed high-availability cluster leverage the [EDB Postgres Distributed switchover](/pgd/latest/cli/command_ref/pgd_switchover/) feature, which provides subsecond interruptions during planned lifecycle operations.
22+
Operations against a distributed high-availability cluster leverage the [EDB Postgres Distributed set-leader](/pgd/latest/cli/command_ref/group/set-leader) feature, which provides subsecond interruptions during planned lifecycle operations.
2323

2424
## Single data location
2525

product_docs/docs/epas/17/database_administration/01_configuration_parameters/03_configuration_parameters_by_functionality/02_resource_usage_memory.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ These configuration parameters control resource use pertaining to memory.
1616

1717
**Parameter type:** Integer
1818

19-
**Default value:** 0
19+
**Default value:** 66
2020

2121
**Range:** 0 to 100
2222

product_docs/docs/pgd/4/index.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ navigation:
2727
- cli
2828
pdf: true
2929
directoryDefaults:
30-
version: "4.3.6"
30+
version: "4.3.7"
3131
---
3232

3333

0 commit comments

Comments
 (0)