Skip to content

Commit

Permalink
Merge pull request #2322 from EnterpriseDB/release/2022-02-11
Browse files Browse the repository at this point in the history
Release: 2022-02-11
  • Loading branch information
drothery-edb authored Feb 11, 2022
2 parents c6c1a05 + a6245f2 commit 8abd142
Show file tree
Hide file tree
Showing 27 changed files with 339 additions and 13 deletions.
Binary file added Docs 2.0 Process.docx
Binary file not shown.
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: 'Using Liquibase'
title: 'Using Liquibase Pro'
description: 'Walkthroughs of example usage scenarios'
---

Expand Down Expand Up @@ -156,4 +156,4 @@ The diagram below shows the details for the selected changeset.

<p align="center">
<img alt="Changeset details" src="Images/IntegrationViews5.png">
</p>
</p>
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: 'Using Nutanix'
title: 'Using Nutanix AHV'
description: 'Walkthroughs of example usage scenarios'
---

Expand Down
4 changes: 2 additions & 2 deletions advocacy_docs/partner_docs/RepostorGuide/05-UsingRepostor.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: 'Using Repostor'
title: 'Using Repostor Data Protector for PostgreSQL'
description: 'Walkthroughs of example usage scenarios'
---
The current RDP version is a command-line client. There are three commands that the user runs
Expand Down Expand Up @@ -52,4 +52,4 @@ Dropping database for visibility only.

<p align="center">
<img src="Images/RedirectedRestore.png">
</p>
</p>
2 changes: 1 addition & 1 deletion advocacy_docs/partner_docs/ThalesGuide/05-UsingThales.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: 'Using Thales'
title: 'Using Thales CipherTrust Transparent Encryption'
description: 'Walkthroughs of example usage scenarios'
---

Expand Down
12 changes: 12 additions & 0 deletions advocacy_docs/partner_docs/VeritasGuide/02-PartnerInformation.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
title: 'Partner Information'
description: 'Details for Veritas and NetBackup for PostgreSQL'

---
| &nbsp; | &nbsp; |
| ----------- | ----------- |
| **Partner Name** | Veritas |
| **Partner Product** | NetBackup for PostgreSQL |
| **Web Site** | https://www.veritas.com/ |
| **Version & Platform** | NetBackup for PostgreSQL 9.1: Linux, Windows |
| **Product Description** | NetBackup gives enterprise IT a simple and powerful way to ensure the integrity and availability of their data – from edge to core to cloud. NetBackup for PostgreSQL Agent extends the capabilities of NetBackup to include backup and restore of PostgreSQL databases. |
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
title: 'Solution Summary'
description: 'Brief explanation of the solution and its purpose'
---
NetBackup provides a non-distruptive way of validating your resiliency plan for assurance and compliance through automated recovery and rehearsal of business-critical applications. Moving data and spinning up applications when and where you need to without risking data loss requires business-level resiliency. Veritas NetBackup for PostgreSQL Agent extends the capabilities of NetBackup to include backup and restore of PostgreSQL databases. If a NetBackup environment is operational within an organization, then users can backup and restore EDB Postgres Advanced Server and EDB Postgres Extended Server with the help of Veritas NetBackup for PostgreSQL Agent.

<p align="center">
<img src="Images/ArchitectureUpdate4.png">
</p>
Original file line number Diff line number Diff line change
@@ -0,0 +1,123 @@
---
title: 'Configuring the Integration'
description: 'Walkthrough on configuring Veritas NetBackup for PostgreSQL'
---

**Implementing Veritas NetBackup solution for backup/restore of PostgreSQL databases requires the following components:**

- EDB Postgres Advanced Server (EPAS).
- Veritas NetBackup Server.
- Veritas NetBackup Client.
- Veritas NetBackup Agent for PostgreSQL.

### Prerequisites

- A running EDB Postgres Advanced Server (EPAS).
- A running Veritas NetBackup Server.
- Veritas NetBackup Client installed on the EPAS host.
- Veritas NetBackup PostgreSQL Agent installed on the EPAS host.


Configuring Veritas NetBackup for PostgreSQL consists of configuring the following components:
- Veritas NetBackup Agent for PostgreSQL.
- PostgreSQL server.

The steps below show an example of how to configure Veritas NetBackup for PostgreSQL for EPAS.

### Configuring Veritas NetBackup for PostgreSQL

1. Log on to the NetBackup Administration Console:

a. Use the credentials for the **root** user

b. Select the hostname for the NetBackup Master Server you want to administer

<p align="center">
<img src="Images/NetBackupAdminConsole.png">
</p>

2. Create a policy for EDB Postgres Advanced Servers:

!!! Note
Refer to the [Veritas NetBackup Administrator's Guide](https://www.veritas.com/content/support/en_US/doc/18716246-126559472-0/v42176014-126559472) for detailed information on policies.

a. Click on **NetBackup Management > Policies**, select the NetBackup server

b. Right mouse click and select **New Policy**

<p align="center">
<img src="Images/NetBackupDataPolicy1.png">
</p>

c. Enter the policy name in the **Add New Policy** dialog box and click OK

<p align="center">
<img src="Images/NetBackupDataPolicy2.png">
</p>

d. Select the **Clients** tab

e. Click on **New**

f. Enter the NetBackup client name in the **Add Client** dialog box, and click **OK**

<p align="center">
<img src="Images/NetBackupDataPolicy3.png">
</p>

g. Select the **Attributes** tab

h. Select **DataStore** for **Policy type**

i. Select **Policy storage** from available values

j. Set any other parameters you require for your policy and then click **OK**

<p align="center">
<img src="Images/NetBackupDataPolicy4.png">
</p>


3. On the NetBackup Client, update the agent configuration file `/usr/NBPostgreSQLAgent/nbpgsql.conf` to set the necessary parameters to make the agent work successfully with EPAS:
```
DB_USER= enterprisedb
DB_PORT=5444
DB_INSTANCE_NAME=edb
PGSQL_LIB_INSTALL_PATH= /usr/edb/as13/lib
MASTER_SERVER_NAME=<netbackup-master-server>
POLICY_NAME=<datastore-policy>
SCHEDULE_NAME= Default-Application-Backup
SNAPSHOT_SIZE=4MB
```

!!! Note
Value of **PGSQL_LIB_INSTALL_PATH** will be dependent on the version of EPAS installed.
Values of **MASTER_SERVER_NAME** and **POLICY_NAME** parameters must match the names of your NetBackup Master Server and DataStore Policy respectively.

In the sample configuration file above, the values for **DB_USER**, **DB_PORT**, **DB_INSTANCE_NAME**, and **PGSQL_LIB_INSTALL_PATH** have been substituted for EPAS as the default values are for Postgres.
Refer to the [Veritas NetBackup for PostgreSQL Administrator's Guide](https://www.veritas.com/content/support/en_US/doc/129277259-150015228-0/v129276458-150015228) for detailed description of the parameters.



### Configuring EDB Postgres Advanced Server

Set up WAL archiving on the EPAS server by using the steps below. WAL archiving prepares Postgresql/EPAS database servers for backup/recovery operations and is a precondition for any backup/recovery tool to work with the database server.

1. Create a writeable `<archivedir>` directory at your desired location.

2. Set the required parameters in the `postgresql.conf` file to turn on WAL archiving:
```
wal_level = archive
archive_mode = on
archive_timeout = 0
statement_timeout = 0
archive_command = test ! -f <archivedir>/%f && cp %p <archivedir>/%f
```

!!! Note
Replace `<archivedir>` in the `archive_command` parameter with the location of the directory created in Step 1.

3. Restart the PostgreSQL server.

Refer to the [Veritas NetBackup for PostgreSQL Administrator's Guide](https://www.veritas.com/content/support/en_US/doc/129277259-150015228-0/v129903049-150015228) for detailed information on how to configure EPAS for Veritas NetBackup Agent for PostgreSQL.

Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
---
title: 'Using Veritas NetBackup for PostgreSQL'
description: 'Walkthroughs of example usage scenarios'
---

Common backup/restore operations for PostgreSQL databases using Veritas NetBackup for PostgreSQL are:
- Performing backups - takes backup of the database and stores it in a predetermined location.
- Querying backups - lists available database backups.
- Performing restores - restores the database from a backup previously taken:
- Local restore - database files are restored to the same host as the client.
- Redirected restore - database files are restored to a different host than the client.



### Performing Backups

To take a backup of the database, enter the command on the NetBackup Client:

`/usr/NBPostgreSQLAgent/nbpgsql -o backup`


### Querying Backups

To list available database backups, enter the command on the NetBackup Client:

`/usr/NBPostgreSQLAgent/nbpgsql -o query`
<p align="center">
<img src="Images/BackupQuery.png">
</p>

### Performing Restores

Database restores can be performed in the following two scenarios:

- Local Restore.
- Redirected Restore.


#### Local Restore

In this scenario, the database files are restored on the original (source) database server host (default
option).

To perform a local restore, use the steps below:

1. Stop the database server.

2. Create the target directory to store the database files to be used for the restore operation.

3. Determine the database backup id you want to use for the restore by querying available backups:

`/usr/NBPostgreSQLAgent/nbpgsql -o query`

4. Restore the database files to the target directory:

`/usr/NBPostgreSQLAgent/nbpgsql -o restore -t <target-directory> -id <db-backup-id>`

5. Once the restore operation is completed, replace the data directory (PGDATA) with the contents
of the target directory.

6. Set the `restore_command` parameter in the `postgresql.conf` file:
```
restore_command = 'cp /var/lib/edb/as13/data/pgarchive/%f %p'
```

7. Start the PostgreSQL server.



#### Redirected Restore

In this scenario, the database files are restored on a (target) database server host which is different from the original (source) database server.

To perform a redirected restore, use the steps below:

1. Stop the database server on the target host.

2. Create the target directory on the target host to store the database files to be used for the restore operation.

3. Determine the database backup id you want to use for the restore by querying available backups on the source host:

`/usr/NBPostgreSQLAgent/nbpgsql -o query -C <source-db-server-host>`

4. Restore the database files to the target directory on the target host:

`/usr/NBPostgreSQLAgent/nbpgsql -o restore -t <target-directory> -id <db-backup-id> -C <source-db-server-host>`

5. Once the restore operation is completed, replace the data directory `PGDATA` on the target host with the contents of the target directory.

6. Set the `restore_command` parameter in the `postgresql.conf` file on the target host:
```
restore_command = 'cp /var/lib/edb/as13/data/pgarchive/%f %p'
```

7. Start the PostgreSQL server on the target host.
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
---
title: 'Certification Environment'
description: 'Overview of the certification environment used in the certification of NetBackup for PostgreSQL'
---

| &nbsp; | &nbsp; |
| ----------- | ----------- |
| **Certification Test Date** | December 28, 2021 |
| **EDB Postgres Advanced Server** | 11,12,13,14 |
| **Veritas NetBackup for PostgreSQL** | 9.1 |
| **Veritas NetBackup Server** | 9.1 |
| **Veritas NetBackup Client** | 9.1 |

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
12 changes: 12 additions & 0 deletions advocacy_docs/partner_docs/VeritasGuide/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
title: 'Veritas Implementation Guide'
indexCards: simple
directoryDefaults:
iconName: handshake
---

<p align="center">
<img src="Images/EDBPartnerProgram.png">
</p>
<h1 style="text-align: center;">EDB GlobalConnect Technology Partner Implementation Guide</h1>
<h3 style="text-align: center;">Veritas NetBackup for PostgreSQL</h3>
2 changes: 1 addition & 1 deletion product_docs/docs/efm/4/05_using_efm.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,7 @@ For example, if the properties file on node `10.0.1.10` includes a setting of `p
efm set-priority acctg 10.0.1.10 1
```

In the event of a failover, Failover Manager first retrieves information from Postgres streaming replication to confirm which standby node has the most recent data and promote the node with the least chance of data loss. If two standby nodes contain equally up-to-date data, the node with a higher user-specified priority value is promoted to orimary unless [use.replay.tiebreaker](04_configuring_efm/01_cluster_properties/#use_replay_tiebreaker) is set to `true`. To check the priority value of your standby nodes, use the command:
In the event of a failover, Failover Manager first retrieves information from Postgres streaming replication to confirm which standby node has the most recent data and promote the node with the least chance of data loss. If two standby nodes contain equally up-to-date data, the node with a higher user-specified priority value is promoted to primary unless [use.replay.tiebreaker](04_configuring_efm/01_cluster_properties/#use_replay_tiebreaker) is set to `true`. To check the priority value of your standby nodes, use the command:

`efm cluster-status <cluster_name>`

Expand Down
2 changes: 1 addition & 1 deletion product_docs/docs/pgbouncer/1.16/01_installation/index.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "Installation"
title: "Installing"

legacyRedirectsGenerated:
# This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
Expand Down
Loading

0 comments on commit 8abd142

Please sign in to comment.