-
Notifications
You must be signed in to change notification settings - Fork 251
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #1993 from EnterpriseDB/docs/biganimal-more-fixes
rebranding fixes
- Loading branch information
Showing
7 changed files
with
32 additions
and
32 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -11,19 +11,19 @@ You can connect to your cluster using [`psql`](http://postgresguide.com/utilitie | |
|
||
## Using `psql` | ||
To connect to your cluster using `psql`: | ||
1. Sign in to the [EDB Cloud](https://portal.edbcloud.com) portal. | ||
1. Sign in to the [BigAnimal](https://portal.biganimal.com) portal. | ||
|
||
1. Go to the [**Clusters**](https://portal.edbcloud.com/clusters) page. | ||
1. Go to the [**Clusters**](https://portal.biganimal.com/clusters) page. | ||
|
||
3. Select the name of your cluster. | ||
4. On the **Overview** tab, select the copy icon to the right of the **Quick Connect** field to copy the command for connecting to your cluster using `psql` to your clipboard. `psql` will prompt for the edb_admin user password you selected at cluster creation time. | ||
5. Paste the command in your terminal. | ||
|
||
## Using another client | ||
To connect to your cluster using a client other than `psql`: | ||
1. Sign in to the [EDB Cloud](https://portal.edbcloud.com) portal. | ||
1. Sign in to the [BigAnimal](https://portal.biganimal.com) portal. | ||
|
||
1. Go to the [**Clusters**](https://portal.edbcloud.com/clusters) page. | ||
1. Go to the [**Clusters**](https://portal.biganimal.com/clusters) page. | ||
|
||
2. Select the name of your cluster. | ||
3. Select the **Connect** tab. You can review and copy all the relevant information you need from this screen except for the edb_admin user password. Please consult the client driver documentation for the connection string format the driver uses. | ||
|
@@ -32,17 +32,17 @@ To connect to your cluster using a client other than `psql`: | |
|
||
Different clients can have different default TLS/SSL modes (sslmode). For example, `psql` defaults to `prefer`, which means the client will attempt to establish a TLS connection but fall back to non-TLS if the server does not support it. In the `psql` example provided by EDB in the **Quick Connect** field, `sslmode` is explicitly set to `require`, which means the client will attempt a TLS connection and fail if the connection to the server can't be encrypted. | ||
|
||
For public connections and in most environments, EDB recommends setting `sslmode` to `verify-full`. This ensures that you connect to the server you specified and that the connection is encrypted. EDB Cloud generates certificates with LetsEncrypt, a widely trusted certificate authority. Your client machine may already have a bundled CA certificate for LetsEncrypt, for example, at `/etc/ssl/certs/ca-certificates.crt` or `/etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem`. If it doesn't, your client machine needs a [CA certificate for Let's Encrypt](https://letsencrypt.org/certificates/). Once the CA certificate is in place on your client machine, configure the `sslrootcert` parameter to its location and set the `sslmode` parameter to `verify-full` to verify the certificate to fully validate the connection: | ||
For public connections and in most environments, EDB recommends setting `sslmode` to `verify-full`. This ensures that you connect to the server you specified and that the connection is encrypted. BigAnimal generates certificates with LetsEncrypt, a widely trusted certificate authority. Your client machine may already have a bundled CA certificate for LetsEncrypt, for example, at `/etc/ssl/certs/ca-certificates.crt` or `/etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem`. If it doesn't, your client machine needs a [CA certificate for Let's Encrypt](https://letsencrypt.org/certificates/). Once the CA certificate is in place on your client machine, configure the `sslrootcert` parameter to its location and set the `sslmode` parameter to `verify-full` to verify the certificate to fully validate the connection: | ||
|
||
``` | ||
psql -W "postgres://[email protected].edbcloud.io:5432/edb_admin?sslmode=verify-full&sslrootcert=/usr/share/ca-certificates/isrgrootx1.pem" | ||
psql -W "postgres://[email protected].biganimal.io:5432/edb_admin?sslmode=verify-full&sslrootcert=/usr/share/ca-certificates/isrgrootx1.pem" | ||
``` | ||
|
||
Once connected to the cluster using `psql`, the `conninfo` meta-command shows the encryption protocol being used for communication. In the case of EDB Cloud, TLS (v1.2+) is supported: | ||
Once connected to the cluster using `psql`, the `conninfo` meta-command shows the encryption protocol being used for communication. In the case of BigAnimal, TLS (v1.2+) is supported: | ||
|
||
``` | ||
edb_admin=> \conninfo | ||
You are connected to database "edb_admin" as user "edb_admin" on host "xxxxxxxxx.xxxxx.edbcloud.io" at port "5432". | ||
You are connected to database "edb_admin" as user "edb_admin" on host "xxxxxxxxx.xxxxx.biganimal.io" at port "5432". | ||
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off) | ||
``` | ||
|
||
|