From 4f2d606f7432b6d37a42cd35ddd2eb1fb9916279 Mon Sep 17 00:00:00 2001 From: drothery-edb Date: Mon, 2 May 2022 17:17:03 -0400 Subject: [PATCH 01/32] BigAnimal: Azure AD and Okta IdP topics --- .../indentity_provider/azure_ad.mdx | 62 +++++++++++++++++++ .../index.mdx} | 0 2 files changed, 62 insertions(+) create mode 100644 product_docs/docs/biganimal/release/getting_started/indentity_provider/azure_ad.mdx rename product_docs/docs/biganimal/release/getting_started/{identity_provider.mdx => indentity_provider/index.mdx} (100%) diff --git a/product_docs/docs/biganimal/release/getting_started/indentity_provider/azure_ad.mdx b/product_docs/docs/biganimal/release/getting_started/indentity_provider/azure_ad.mdx new file mode 100644 index 00000000000..a78c2d58a3b --- /dev/null +++ b/product_docs/docs/biganimal/release/getting_started/indentity_provider/azure_ad.mdx @@ -0,0 +1,62 @@ +--- +title: "Using Azure AD as your identity provider" +navTitle: "Azure AD" +--- + +## Prerequisites + +- In order to connect BigAnimal to Azure AD, you must have one of the following roles in Azure: + + - Global Administrator + - Cloud Application Administrator + - Application Administrator + + or be the owner of the service principal. + +- Unique URL and access code provided in an email from cloudcare@enterprisedb.com. Contact cloudcare@enterprisedb.com if you have not received the email. The URL becomes invalid once you have set up your identity provider with BigAnimal. If you experience any issues with the code or identity provider set up, contact [Support](/biganimal/release/overview/support). + + +## Setting up BigAnimal with Azure AD + +1. Open the link in the email sent from cloudcare@enterprisedb.com to access the Set Up Identity Provider page in BigAnimal. +1. In a separate browser tab or window, sign into the [Azure Active Directory Admin Center](https://aad.portal.azure.com/). +1. Select **Enterprise Applications** from the left navigation pane. On the Enterprise Applications page, + 1. Select **New application > Create your own application**. + + 1. Enter a name for your application. + 1. Select the third choice for what you are looking to do with your application: **Integrate any other application you don’t find in the gallery (Non-gallery)**. +1. Once the application is created, select **Single sign-on** from the left navigation menu. On the Single sign-in page, + 1. Select **SAML** as your single sign-on method. + 1. Update the Basic SAML Configuration by copying and pasting the following information from the Set Up Identity Provider page in BigAnimal to the SAML Configuration menu in Azure AD: + + | Copy from BigAnimal | Paste in SAML Configuration | + | ------------------------------ | --------------------------- | + | Audience URI | Identifier (Entity ID) | + | Assertion Consumer Service URL | Reply URL | + 1. We recommend the following configuration for Attributes & Claims: + + | Claim name | Value | Note | + |--------------------------------------------------------------------|-----------------------------------------------------|------------------| + | Unique User Identifier (Name ID) | user.userprincipalname [nameid-format:emailAddress] | Required claim | + | http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress | user.mail | Additional claim | + | http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname | user.givenname | Additional claim | + | http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name | user.displayname | Additional claim | + | http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname | user.surname | Additional claim | + 1. Under **SAML Signing Certificate**, select **Download** for the Base64-encoded certificate. + 1. Copy the **Login URL** value. +1. Select **Properties** from the left navigation pane. On the Properties page, if you do not want all of the users in Azure AD to be able to use BigAnimal, select **No** for the “Assignment required?” question. Otherwise, select **Yes** and assign the specified users to this Enterprise Application explicitly on the Users and Groups page. +1. On the Setup Config tab on the Set Up Identity Provider page in BigAnimal, + 1. Paste the Login URL value you copied from the Single sign-on page in Azure AD as the **Single Sign-On URL**. + + 1. For **Identity Provider Signature Certificate**, upload the Base64-encoded certificate previously downloaded from Azure. + 1. Choose the appropriate method for **Request Binding**. Azure AD supports HTTP POST and HTTP Redirect. + 1. Select `rsa-sha256` for the **Response Signature Algorithm**. +1. Select **Test Connection**. If the connection is successful, select **Sign in to BigAnimal** to complete the setup process in the BigAnimal portal. + + + + + + + + diff --git a/product_docs/docs/biganimal/release/getting_started/identity_provider.mdx b/product_docs/docs/biganimal/release/getting_started/indentity_provider/index.mdx similarity index 100% rename from product_docs/docs/biganimal/release/getting_started/identity_provider.mdx rename to product_docs/docs/biganimal/release/getting_started/indentity_provider/index.mdx From 7f4c7ca991501ea67cdfc67fa4775e6f0f77a9b2 Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Tue, 3 May 2022 17:54:52 +0530 Subject: [PATCH 02/32] PEM 8 - Reorg fixes --- product_docs/docs/pem/8/considerations.mdx | 24 +++++++++++ .../configuring_2fa_authentication.mdx | 0 ..._server_to_use_kerberos_authentication.mdx | 0 ..._server_to_use_windows_kerberos_server.mdx | 0 .../authentication_options/index.mdx | 0 .../docs/pem/8/considerations/index.mdx | 21 ++++++++++ ...rver_and_apache_web_server_preferences.mdx | 0 .../pem_pgbouncer/configuring_pgBouncer.mdx | 0 .../configuring_the_pem_agent.mdx | 0 .../pem_pgbouncer/index.mdx | 0 ..._agent_connection_management_mechanism.mdx | 0 .../preparing_the_pem_database_server.mdx | 0 .../apache_httpd_security_configuration.mdx | 0 .../pem_security_best_practices/index.mdx | 0 .../pem_application_configuration.mdx | 0 .../setup_ha_using_efm.mdx | 0 product_docs/docs/pem/8/index.mdx | 1 + .../pem/8/installing_pem_server/index.mdx | 4 -- .../installing_on_linux/index.mdx | 2 - .../x86/pem_server_sles12_x86.mdx | 40 ++++++++++++++++++- ...rerequisites_for_installing_pem_server.mdx | 2 +- 21 files changed, 86 insertions(+), 8 deletions(-) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/authentication_options/configuring_2fa_authentication.mdx (100%) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/authentication_options/configuring_the_pem_server_to_use_kerberos_authentication.mdx (100%) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/authentication_options/configuring_the_pem_server_to_use_windows_kerberos_server.mdx (100%) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/authentication_options/index.mdx (100%) create mode 100644 product_docs/docs/pem/8/considerations/index.mdx rename product_docs/docs/pem/8/{installing_pem_server/installing_on_linux => considerations}/installing_pem_server_and_apache_web_server_preferences.mdx (100%) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/pem_pgbouncer/configuring_pgBouncer.mdx (100%) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/pem_pgbouncer/configuring_the_pem_agent.mdx (100%) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/pem_pgbouncer/index.mdx (100%) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/pem_pgbouncer/pem_server_pem_agent_connection_management_mechanism.mdx (100%) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/pem_pgbouncer/preparing_the_pem_database_server.mdx (100%) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/pem_security_best_practices/apache_httpd_security_configuration.mdx (100%) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/pem_security_best_practices/index.mdx (100%) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/pem_security_best_practices/pem_application_configuration.mdx (100%) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/setup_ha_using_efm.mdx (100%) rename product_docs/docs/pem/8/{installing_pem_server/installing_on_linux => }/prerequisites_for_installing_pem_server.mdx (99%) diff --git a/product_docs/docs/pem/8/considerations.mdx b/product_docs/docs/pem/8/considerations.mdx index 8143ecaf51a..2d57e82ddad 100644 --- a/product_docs/docs/pem/8/considerations.mdx +++ b/product_docs/docs/pem/8/considerations.mdx @@ -11,3 +11,27 @@ There are a number of things to consider before deploying Postgres Enterprise Ma | What type of authentication to use? | [Authentication options](/pem/latest/installing_pem_server/authentication_options/) | | What actions should you take to avoid security vulnerabilities? | [Securing your deployment](/pem/latest/installing_pem_server/pem_security_best_practices/) | | Where to host the Apache web server? | [Web server installation options](/pem/latest/installing_pem_server/installing_on_linux/installing_pem_server_and_apache_web_server_preferences) | + + +## Web server installation options + +During the PEM server installation, you can specify your hosting preferences for the Apache web server: + +#### PEM server and Apache web server on separate hosts + +1. Install the PEM server on both the hosts, for steps see [Installing the PEM server on Linux](using_edb_repository). +2. Configure the PEM server host by selecting the `Database` option on the first host. +3. Configure an Apache web server by selecting the `Web Services` option on the second host. + +For detailed information about configuring a PEM server, see [Configuring the PEM server on Linux platforms](configuring_the_pem_server_on_linux). + +!!! Note + For production environments, it is a best practice to have PEM server and Apache web server on separates hosts. + +#### PEM server and Apache web server on the same host + +1. Install the PEM server, for steps see [Installing the PEM server on Linux](using_edb_repository). +2. Run the configuration script, select the `Web Services and Database` option to install PEM Server and Apache Web Server on the same host, for steps see [Configuring the PEM server on Linux platforms](configuring_the_pem_server_on_linux). + +!!! Note + For non-production environments, it is a best practice to have PEM server and Apache web server on same hosts. diff --git a/product_docs/docs/pem/8/installing_pem_server/authentication_options/configuring_2fa_authentication.mdx b/product_docs/docs/pem/8/considerations/authentication_options/configuring_2fa_authentication.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/authentication_options/configuring_2fa_authentication.mdx rename to product_docs/docs/pem/8/considerations/authentication_options/configuring_2fa_authentication.mdx diff --git a/product_docs/docs/pem/8/installing_pem_server/authentication_options/configuring_the_pem_server_to_use_kerberos_authentication.mdx b/product_docs/docs/pem/8/considerations/authentication_options/configuring_the_pem_server_to_use_kerberos_authentication.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/authentication_options/configuring_the_pem_server_to_use_kerberos_authentication.mdx rename to product_docs/docs/pem/8/considerations/authentication_options/configuring_the_pem_server_to_use_kerberos_authentication.mdx diff --git a/product_docs/docs/pem/8/installing_pem_server/authentication_options/configuring_the_pem_server_to_use_windows_kerberos_server.mdx b/product_docs/docs/pem/8/considerations/authentication_options/configuring_the_pem_server_to_use_windows_kerberos_server.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/authentication_options/configuring_the_pem_server_to_use_windows_kerberos_server.mdx rename to product_docs/docs/pem/8/considerations/authentication_options/configuring_the_pem_server_to_use_windows_kerberos_server.mdx diff --git a/product_docs/docs/pem/8/installing_pem_server/authentication_options/index.mdx b/product_docs/docs/pem/8/considerations/authentication_options/index.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/authentication_options/index.mdx rename to product_docs/docs/pem/8/considerations/authentication_options/index.mdx diff --git a/product_docs/docs/pem/8/considerations/index.mdx b/product_docs/docs/pem/8/considerations/index.mdx new file mode 100644 index 00000000000..3de6302d152 --- /dev/null +++ b/product_docs/docs/pem/8/considerations/index.mdx @@ -0,0 +1,21 @@ +--- +title: "Deployment considerations" +navigation: + +- installing_pem_server_and_apache_web_server_preferences +- authentication_options +- setup_ha_using_efm +- pem_pgbouncer +- pem_security_best_practices +--- + +There are a number of things to consider before deploying Postgres Enterprise Manager. + +| Considerations | Implementation instructions | +| ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | +| Is a standalone server sufficient or do you need a high availability architecture? | [Installing the server](/pem/latest/installing_pem_server/) or [Deploying high availability](/pem/latest/installing_pem_server/setup_ha_using_efm/) | +| Do you need to implement connection pooling? | [Deploying connection pooling](/pem/latest/installing_pem_server/pem_pgbouncer/) | +| What type of authentication to use? | [Authentication options](/pem/latest/installing_pem_server/authentication_options/) | +| What actions should you take to avoid security vulnerabilities? | [Securing your deployment](/pem/latest/installing_pem_server/pem_security_best_practices/) | +| Where to host the Apache web server? | [Web server installation options](/pem/latest/installing_pem_server/installing_on_linux/installing_pem_server_and_apache_web_server_preferences) | + diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/installing_pem_server_and_apache_web_server_preferences.mdx b/product_docs/docs/pem/8/considerations/installing_pem_server_and_apache_web_server_preferences.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/installing_on_linux/installing_pem_server_and_apache_web_server_preferences.mdx rename to product_docs/docs/pem/8/considerations/installing_pem_server_and_apache_web_server_preferences.mdx diff --git a/product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/configuring_pgBouncer.mdx b/product_docs/docs/pem/8/considerations/pem_pgbouncer/configuring_pgBouncer.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/configuring_pgBouncer.mdx rename to product_docs/docs/pem/8/considerations/pem_pgbouncer/configuring_pgBouncer.mdx diff --git a/product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/configuring_the_pem_agent.mdx b/product_docs/docs/pem/8/considerations/pem_pgbouncer/configuring_the_pem_agent.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/configuring_the_pem_agent.mdx rename to product_docs/docs/pem/8/considerations/pem_pgbouncer/configuring_the_pem_agent.mdx diff --git a/product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/index.mdx b/product_docs/docs/pem/8/considerations/pem_pgbouncer/index.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/index.mdx rename to product_docs/docs/pem/8/considerations/pem_pgbouncer/index.mdx diff --git a/product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/pem_server_pem_agent_connection_management_mechanism.mdx b/product_docs/docs/pem/8/considerations/pem_pgbouncer/pem_server_pem_agent_connection_management_mechanism.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/pem_server_pem_agent_connection_management_mechanism.mdx rename to product_docs/docs/pem/8/considerations/pem_pgbouncer/pem_server_pem_agent_connection_management_mechanism.mdx diff --git a/product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/preparing_the_pem_database_server.mdx b/product_docs/docs/pem/8/considerations/pem_pgbouncer/preparing_the_pem_database_server.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/preparing_the_pem_database_server.mdx rename to product_docs/docs/pem/8/considerations/pem_pgbouncer/preparing_the_pem_database_server.mdx diff --git a/product_docs/docs/pem/8/installing_pem_server/pem_security_best_practices/apache_httpd_security_configuration.mdx b/product_docs/docs/pem/8/considerations/pem_security_best_practices/apache_httpd_security_configuration.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/pem_security_best_practices/apache_httpd_security_configuration.mdx rename to product_docs/docs/pem/8/considerations/pem_security_best_practices/apache_httpd_security_configuration.mdx diff --git a/product_docs/docs/pem/8/installing_pem_server/pem_security_best_practices/index.mdx b/product_docs/docs/pem/8/considerations/pem_security_best_practices/index.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/pem_security_best_practices/index.mdx rename to product_docs/docs/pem/8/considerations/pem_security_best_practices/index.mdx diff --git a/product_docs/docs/pem/8/installing_pem_server/pem_security_best_practices/pem_application_configuration.mdx b/product_docs/docs/pem/8/considerations/pem_security_best_practices/pem_application_configuration.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/pem_security_best_practices/pem_application_configuration.mdx rename to product_docs/docs/pem/8/considerations/pem_security_best_practices/pem_application_configuration.mdx diff --git a/product_docs/docs/pem/8/installing_pem_server/setup_ha_using_efm.mdx b/product_docs/docs/pem/8/considerations/setup_ha_using_efm.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/setup_ha_using_efm.mdx rename to product_docs/docs/pem/8/considerations/setup_ha_using_efm.mdx diff --git a/product_docs/docs/pem/8/index.mdx b/product_docs/docs/pem/8/index.mdx index c356ba4704c..e18951cd5e1 100644 --- a/product_docs/docs/pem/8/index.mdx +++ b/product_docs/docs/pem/8/index.mdx @@ -5,6 +5,7 @@ directoryDefaults: navigation: - pem_rel_notes - supported_platforms + - prerequisites_for_installing_pem_server - "#Planning" - pem_architecture - considerations diff --git a/product_docs/docs/pem/8/installing_pem_server/index.mdx b/product_docs/docs/pem/8/installing_pem_server/index.mdx index f93553042b4..20be9ca7e72 100644 --- a/product_docs/docs/pem/8/installing_pem_server/index.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/index.mdx @@ -6,10 +6,6 @@ navigation: - installing_on_linux - installing_on_windows -- authentication_options -- setup_ha_using_efm -- pem_pgbouncer -- pem_security_best_practices --- The two primary deployment options for Postgres Enterprise Manager are a standalone server or a high availability environment. diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/index.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/index.mdx index baf244d1854..64f3503cba3 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/index.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/index.mdx @@ -10,8 +10,6 @@ redirects: - /pem/latest/pem_inst_guide_linux/04_installing_postgres_enterprise_manager/ navigation: -- prerequisites_for_installing_pem_server -- installing_pem_server_and_apache_web_server_preferences - creating_pem_repository_in_isolated_network - using_edb_repository - configuring_the_pem_server_on_linux diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx index 19043551701..e7c6d36493d 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx @@ -1,8 +1,9 @@ --- title: "SLES 12" --- -There are three steps to completing an installation: +Follow these steps to completing an installation: +- [Prerequisites](#prerequisites) - [Setting up the repository](#setting-up-the-repository) - [Installing the package](#installing-the-package) - [Performing the initial configuration](#initial-configuration) @@ -14,6 +15,43 @@ For each step, you must be logged in as superuser. sudo su - ``` +## Prerequisites + + +1. Install an Advanced Server or PostgresSQL database server to hold the `pem` backend database. Configure the Postgres authentication on the backend database. For more details see [Software prerequisites](). + +2. Ensure that the `sslutils` extension and `hstore` contrib module are installed on your backend database. + + - On an Advanced Server backend database, the `sslutils` extension and `hstore` contrib module are by default installed along with Advanced Server. + + - If you are using a PostgreSQL backend database, ensure you have access to the PostgreSQL community repository, and then install `sslutils` extension and `hstore` contrib module. Use the applicable install command for your operating system: + + ```text + zypper install postgresql-_sslutils postgresql-contrib + ``` + + Where, `x` is the server version. + +3. Adjust your firewall restrictions. + + If you are using a firewall, you must allow access to port `8443` on the PEM backend database: + + ```text + firewall-cmd --permanent --zone=public --add-port=8443/tcp + + firewall-cmd --reload + ``` + +4. PEM is dependent on third-party components from the vendor repository, including the python3, libboost, openssl, snmp++, libcurl, etc. To ensure these components are up to date, you should update your operating system using following platform-specific commands. Minimum version require for openssl is 1.0.2k. + + ```text + zypper update + ``` + +5. Supported locales + + Currently, the PEM server and web interface support a locale of `English(US) en_US` and use of a period (.) as a language separator character. Using an alternate locale, or a separator character other than a period may result in errors. + Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). ## Setting up the Repository diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/prerequisites_for_installing_pem_server.mdx b/product_docs/docs/pem/8/prerequisites_for_installing_pem_server.mdx similarity index 99% rename from product_docs/docs/pem/8/installing_pem_server/installing_on_linux/prerequisites_for_installing_pem_server.mdx rename to product_docs/docs/pem/8/prerequisites_for_installing_pem_server.mdx index 5472c4c5f13..7b40ed276ed 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/prerequisites_for_installing_pem_server.mdx +++ b/product_docs/docs/pem/8/prerequisites_for_installing_pem_server.mdx @@ -1,6 +1,6 @@ --- title: "Prerequisites for installing the PEM server on Linux" -navTitle: "Prerequisites" +navTitle: "Requirements" legacyRedirectsGenerated: # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - "/edb-docs/d/edb-postgres-enterprise-manager/installation-getting-started/linux-installation-guide/8.0/prerequisites_for_installing_pem_server.html" From f8fd9bee57677632f78f66262625fa58a1a9d372 Mon Sep 17 00:00:00 2001 From: drothery-edb Date: Tue, 3 May 2022 14:49:00 -0400 Subject: [PATCH 03/32] first draft of Okta topic --- .../azure_ad.mdx | 44 ++++++----- .../index.mdx | 12 ++- .../identity_provider/okta.mdx | 73 +++++++++++++++++++ 3 files changed, 108 insertions(+), 21 deletions(-) rename product_docs/docs/biganimal/release/getting_started/{indentity_provider => identity_provider}/azure_ad.mdx (55%) rename product_docs/docs/biganimal/release/getting_started/{indentity_provider => identity_provider}/index.mdx (94%) create mode 100644 product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx diff --git a/product_docs/docs/biganimal/release/getting_started/indentity_provider/azure_ad.mdx b/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx similarity index 55% rename from product_docs/docs/biganimal/release/getting_started/indentity_provider/azure_ad.mdx rename to product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx index a78c2d58a3b..6ec15c8ccb2 100644 --- a/product_docs/docs/biganimal/release/getting_started/indentity_provider/azure_ad.mdx +++ b/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx @@ -1,17 +1,21 @@ --- title: "Using Azure AD as your identity provider" navTitle: "Azure AD" +description: "Using Azure AD as your identity provider for your Azure account" --- ## Prerequisites -- In order to connect BigAnimal to Azure AD, you must have one of the following roles in Azure: +- In order to connect BigAnimal to Azure AD, you must either: - - Global Administrator - - Cloud Application Administrator - - Application Administrator + - Have one of the following roles in Azure: - or be the owner of the service principal. + - Global Administrator + + - Cloud Application Administrator + - Application Administrator + + - Be the owner of the service principal - Unique URL and access code provided in an email from cloudcare@enterprisedb.com. Contact cloudcare@enterprisedb.com if you have not received the email. The URL becomes invalid once you have set up your identity provider with BigAnimal. If you experience any issues with the code or identity provider set up, contact [Support](/biganimal/release/overview/support). @@ -19,7 +23,7 @@ navTitle: "Azure AD" ## Setting up BigAnimal with Azure AD 1. Open the link in the email sent from cloudcare@enterprisedb.com to access the Set Up Identity Provider page in BigAnimal. -1. In a separate browser tab or window, sign into the [Azure Active Directory Admin Center](https://aad.portal.azure.com/). +1. In a separate browser tab or window, log into the [Azure Active Directory Admin Center](https://aad.portal.azure.com/). 1. Select **Enterprise Applications** from the left navigation pane. On the Enterprise Applications page, 1. Select **New application > Create your own application**. @@ -35,24 +39,26 @@ navTitle: "Azure AD" | Assertion Consumer Service URL | Reply URL | 1. We recommend the following configuration for Attributes & Claims: - | Claim name | Value | Note | - |--------------------------------------------------------------------|-----------------------------------------------------|------------------| - | Unique User Identifier (Name ID) | user.userprincipalname [nameid-format:emailAddress] | Required claim | - | http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress | user.mail | Additional claim | - | http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname | user.givenname | Additional claim | - | http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name | user.displayname | Additional claim | - | http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname | user.surname | Additional claim | + | Claim name | Value | Note | + |----------------------------------|-----------------------------------------------------|------------------| + | Unique User Identifier (Name ID) | user.userprincipalname [nameid-format:emailAddress] | Required claim | + | <assertion_path>/emailaddress | user.mail | Additional claim | + | <assertion_path>/givenname | user.givenname | Additional claim | + | <assertion_path>/name | user.displayname | Additional claim | + | <assertion_path>/surname | user.surname | Additional claim | + + Where <assertion_path> is http://schemas.xmlsoap.org/ws/2005/05/identity/claims. + 1. Under **SAML Signing Certificate**, select **Download** for the Base64-encoded certificate. 1. Copy the **Login URL** value. -1. Select **Properties** from the left navigation pane. On the Properties page, if you do not want all of the users in Azure AD to be able to use BigAnimal, select **No** for the “Assignment required?” question. Otherwise, select **Yes** and assign the specified users to this Enterprise Application explicitly on the Users and Groups page. +1. Select **Properties** from the left navigation pane. On the Properties page, if you do not want all of the users in Azure AD to be able to use BigAnimal, answer `No` for the **Assignment required?** question. Otherwise, answer `Yes` and assign the specified users to this Enterprise Application explicitly on the Users and Groups page. 1. On the Setup Config tab on the Set Up Identity Provider page in BigAnimal, 1. Paste the Login URL value you copied from the Single sign-on page in Azure AD as the **Single Sign-On URL**. - - 1. For **Identity Provider Signature Certificate**, upload the Base64-encoded certificate previously downloaded from Azure. - 1. Choose the appropriate method for **Request Binding**. Azure AD supports HTTP POST and HTTP Redirect. - 1. Select `rsa-sha256` for the **Response Signature Algorithm**. -1. Select **Test Connection**. If the connection is successful, select **Sign in to BigAnimal** to complete the setup process in the BigAnimal portal. + 1. For **Identity Provider Signature Certificate**, upload the Base64-encoded certificate downloaded from Azure. + 1. Choose the appropriate method for **Request Binding**. Azure AD supports `HTTP POST` and `HTTP Redirect`. + 1. Select `rsa-sha256` for the **Response Signature Algorithm**. + 1. Select **Test Connection**. If the connection is successful, select **Sign in to BigAnimal** to complete the setup process in the BigAnimal portal. diff --git a/product_docs/docs/biganimal/release/getting_started/indentity_provider/index.mdx b/product_docs/docs/biganimal/release/getting_started/identity_provider/index.mdx similarity index 94% rename from product_docs/docs/biganimal/release/getting_started/indentity_provider/index.mdx rename to product_docs/docs/biganimal/release/getting_started/identity_provider/index.mdx index 4d55e735d5f..ec26caae516 100644 --- a/product_docs/docs/biganimal/release/getting_started/indentity_provider/index.mdx +++ b/product_docs/docs/biganimal/release/getting_started/identity_provider/index.mdx @@ -1,6 +1,6 @@ --- title: "Setting up your identity provider" -navTitle: Setting up your identity provider +navTitle: "Setting up your identity provider" --- If you purchased BigAnimal directly from EDB, you must set up your identity provider (IDP) before accessing BigAnimal for the first time. After setting up your identity provider, you can add users to BigAnimal by adding them to the designated group in your identity provider. Once you've logged into BigAnimal using your identity provider, you can set up your cloud service provider (CSP) in the BigAnimal portal to complete onboarding. If you purchased through Azure Marketplace, BigAnimal authenticates users using Azure Active Directory (AD) and you don't have to complete these steps as Azure AD is linked during subscription. @@ -47,7 +47,7 @@ On the Set Up Identity Provider page: For example: - ![](images/nameID.png) + ![](../images/nameID.png) 3. On the **Setup Configuration** tab, enter the configuration information for your preferred SAML identity provider: | Field | Description | @@ -61,6 +61,7 @@ On the Set Up Identity Provider page: Once your identity provider is set up, you can view your connection status, ID, login URL, audience URI, and assertion consumer service URL from the BigAnimal portal on the **Admin > Identity Provider** page. + ## Manage roles for added users You add users through your identity provider. A user who is added in the identity provider is automatically added to BigAnimal. BigAnimal assigns them with the default role of reader. You manage roles and permissions from BigAnimal. See [Managing portal access](../administering_cluster/01_portal_access/). @@ -69,6 +70,13 @@ You add users through your identity provider. A user who is added in the identit A user is created in BigAnimal only after they log in. After they log in, you can change their BigAnimal role. + +## Setting up specific identity providers + +For step-by-step instructions for setting up specific identity provides, see: +- [Using Azure AD as your identity provider](azure_ad) +- [Using Okta as your identity provider](okta) + ## Next steps [Setting up your cloud service provider](02_connecting_to_your_cloud/01_connecting_your_own_cloud) diff --git a/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx b/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx new file mode 100644 index 00000000000..df722e3a6ed --- /dev/null +++ b/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx @@ -0,0 +1,73 @@ +--- +title: "Using Okta as your identity provider" +navTitle: "Okta" +description: "Using Okta as your identity provider for your Azure or AWS account" +--- + +## Prerequisites + +- In order to connect BigAnimal to Azure AD, you must either: + + - Have one of the following roles in Okta: + + - Super Administrator + - Application Administrator + + - A custom admin role with similar permissions. + + [Learn more](https://help.okta.com/oie/en-us/Content/Topics/Security/administrators-learn-about-admins.htm) about Okta administrator roles. + +- Unique URL and access code provided in an email from cloudcare@enterprisedb.com. Contact cloudcare@enterprisedb.com if you have not received the email. The URL becomes invalid once you have set up your identity provider with BigAnimal. If you experience any issues with the code or identity provider set up, contact [Support](/biganimal/release/overview/support). + + +## Setting up BigAnimal with Azure AD + +1. Open the link in the email sent from cloudcare@enterprisedb.com to access the Set Up Identity Provider page in BigAnimal. +1. In a separate browser tab or window, log into Okta’s Admin Console. +1. Select **Applications** from the left navigation pane. On the Applications page, + 1. Select **Create App Integration**. + + 1. Select SAML 2.0 as the sign-in method. + 1. Enter a name for your application. + 1. Select **Do not display application icon to users** and **Do not display application icon in the Okta Mobile app**. + +1. Next to go to the Configure SAML step. + 1. Copy and paste the following information from the Set Up Identity Provider page in BigAnimal to Okta: + + | Copy from BigAnimal | Paste in Okta | + | ------------------------------ | --------------------------- | + | Audience URI | Audience URI (SP Entity ID) | + | Assertion Consumer Service URL | Single sign on URL | + 1. We recommend the following configuration in the Attribute Statements section: + + | Name | Value | Notes | + |------------------------------------|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| + | <assertion_path>/name | user.name | The name field will default to the user’s email. Alternatively, you can set the value as the following Okta expression to combine the first and last names: `user.firstName + “ “ + user.lastName` | + | <assertion_path>/emailaddress | user.email | | + | <assertion_path>/nameidentifier | user.userId | Optional | + | <assertion_path>/surname | user.lastName | | + | <assertion_path>/givenname | user.firstName | | + + + Where <assertion_path> is http://schemas.xmlsoap.org/ws/2005/05/identity/claims. + + 1. On the Assignments tab on the Applications page, select **Assign** to assign people or groups to the newly created application. If you will be signing into BigAnimal, make sure to assign yourself. + 1. On the Sign On tab, select **View SAML setup instructions** to open a tab with instructions for your application. + 1. Copy from the Identity Provider Single Sign-on URL from step 1 of the SAML setup instructions. + 1. Select **Download certificate** in step 3 of the instructions. + + 1. In BigAnimal, on the Setup Config tab on the Set Up Identity Provider page, + 1. Paste the Identity Provider Single Sign-on URL you copied from Okta into the **Single Sign-On URL** field. + 1. For **Identity Provider Signature Certificate**, upload the certificate downloaded from Okta. + 1. Choose the appropriate method for **Request Binding**. Okta supports `HTTP POST` and `HTTP Redirect`. + 1. Select `rsa-sha256` for the **Response Signature Algorithm**. + 1. Select **Test Connection**. If the connection is successful, select **Sign in to BigAnimal** to complete the setup process in the BigAnimal portal. + + + + + + + + + From 9865b112ba025dfa3e17f472b9844e8854a3de78 Mon Sep 17 00:00:00 2001 From: drothery-edb Date: Wed, 4 May 2022 19:53:02 -0400 Subject: [PATCH 04/32] adjusting software prerequisites --- .../pem/8/installing_pem_server/index.mdx | 2 +- .../x86/pem_server_sles12_x86.mdx | 52 +++---- ...rerequisites_for_installing_pem_server.mdx | 21 +++ ...rerequisites_for_installing_pem_server.mdx | 134 ------------------ .../docs/pem/8/supported_platforms.mdx | 6 +- 5 files changed, 54 insertions(+), 161 deletions(-) create mode 100644 product_docs/docs/pem/8/installing_pem_server/prerequisites_for_installing_pem_server.mdx delete mode 100644 product_docs/docs/pem/8/prerequisites_for_installing_pem_server.mdx diff --git a/product_docs/docs/pem/8/installing_pem_server/index.mdx b/product_docs/docs/pem/8/installing_pem_server/index.mdx index 20be9ca7e72..ae2f850a65d 100644 --- a/product_docs/docs/pem/8/installing_pem_server/index.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/index.mdx @@ -3,7 +3,7 @@ navTitle: "Installing the PEM server" title: "Installing Postgres Enterprise Manager server" # This is new created file and content is added from pem_inst_guide_linux/04_installing_postgres_enterprise_manager/index.mdx navigation: - +- prerequisites_for_installing_pem_server - installing_on_linux - installing_on_windows --- diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx index e7c6d36493d..95111f76fcb 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx @@ -17,45 +17,47 @@ sudo su - ## Prerequisites +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the `pem` backend database. + + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/) + + 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. + + - If you are using EDB Postgres Advanced Server, see [Modifying the pg_hbaconfig file](/pem/latest/managing_database_server/#modifying-the-pg_hbaconf-file). + + - If you are using PostgreSQL, see [Client Authentication](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html). -1. Install an Advanced Server or PostgresSQL database server to hold the `pem` backend database. Configure the Postgres authentication on the backend database. For more details see [Software prerequisites](). - -2. Ensure that the `sslutils` extension and `hstore` contrib module are installed on your backend database. - - - On an Advanced Server backend database, the `sslutils` extension and `hstore` contrib module are by default installed along with Advanced Server. + 1. Ensure that the `sslutils` extension and `hstore` contrib module are installed on your Postgres server. - - If you are using a PostgreSQL backend database, ensure you have access to the PostgreSQL community repository, and then install `sslutils` extension and `hstore` contrib module. Use the applicable install command for your operating system: + - If you are using EDB Postgres Advanced Server, the `sslutils` extension and `hstore` contrib module are installed by default. - ```text - zypper install postgresql-_sslutils postgresql-contrib - ``` + - If you are PostgreSQL, ensure you have access to the PostgreSQL community repository, and then install the `sslutils` extension and the `hstore` contrib module: - Where, `x` is the server version. + ```text + zypper install postgresql-_sslutils postgresql-contrib + ``` -3. Adjust your firewall restrictions. + Where, `x` is the Postgres server version. - If you are using a firewall, you must allow access to port `8443` on the PEM backend database: + 3. If you are using a firewall, you allow access to port `8443` on the Postgres server: - ```text - firewall-cmd --permanent --zone=public --add-port=8443/tcp + ```text + firewall-cmd --permanent --zone=public --add-port=8443/tcp - firewall-cmd --reload - ``` + firewall-cmd --reload + ``` -4. PEM is dependent on third-party components from the vendor repository, including the python3, libboost, openssl, snmp++, libcurl, etc. To ensure these components are up to date, you should update your operating system using following platform-specific commands. Minimum version require for openssl is 1.0.2k. +- Ensure the components Postgres Enterprise Manager depends on such as python3, libboost, openssl (1.0.2k or later), snmp++, and libcurl are up to date, using the following command: - ```text - zypper update - ``` + ```text + zypper update + ``` -5. Supported locales - - Currently, the PEM server and web interface support a locale of `English(US) en_US` and use of a period (.) as a language separator character. Using an alternate locale, or a separator character other than a period may result in errors. - -Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). ## Setting up the Repository +Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request).- + ```shell # Install the repository configuration and enter your EDB repository # credentials when prompted diff --git a/product_docs/docs/pem/8/installing_pem_server/prerequisites_for_installing_pem_server.mdx b/product_docs/docs/pem/8/installing_pem_server/prerequisites_for_installing_pem_server.mdx new file mode 100644 index 00000000000..efa224471d4 --- /dev/null +++ b/product_docs/docs/pem/8/installing_pem_server/prerequisites_for_installing_pem_server.mdx @@ -0,0 +1,21 @@ +--- +title: "Hardware requirements for installing the PEM server on Linux" +navTitle: "Hardware requirements" +legacyRedirectsGenerated: + # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. + - "/edb-docs/d/edb-postgres-enterprise-manager/installation-getting-started/linux-installation-guide/8.0/prerequisites_for_installing_pem_server.html" +# This file is moved from pem_inst_guide_linux/04_installing_postgres_enterprise_manager +redirects: +- /pem/latest/pem_inst_guide_linux/02_pem_hardware_software_requirements/ +- /pem/latest/pem_inst_guide_linux/04_installing_postgres_enterprise_manager/01_prerequisites_for_installing_pem_server/ +--- + + +For optimum performance when monitoring servers and rendering dashboards, we recommend installing PEM on a system with at least: + +- 4 CPU cores +- 8 GB of RAM +- 100 GB of Storage + +Additional disk space is required for data storage. Please note that resource usage will vary based on which probes are defined and enabled, and the activity level on the monitored databases. Monitoring server resources (as you use PEM) will let you know when you need to expand your initial system configuration. + diff --git a/product_docs/docs/pem/8/prerequisites_for_installing_pem_server.mdx b/product_docs/docs/pem/8/prerequisites_for_installing_pem_server.mdx deleted file mode 100644 index 7b40ed276ed..00000000000 --- a/product_docs/docs/pem/8/prerequisites_for_installing_pem_server.mdx +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: "Prerequisites for installing the PEM server on Linux" -navTitle: "Requirements" -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-postgres-enterprise-manager/installation-getting-started/linux-installation-guide/8.0/prerequisites_for_installing_pem_server.html" -# This file is moved from pem_inst_guide_linux/04_installing_postgres_enterprise_manager -redirects: -- /pem/latest/pem_inst_guide_linux/02_pem_hardware_software_requirements/ -- /pem/latest/pem_inst_guide_linux/04_installing_postgres_enterprise_manager/01_prerequisites_for_installing_pem_server/ ---- - -## Hardware prerequisites - -For optimum performance when monitoring servers and rendering dashboards, we recommend installing PEM on a system with at least: - -- 4 CPU cores -- 8 GB of RAM -- 100 GB of Storage - -Additional disk space is required for data storage. Please note that resource usage will vary based on which probes are defined and enabled, and the activity level on the monitored databases. Monitoring server resources (as you use PEM) will let you know when you need to expand your initial system configuration. - -## Software prerequisites - -1. Install a backend database. - - When installing a PEM server on a Linux host, you must first install a backend database cluster which will hold the `pem` database. The PEM server’s backend database may be installed via package for Linux. The backend database must be one of the following versions: - - - EDB Postgres Advanced Server version 11 or above - - - PostgreSQL version 11 or above - - For detailed information about installing an Advanced Server or PostgreSQL database, please see the product documentation at the EDB website. - -2. Configure Postgres authentication on the backend database. - - The `pg_hba.conf` file manages connections for the Postgres server. You must ensure that the `pg_hba.conf` file on each monitored server allows connections from the PEM server, the monitoring PEM Agent, and the host of the Apache web server in Linux (PEM-HTTPD in Windows) server. - - For information about modifying the `pg_hba.conf` file, see the [managing the database server](../../managing_database_server/#modifying-the-pg_hbaconf-file). - - Information about managing authentication is also available in the [Postgres core documentation](https://www.postgresql.org/docs/current/static/auth-pg-hba-conf.html). - - -3. Ensure that the `sslutils` extension and `hstore` contrib module are installed on your backend database. - - - On an Advanced Server backend database, the `sslutils` extension and `hstore` contrib module are by default installed along with Advanced Server. - - - If you are using a PostgreSQL backend database, ensure you have access to the PostgreSQL community repository, and then install `sslutils` extension and `hstore` contrib module. Use the applicable install command for your operating system: - - For RHEL/OL/CentOS 7, - - ```text - yum install postgresql__sslutils postgresql-contrib - ``` - - Where, `x` is the server version. - - For RHEL/Rocky Linux/AlmaLinux/OL 8 - - ```text - dnf install postgresql__sslutils postgresql-contrib - ``` - - Where, `x` is the server version. - - For Debian/Ubuntu, - - ```text - apt install postgresql__sslutils postgresql-contrib - ``` - - Where, `x` is the server version. - - For SLES, - - ```text - zypper install postgresql-_sslutils postgresql-contrib - ``` - - Where, `x` is the server version. - - !!! Note - Debian 10 and Ubuntu 20 has increased the requirements to accept the certificates due to security reason. - - If a user wants to install the PEM agent on any of the machines, they must upgrade `ssltuils` to 1.3 where 4096 bit RSA key and sha256 signature algorithm support has added. - - If a user does not upgrade `sslutils` to 1.3, then PEM agent may fail to connect to the PEM backend database server, and it might log the error `ca md too weak`. - - -4. Adjust your firewall restrictions. - - If you are using a firewall, you must allow access to port `8443` on the PEM backend database: - - For RHEL/Rocky Linux/AlmaLinux/OL/CentOS, - - ```text - firewall-cmd --permanent --zone=public --add-port=8443/tcp - - firewall-cmd --reload - ``` - - For Debian/Ubuntu, - - ```text - iptables -t filter -A INPUT -p TCP --dport 8443 -j ACCEPT - ``` - -5. PEM is dependent on third-party components from the vendor repository, including the python3, libboost, openssl, snmp++, libcurl, etc. To ensure these components are up to date, you should update your operating system using following platform-specific commands. Minimum version require for openssl is 1.0.2k. - - To upgrade packages on a RHEL/OL/CentOS 7.x host - - ```text - yum upgrade - ``` - - To upgrade packages on a RHEL/Rocky Linux/AlmaLinux/OL 8.x host - - ```text - dnf upgrade - ``` - - To upgrade packages on a Debian/Ubuntu host - - ```text - apt-get update - ``` - - To upgrade packages on a SLES host - - ```text - zypper update - ``` - -6. Supported locales - - Currently, the PEM server and web interface support a locale of `English(US) en_US` and use of a period (.) as a language separator character. Using an alternate locale, or a separator character other than a period may result in errors. \ No newline at end of file diff --git a/product_docs/docs/pem/8/supported_platforms.mdx b/product_docs/docs/pem/8/supported_platforms.mdx index 7d0527cfa1b..fc0df90d9ed 100644 --- a/product_docs/docs/pem/8/supported_platforms.mdx +++ b/product_docs/docs/pem/8/supported_platforms.mdx @@ -1,6 +1,10 @@ --- -title: "Supported platforms" +title: "Supported platforms and locales" # This is a new file and content is moved from 02_pem_hardware_software_requirements.dx file. --- For information about the platforms and versions supported by PEM, see [Platform Compatibility](https://www.enterprisedb.com/platform-compatibility#pem). + +## Supported locales + +Currently, the Postgres Enterprise Manager server and web interface support a locale of `English(US) en_US` and use of a period (.) as a language separator character. Using an alternate locale, or a separator character other than a period may result in errors. From c08eb84b74bfbca9f6e26512446a4cfaf56240ea Mon Sep 17 00:00:00 2001 From: drothery-edb Date: Thu, 5 May 2022 04:50:20 -0400 Subject: [PATCH 05/32] applied latest template approach --- .../x86/pem_server_sles12_x86.mdx | 24 ++++++++----------- 1 file changed, 10 insertions(+), 14 deletions(-) diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx index 95111f76fcb..286fd17fbcb 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx @@ -1,30 +1,27 @@ --- title: "SLES 12" --- -Follow these steps to completing an installation: +Before you begin the installation process: -- [Prerequisites](#prerequisites) -- [Setting up the repository](#setting-up-the-repository) -- [Installing the package](#installing-the-package) -- [Performing the initial configuration](#initial-configuration) +- Log in as superuser: -For each step, you must be logged in as superuser. + ```shell + # To log in as a superuser: + sudo su - + ``` -```shell -# To log in as a superuser: -sudo su - -``` +- Register with EDB to receive credentials for the EDB repository. See [Repository Access Request](https://www.enterprisedb.com/repository-access-request). ## Prerequisites -- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the `pem` backend database. +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/) 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. - If you are using EDB Postgres Advanced Server, see [Modifying the pg_hbaconfig file](/pem/latest/managing_database_server/#modifying-the-pg_hbaconf-file). - + - If you are using PostgreSQL, see [Client Authentication](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html). 1. Ensure that the `sslutils` extension and `hstore` contrib module are installed on your Postgres server. @@ -39,7 +36,7 @@ sudo su - Where, `x` is the Postgres server version. - 3. If you are using a firewall, you allow access to port `8443` on the Postgres server: + 3. If you are using a firewall, allow access to port `8443` on the Postgres server: ```text firewall-cmd --permanent --zone=public --add-port=8443/tcp @@ -56,7 +53,6 @@ sudo su - ## Setting up the Repository -Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request).- ```shell # Install the repository configuration and enter your EDB repository From 212ad5fe327940581975660f60901ff63132cb1b Mon Sep 17 00:00:00 2001 From: drothery-edb Date: Thu, 5 May 2022 06:12:47 -0400 Subject: [PATCH 06/32] added title to SLES 12 x86 topic --- .../x86/pem_server_sles12_x86.mdx | 22 +++++++++---------- 1 file changed, 10 insertions(+), 12 deletions(-) diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx index 286fd17fbcb..8134c7c4333 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx @@ -1,26 +1,23 @@ --- -title: "SLES 12" +title: "Installing Postgres Enterprise Manager on SLES 12 x86" --- -Before you begin the installation process: +Before you begin the installation process, log in as superuser: -- Log in as superuser: - - ```shell - # To log in as a superuser: - sudo su - - ``` +```shell +# To log in as a superuser: +sudo su - +``` -- Register with EDB to receive credentials for the EDB repository. See [Repository Access Request](https://www.enterprisedb.com/repository-access-request). ## Prerequisites - Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. - 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/) + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. - - If you are using EDB Postgres Advanced Server, see [Modifying the pg_hbaconfig file](/pem/latest/managing_database_server/#modifying-the-pg_hbaconf-file). + - If you are using EDB Postgres Advanced Server, see [Modifying the pg_hba.conf file](/pem/latest/managing_database_server/#modifying-the-pg_hbaconf-file). - If you are using PostgreSQL, see [Client Authentication](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html). @@ -30,7 +27,7 @@ Before you begin the installation process: - If you are PostgreSQL, ensure you have access to the PostgreSQL community repository, and then install the `sslutils` extension and the `hstore` contrib module: - ```text + ```shell zypper install postgresql-_sslutils postgresql-contrib ``` @@ -53,6 +50,7 @@ Before you begin the installation process: ## Setting up the Repository +If you haven't already, you need to register with EDB to receive credentials for the EDB repository. See [Repository Access Request](https://www.enterprisedb.com/repository-access-request). ```shell # Install the repository configuration and enter your EDB repository From ac4715d23b25f8535412f7d4eb2fd56e9fabcca8 Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Thu, 5 May 2022 15:53:49 +0530 Subject: [PATCH 07/32] PEM 8 - Removed EPEL repo steps from install topics as per PEM-4477 --- .../ppc64le/pem_server_rhel8_ppcle.mdx | 14 -------------- .../x86/pem_server_centos7_x86.mdx | 9 --------- .../x86/pem_server_other_linux8_x86.mdx | 12 ------------ .../x86/pem_server_rhel7_x86.mdx | 9 --------- .../x86/pem_server_rhel8_x86.mdx | 6 ------ 5 files changed, 50 deletions(-) diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_rhel8_ppcle.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_rhel8_ppcle.mdx index d7f897abd07..fd1365cc9c0 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_rhel8_ppcle.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_rhel8_ppcle.mdx @@ -37,20 +37,6 @@ sudo su - sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo ``` -1. Install EPEL repository and refresh the cache: - - ```shell - dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm - dnf makecache - ``` - -1. Enable the codeready-builder-for-rhel-8-\*-rpms repository since EPEL packages may depend on packages from it: - - ```shell - ARCH=$( /bin/arch ) - subscription-manager repos --enable "codeready-builder-for-rhel-8-${ARCH}-rpms" - ``` - 1. Disable the built-in PostgreSQL module: ```shell diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx index 8ea865929e2..629ee0cdfeb 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx @@ -7,15 +7,6 @@ Before following the detailed instructions that install the PEM server on your s On a CentOS system, you can use the `yum` package manager to install a PEM Server; the installation tool you use will be dependent on the version of the host operating system. Before installing the server, you must ensure that your system contains the required prerequisite software listed below. -**Install the `epel-release` package** - -```text -yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm -``` - -!!! Note - You may need to enable the `[extras]` repository definition in the `CentOS-Base.repo` file (located in `/etc/yum.repos.d`). - **Install and Configure the edb.repo File** To create an EnterpriseDB repository configuration file, assume superuser privileges and invoke the following command: diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx index a6f6818006a..72d4c9a655b 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx @@ -6,18 +6,6 @@ Before following the detailed instructions that install the PEM server on your s On a Rocky Linux or AlmaLinux system, you can use the `yum` package manager or `dnf` command to install a PEM Server; the installation tool you use will be dependent on the version of the host operating system. Before installing the server, you must ensure that your system contains the required prerequisite software listed below. -**Install the `epel-release` package** - -```text -dnf -y install epel-release -``` - -**Enable the powertools repository since EPEL packages may depend on packages from it** - -```text -dnf config-manager --set-enabled powertools -``` - **Install and Configure the edb.repo File** To create an EnterpriseDB repository configuration file, assume superuser privileges and invoke the following command: diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx index d5a16f7c093..6ab38d081b2 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx @@ -7,15 +7,6 @@ Before following the detailed instructions that install the PEM server on your s On a RHEL or OL system, you can use the `yum` package manager to install a PEM Server; the installation tool you use will be dependent on the version of the host operating system. Before installing the server, you must ensure that your system contains the required prerequisite software listed below. -**Install the `epel-release` package** - -```text -yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm -``` - -!!! Note - You may need to enable the `[extras]` repository definition in the `CentOS-Base.repo` file (located in `/etc/yum.repos.d`). - **If you are a Red Hat Network user** Enable the optional, extras, and HA repositories since EPEL packages may depend on packages from these repositories diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx index 00e60c51827..379a9d513c6 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx @@ -6,12 +6,6 @@ Before following the detailed instructions that install the PEM server on your s On a RHEL or OL system, you can use the `dnf` command to install a PEM Server; the installation tool you use will be dependent on the version of the host operating system. Before installing the server, you must ensure that your system contains the required prerequisite software listed below. -**Install the `epel-release` package** - -```text -dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm -``` - **If you are a Red Hat Network user** Enable the codeready-builder-for-rhel-8-*-rpms repository since EPEL packages may depend on packages from it From 6770a3352b596e432bcad4fe7bf8aa39ef22fb5f Mon Sep 17 00:00:00 2001 From: drothery-edb Date: Thu, 5 May 2022 07:23:34 -0400 Subject: [PATCH 08/32] applied latest content model changes --- .../installing_on_linux/using_edb_repository/index.mdx | 4 ++-- .../using_edb_repository/ppc64le/index.mdx | 3 ++- .../using_edb_repository/ppc64le/pem_server_rhel8_ppcle.mdx | 3 ++- .../using_edb_repository/ppc64le/pem_server_sles12_ppcle.mdx | 3 ++- .../using_edb_repository/ppc64le/pem_server_sles15_ppcle.mdx | 3 ++- .../installing_on_linux/using_edb_repository/x86/index.mdx | 3 ++- .../using_edb_repository/x86/pem_server_centos7_x86.mdx | 3 ++- .../using_edb_repository/x86/pem_server_other_linux8_x86.mdx | 3 ++- .../using_edb_repository/x86/pem_server_rhel7_x86.mdx | 3 ++- .../using_edb_repository/x86/pem_server_rhel8_x86.mdx | 3 ++- .../using_edb_repository/x86/pem_server_sles12_x86.mdx | 3 ++- .../using_edb_repository/x86/pem_server_sles15_x86.mdx | 3 ++- .../using_edb_repository/x86/pem_server_ubuntu18_deb9_x86.mdx | 3 ++- .../x86/pem_server_ubuntu20_deb10_x86.mdx | 3 ++- 14 files changed, 28 insertions(+), 15 deletions(-) diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/index.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/index.mdx index 670b7576483..3431c065d5d 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/index.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/index.mdx @@ -1,6 +1,6 @@ --- -title: "Installing Postgres Enterprise Manger using EDB repository" -navTitle: "Using EDB repository" +title: "Installing the PEM server using the EDB repository" +navTitle: "Using the EDB repository" redirects: - /pem/latest/pem_inst_guide_linux/04_installing_postgres_enterprise_manager/03_installing_pem_server_using_edb_repository/ navigation: diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/index.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/index.mdx index 30f566be12c..eb4fc6ad09f 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/index.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/index.mdx @@ -1,5 +1,6 @@ --- -title: "IBM Power (ppc64le)" +title: "Installing the PEM server on IBM Power (ppc64le)" +navTitle: "IBM Power (ppc64le)" navigation: - pem_server_rhel8_ppcle diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_rhel8_ppcle.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_rhel8_ppcle.mdx index d7f897abd07..61b3a3bc48b 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_rhel8_ppcle.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_rhel8_ppcle.mdx @@ -1,5 +1,6 @@ --- -title: "RHEL 8" +title: "Installing the PEM server on RHEL 8 ppc64le" +navTitle: "RHEL 8" --- This topic describes how to install Postgres Enteprise Manager (PEM) Server. diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles12_ppcle.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles12_ppcle.mdx index 14c2d31085e..d0cfee45d34 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles12_ppcle.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles12_ppcle.mdx @@ -1,5 +1,6 @@ --- -title: "SLES 12" +title: "Installing the PEM server on SLES 12 Power" +navTitle: "SLES 12" --- There are three steps to completing an installation: diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles15_ppcle.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles15_ppcle.mdx index c292d777517..e8ed8aa6aa1 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles15_ppcle.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles15_ppcle.mdx @@ -1,5 +1,6 @@ --- -title: "SLES 15" +title: "Installing the PEM server on SLES 15 on Power" +navTitle: "SLES 15" --- There are three steps to completing an installation: diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/index.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/index.mdx index a95d0e32c0c..9a8fd358779 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/index.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/index.mdx @@ -1,5 +1,6 @@ --- -title: "x86" +title: "Installing Postgres Enterprise Manager on x86" +navTitle: "Intel x86 (AMD64)" navigation: - pem_server_rhel8_x86 diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx index 8ea865929e2..5f96f34cdf0 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx @@ -1,5 +1,6 @@ --- -title: "CentOS 7" +title: "Installing the PEM server on CentOS 7 x86" +navTitle: "CentOS 7" --- diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx index a6f6818006a..3a92b64f962 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx @@ -1,5 +1,6 @@ --- -title: "Rocky Linux 8/AlmaLinux 8" +title: "Installing the PEM server on Rocky Linux 8/AlmaLinux 8 x86" +navTitle: "Rocky Linux 8/AlmaLinux 8" --- Before following the detailed instructions that install the PEM server on your specific platform, you must perform the prerequisite steps detailed in [Prerequisites for installing PEM Server](../../prerequisites_for_installing_pem_server/). diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx index d5a16f7c093..eed6235f5f4 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx @@ -1,5 +1,6 @@ --- -title: "RHEL 7/OL 7" +title: "Installing the PEM server on RHEL 7/OL 7 x86" +navTitle: "RHEL 7/OL 7" --- diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx index 00e60c51827..65eb268534b 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx @@ -1,5 +1,6 @@ --- -title: "RHEL 8/OL 8" +title: "Installing the PEM server on RHEL 8/OL 8 x86" +navTitle: "RHEL 8/OL 8 x86" --- Before following the detailed instructions that install the PEM server on your specific platform, you must perform the prerequisite steps detailed in [Prerequisites for installing PEM Server](../../prerequisites_for_installing_pem_server/). diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx index 8134c7c4333..270ffd14cd0 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx @@ -1,5 +1,6 @@ --- -title: "Installing Postgres Enterprise Manager on SLES 12 x86" +title: "Installing the PEM server on SLES 12 x86" +navTitle: "SLES 12" --- Before you begin the installation process, log in as superuser: diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles15_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles15_x86.mdx index 9e03cad280f..9f272629f4b 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles15_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles15_x86.mdx @@ -1,5 +1,6 @@ --- -title: "SLES 15" +title: "Installing the PEM server on SLES 15 x86" +navTitle: "SLES 15" --- There are three steps to completing an installation: diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu18_deb9_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu18_deb9_x86.mdx index 259723a9e92..f0fc5dfa1e8 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu18_deb9_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu18_deb9_x86.mdx @@ -1,5 +1,6 @@ --- -title: "Ubuntu 18.04/Debian 9" +title: "Installing the PEM server on Ubuntu 18.04/Debian 9 x86" +navTitle: "Ubuntu 18.04/Debian 9" --- The following steps will walk you through using the EDB `apt` repository to install a Debian package. diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu20_deb10_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu20_deb10_x86.mdx index c84256dd265..9bb1794ba49 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu20_deb10_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu20_deb10_x86.mdx @@ -1,5 +1,6 @@ --- -title: "Ubuntu 20.04/Debian 10" +title: "Installing the PEM server on Ubuntu 20.04/Debian 10 x86" +navTitle: "Ubuntu 20.04/Debian 10" --- The following steps will walk you through using the EDB `apt` repository to install a Debian package. From d9a40fb0ee16f18c9bc4c3fad5d07c3e617240df Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Thu, 5 May 2022 18:03:56 +0530 Subject: [PATCH 09/32] Renamed the titles and navtitles of agent installation topics --- .../pem/8/installing_pem_agent/installing_on_linux/index.mdx | 2 +- .../installing_pem_agent/installing_on_linux/ppc64le/index.mdx | 3 ++- .../installing_on_linux/ppc64le/pem_agent_rhel8_ppcle.mdx | 3 ++- .../installing_on_linux/ppc64le/pem_agent_sles12_ppcle.mdx | 3 ++- .../installing_on_linux/ppc64le/pem_agent_sles15_ppcle.mdx | 3 ++- .../8/installing_pem_agent/installing_on_linux/x86/index.mdx | 3 ++- .../installing_on_linux/x86/pem_agent_centos7_x86.mdx | 3 ++- .../installing_on_linux/x86/pem_agent_other_linux8_x86.mdx | 3 ++- .../installing_on_linux/x86/pem_agent_rhel7_x86.mdx | 3 ++- .../installing_on_linux/x86/pem_agent_rhel8_x86.mdx | 3 ++- .../installing_on_linux/x86/pem_agent_sles12_x86.mdx | 3 ++- .../installing_on_linux/x86/pem_agent_sles15_x86.mdx | 3 ++- .../installing_on_linux/x86/pem_agent_ubuntu18_deb9_x86.mdx | 3 ++- .../installing_on_linux/x86/pem_agent_ubuntu20_deb10_x86.mdx | 3 ++- .../installing_on_linux/using_edb_repository/index.mdx | 2 +- .../installing_on_linux/using_edb_repository/ppc64le/index.mdx | 2 +- .../installing_on_linux/using_edb_repository/x86/index.mdx | 2 +- 17 files changed, 30 insertions(+), 17 deletions(-) diff --git a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/index.mdx b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/index.mdx index 05646fcf63c..62685d35f5b 100644 --- a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/index.mdx +++ b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/index.mdx @@ -18,6 +18,6 @@ The native packages installs the PEM agent on Linux. You need to register the ag For platform-specific install instructions, see: -- [Linux x86-64 (amd64)](x86) +- [Linux x86-64 (AMD64)](x86) - [Linux on IBM Power (ppc64le)](ppc64le) diff --git a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/ppc64le/index.mdx b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/ppc64le/index.mdx index 2919a760bb0..f34c236ce3f 100644 --- a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/ppc64le/index.mdx +++ b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/ppc64le/index.mdx @@ -1,5 +1,6 @@ --- -title: "IBM Power (ppc64le)" +title: "Installing the PEM agent on ppc64le" +navTitle: "IBM Power (ppc64le)" navigation: - pem_agent_rhel8_ppcle diff --git a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/ppc64le/pem_agent_rhel8_ppcle.mdx b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/ppc64le/pem_agent_rhel8_ppcle.mdx index 0d4ad276022..f9f13eb05bc 100644 --- a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/ppc64le/pem_agent_rhel8_ppcle.mdx +++ b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/ppc64le/pem_agent_rhel8_ppcle.mdx @@ -1,5 +1,6 @@ --- -title: "RHEL 8" +title: "Installing the PEM agent on RHEL 8 ppc64le" +navTitle: "RHEL 8" --- diff --git a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/ppc64le/pem_agent_sles12_ppcle.mdx b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/ppc64le/pem_agent_sles12_ppcle.mdx index 2391b83043f..597ea92a892 100644 --- a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/ppc64le/pem_agent_sles12_ppcle.mdx +++ b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/ppc64le/pem_agent_sles12_ppcle.mdx @@ -1,5 +1,6 @@ --- -title: "SLES 12" +title: "Installing the PEM agent on SLES 12 ppc64le" +navTitle: "SLES 12" --- There are three steps to completing an installation: diff --git a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/ppc64le/pem_agent_sles15_ppcle.mdx b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/ppc64le/pem_agent_sles15_ppcle.mdx index 577c23ad865..a14926af8bd 100644 --- a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/ppc64le/pem_agent_sles15_ppcle.mdx +++ b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/ppc64le/pem_agent_sles15_ppcle.mdx @@ -1,5 +1,6 @@ --- -title: "SLES 15" +title: "Installing the PEM agent on SLES 15 ppc64le" +navTitle: "SLES 15" --- There are two steps to completing an installation: diff --git a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/index.mdx b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/index.mdx index 8edb8c6ba21..722740063ec 100644 --- a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/index.mdx +++ b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/index.mdx @@ -1,5 +1,6 @@ --- -title: "x86" +title: "Installing the PEM agent on x86" +navTitle: "Intel x86 (AMD64)" navigation: - pem_agent_rhel8_x86 diff --git a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_centos7_x86.mdx b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_centos7_x86.mdx index 286f33a1f73..cee52d8f987 100644 --- a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_centos7_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_centos7_x86.mdx @@ -1,5 +1,6 @@ --- -title: "CentOS 7" +title: "Installing the PEM agent on CentOS 7 x86" +navTitle: "CentOS 7" --- A PEM Agent may monitor one or more servers on one or more hosts. For comprehensive information about managing a PEM Agent, see the [Managing an agent](../../../managing_pem_agent). diff --git a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_other_linux8_x86.mdx b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_other_linux8_x86.mdx index 895a3ef04e3..0cb41c4db0d 100644 --- a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_other_linux8_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_other_linux8_x86.mdx @@ -1,5 +1,6 @@ --- -title: "Rocky Linux 8/AlmaLinux 8" +title: "Installing the PEM agent on Rocky Linux 8/AlmaLinux x86" +navTitle: "Rocky Linux 8/AlmaLinux 8" --- A PEM Agent may monitor one or more servers on one or more hosts. For comprehensive information about managing a PEM Agent, see [Managing an agent](../../../managing_pem_agent). diff --git a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_rhel7_x86.mdx b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_rhel7_x86.mdx index 6d851d052e8..0ce90049d0c 100644 --- a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_rhel7_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_rhel7_x86.mdx @@ -1,5 +1,6 @@ --- -title: "RHEL 7/OL 7" +title: "Installing the PEM agent on RHEL 7/OL 7 x86" +navTitle: "RHEL 7/OL 7" --- A PEM Agent may monitor one or more servers on one or more hosts. For comprehensive information about managing a PEM Agent, see [Managing an agent](../../../managing_pem_agent). diff --git a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_rhel8_x86.mdx b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_rhel8_x86.mdx index 27ab664b107..c464a77bb1b 100644 --- a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_rhel8_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_rhel8_x86.mdx @@ -1,5 +1,6 @@ --- -title: "RHEL 8/OL 8" +title: "Installing the PEM agent on RHEL 8/OL 8 x86" +navTitle: "RHEL 8/OL 8" --- A PEM Agent may monitor one or more servers on one or more hosts. For comprehensive information about managing a PEM Agent, see [Managing an agent](../../../managing_pem_agent). diff --git a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_sles12_x86.mdx b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_sles12_x86.mdx index 1deb678c289..d6aea1a5f7f 100644 --- a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_sles12_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_sles12_x86.mdx @@ -1,5 +1,6 @@ --- -title: "SLES 12" +title: "Installing the PEM agent on SLES 12 x86" +navTitle: "SLES 12" --- There are two steps to completing an installation: diff --git a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_sles15_x86.mdx b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_sles15_x86.mdx index 42f11fe3622..0aa0fbd026a 100644 --- a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_sles15_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_sles15_x86.mdx @@ -1,5 +1,6 @@ --- -title: "SLES 15" +title: "Installing the PEM agent on SLES 15 x86" +navTitle: "SLES 15" --- There are two steps to completing an installation: diff --git a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_ubuntu18_deb9_x86.mdx b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_ubuntu18_deb9_x86.mdx index 0e0c0b9fe77..2367b09a298 100644 --- a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_ubuntu18_deb9_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_ubuntu18_deb9_x86.mdx @@ -1,5 +1,6 @@ --- -title: "Ubuntu 18.04/Debian 9" +title: "Installing the PEM agent on Ubuntu 18.04/Debian 9 x86" +navTitle: "Ubuntu 18.04/Debian 9" --- To install PEM on a Debian or Ubuntu host, you must have credentials that allow access to the EDB repository. To request credentials for the repository, [contact EDB](https://www.enterprisedb.com/repository-access-request) . diff --git a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_ubuntu20_deb10_x86.mdx b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_ubuntu20_deb10_x86.mdx index e7303efc83b..64c8da3ce67 100644 --- a/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_ubuntu20_deb10_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_agent/installing_on_linux/x86/pem_agent_ubuntu20_deb10_x86.mdx @@ -1,5 +1,6 @@ --- -title: "Ubuntu 20.04/Debian 10" +title: "Installing the PEM agent on Ubuntu 20.04/Debian 10 x86" +navTitle: "Ubuntu 20.04/Debian 10" --- diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/index.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/index.mdx index 3431c065d5d..2968a7571e0 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/index.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/index.mdx @@ -11,6 +11,6 @@ navigation: For platform-specific detailed information about PEM server install instructions, see: -- [Linux x86-64 (amd64)](x86) +- [Linux x86-64 (AMD64)](x86) - [Linux on IBM Power (ppc64le)](ppc64le) diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/index.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/index.mdx index eb4fc6ad09f..20d2fbd0d99 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/index.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/index.mdx @@ -1,5 +1,5 @@ --- -title: "Installing the PEM server on IBM Power (ppc64le)" +title: "Installing the PEM server on ppc64le" navTitle: "IBM Power (ppc64le)" navigation: diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/index.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/index.mdx index 9a8fd358779..3ac4bec73a7 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/index.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/index.mdx @@ -1,5 +1,5 @@ --- -title: "Installing Postgres Enterprise Manager on x86" +title: "Installing the PEM server on x86" navTitle: "Intel x86 (AMD64)" navigation: From 861b16df1b095a7ef04cc977ec9837d4c7450de4 Mon Sep 17 00:00:00 2001 From: Betsy Gitelman <93718720+ebgitelman@users.noreply.github.com> Date: Thu, 5 May 2022 10:50:21 -0400 Subject: [PATCH 10/32] Edit of new content for BigAnimal --- .../identity_provider/azure_ad.mdx | 45 +++++++--------- .../identity_provider/index.mdx | 10 ++-- .../identity_provider/okta.mdx | 51 ++++++++----------- 3 files changed, 43 insertions(+), 63 deletions(-) diff --git a/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx b/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx index 6ec15c8ccb2..bce4f333357 100644 --- a/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx +++ b/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx @@ -6,30 +6,28 @@ description: "Using Azure AD as your identity provider for your Azure account" ## Prerequisites -- In order to connect BigAnimal to Azure AD, you must either: +To connect BigAnimal to Azure AD, you must either: - - Have one of the following roles in Azure: +- Have one of the following roles in Azure: - - Global Administrator + - Global Administrator + - Cloud Application Administrator + - Application Administrator - - Cloud Application Administrator - - Application Administrator +- Be the owner of the service principal - - Be the owner of the service principal +A unique URL and access code are provided in an email from cloudcare@enterprisedb.com. Contact [cloudcare@enterprisedb.com](mailto:cloudcare@enterprisedb.com) if you don't receive the email. The URL becomes invalid after you set up your identity provider with BigAnimal. For issues with the code or identity provider setup, contact [Support](/biganimal/release/overview/support). -- Unique URL and access code provided in an email from cloudcare@enterprisedb.com. Contact cloudcare@enterprisedb.com if you have not received the email. The URL becomes invalid once you have set up your identity provider with BigAnimal. If you experience any issues with the code or identity provider set up, contact [Support](/biganimal/release/overview/support). +## Set up BigAnimal with Azure AD - -## Setting up BigAnimal with Azure AD - -1. Open the link in the email sent from cloudcare@enterprisedb.com to access the Set Up Identity Provider page in BigAnimal. +1. To access the Set Up Identity Provider page in BigAnimal, open the link in the email sent from cloudcare@enterprisedb.com. 1. In a separate browser tab or window, log into the [Azure Active Directory Admin Center](https://aad.portal.azure.com/). -1. Select **Enterprise Applications** from the left navigation pane. On the Enterprise Applications page, +1. From the left navigation pane, select **Enterprise Applications**. On the Enterprise Applications page: 1. Select **New application > Create your own application**. 1. Enter a name for your application. - 1. Select the third choice for what you are looking to do with your application: **Integrate any other application you don’t find in the gallery (Non-gallery)**. -1. Once the application is created, select **Single sign-on** from the left navigation menu. On the Single sign-in page, + 1. Select the third choice for what you intend to do with your application: **Integrate any other application you don’t find in the gallery (Non-gallery)**. +1. After the application is created, from the left navigation menu, select **Single sign-on**. On the Single sign-on page: 1. Select **SAML** as your single sign-on method. 1. Update the Basic SAML Configuration by copying and pasting the following information from the Set Up Identity Provider page in BigAnimal to the SAML Configuration menu in Azure AD: @@ -37,7 +35,8 @@ description: "Using Azure AD as your identity provider for your Azure account" | ------------------------------ | --------------------------- | | Audience URI | Identifier (Entity ID) | | Assertion Consumer Service URL | Reply URL | - 1. We recommend the following configuration for Attributes & Claims: + + 1. Enter the configuration for Attributes & Claims. We recommend the following: | Claim name | Value | Note | |----------------------------------|-----------------------------------------------------|------------------| @@ -51,18 +50,10 @@ description: "Using Azure AD as your identity provider for your Azure account" 1. Under **SAML Signing Certificate**, select **Download** for the Base64-encoded certificate. 1. Copy the **Login URL** value. -1. Select **Properties** from the left navigation pane. On the Properties page, if you do not want all of the users in Azure AD to be able to use BigAnimal, answer `No` for the **Assignment required?** question. Otherwise, answer `Yes` and assign the specified users to this Enterprise Application explicitly on the Users and Groups page. -1. On the Setup Config tab on the Set Up Identity Provider page in BigAnimal, +1. From the left navigation pane, Select **Properties**. On the Properties page, if you don't want all of the users in Azure AD to use BigAnimal, answer `No` for the **Assignment required?** question. Otherwise, answer `Yes` and assign the specified users to this Enterprise Application explicitly on the Users and Groups page. +1. On the **Setup Config** tab on the Set Up Identity Provider page in BigAnimal: 1. Paste the Login URL value you copied from the Single sign-on page in Azure AD as the **Single Sign-On URL**. - 1. For **Identity Provider Signature Certificate**, upload the Base64-encoded certificate downloaded from Azure. - 1. Choose the appropriate method for **Request Binding**. Azure AD supports `HTTP POST` and `HTTP Redirect`. - 1. Select `rsa-sha256` for the **Response Signature Algorithm**. + 1. Select the appropriate method for **Request Binding**. Azure AD supports HTTP POST and HTTP Redirect. + 1. Select **rsa-sha256** for the **Response Signature Algorithm**. 1. Select **Test Connection**. If the connection is successful, select **Sign in to BigAnimal** to complete the setup process in the BigAnimal portal. - - - - - - - diff --git a/product_docs/docs/biganimal/release/getting_started/identity_provider/index.mdx b/product_docs/docs/biganimal/release/getting_started/identity_provider/index.mdx index ec26caae516..99b9f267e9c 100644 --- a/product_docs/docs/biganimal/release/getting_started/identity_provider/index.mdx +++ b/product_docs/docs/biganimal/release/getting_started/identity_provider/index.mdx @@ -3,7 +3,7 @@ title: "Setting up your identity provider" navTitle: "Setting up your identity provider" --- -If you purchased BigAnimal directly from EDB, you must set up your identity provider (IDP) before accessing BigAnimal for the first time. After setting up your identity provider, you can add users to BigAnimal by adding them to the designated group in your identity provider. Once you've logged into BigAnimal using your identity provider, you can set up your cloud service provider (CSP) in the BigAnimal portal to complete onboarding. If you purchased through Azure Marketplace, BigAnimal authenticates users using Azure Active Directory (AD) and you don't have to complete these steps as Azure AD is linked during subscription. +If you purchased BigAnimal directly from EDB, you must set up your identity provider (IDP) before accessing BigAnimal for the first time. After setting up your identity provider, you can add users to BigAnimal by adding them to the designated group in your identity provider. Once you've logged into BigAnimal using your identity provider, you can set up your cloud service provider (CSP) in the BigAnimal portal to complete onboarding. If you purchased through Azure Marketplace, BigAnimal authenticates users using Azure Active Directory (AD) and you don't have to complete these steps, as Azure AD is linked during subscription. BigAnimal supports single sign-on through SAML identity providers. The SAML application enables access to BigAnimal for groups selected in your identity provider. You configure your SAML application to send a SAML assertion response to BigAnimal for each user. @@ -43,7 +43,7 @@ On the Set Up Identity Provider page: - `name`: BigAnimal uses the value as the full name (`givenname` joined with `surname`) in the profile of the authenticated user. - `emailaddress` (optional): BigAnimal uses the value for the email address in the profile of the authenticated user. - Provide a `NameID` element in the `Subject` element. Provide your email ID as the value to `NameID`. BigAnimal uses the email ID you provide as your username and primary email, so `NameID` must be formatted like an email address. + Provide a `NameID` element in the `Subject` element. Provide your email ID as the value to `NameID`. BigAnimal uses the email ID you provide as your username and primary email, so format `NameID` like an email address. For example: @@ -54,12 +54,12 @@ On the Set Up Identity Provider page: | ---------- | ----------- | | Issuer URL | URL string uniquely associated with your identity provider partner. | | Single Sign-On URL | The identity provider's sign-on URL. | - | Identity provider signature certificate | Identity provider's assertion signing certificate (.cer or .cert). Coordinate with your identity provider partner to obtain this certificate securely. | + | Identity provider signature certificate | Identity provider's assertion signing certificate (`.cer` or `.cert`). Coordinate with your identity provider partner to obtain this certificate securely. | | Request Binding | SAML Authentication Request Protocol binding used to send the authentication request: HTTP-Redirect, HTTP-Post, or Hybrid (SAML request is REDIRECT and response is POST). | | Response Signature Algorithm (RSA) Algorithm | The signature algorithm used to sign the SAML AuthNRequest (RSA SHA-1 or RSA SHA-256). | 4. Select **Test Connection**. If you connect to your identity provider successfully, your identity provider's login screen appears. If an error message appears, contact [Support](../overview/support). -Once your identity provider is set up, you can view your connection status, ID, login URL, audience URI, and assertion consumer service URL from the BigAnimal portal on the **Admin > Identity Provider** page. +Once your identity provider is set up, you can view your connection status, ID, login URL, audience URI, and assertion consumer service URL from the BigAnimal portal on the Identity Provider page (select **Admin > Identity Provider** to access). ## Manage roles for added users @@ -73,7 +73,7 @@ You add users through your identity provider. A user who is added in the identit ## Setting up specific identity providers -For step-by-step instructions for setting up specific identity provides, see: +For step-by-step instructions for setting up specific identity providers, see: - [Using Azure AD as your identity provider](azure_ad) - [Using Okta as your identity provider](okta) diff --git a/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx b/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx index df722e3a6ed..7628b04ca56 100644 --- a/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx +++ b/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx @@ -6,43 +6,41 @@ description: "Using Okta as your identity provider for your Azure or AWS account ## Prerequisites -- In order to connect BigAnimal to Azure AD, you must either: +To connect BigAnimal to Okta, you must have either: - - Have one of the following roles in Okta: +- One of the following roles in Okta: - - Super Administrator - - Application Administrator + - Super Administrator + - Application Administrator - - A custom admin role with similar permissions. +- A custom admin role with similar permissions. [Learn more](https://help.okta.com/oie/en-us/Content/Topics/Security/administrators-learn-about-admins.htm) about Okta administrator roles. -- Unique URL and access code provided in an email from cloudcare@enterprisedb.com. Contact cloudcare@enterprisedb.com if you have not received the email. The URL becomes invalid once you have set up your identity provider with BigAnimal. If you experience any issues with the code or identity provider set up, contact [Support](/biganimal/release/overview/support). +Unique URL and access code are provided in an email from cloudcare@enterprisedb.com. Contact [cloudcare@enterprisedb.com](mailto:cloudcare@enterprisedb.com) if you don't receive the email. The URL becomes invalid after you set up your identity provider with BigAnimal. If you have issues with the code or identity provider setup, contact [Support](/biganimal/release/overview/support). +## Set up BigAnimal with Okta -## Setting up BigAnimal with Azure AD - -1. Open the link in the email sent from cloudcare@enterprisedb.com to access the Set Up Identity Provider page in BigAnimal. -1. In a separate browser tab or window, log into Okta’s Admin Console. -1. Select **Applications** from the left navigation pane. On the Applications page, +1. To access the Set Up Identity Provider page in BigAnimal, open the link in the email sent from cloudcare@enterprisedb.com. +1. In a separate browser tab or window, log into the Okta Admin Console. +1. From the left navigation pane, select **Applications**. On the Applications page: 1. Select **Create App Integration**. - - 1. Select SAML 2.0 as the sign-in method. + 1. Select **SAML 2.0** as the sign-in method. 1. Enter a name for your application. 1. Select **Do not display application icon to users** and **Do not display application icon in the Okta Mobile app**. -1. Next to go to the Configure SAML step. +1. Go to the Configure SAML step. 1. Copy and paste the following information from the Set Up Identity Provider page in BigAnimal to Okta: | Copy from BigAnimal | Paste in Okta | | ------------------------------ | --------------------------- | | Audience URI | Audience URI (SP Entity ID) | - | Assertion Consumer Service URL | Single sign on URL | - 1. We recommend the following configuration in the Attribute Statements section: + | Assertion Consumer Service URL | Single sign-on URL | + 1. In the Attribute Statements section, enter the configuration. We recommend the following: | Name | Value | Notes | |------------------------------------|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| - | <assertion_path>/name | user.name | The name field will default to the user’s email. Alternatively, you can set the value as the following Okta expression to combine the first and last names: `user.firstName + “ “ + user.lastName` | + | <assertion_path>/name | user.name | The name field defaults to the user’s email. Alternatively, you can set the value as the following Okta expression to combine the first and last names: `user.firstName + “ “ + user.lastName` | | <assertion_path>/emailaddress | user.email | | | <assertion_path>/nameidentifier | user.userId | Optional | | <assertion_path>/surname | user.lastName | | @@ -51,23 +49,14 @@ description: "Using Okta as your identity provider for your Azure or AWS account Where <assertion_path> is http://schemas.xmlsoap.org/ws/2005/05/identity/claims. - 1. On the Assignments tab on the Applications page, select **Assign** to assign people or groups to the newly created application. If you will be signing into BigAnimal, make sure to assign yourself. - 1. On the Sign On tab, select **View SAML setup instructions** to open a tab with instructions for your application. + 1. On the **Assignments** tab on the Applications page, select **Assign** to assign people or groups to the newly created application. If you need to sign into BigAnimal, be sure to assign yourself. + 1. On the **Sign On** tab, select **View SAML setup instructions** to open a tab with instructions for your application. 1. Copy from the Identity Provider Single Sign-on URL from step 1 of the SAML setup instructions. 1. Select **Download certificate** in step 3 of the instructions. - 1. In BigAnimal, on the Setup Config tab on the Set Up Identity Provider page, + 1. In BigAnimal, on the **Setup Config** tab on the Set Up Identity Provider page: 1. Paste the Identity Provider Single Sign-on URL you copied from Okta into the **Single Sign-On URL** field. 1. For **Identity Provider Signature Certificate**, upload the certificate downloaded from Okta. - 1. Choose the appropriate method for **Request Binding**. Okta supports `HTTP POST` and `HTTP Redirect`. - 1. Select `rsa-sha256` for the **Response Signature Algorithm**. + 1. Select the appropriate method for **Request Binding**. Okta supports HTTP POST and HTTP Redirect. + 1. For **Response Signature Algorithm**, select **rsa-sha256** . 1. Select **Test Connection**. If the connection is successful, select **Sign in to BigAnimal** to complete the setup process in the BigAnimal portal. - - - - - - - - - From 17852cf2a12e5f32f71d06f4c9357b94018784ba Mon Sep 17 00:00:00 2001 From: drothery-edb Date: Thu, 5 May 2022 14:49:42 -0400 Subject: [PATCH 11/32] Update okta.mdx --- .../release/getting_started/identity_provider/okta.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx b/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx index 7628b04ca56..f686b0b6754 100644 --- a/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx +++ b/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx @@ -22,9 +22,11 @@ Unique URL and access code are provided in an email from cloudcare@enterprisedb. ## Set up BigAnimal with Okta 1. To access the Set Up Identity Provider page in BigAnimal, open the link in the email sent from cloudcare@enterprisedb.com. + 1. In a separate browser tab or window, log into the Okta Admin Console. 1. From the left navigation pane, select **Applications**. On the Applications page: 1. Select **Create App Integration**. + 1. Select **SAML 2.0** as the sign-in method. 1. Enter a name for your application. 1. Select **Do not display application icon to users** and **Do not display application icon in the Okta Mobile app**. From c947753b6a7829a3af8fd4b8560a3fc107b4160e Mon Sep 17 00:00:00 2001 From: amrita-suresh <33535573+amrita-suresh@users.noreply.github.com> Date: Thu, 5 May 2022 15:02:54 -0400 Subject: [PATCH 12/32] remove code formatting --- .../release/getting_started/identity_provider/okta.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx b/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx index f686b0b6754..de96428dafa 100644 --- a/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx +++ b/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx @@ -42,7 +42,7 @@ Unique URL and access code are provided in an email from cloudcare@enterprisedb. | Name | Value | Notes | |------------------------------------|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| - | <assertion_path>/name | user.name | The name field defaults to the user’s email. Alternatively, you can set the value as the following Okta expression to combine the first and last names: `user.firstName + “ “ + user.lastName` | + | <assertion_path>/name | user.name | The name field defaults to the user’s email. Alternatively, you can set the value as the following Okta expression to combine the first and last names: user.firstName + " " + user.lastName | | <assertion_path>/emailaddress | user.email | | | <assertion_path>/nameidentifier | user.userId | Optional | | <assertion_path>/surname | user.lastName | | From c7872bc4dc9f482f2fca84d1dde6248cee4f301d Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Fri, 6 May 2022 11:59:59 +0530 Subject: [PATCH 13/32] Added prerequistes to all the install topics of PEM server --- .../ppc64le/pem_server_rhel8_ppcle.mdx | 48 +++++++-- .../ppc64le/pem_server_sles12_ppcle.mdx | 48 +++++++-- .../ppc64le/pem_server_sles15_ppcle.mdx | 48 +++++++-- .../x86/pem_server_centos7_x86.mdx | 42 +++++++- .../x86/pem_server_other_linux8_x86.mdx | 45 ++++++++- .../x86/pem_server_rhel7_x86.mdx | 45 ++++++++- .../x86/pem_server_rhel8_x86.mdx | 43 +++++++- .../x86/pem_server_sles12_x86.mdx | 6 +- .../x86/pem_server_sles15_x86.mdx | 48 +++++++-- .../x86/pem_server_ubuntu18_deb9_x86.mdx | 96 +++++++++++++----- .../x86/pem_server_ubuntu20_deb10_x86.mdx | 98 +++++++++++++------ .../pem_pgbouncer/configuring_pgBouncer.mdx | 0 .../configuring_the_pem_agent.mdx | 0 .../pem_pgbouncer/index.mdx | 0 ..._agent_connection_management_mechanism.mdx | 0 .../preparing_the_pem_database_server.mdx | 0 16 files changed, 465 insertions(+), 102 deletions(-) rename product_docs/docs/pem/8/{considerations => installing_pem_server}/pem_pgbouncer/configuring_pgBouncer.mdx (100%) rename product_docs/docs/pem/8/{considerations => installing_pem_server}/pem_pgbouncer/configuring_the_pem_agent.mdx (100%) rename product_docs/docs/pem/8/{considerations => installing_pem_server}/pem_pgbouncer/index.mdx (100%) rename product_docs/docs/pem/8/{considerations => installing_pem_server}/pem_pgbouncer/pem_server_pem_agent_connection_management_mechanism.mdx (100%) rename product_docs/docs/pem/8/{considerations => installing_pem_server}/pem_pgbouncer/preparing_the_pem_database_server.mdx (100%) diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_rhel8_ppcle.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_rhel8_ppcle.mdx index 61b3a3bc48b..29e6b96cd24 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_rhel8_ppcle.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_rhel8_ppcle.mdx @@ -3,21 +3,49 @@ title: "Installing the PEM server on RHEL 8 ppc64le" navTitle: "RHEL 8" --- -This topic describes how to install Postgres Enteprise Manager (PEM) Server. +Before you begin the installation process, log in as superuser: -There are two steps to completing an installation: +```shell +# To log in as a superuser: +sudo su - +``` +## Prerequisites -- [Setting up the repository](#setting-up-the-repository) -- [Installing the package](#installing-the-package) -- [Performing the initial configuration](#initial-configuration) +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. + + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + + 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. + + - If you are using EDB Postgres Advanced Server, see [Modifying the pg_hba.conf file](/pem/latest/managing_database_server/#modifying-the-pg_hbaconf-file). -For each step, you must be logged in as superuser. + - If you are using PostgreSQL, see [Client Authentication](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html). -To log in as a superuser: + 3. Ensure that the `sslutils` extension and `hstore` contrib module are installed on your Postgres server. -```shell -sudo su - -``` + - If you are using EDB Postgres Advanced Server, the `sslutils` extension and `hstore` contrib module are installed by default. + + - If you are PostgreSQL, ensure you have access to the PostgreSQL community repository, and then install the `sslutils` extension and the `hstore` contrib module: + + ```shell + dnf install postgresql-_sslutils postgresql-contrib + ``` + + Where, `x` is the Postgres server version. + + 4. If you are using a firewall, allow access to port `8443` on the Postgres server: + + ```text + firewall-cmd --permanent --zone=public --add-port=8443/tcp + + firewall-cmd --reload + ``` + +- Ensure the components Postgres Enterprise Manager depends on such as python3, libboost, openssl (1.0.2k or later), snmp++, and libcurl are up to date, using the following command: + + ```text + dnf upgrade + ``` ### Setting up the Repository diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles12_ppcle.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles12_ppcle.mdx index d0cfee45d34..81042b538ce 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles12_ppcle.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles12_ppcle.mdx @@ -3,23 +3,55 @@ title: "Installing the PEM server on SLES 12 Power" navTitle: "SLES 12" --- -There are three steps to completing an installation: - -- [Setting up the repository](#setting-up-the-repository) -- [Installing the package](#installing-the-package) -- [Performing the initial configuration](#initial-configuration) - -For each step, you must be logged in as superuser. +Before you begin the installation process, log in as superuser: ```shell # To log in as a superuser: sudo su - ``` -Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). +## Prerequisites + +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. + + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + + 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. + + - If you are using EDB Postgres Advanced Server, see [Modifying the pg_hba.conf file](/pem/latest/managing_database_server/#modifying-the-pg_hbaconf-file). + + - If you are using PostgreSQL, see [Client Authentication](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html). + + 3. Ensure that the `sslutils` extension and `hstore` contrib module are installed on your Postgres server. + + - If you are using EDB Postgres Advanced Server, the `sslutils` extension and `hstore` contrib module are installed by default. + + - If you are PostgreSQL, ensure you have access to the PostgreSQL community repository, and then install the `sslutils` extension and the `hstore` contrib module: + + ```shell + zypper install postgresql-_sslutils postgresql-contrib + ``` + + Where, `x` is the Postgres server version. + + 4. If you are using a firewall, allow access to port `8443` on the Postgres server: + + ```text + firewall-cmd --permanent --zone=public --add-port=8443/tcp + + firewall-cmd --reload + ``` + +- Ensure the components Postgres Enterprise Manager depends on such as python3, libboost, openssl (1.0.2k or later), snmp++, and libcurl are up to date, using the following command: + + ```text + zypper update + ``` ## Setting up the Repository +If you haven't already, you need to register with EDB to receive credentials for the EDB repository. See [Repository Access Request](https://www.enterprisedb.com/repository-access-request). + ```shell # Install the repository configuration and enter your EDB repository # credentials when prompted diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles15_ppcle.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles15_ppcle.mdx index e8ed8aa6aa1..8d3ef754afe 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles15_ppcle.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles15_ppcle.mdx @@ -3,23 +3,55 @@ title: "Installing the PEM server on SLES 15 on Power" navTitle: "SLES 15" --- -There are three steps to completing an installation: - -- [Setting up the repository](#setting-up-the-repository) -- [Installing the package](#installing-the-package) -- [Performing the initial configuration](#initial-configuration) - -For each step, you must be logged in as superuser. +Before you begin the installation process, log in as superuser: ```shell # To log in as a superuser sudo su - ``` -Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). +## Prerequisites + +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. + + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + + 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. + + - If you are using EDB Postgres Advanced Server, see [Modifying the pg_hba.conf file](/pem/latest/managing_database_server/#modifying-the-pg_hbaconf-file). + + - If you are using PostgreSQL, see [Client Authentication](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html). + + 3. Ensure that the `sslutils` extension and `hstore` contrib module are installed on your Postgres server. + + - If you are using EDB Postgres Advanced Server, the `sslutils` extension and `hstore` contrib module are installed by default. + + - If you are PostgreSQL, ensure you have access to the PostgreSQL community repository, and then install the `sslutils` extension and the `hstore` contrib module: + + ```shell + zypper install postgresql-_sslutils postgresql-contrib + ``` + + Where, `x` is the Postgres server version. + + 4. If you are using a firewall, allow access to port `8443` on the Postgres server: + + ```text + firewall-cmd --permanent --zone=public --add-port=8443/tcp + + firewall-cmd --reload + ``` + +- Ensure the components Postgres Enterprise Manager depends on such as python3, libboost, openssl (1.0.2k or later), snmp++, and libcurl are up to date, using the following command: + + ```text + zypper update + ``` ## Setting up the Repository +If you haven't already, you need to register with EDB to receive credentials for the EDB repository. See [Repository Access Request](https://www.enterprisedb.com/repository-access-request). + ```shell # Install the repository configuration and enter your EDB repository # credentials when prompted diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx index 5f96f34cdf0..01d0e0a62a9 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx @@ -17,7 +17,45 @@ yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarc !!! Note You may need to enable the `[extras]` repository definition in the `CentOS-Base.repo` file (located in `/etc/yum.repos.d`). -**Install and Configure the edb.repo File** +## Prerequisites + +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. + + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + + 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. + + - If you are using EDB Postgres Advanced Server, see [Modifying the pg_hba.conf file](/pem/latest/managing_database_server/#modifying-the-pg_hbaconf-file). + + - If you are using PostgreSQL, see [Client Authentication](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html). + + 3. Ensure that the `sslutils` extension and `hstore` contrib module are installed on your Postgres server. + + - If you are using EDB Postgres Advanced Server, the `sslutils` extension and `hstore` contrib module are installed by default. + + - If you are PostgreSQL, ensure you have access to the PostgreSQL community repository, and then install the `sslutils` extension and the `hstore` contrib module: + + ```shell + yum install postgresql-_sslutils postgresql-contrib + ``` + + Where, `x` is the Postgres server version. + + 4. If you are using a firewall, allow access to port `8443` on the Postgres server: + + ```text + firewall-cmd --permanent --zone=public --add-port=8443/tcp + + firewall-cmd --reload + ``` + +- Ensure the components Postgres Enterprise Manager depends on such as python3, libboost, openssl (1.0.2k or later), snmp++, and libcurl are up to date, using the following command: + + ```text + yum upgrade + ``` + +## Install and Configure the edb.repo File To create an EnterpriseDB repository configuration file, assume superuser privileges and invoke the following command: @@ -33,7 +71,7 @@ sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo To request credentials for the repository, contact [EDB](https://www.enterprisedb.com/repository-access-request). -**Install the PEM Server** +## Install the PEM Server After meeting the platform-specific prerequisites listed above, you can use yum to install the PEM Server: diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx index 3a92b64f962..9bb9895731e 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx @@ -13,13 +13,52 @@ On a Rocky Linux or AlmaLinux system, you can use the `yum` package manager or ` dnf -y install epel-release ``` + **Enable the powertools repository since EPEL packages may depend on packages from it** ```text dnf config-manager --set-enabled powertools ``` -**Install and Configure the edb.repo File** +## Prerequisites + +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. + + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + + 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. + + - If you are using EDB Postgres Advanced Server, see [Modifying the pg_hba.conf file](/pem/latest/managing_database_server/#modifying-the-pg_hbaconf-file). + + - If you are using PostgreSQL, see [Client Authentication](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html). + + 3. Ensure that the `sslutils` extension and `hstore` contrib module are installed on your Postgres server. + + - If you are using EDB Postgres Advanced Server, the `sslutils` extension and `hstore` contrib module are installed by default. + + - If you are PostgreSQL, ensure you have access to the PostgreSQL community repository, and then install the `sslutils` extension and the `hstore` contrib module: + + ```shell + dnf install postgresql-_sslutils postgresql-contrib + ``` + + Where, `x` is the Postgres server version. + + 4. If you are using a firewall, allow access to port `8443` on the Postgres server: + + ```text + firewall-cmd --permanent --zone=public --add-port=8443/tcp + + firewall-cmd --reload + ``` + +- Ensure the components Postgres Enterprise Manager depends on such as python3, libboost, openssl (1.0.2k or later), snmp++, and libcurl are up to date, using the following command: + + ```text + dnf upgrade + ``` + +## Install and Configure the edb.repo File To create an EnterpriseDB repository configuration file, assume superuser privileges and invoke the following command: @@ -35,13 +74,13 @@ sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo To request credentials for the repository, contact [EDB](https://www.enterprisedb.com/repository-access-request). -**Disbale the built-in PostgreSQL module** +## Disbale the built-in PostgreSQL module ```text dnf -qy module disable PostgreSQL ``` -**Install the PEM Server** +## Install the PEM Server After meeting the platform-specific prerequisites listed above, you can use dnf to install the PEM Server: diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx index eed6235f5f4..db5a082691c 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx @@ -3,7 +3,6 @@ title: "Installing the PEM server on RHEL 7/OL 7 x86" navTitle: "RHEL 7/OL 7" --- - Before following the detailed instructions that install the PEM server on your specific platform, you must perform the prerequisite steps detailed in [Prerequisites for installing PEM Server](../../prerequisites_for_installing_pem_server/). On a RHEL or OL system, you can use the `yum` package manager to install a PEM Server; the installation tool you use will be dependent on the version of the host operating system. Before installing the server, you must ensure that your system contains the required prerequisite software listed below. @@ -25,7 +24,47 @@ Enable the optional, extras, and HA repositories since EPEL packages may depend subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extras-rpms" --enable "rhel-ha-for-rhel-*-server-rpms" ``` -**Install and Configure the edb.repo File** +## Prerequisites + +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. + + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + + 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. + + - If you are using EDB Postgres Advanced Server, see [Modifying the pg_hba.conf file](/pem/latest/managing_database_server/#modifying-the-pg_hbaconf-file). + + - If you are using PostgreSQL, see [Client Authentication](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html). + + 3. Ensure that the `sslutils` extension and `hstore` contrib module are installed on your Postgres server. + + - If you are using EDB Postgres Advanced Server, the `sslutils` extension and `hstore` contrib module are installed by default. + + - If you are PostgreSQL, ensure you have access to the PostgreSQL community repository, and then install the `sslutils` extension and the `hstore` contrib module: + + ```shell + yum install postgresql-_sslutils postgresql-contrib + ``` + + Where, `x` is the Postgres server version. + + 4. If you are using a firewall, allow access to port `8443` on the Postgres server: + + ```text + firewall-cmd --permanent --zone=public --add-port=8443/tcp + + firewall-cmd --reload + ``` + +- Ensure the components Postgres Enterprise Manager depends on such as python3, libboost, openssl (1.0.2k or later), snmp++, and libcurl are up to date, using the following command: + + ```text + yum upgrade + ``` + + + +## Install and Configure the edb.repo File To create an EnterpriseDB repository configuration file, assume superuser privileges and invoke the following command: @@ -41,7 +80,7 @@ sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo To request credentials for the repository, contact [EDB](https://www.enterprisedb.com/repository-access-request). -**Install the PEM Server** +## Install the PEM Server After meeting the platform-specific prerequisites listed above, you can use yum to install the PEM Server: diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx index 65eb268534b..34ab62ff535 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx @@ -22,7 +22,46 @@ ARCH=$( /bin/arch ) subscription-manager repos --enable "codeready-builder-for-rhel-8-${ARCH}-rpms" ``` -**Install and Configure the edb.repo File** +## Prerequisites + +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. + + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + + 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. + + - If you are using EDB Postgres Advanced Server, see [Modifying the pg_hba.conf file](/pem/latest/managing_database_server/#modifying-the-pg_hbaconf-file). + + - If you are using PostgreSQL, see [Client Authentication](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html). + + 3. Ensure that the `sslutils` extension and `hstore` contrib module are installed on your Postgres server. + + - If you are using EDB Postgres Advanced Server, the `sslutils` extension and `hstore` contrib module are installed by default. + + - If you are PostgreSQL, ensure you have access to the PostgreSQL community repository, and then install the `sslutils` extension and the `hstore` contrib module: + + ```shell + dnf install postgresql-_sslutils postgresql-contrib + ``` + + Where, `x` is the Postgres server version. + + 4. If you are using a firewall, allow access to port `8443` on the Postgres server: + + ```text + firewall-cmd --permanent --zone=public --add-port=8443/tcp + + firewall-cmd --reload + ``` + +- Ensure the components Postgres Enterprise Manager depends on such as python3, libboost, openssl (1.0.2k or later), snmp++, and libcurl are up to date, using the following command: + + ```text + dnf upgrade + ``` + + +## Install and Configure the edb.repo File To create an EnterpriseDB repository configuration file, assume superuser privileges and invoke the following command: @@ -38,7 +77,7 @@ sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo To request credentials for the repository, contact [EDB](https://www.enterprisedb.com/repository-access-request). -**Install the PEM Server** +## Install the PEM Server After meeting the platform-specific prerequisites listed above, you can use dnf to install the PEM Server: diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx index 270ffd14cd0..de1fb852c09 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx @@ -2,6 +2,7 @@ title: "Installing the PEM server on SLES 12 x86" navTitle: "SLES 12" --- + Before you begin the installation process, log in as superuser: ```shell @@ -9,7 +10,6 @@ Before you begin the installation process, log in as superuser: sudo su - ``` - ## Prerequisites - Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. @@ -22,7 +22,7 @@ sudo su - - If you are using PostgreSQL, see [Client Authentication](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html). - 1. Ensure that the `sslutils` extension and `hstore` contrib module are installed on your Postgres server. + 3. Ensure that the `sslutils` extension and `hstore` contrib module are installed on your Postgres server. - If you are using EDB Postgres Advanced Server, the `sslutils` extension and `hstore` contrib module are installed by default. @@ -34,7 +34,7 @@ sudo su - Where, `x` is the Postgres server version. - 3. If you are using a firewall, allow access to port `8443` on the Postgres server: + 4. If you are using a firewall, allow access to port `8443` on the Postgres server: ```text firewall-cmd --permanent --zone=public --add-port=8443/tcp diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles15_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles15_x86.mdx index 9f272629f4b..655fe1f2c9b 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles15_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles15_x86.mdx @@ -3,23 +3,55 @@ title: "Installing the PEM server on SLES 15 x86" navTitle: "SLES 15" --- -There are three steps to completing an installation: - -- [Setting up the repository](#setting-up-the-repository) -- [Installing the package](#installing-the-package) -- [Performing the initial configuration](#initial-configuration) - -For each step, you must be logged in as superuser. +Before you begin the installation process, log in as superuser: ```shell # To log in as a superuser sudo su - ``` -Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). +## Prerequisites + +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. + + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + + 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. + + - If you are using EDB Postgres Advanced Server, see [Modifying the pg_hba.conf file](/pem/latest/managing_database_server/#modifying-the-pg_hbaconf-file). + + - If you are using PostgreSQL, see [Client Authentication](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html). + + 3. Ensure that the `sslutils` extension and `hstore` contrib module are installed on your Postgres server. + + - If you are using EDB Postgres Advanced Server, the `sslutils` extension and `hstore` contrib module are installed by default. + + - If you are PostgreSQL, ensure you have access to the PostgreSQL community repository, and then install the `sslutils` extension and the `hstore` contrib module: + + ```shell + zypper install postgresql-_sslutils postgresql-contrib + ``` + + Where, `x` is the Postgres server version. + + 4. If you are using a firewall, allow access to port `8443` on the Postgres server: + + ```text + firewall-cmd --permanent --zone=public --add-port=8443/tcp + + firewall-cmd --reload + ``` + +- Ensure the components Postgres Enterprise Manager depends on such as python3, libboost, openssl (1.0.2k or later), snmp++, and libcurl are up to date, using the following command: + + ```text + zypper update + ``` ## Setting up the Repository +If you haven't already, you need to register with EDB to receive credentials for the EDB repository. See [Repository Access Request](https://www.enterprisedb.com/repository-access-request). + ```shell # Install the repository configuration and enter your EDB repository # credentials when prompted diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu18_deb9_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu18_deb9_x86.mdx index f0fc5dfa1e8..22817a141de 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu18_deb9_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu18_deb9_x86.mdx @@ -8,45 +8,87 @@ The following steps will walk you through using the EDB `apt` repository to inst !!! Note You can also visit and select the platform and product to view the steps for installation. -1. Log in as root on your Debian or Ubuntu host: +Log in as root on your Debian or Ubuntu host: - ```text - sudo su - - ``` +```text +sudo su - +``` -2. Configure the EDB repository: +## Prerequisites - ```text - sh -c 'echo "deb https://username:password@apt.enterprisedb.com $(lsb_release - cs)-edb/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/edb-$(lsb_release -cs).list' - ``` +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. + + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + + 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. + + - If you are using EDB Postgres Advanced Server, see [Modifying the pg_hba.conf file](/pem/latest/managing_database_server/#modifying-the-pg_hbaconf-file). - Where `username:password` is to be replaced by the credentials provided by EDB. To request credentials for the repository, contact [EDB](https://www.enterprisedb.com/repository-access-request). + - If you are using PostgreSQL, see [Client Authentication](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html). -3. Add support to your system for secure APT repositories: + 3. Ensure that the `sslutils` extension and `hstore` contrib module are installed on your Postgres server. - ```text - apt-get install apt-transport-https - ``` + - If you are using EDB Postgres Advanced Server, the `sslutils` extension and `hstore` contrib module are installed by default. -4. Add the EBD signing key: + - If you are PostgreSQL, ensure you have access to the PostgreSQL community repository, and then install the `sslutils` extension and the `hstore` contrib module: - ```text - wget -q -O -https://username:password@apt.enterprisedb.com/edb-deb.gpg.key | apt-key add – - ``` + ```shell + apt install postgresql-_sslutils postgresql-contrib + ``` -5. Update the repository metadata: + Where, `x` is the Postgres server version. - ```text - apt-get update - ``` + !!! Note + Debian 10 and Ubuntu 20 has increased the requirements to accept the certificates due to security reason. -6. Use the following command to install the Debian package for the PEM server: + - If a user wants to install the PEM agent on any of the machines, they must upgrade ssltuils to 1.3 where 4096 bit RSA key and sha256 signature algorithm support has added. + - If a user does not upgrade sslutils to 1.3, then PEM agent may fail to connect to the PEM backend database server, and it might log the error ca md too weak. - ```text - apt-get install edb-pem - ``` + 4. If you are using a firewall, allow access to port `8443` on the Postgres server: - !!! Note - The operating system user `pem` gets created while installing the PEM Server. The PEM Server web application is a WSGI application, which runs under Apache HTTPD. The pem application data and the session gets saved to this user's home directory. + ```text + iptables -t filter -A INPUT -p TCP --dport 8443 -j ACCEPT + ``` + +- Ensure the components Postgres Enterprise Manager depends on such as python3, libboost, openssl (1.0.2k or later), snmp++, and libcurl are up to date, using the following command: + + ```text + apt-get update + ``` + +## Configure the EDB repository + +```text +sh -c 'echo "deb https://username:password@apt.enterprisedb.com $(lsb_release - cs)-edb/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/edb-$(lsb_release -cs).list' +``` + +Where `username:password` is to be replaced by the credentials provided by EDB. To request credentials for the repository, contact [EDB](https://www.enterprisedb.com/repository-access-request). + +## Add support to your system for secure APT repositories: + +```text +apt-get install apt-transport-https +``` + +## Add the EBD signing key + +```text +wget -q -O -https://username:password@apt.enterprisedb.com/edb-deb.gpg.key | apt-key add – +``` + +## Update the repository metadata + +```text +apt-get update +``` + +## Install the PEM server + +```text +apt-get install edb-pem +``` + +!!! Note + The operating system user `pem` gets created while installing the PEM Server. The PEM Server web application is a WSGI application, which runs under Apache HTTPD. The pem application data and the session gets saved to this user's home directory. When the installation completes, you must configure the PEM Server. For detailed information see [Configuring the PEM Server on Linux Platforms](../../configuring_the_pem_server_on_linux/). diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu20_deb10_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu20_deb10_x86.mdx index 9bb1794ba49..36ea251a0f6 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu20_deb10_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu20_deb10_x86.mdx @@ -14,47 +14,89 @@ The following steps will walk you through using the EDB `apt` repository to inst sudo su - ``` -2. Configure the EDB repository: +## Prerequisites - a. Set up the EnterpriseDB repository: +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. + + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + + 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. + + - If you are using EDB Postgres Advanced Server, see [Modifying the pg_hba.conf file](/pem/latest/managing_database_server/#modifying-the-pg_hbaconf-file). - ```text - sh -c 'echo "deb [arch=amd64] https://apt.enterprisedb.com/$(lsb_release -cs)-edb/ $(lsb_release -cs)main" > /etc/apt/sources.list.d/edb-$(lsb_release -cs).list' - ``` + - If you are using PostgreSQL, see [Client Authentication](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html). - b. Substitute your EnterpriseDB credentials for the `` and `` placeholders in the following command: + 3. Ensure that the `sslutils` extension and `hstore` contrib module are installed on your Postgres server. - ```text - sh -c 'echo "machine apt.enterprisedb.com login password " > /etc/apt/auth.conf.d/edb.conf' - ``` + - If you are using EDB Postgres Advanced Server, the `sslutils` extension and `hstore` contrib module are installed by default. + + - If you are PostgreSQL, ensure you have access to the PostgreSQL community repository, and then install the `sslutils` extension and the `hstore` contrib module: + + ```shell + apt install postgresql-_sslutils postgresql-contrib + ``` + + Where, `x` is the Postgres server version. + + !!! Note + Debian 10 and Ubuntu 20 has increased the requirements to accept the certificates due to security reason. + + - If a user wants to install the PEM agent on any of the machines, they must upgrade ssltuils to 1.3 where 4096 bit RSA key and sha256 signature algorithm support has added. + - If a user does not upgrade sslutils to 1.3, then PEM agent may fail to connect to the PEM backend database server, and it might log the error ca md too weak. + + 4. If you are using a firewall, allow access to port `8443` on the Postgres server: + + ```text + iptables -t filter -A INPUT -p TCP --dport 8443 -j ACCEPT + ``` + +- Ensure the components Postgres Enterprise Manager depends on such as python3, libboost, openssl (1.0.2k or later), snmp++, and libcurl are up to date, using the following command: + + ```text + apt-get update + ``` + +## Configure the EDB repository + +a. Set up the EnterpriseDB repository: + +```text +sh -c 'echo "deb [arch=amd64] https://apt.enterprisedb.com/$(lsb_release -cs)-edb/ $(lsb_release -cs)main" > /etc/apt/sources.list.d/edb-$(lsb_release -cs).list' +``` + +b. Substitute your EnterpriseDB credentials for the `` and `` placeholders in the following command: + +```text +sh -c 'echo "machine apt.enterprisedb.com login password " > /etc/apt/auth.conf.d/edb.conf' +``` - To request credentials for the repository, contact [EDB](https://www.enterprisedb.com/repository-access-request). +To request credentials for the repository, contact [EDB](https://www.enterprisedb.com/repository-access-request). -3. Add support to your system for secure APT repositories: +## Add support to your system for secure APT repositories - ```text - apt-get install apt-transport-https - ``` +```text +apt-get install apt-transport-https +``` -4. Add the EBD signing key: +## Add the EBD signing key - ```text - wget -q -O -https://username:password@apt.enterprisedb.com/edb-deb.gpg.key | apt-key add – - ``` +```text +wget -q -O -https://username:password@apt.enterprisedb.com/edb-deb.gpg.key | apt-key add – +``` -5. Update the repository metadata: +## Update the repository metadata - ```text - apt-get update - ``` +```text +apt-get update +``` -6. Use the following command to install the Debian package for the PEM server: +## Install the PEM server - ```text - apt-get install edb-pem - ``` +```text +apt-get install edb-pem +``` - !!! Note - The operating system user `pem` gets created while installing the PEM Server. The PEM Server web application is a WSGI application, which runs under Apache HTTPD. The pem application data and the session gets saved to this user's home directory. +!!! Note + The operating system user `pem` gets created while installing the PEM Server. The PEM Server web application is a WSGI application, which runs under Apache HTTPD. The pem application data and the session gets saved to this user's home directory. When the installation completes, you must configure the PEM Server. For detailed information see [Configuring the PEM Server on Linux Platforms](../../configuring_the_pem_server_on_linux/). diff --git a/product_docs/docs/pem/8/considerations/pem_pgbouncer/configuring_pgBouncer.mdx b/product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/configuring_pgBouncer.mdx similarity index 100% rename from product_docs/docs/pem/8/considerations/pem_pgbouncer/configuring_pgBouncer.mdx rename to product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/configuring_pgBouncer.mdx diff --git a/product_docs/docs/pem/8/considerations/pem_pgbouncer/configuring_the_pem_agent.mdx b/product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/configuring_the_pem_agent.mdx similarity index 100% rename from product_docs/docs/pem/8/considerations/pem_pgbouncer/configuring_the_pem_agent.mdx rename to product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/configuring_the_pem_agent.mdx diff --git a/product_docs/docs/pem/8/considerations/pem_pgbouncer/index.mdx b/product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/index.mdx similarity index 100% rename from product_docs/docs/pem/8/considerations/pem_pgbouncer/index.mdx rename to product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/index.mdx diff --git a/product_docs/docs/pem/8/considerations/pem_pgbouncer/pem_server_pem_agent_connection_management_mechanism.mdx b/product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/pem_server_pem_agent_connection_management_mechanism.mdx similarity index 100% rename from product_docs/docs/pem/8/considerations/pem_pgbouncer/pem_server_pem_agent_connection_management_mechanism.mdx rename to product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/pem_server_pem_agent_connection_management_mechanism.mdx diff --git a/product_docs/docs/pem/8/considerations/pem_pgbouncer/preparing_the_pem_database_server.mdx b/product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/preparing_the_pem_database_server.mdx similarity index 100% rename from product_docs/docs/pem/8/considerations/pem_pgbouncer/preparing_the_pem_database_server.mdx rename to product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/preparing_the_pem_database_server.mdx From fe7a708d72a25f588c1e98628ac5ffdf0789d8f0 Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Fri, 6 May 2022 14:42:28 +0530 Subject: [PATCH 14/32] EPAS - fixed the hyphen character for versions 11 to 14 as per DF-280 --- .../03_using_a_package_manager_to_install_advanced_server.mdx | 2 +- .../03_using_a_package_manager_to_install_advanced_server.mdx | 2 +- .../03_using_a_package_manager_to_install_advanced_server.mdx | 2 +- .../03_using_a_package_manager_to_install_advanced_server.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/product_docs/docs/epas/11/epas_inst_linux/03_using_a_package_manager_to_install_advanced_server.mdx b/product_docs/docs/epas/11/epas_inst_linux/03_using_a_package_manager_to_install_advanced_server.mdx index b4b8311a071..524ef3d5a3a 100644 --- a/product_docs/docs/epas/11/epas_inst_linux/03_using_a_package_manager_to_install_advanced_server.mdx +++ b/product_docs/docs/epas/11/epas_inst_linux/03_using_a_package_manager_to_install_advanced_server.mdx @@ -972,7 +972,7 @@ The following steps will walk you through using the EnterpriseDB apt repository - Install Debian package: ```text - apt-get –y install edb-as11-server + apt-get -y install edb-as11-server ``` !!! Note diff --git a/product_docs/docs/epas/12/epas_inst_linux/03_using_a_package_manager_to_install_advanced_server.mdx b/product_docs/docs/epas/12/epas_inst_linux/03_using_a_package_manager_to_install_advanced_server.mdx index 2b76824c001..71791a451b3 100644 --- a/product_docs/docs/epas/12/epas_inst_linux/03_using_a_package_manager_to_install_advanced_server.mdx +++ b/product_docs/docs/epas/12/epas_inst_linux/03_using_a_package_manager_to_install_advanced_server.mdx @@ -1070,7 +1070,7 @@ The following steps will walk you through using the EnterpriseDB apt repository - Install Debian package: ```text - apt-get –y install edb-as12-server + apt-get -y install edb-as12-server ``` !!! Note diff --git a/product_docs/docs/epas/13/epas_inst_linux/03_using_a_package_manager_to_install_advanced_server.mdx b/product_docs/docs/epas/13/epas_inst_linux/03_using_a_package_manager_to_install_advanced_server.mdx index c67a3b498c5..ebe9c81de1d 100644 --- a/product_docs/docs/epas/13/epas_inst_linux/03_using_a_package_manager_to_install_advanced_server.mdx +++ b/product_docs/docs/epas/13/epas_inst_linux/03_using_a_package_manager_to_install_advanced_server.mdx @@ -809,7 +809,7 @@ The following steps will walk you through using the EDB apt repository to instal - Install Debian package: ```text - apt-get –y install edb-as13-server + apt-get -y install edb-as13-server ``` !!! Note diff --git a/product_docs/docs/epas/14/epas_inst_linux/03_using_a_package_manager_to_install_advanced_server.mdx b/product_docs/docs/epas/14/epas_inst_linux/03_using_a_package_manager_to_install_advanced_server.mdx index dd278a45bab..dce15b21dd6 100644 --- a/product_docs/docs/epas/14/epas_inst_linux/03_using_a_package_manager_to_install_advanced_server.mdx +++ b/product_docs/docs/epas/14/epas_inst_linux/03_using_a_package_manager_to_install_advanced_server.mdx @@ -802,7 +802,7 @@ The following steps walk you through using the EDB apt repository to install a d - Install Debian package: ```text - apt-get –y install edb-as14-server + apt-get -y install edb-as14-server ``` !!! Note From 9dd5dcb3bcca6de6ec647bf8a525340bdf408fdf Mon Sep 17 00:00:00 2001 From: drothery-edb Date: Fri, 6 May 2022 09:51:49 -0400 Subject: [PATCH 15/32] Incorporated Guang's comments --- .../release/getting_started/identity_provider/azure_ad.mdx | 4 ++-- .../release/getting_started/identity_provider/okta.mdx | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx b/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx index bce4f333357..977358eba96 100644 --- a/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx +++ b/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx @@ -54,6 +54,6 @@ A unique URL and access code are provided in an email from cloudcare@enterprised 1. On the **Setup Config** tab on the Set Up Identity Provider page in BigAnimal: 1. Paste the Login URL value you copied from the Single sign-on page in Azure AD as the **Single Sign-On URL**. 1. For **Identity Provider Signature Certificate**, upload the Base64-encoded certificate downloaded from Azure. - 1. Select the appropriate method for **Request Binding**. Azure AD supports HTTP POST and HTTP Redirect. - 1. Select **rsa-sha256** for the **Response Signature Algorithm**. + 1. Select the appropriate method for **Request Binding**. Azure AD supports HTTP POST and Hybrid. + 1. Select the appropriate value for **Response Signature Algorithm**. Azure AD supports rsa-sha256 and rsh-sha1. 1. Select **Test Connection**. If the connection is successful, select **Sign in to BigAnimal** to complete the setup process in the BigAnimal portal. diff --git a/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx b/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx index de96428dafa..4045abdd291 100644 --- a/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx +++ b/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx @@ -59,6 +59,6 @@ Unique URL and access code are provided in an email from cloudcare@enterprisedb. 1. In BigAnimal, on the **Setup Config** tab on the Set Up Identity Provider page: 1. Paste the Identity Provider Single Sign-on URL you copied from Okta into the **Single Sign-On URL** field. 1. For **Identity Provider Signature Certificate**, upload the certificate downloaded from Okta. - 1. Select the appropriate method for **Request Binding**. Okta supports HTTP POST and HTTP Redirect. - 1. For **Response Signature Algorithm**, select **rsa-sha256** . + 1. Select the appropriate method for **Request Binding**. Okta supports HTTP POST, HTTP REDIRECT, and HYBRID. + 1. Select the appropriate value for **Response Signature Algorithm**. Okta AD supports rsa-sha256 and rsh-sha1. 1. Select **Test Connection**. If the connection is successful, select **Sign in to BigAnimal** to complete the setup process in the BigAnimal portal. From 932ed2d5240ed71f3f71d38cc268a60027b2aeea Mon Sep 17 00:00:00 2001 From: drothery-edb Date: Fri, 6 May 2022 10:19:38 -0400 Subject: [PATCH 16/32] fixed capitalization and hyphenation --- .../release/getting_started/identity_provider/azure_ad.mdx | 2 +- .../release/getting_started/identity_provider/okta.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx b/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx index 977358eba96..67be41d74dd 100644 --- a/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx +++ b/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx @@ -54,6 +54,6 @@ A unique URL and access code are provided in an email from cloudcare@enterprised 1. On the **Setup Config** tab on the Set Up Identity Provider page in BigAnimal: 1. Paste the Login URL value you copied from the Single sign-on page in Azure AD as the **Single Sign-On URL**. 1. For **Identity Provider Signature Certificate**, upload the Base64-encoded certificate downloaded from Azure. - 1. Select the appropriate method for **Request Binding**. Azure AD supports HTTP POST and Hybrid. + 1. Select the appropriate method for **Request Binding**. Azure AD supports HTTP-POST and Hybrid. 1. Select the appropriate value for **Response Signature Algorithm**. Azure AD supports rsa-sha256 and rsh-sha1. 1. Select **Test Connection**. If the connection is successful, select **Sign in to BigAnimal** to complete the setup process in the BigAnimal portal. diff --git a/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx b/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx index 4045abdd291..df51a202cde 100644 --- a/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx +++ b/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx @@ -59,6 +59,6 @@ Unique URL and access code are provided in an email from cloudcare@enterprisedb. 1. In BigAnimal, on the **Setup Config** tab on the Set Up Identity Provider page: 1. Paste the Identity Provider Single Sign-on URL you copied from Okta into the **Single Sign-On URL** field. 1. For **Identity Provider Signature Certificate**, upload the certificate downloaded from Okta. - 1. Select the appropriate method for **Request Binding**. Okta supports HTTP POST, HTTP REDIRECT, and HYBRID. + 1. Select the appropriate method for **Request Binding**. Okta supports HTTP-POST, HTTP-Redirect, and Hybrid. 1. Select the appropriate value for **Response Signature Algorithm**. Okta AD supports rsa-sha256 and rsh-sha1. 1. Select **Test Connection**. If the connection is successful, select **Sign in to BigAnimal** to complete the setup process in the BigAnimal portal. From df5a286b722c04439203c4d2f162bc285daeb4bd Mon Sep 17 00:00:00 2001 From: drothery-edb Date: Fri, 6 May 2022 11:05:18 -0400 Subject: [PATCH 17/32] addressing typo --- .../release/getting_started/identity_provider/azure_ad.mdx | 2 +- .../release/getting_started/identity_provider/okta.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx b/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx index 67be41d74dd..9ce4c87701b 100644 --- a/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx +++ b/product_docs/docs/biganimal/release/getting_started/identity_provider/azure_ad.mdx @@ -55,5 +55,5 @@ A unique URL and access code are provided in an email from cloudcare@enterprised 1. Paste the Login URL value you copied from the Single sign-on page in Azure AD as the **Single Sign-On URL**. 1. For **Identity Provider Signature Certificate**, upload the Base64-encoded certificate downloaded from Azure. 1. Select the appropriate method for **Request Binding**. Azure AD supports HTTP-POST and Hybrid. - 1. Select the appropriate value for **Response Signature Algorithm**. Azure AD supports rsa-sha256 and rsh-sha1. + 1. Select the appropriate value for **Response Signature Algorithm**. Azure AD supports rsa-sha256 and rsa-sha1. 1. Select **Test Connection**. If the connection is successful, select **Sign in to BigAnimal** to complete the setup process in the BigAnimal portal. diff --git a/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx b/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx index df51a202cde..a84181e2872 100644 --- a/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx +++ b/product_docs/docs/biganimal/release/getting_started/identity_provider/okta.mdx @@ -60,5 +60,5 @@ Unique URL and access code are provided in an email from cloudcare@enterprisedb. 1. Paste the Identity Provider Single Sign-on URL you copied from Okta into the **Single Sign-On URL** field. 1. For **Identity Provider Signature Certificate**, upload the certificate downloaded from Okta. 1. Select the appropriate method for **Request Binding**. Okta supports HTTP-POST, HTTP-Redirect, and Hybrid. - 1. Select the appropriate value for **Response Signature Algorithm**. Okta AD supports rsa-sha256 and rsh-sha1. + 1. Select the appropriate value for **Response Signature Algorithm**. Okta AD supports rsa-sha256 and rsa-sha1. 1. Select **Test Connection**. If the connection is successful, select **Sign in to BigAnimal** to complete the setup process in the BigAnimal portal. From d07a828051aae32437bf56b8e77667641f2c69dd Mon Sep 17 00:00:00 2001 From: David Wicinas <93669463+dwicinas@users.noreply.github.com> Date: Mon, 2 May 2022 11:16:10 -0400 Subject: [PATCH 18/32] initial setup for pgpool restructure --- .../index.mdx} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename product_docs/docs/pgpool/{4.3/01_installing_and_configuring_the_pgpool-II.mdx => 01_installing_and_configuring_the_pgpool-II/index.mdx} (100%) diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II.mdx b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/index.mdx similarity index 100% rename from product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II.mdx rename to product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/index.mdx From a2a37846cdfd4227c4a0ac26387ec79da767c96f Mon Sep 17 00:00:00 2001 From: David Wicinas <93669463+dwicinas@users.noreply.github.com> Date: Tue, 3 May 2022 08:36:20 -0400 Subject: [PATCH 19/32] numerous changes for restructuring pgpool --- .../09_pgpool_rhel8_ppcle.mdx | 65 ++ .../10_pgpool_rhel7_ppcle.mdx | 59 ++ .../11_pgpool_sles15_ppcle.mdx | 55 ++ .../12_pgpool_sles12_ppcle.mdx | 55 ++ .../ibm_power_ppc64le/index.mdx | 17 + .../index.mdx | 570 ------------------ .../x86_amd64/01_pgpool_rhel8_x86.mdx | 52 ++ .../x86_amd64/02_pgpool_other_linux8_x86.mdx | 48 ++ .../x86_amd64/03_pgpool_rhel7_x86.mdx | 45 ++ .../x86_amd64/05_pgpool_sles15_x86.mdx | 53 ++ .../x86_amd64/06_pgpool_sles12_x86.mdx | 49 ++ .../07_pgpool_ubuntu20_deb10_x86.mdx | 66 ++ .../x86_amd64/08_pgpool_ubuntu18_deb9_x86.mdx | 42 ++ .../x86_amd64/index.mdx | 17 + 14 files changed, 623 insertions(+), 570 deletions(-) create mode 100644 product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx create mode 100644 product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx create mode 100644 product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/11_pgpool_sles15_ppcle.mdx create mode 100644 product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/12_pgpool_sles12_ppcle.mdx create mode 100644 product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/index.mdx create mode 100644 product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/01_pgpool_rhel8_x86.mdx create mode 100644 product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/02_pgpool_other_linux8_x86.mdx create mode 100644 product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/03_pgpool_rhel7_x86.mdx create mode 100644 product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/05_pgpool_sles15_x86.mdx create mode 100644 product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/06_pgpool_sles12_x86.mdx create mode 100644 product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/07_pgpool_ubuntu20_deb10_x86.mdx create mode 100644 product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/08_pgpool_ubuntu18_deb9_x86.mdx create mode 100644 product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx new file mode 100644 index 00000000000..49c63643167 --- /dev/null +++ b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx @@ -0,0 +1,65 @@ +--- +title: "Installing EDB PgPool-II on RHEL 8 IBM Power (ppc64le)" +navTitle: "RHEL 8" +--- + +There are two steps to completing an installation: + +- Setting up the repository +- Installing the package + +For each step, you must be logged in as superuser. + +To log in as a superuser: + +```shell +sudo su - +``` + +## Setting up the repository + +1. To register with EDB to receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). + +1. Set up the EDB repository: + + ```shell + dnf -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm + ``` + + This creates the /etc/yum.repos.d/edb.repo configuration file. + +1. Add your EDB credentials to the edb.repo file: + + ```shell + sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo + ``` + + where `USERNAME:PASSWORD` is the username and password available from your + [EDB account](https://www.enterprisedb.com/user). + +1. Install the EPEL repository and refresh the cache: + + ```shell + dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm + dnf makecache + ``` + +1. Enable the codeready-builder-for-rhel-8-\*-rpms repository since EPEL packages may depend on packages from it: + + ```shell + ARCH=$( /bin/arch ) + subscription-manager repos --enable "codeready-builder-for-rhel-8-${ARCH}-rpms" + ``` + +1. Disable the built-in PostgreSQL module: + ```shell + dnf -qy module disable postgresql + ``` + +## Installing the package + +```shell +dnf -y install edb-pgpool +``` + +where <xx> is the EDB Pgpool-II version you want to install. diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx new file mode 100644 index 00000000000..f23a1fbc96f --- /dev/null +++ b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx @@ -0,0 +1,59 @@ +--- +title: "Installing EDB PgPool-II on RHEL 7 IBM Power (ppc64le)" +navTitle: "RHEL 7" +--- + +Before creating the repository configuration file, you must have credentials that allow access to the EDB repository. For information about requesting credentials, visit the [EDB website](https://www.enterprisedb.com/user). + +Perform the following steps to install EDB Pgpool-II on an RHEL/CentOS 7 PPC64LE Host: + +1. Install Advance Toolchain: + + ```text + rpm --import https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/redhat/RHEL7/gpg-pubkey-6976a827-5164221b + + cat > /etc/yum.repos.d/advance-toolchain.repo <:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo + ``` + +4. Invoke the following command to install the Extra Packages for Enterprise Linux (EPEL): + + ```text + yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm + ``` + +5. On RHEL 7, enable the `optional, extras`, and `HA` repositories to satisfy additional package dependencies: + + ```text + subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extras-rpms" --enable "rhel-ha-for-rhel-*-server-rpms" + ``` + +6. Invoke the following command to install EDB Pgpool-II: + + ```text + yum -y install edb-pgpool + ``` + + where <xx> is the EDB Pgpool-II version you want to install. + diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/11_pgpool_sles15_ppcle.mdx b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/11_pgpool_sles15_ppcle.mdx new file mode 100644 index 00000000000..080306fbdc1 --- /dev/null +++ b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/11_pgpool_sles15_ppcle.mdx @@ -0,0 +1,55 @@ +--- +title: "Installing EDB PgPool-II on SLES 15 IBM Power (ppc64le)" +navTitle: "SLES 15" +--- + +!!! note + Supported on EDB Pgpool-II 4.3 and later. + +There are two steps to completing an installation: + +- Setting up the repository +- Installing the package + +For each step, you must be logged in as superuser. + +```shell +# To log in as a superuser: +sudo su - +``` + +Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). + +## Setting up the repository + +Setting up the repository is a one time task. If you have already set up your repository, you do not need to perform these steps. + +```shell +# Install the repository configuration and enter your EDB repository +# credentials when prompted +zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo + +# Install SUSEConnect to register the host with SUSE, allowing access to +# SUSE repositories +zypper install SUSEConnect + +# Register the host with SUSE, allowing access to SUSE repositories +# Replace 'REGISTRATION_CODE' and 'EMAIL' with your SUSE registration +# information +SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' + +# Activate the required SUSE module +SUSEConnect -p PackageHub/15.3/ppc64le + +# Refresh the metadata +zypper refresh +``` + +## Installing the package + +```shell +zypper -n install edb-pgpool +``` +where <xx> is the EDB Pgpool-II version you want to install. + + diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/12_pgpool_sles12_ppcle.mdx b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/12_pgpool_sles12_ppcle.mdx new file mode 100644 index 00000000000..815912cc51b --- /dev/null +++ b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/12_pgpool_sles12_ppcle.mdx @@ -0,0 +1,55 @@ +--- +title: "Installing EDB PgPool-II on SLES 12 IBM Power (ppc64le)" +navTitle: "SLES 12" +--- + +!!! note + Supported on EDB Pgpool-II 4.3 and later. + +There are two steps to completing an installation: + +- Setting up the repository +- Installing the package + + +For each step, you must be logged in as superuser. + +```shell +# To log in as a superuser: +sudo su - +``` + +Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). + +## Setting up the repository + +Setting up the repository is a one time task. If you have already set up your repository, you do not need to perform these steps. + +```shell +# Install the repository configuration and enter your EDB repository +# credentials when prompted +zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo + +# Install SUSEConnect to register the host with SUSE, allowing access to +# SUSE repositories +zypper install SUSEConnect + +# Register the host with SUSE, allowing access to SUSE repositories +# Replace 'REGISTRATION_CODE' and 'EMAIL' with your SUSE registration +# information +SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' + +# Activate the required SUSE modules +SUSEConnect -p PackageHub/12.5/ppc64le +SUSEConnect -p sle-sdk/12.5/ppc64le + +# Refresh the metadata +zypper refresh +``` + +## Installing the package + +```shell +zypper -n install edb-pgpool +``` +where <xx> is the EDB Pgpool-II version you want to install. diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/index.mdx b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/index.mdx new file mode 100644 index 00000000000..bf30863bbec --- /dev/null +++ b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/index.mdx @@ -0,0 +1,17 @@ +--- +title: "Installing EDB PgPool-II on IBM Power (ppc64le)" +navTitle: "IBM Power (ppc64le)" +--- + +For operating system-specific install instructions, see: + + + - [RHEL 8](09_pgpool_rhel8_ppcle) + + - [RHEL 7](10_pgpool_rhel7_ppcle) + - [SLES 15](11_pgpool_sles15_ppcle) + - [SLES 12](12_pgpool_sles12_ppcle) + +After installing Migration Toolkit, you must install the appropriate source-specific drivers before performing a migration. See [Installing source-specific drivers](../../#installing_drivers) for more information. + + diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/index.mdx b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/index.mdx index 9f85cdd36e3..721fd409062 100644 --- a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/index.mdx +++ b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/index.mdx @@ -31,578 +31,8 @@ This documentation assumes that the user has some knowledge of installation and Before installing the repository configuration, you must have credentials that allow access to the EDB repository. For information about requesting credentials, visit the [EDB website](https://www.enterprisedb.com/user). -## Installing EDB Pgpool-II on a CentOS/Rocky Linux/AlmaLinux x86-64 host -Perform the following steps: -1. To install the repository configuration, assume superuser privileges, and invoke the platform-specific command: - - On CentOS 7: - - ```text - yum -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm - ``` - - On Rocky Linux 8 or AlmaLinux 8: - - ```text - dnf -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm - ``` - -2. Replace the `USERNAME:PASSWORD` variable in the following command with the username and password of a registered EDB user: - - ```text - sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo - ``` - -3. Invoke the following command to install the Extra Packages for Enterprise Linux (EPEL): - - On CentOS 7: - - ```text - yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm - ``` - - On Rocky Linux 8 or AlmaLinux 8: - - ```text - dnf -y install epel-release - ``` - -4. The following steps are applicable only for Rocky Linux 8 or AlmaLinux 8: - - a. Enable the PowerTools repository to satisfy additional package dependencies: - - ```text - dnf config-manager --set-enabled PowerTools - ``` - - b. Disable the built-in PostgreSQL module: - - ```text - dnf -qy module disable postgresql - ``` - -5. Invoke the platform-specific command to install EDB Pgpool-II: - - On CentOS 7: - - ```text - yum install edb-pgpool - ``` - - On Rocky Linux 8 or AlmaLinux 8: - - ```text - dnf install edb-pgpool - ``` - - where `` is the EDB Pgpool release version. - - For example, to install EDB Pgpool 4.3, invoke the following command: - - On CentOS 7: - - ```text - yum install edb-pgpool43 - ``` - - On Rocky Linux 8 or AlmaLinux 8: - - ```text - dnf install edb-pgpool43 - ``` - - When you install an RPM package signed by a source that is not recognized by your system, your permission to import the key to your local server may be asked. If prompted, and you are satisfied that the packages come from a trustworthy source, enter `y` and press `Return` to continue. - - EDB Pgpool-II is installed in the `/usr/edb/pgpool/` directory, where <x.y> is the installed EDB Pgpool-II version number. - - - -## Installing EDB Pgpool-II on an RHEL x86-64 host - -Before creating the repository configuration file, you must have credentials that allow access to the EDB repository. For information about requesting credentials, visit the [EDB website](https://www.enterprisedb.com/user). - -Perform the following steps to install EDB Pgpool-II: - -1. To create the repository configuration file, assume superuser privileges, and invoke the platform-specific command: - - On RHEL 7: - - ```text - yum -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm - ``` - - On RHEL 8: - - ```text - dnf -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm - ``` - -2. Replace the `USERNAME:PASSWORD` variable in the following command with the username and password of a registered EDB user: - - ```text - sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo - ``` - -3. Invoke the following command to install the Extra Packages for Enterprise Linux (EPEL): - - On RHEL 7: - - ```text - yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm - ``` - - On RHEL 8: - - ```text - dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm - ``` - -4. Enable the repository: - - On RHEL 7, enable the `optional, extras`, and `HA` repositories to satisfy additional package dependencies: - - ```text - subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extras-rpms" --enable "rhel-ha-for-rhel-*-server-rpms" - ``` - - On RHEL 8, enable the `codeready-builder-for-rhel-8-*-rpms` repository to satisfy additional package dependencies: - - ```text - ARCH=$( /bin/arch ) - - subscription-manager repos --enable "codeready-builder-for-rhel-8-${ARCH}-rpms" - ``` - -5. For RHEL 8, disable the built-in PostgreSQL module: - - ```text - dnf -qy module disable postgresql - ``` - -6. Invoke the platform-specific command to install EDB Pgpool-II: - - On RHEL 7: - - ```text - yum install edb-pgpool - ``` - - On RHEL 8: - - ```text - dnf install edb-pgpool - ``` - - where <xx> is the EDB Pgpool release version. - - For example, to install EDB Pgpool 4.3, invoke the following command: - - On RHEL 7: - - ```text - yum install edb-pgpool43 - ``` - - On RHEL 8: - - ```text - dnf install edb-pgpool43 - ``` - - When you install an RPM package that is signed by a source that is not recognized by your system, your permission to import the key to your local server may be asked for. If prompted, and you are satisfied that the packages come from a trustworthy source, enter `y`, and press `Return` to continue. - - EDB Pgpool-II will be installed in the `/usr/edb/pgpool/` directory, where <x.y> is the installed EDB Pgpool-II version number. - - - -## Installing EDB Pgpool-II on an RHEL 7 ppc64le host - -Before creating the repository configuration file, you must have credentials that allow access to the EDB repository. For information about requesting credentials, visit the [EDB website](https://www.enterprisedb.com/user). - -Perform the following steps to install EDB Pgpool-II on an RHEL/CentOS 7 PPC64LE Host: - -1. Install Advance Toolchain: - - ```text - rpm --import https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/redhat/RHEL7/gpg-pubkey-6976a827-5164221b - - cat > /etc/yum.repos.d/advance-toolchain.repo <:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo - ``` - -4. Invoke the following command to install the Extra Packages for Enterprise Linux (EPEL): - - ```text - yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm - ``` - -5. On RHEL 7, enable the `optional, extras`, and `HA` repositories to satisfy additional package dependencies: - - ```text - subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extras-rpms" --enable "rhel-ha-for-rhel-*-server-rpms" - ``` - -6. Invoke the following command to install EDB Pgpool-II: - - ```text - yum -y install edb-pgpool - ``` - - where <xx> is the EDB Pgpool-II version you want to install. - -## Installing EDB Pgpool-II on an RHEL 8 ppc64le host - -There are two steps to completing an installation: - -- Setting up the repository -- Installing the package - -For each step, you must be logged in as superuser. - -To log in as a superuser: - -```shell -sudo su - -``` - -### Setting up the repository - -1. To register with EDB to receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). - -1. Set up the EDB repository: - - ```shell - dnf -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm - ``` - - This creates the /etc/yum.repos.d/edb.repo configuration file. - -1. Add your EDB credentials to the edb.repo file: - - ```shell - sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo - ``` - - where `USERNAME:PASSWORD` is the username and password available from your - [EDB account](https://www.enterprisedb.com/user). - -1. Install the EPEL repository and refresh the cache: - - ```shell - dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm - dnf makecache - ``` - -1. Enable the codeready-builder-for-rhel-8-\*-rpms repository since EPEL packages may depend on packages from it: - - ```shell - ARCH=$( /bin/arch ) - subscription-manager repos --enable "codeready-builder-for-rhel-8-${ARCH}-rpms" - ``` - -1. Disable the built-in PostgreSQL module: - ```shell - dnf -qy module disable postgresql - ``` - -### Installing the package - -```shell -dnf -y install edb-pgpool -``` - -where <xx> is the EDB Pgpool-II version you want to install. - - - -## Installing EDB Pgpool-II on a Debian/Ubuntu x86-64 host - -To install EDB Pgpool-II on a Debian or Ubuntu host, you must have credentials that allow access to the EDB repository. To request credentials for the repository, visit the [EDB website](https://www.enterprisedb.com/user). - -Perform the following steps to install a Debian package using the EDB apt repository. - -1. Assume superuser privileges: - - ```text - sudo su – - ``` - -2. Configure access to the EDB repository on your system: - - On Debian 9, Ubuntu 18, and Ubuntu 20, replace the `username` and `password` with your EDB credentials: - - ```text - sh -c 'echo "deb https://:@apt.enterprisedb.com/$(lsb_release -cs)-edb/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/edb-$(lsb_release -cs).list' - ``` - - On Debian 10: - - a. Set up the EDB repository: - - ```text - sh -c 'echo "deb [arch=amd64] https://apt.enterprisedb.com/$(lsb_release -cs)-edb/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/edb-$(lsb_release -cs).list' - ``` - - b. Replace the `username` and `password` with your EDB credentials: - - ```text - sh -c 'echo "machine apt.enterprisedb.com login password " > /etc/apt/auth.conf.d/edb.conf' - ``` - -3. Add support to your system for secure APT repositories: - - ```text - apt-get install apt-transport-https - ``` - -4. Add the EDB signing key: - - ```text - wget -q -O - https://apt.enterprisedb.com/edb-deb.gpg.key | sudo apt-key add - - ``` - -5. Update the repository metadata: - - ```text - apt-get update - ``` - -6. Install the Debian package: - - ```text - apt-get install -y edb-pgpool - ``` - - where <xx> is the EDB Pgpool-II release version. - -After installing EDB Pgpool-II on a Debian host, the configuration files are located in the `/etc/edb/edb-pgpool` directory, where <x.y> is the EDB Pgpool-II release version. - - - -## Installing EDB Pgpool-II on an SLES 12 x86-64 host - -You can use the Zypper package manager to install EDB Pgpool-II on an SLES 12 host. Zypper will attempt to satisfy package dependencies but requires access to specific repositories that EDB does not host. - -1. Assume superuser privileges. - - ```text - sudo su - - ``` - -2. Invoke the following command to add the EDB repository to your SLES host: - - ```text - zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo - ``` - -4. Install `SUSEConnect` to register the host with SUSE to allow access to SUSE repositories: - - ```text - zypper install SUSEConnect - ``` - -5. Register the host with SUSE to allow access to SUSE repositories and replace `'REGISTRATION_CODE'` and `'EMAIL'` with your SUSE registration information: - - ```text - SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' - SUSEConnect -p PackageHub/12.5/x86_64 - SUSEConnect -p sle-sdk/12.5/x86_64 - ``` - - -6. Refresh the metadata: - - ```text - zypper refresh - ``` - - -7. Use the Zypper utility to install EDB Pgpool-II: - - ```text - zypper install -n edb-pgpool - ``` - - where <xx> is the EDB Pgpool II version you wish to install. - -## Installing EDB Pgpool-II on an SLES 15 x86-64 host - -!!! note - Supported on EDB Pgpool-II 4.3 and later. - -There are two steps to completing an installation: - -- Setting up the repository -- Installing the package - -For each step, you must be logged in as superuser. - -```shell -# To log in as a superuser: -sudo su - -``` - -Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). - -### Setting up the repository - -Setting up the repository is a one time task. If you have already set up your repository, you do not need to perform these steps. - -```shell -# Install the repository configuration and enter your EDB repository -# credentials when prompted -zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo - -# Install SUSEConnect to register the host with SUSE, allowing access to -# SUSE repositories -zypper install SUSEConnect - -# Register the host with SUSE, allowing access to SUSE repositories -# Replace 'REGISTRATION_CODE' and 'EMAIL' with your SUSE registration -# information -SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' - -# Activate the required SUSE module -SUSEConnect -p PackageHub/15.3/x86_64 - -# Refresh the metadata -zypper refresh -``` - -### Installing the package - -```shell -zypper -n install edb-pgpool -``` -where <xx> is the EDB Pgpool-II version you want to install. - -## Installing EDB Pgpool-II on an SLES 12 ppc64le host - -!!! note - Supported on EDB Pgpool-II 4.3 and later. - -There are two steps to completing an installation: - -- Setting up the repository -- Installing the package - - -For each step, you must be logged in as superuser. - -```shell -# To log in as a superuser: -sudo su - -``` - -Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). - -### Setting up the repository - -Setting up the repository is a one time task. If you have already set up your repository, you do not need to perform these steps. - -```shell -# Install the repository configuration and enter your EDB repository -# credentials when prompted -zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo - -# Install SUSEConnect to register the host with SUSE, allowing access to -# SUSE repositories -zypper install SUSEConnect - -# Register the host with SUSE, allowing access to SUSE repositories -# Replace 'REGISTRATION_CODE' and 'EMAIL' with your SUSE registration -# information -SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' - -# Activate the required SUSE modules -SUSEConnect -p PackageHub/12.5/ppc64le -SUSEConnect -p sle-sdk/12.5/ppc64le - -# Refresh the metadata -zypper refresh -``` - -### Installing the package - -```shell -zypper -n install edb-pgpool -``` -where <xx> is the EDB Pgpool-II version you want to install. - - -## Installing EDB Pgpool-II on an SLES 15 ppc64le host - -!!! note - Supported on EDB Pgpool-II 4.3 and later. - -There are two steps to completing an installation: - -- Setting up the repository -- Installing the package - -For each step, you must be logged in as superuser. - -```shell -# To log in as a superuser: -sudo su - -``` - -Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). - -### Setting up the repository - -Setting up the repository is a one time task. If you have already set up your repository, you do not need to perform these steps. - -```shell -# Install the repository configuration and enter your EDB repository -# credentials when prompted -zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo - -# Install SUSEConnect to register the host with SUSE, allowing access to -# SUSE repositories -zypper install SUSEConnect - -# Register the host with SUSE, allowing access to SUSE repositories -# Replace 'REGISTRATION_CODE' and 'EMAIL' with your SUSE registration -# information -SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' - -# Activate the required SUSE module -SUSEConnect -p PackageHub/15.3/ppc64le - -# Refresh the metadata -zypper refresh -``` - -### Installing the package - -```shell -zypper -n install edb-pgpool -``` -where <xx> is the EDB Pgpool-II version you want to install. diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/01_pgpool_rhel8_x86.mdx b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/01_pgpool_rhel8_x86.mdx new file mode 100644 index 00000000000..11ae3fdb12e --- /dev/null +++ b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/01_pgpool_rhel8_x86.mdx @@ -0,0 +1,52 @@ +--- +title: "Installing EDB PgPool-II on RHEL 8/OL 8 x86" +navTitle: "RHEL 8/OL 8" +--- + +Before creating the repository configuration file, you must have credentials that allow access to the EDB repository. For information about requesting credentials, visit the [EDB website](https://www.enterprisedb.com/user). + +Perform the following steps to install EDB Pgpool-II: + +1. To create the repository configuration file, assume superuser privileges, and invoke the following command: + ```text + dnf -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm + ``` + +2. Replace the `USERNAME:PASSWORD` variable in the following command with the username and password of a registered EDB user: + ```text + sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo + ``` + +3. Install the Extra Packages for Enterprise Linux (EPEL): + ```text + dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm + ``` + +4. Enable the `codeready-builder-for-rhel-8-*-rpms` repository to satisfy additional package dependencies: + ```text + ARCH=$( /bin/arch ) + + subscription-manager repos --enable "codeready-builder-for-rhel-8-${ARCH}-rpms" + ``` + +5. Disable the built-in PostgreSQL module: + ```text + dnf -qy module disable postgresql + ``` + +6. Install EDB Pgpool-II: + ```text + dnf install edb-pgpool + ``` + + where <xx> is the EDB Pgpool release version. + + For example, to install EDB Pgpool 4.3, invoke the following command: + ```text + dnf install edb-pgpool43 + ``` + + When you install an RPM package that is signed by a source that is not recognized by your system, your permission to import the key to your local server may be asked for. If prompted, and you are satisfied that the packages come from a trustworthy source, enter `y`, and press `Return` to continue. + + EDB Pgpool-II will be installed in the `/usr/edb/pgpool/` directory, where <x.y> is the installed EDB Pgpool-II version number. + \ No newline at end of file diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/02_pgpool_other_linux8_x86.mdx b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/02_pgpool_other_linux8_x86.mdx new file mode 100644 index 00000000000..9134a79f3fa --- /dev/null +++ b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/02_pgpool_other_linux8_x86.mdx @@ -0,0 +1,48 @@ +--- +title: "Installing EDB PgPool-II on Rocky Linux 8/AlmaLinux 8 x86" +navTitle: "Rocky Linux 8/AlmaLinux 8" +--- + + + +1. To install the repository configuration, assume superuser privileges, and invoke the platform-specific command: + ```text + dnf -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm + ``` + +2. Replace the `USERNAME:PASSWORD` variable in the following command with the username and password of a registered EDB user: + ```text + sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo + ``` + +3. Invoke the following command to install the Extra Packages for Enterprise Linux (EPEL): + ```text + dnf -y install epel-release + ``` + +4. Enable the PowerTools repository to satisfy additional package dependencies: + ```text + dnf config-manager --set-enabled PowerTools + ``` + +5. Disable the built-in PostgreSQL module: + ```text + dnf -qy module disable postgresql + ``` + +5. Install EDB Pgpool-II: + ```text + dnf install edb-pgpool + ``` + + where `` is the EDB Pgpool release version. + + For example, to install EDB Pgpool 4.3, invoke the following command: + ```text + dnf install edb-pgpool43 + ``` + + When you install an RPM package signed by a source that is not recognized by your system, your permission to import the key to your local server may be asked. If prompted, and you are satisfied that the packages come from a trustworthy source, enter `y` and press `Return` to continue. + + EDB Pgpool-II is installed in the `/usr/edb/pgpool/` directory, where <x.y> is the installed EDB Pgpool-II version number. + \ No newline at end of file diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/03_pgpool_rhel7_x86.mdx b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/03_pgpool_rhel7_x86.mdx new file mode 100644 index 00000000000..9461d01d6fa --- /dev/null +++ b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/03_pgpool_rhel7_x86.mdx @@ -0,0 +1,45 @@ +--- +title: "Installing EDB PgPool-II on RHEL 7/OL 7 x86" +navTitle: "RHEL 7/OL 7" +--- + +Before creating the repository configuration file, you must have credentials that allow access to the EDB repository. For information about requesting credentials, visit the [EDB website](https://www.enterprisedb.com/user). + +Perform the following steps to install EDB Pgpool-II: + +1. To create the repository configuration file, assume superuser privileges, and invoke the following command: + ```text + yum -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm + ``` + +2. Replace the `USERNAME:PASSWORD` variable in the following command with the username and password of a registered EDB user: + ```text + sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo + ``` + +3. Invoke the following command to install the Extra Packages for Enterprise Linux (EPEL): + ```text + yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm + ``` + +4. Enable the `optional, extras`, and `HA` repositories to satisfy additional package dependencies: + ```text + subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extras-rpms" --enable "rhel-ha-for-rhel-*-server-rpms" + ``` + +6. Install EDB Pgpool-II: + ```text + yum install edb-pgpool + ``` + + where <xx> is the EDB Pgpool release version. + + For example, to install EDB Pgpool 4.3, invoke the following command: + ```text + yum install edb-pgpool43 + ``` + + When you install an RPM package that is signed by a source that is not recognized by your system, your permission to import the key to your local server may be asked for. If prompted, and you are satisfied that the packages come from a trustworthy source, enter `y`, and press `Return` to continue. + + EDB Pgpool-II will be installed in the `/usr/edb/pgpool/` directory, where <x.y> is the installed EDB Pgpool-II version number. + \ No newline at end of file diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/05_pgpool_sles15_x86.mdx b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/05_pgpool_sles15_x86.mdx new file mode 100644 index 00000000000..94808b05f72 --- /dev/null +++ b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/05_pgpool_sles15_x86.mdx @@ -0,0 +1,53 @@ +--- +title: "Installing EDB PgPool-II on SLES 15 x86" +navTitle: "SLES 15" +--- + +!!! note + Supported on EDB Pgpool-II 4.3 and later. + +There are two steps to completing an installation: + +- Setting up the repository +- Installing the package + +For each step, you must be logged in as superuser. + +```shell +# To log in as a superuser: +sudo su - +``` + +Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). + +## Setting up the repository + +Setting up the repository is a one time task. If you have already set up your repository, you do not need to perform these steps. + +```shell +# Install the repository configuration and enter your EDB repository +# credentials when prompted +zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo + +# Install SUSEConnect to register the host with SUSE, allowing access to +# SUSE repositories +zypper install SUSEConnect + +# Register the host with SUSE, allowing access to SUSE repositories +# Replace 'REGISTRATION_CODE' and 'EMAIL' with your SUSE registration +# information +SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' + +# Activate the required SUSE module +SUSEConnect -p PackageHub/15.3/x86_64 + +# Refresh the metadata +zypper refresh +``` + +## Installing the package + +```shell +zypper -n install edb-pgpool +``` +where <xx> is the EDB Pgpool-II version you want to install. \ No newline at end of file diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/06_pgpool_sles12_x86.mdx b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/06_pgpool_sles12_x86.mdx new file mode 100644 index 00000000000..e78d90c1236 --- /dev/null +++ b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/06_pgpool_sles12_x86.mdx @@ -0,0 +1,49 @@ +--- +title: "Installing EDB PgPool-II on SLES 12 x86" +navTitle: "SLES 12" +--- + +You can use the Zypper package manager to install EDB Pgpool-II on an SLES 12 host. Zypper will attempt to satisfy package dependencies but requires access to specific repositories that EDB does not host. + +1. Assume superuser privileges. + + ```text + sudo su - + ``` + +2. Invoke the following command to add the EDB repository to your SLES host: + + ```text + zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo + ``` + +4. Install `SUSEConnect` to register the host with SUSE to allow access to SUSE repositories: + + ```text + zypper install SUSEConnect + ``` + +5. Register the host with SUSE to allow access to SUSE repositories and replace `'REGISTRATION_CODE'` and `'EMAIL'` with your SUSE registration information: + + ```text + SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' + SUSEConnect -p PackageHub/12.5/x86_64 + SUSEConnect -p sle-sdk/12.5/x86_64 + ``` + + +6. Refresh the metadata: + + ```text + zypper refresh + ``` + + +7. Use the Zypper utility to install EDB Pgpool-II: + + ```text + zypper install -n edb-pgpool + ``` + + where <xx> is the EDB Pgpool II version you wish to install. + diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/07_pgpool_ubuntu20_deb10_x86.mdx b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/07_pgpool_ubuntu20_deb10_x86.mdx new file mode 100644 index 00000000000..1370b930d81 --- /dev/null +++ b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/07_pgpool_ubuntu20_deb10_x86.mdx @@ -0,0 +1,66 @@ +--- +title: "Installing EDB PgPool-II on Ubuntu 20.04/Debian 10 x86" +navTitle: "Ubuntu 20.04/Debian 10" +--- + +## Installing EDB Pgpool-II on a Debian/Ubuntu x86-64 host + +To install EDB Pgpool-II on a Debian or Ubuntu host, you must have credentials that allow access to the EDB repository. To request credentials for the repository, visit the [EDB website](https://www.enterprisedb.com/user). + +Perform the following steps to install a Debian package using the EDB apt repository. + +1. Assume superuser privileges: + + ```text + sudo su – + ``` + +2. Configure access to the EDB repository on your system: + + On Ubuntu 20, replace the `username` and `password` with your EDB credentials: + + ```text + sh -c 'echo "deb https://:@apt.enterprisedb.com/$(lsb_release -cs)-edb/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/edb-$(lsb_release -cs).list' + ``` + + On Debian 10: + + a. Set up the EDB repository: + + ```text + sh -c 'echo "deb [arch=amd64] https://apt.enterprisedb.com/$(lsb_release -cs)-edb/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/edb-$(lsb_release -cs).list' + ``` + + b. Replace the `username` and `password` with your EDB credentials: + + ```text + sh -c 'echo "machine apt.enterprisedb.com login password " > /etc/apt/auth.conf.d/edb.conf' + ``` + +3. Add support to your system for secure APT repositories: + + ```text + apt-get install apt-transport-https + ``` + +4. Add the EDB signing key: + + ```text + wget -q -O - https://apt.enterprisedb.com/edb-deb.gpg.key | sudo apt-key add - + ``` + +5. Update the repository metadata: + + ```text + apt-get update + ``` + +6. Install the Debian package: + + ```text + apt-get install -y edb-pgpool + ``` + + where <xx> is the EDB Pgpool-II release version. + +After installing EDB Pgpool-II on a Debian host, the configuration files are located in the `/etc/edb/edb-pgpool` directory, where <x.y> is the EDB Pgpool-II release version. diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/08_pgpool_ubuntu18_deb9_x86.mdx b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/08_pgpool_ubuntu18_deb9_x86.mdx new file mode 100644 index 00000000000..873e697892d --- /dev/null +++ b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/08_pgpool_ubuntu18_deb9_x86.mdx @@ -0,0 +1,42 @@ +--- +title: "Installing EDB PgPool-II on Ubuntu 18.04/Debian 9 x86" +navTitle: "Ubuntu 18.04/Debian 9" +--- + +To install EDB Pgpool-II on a Debian or Ubuntu host, you must have credentials that allow access to the EDB repository. To request credentials for the repository, visit the [EDB website](https://www.enterprisedb.com/user). + +Perform the following steps to install a Debian package using the EDB apt repository. + +1. Assume superuser privileges: + + ```text + sudo su – + ``` + +2. Configure access to the EDB repository on your system: + ```text + sh -c 'echo "deb https://:@apt.enterprisedb.com/$(lsb_release -cs)-edb/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/edb-$(lsb_release -cs).list' + ``` +3. Add support to your system for secure APT repositories: + ```text + apt-get install apt-transport-https + ``` + +4. Add the EDB signing key: + ```text + wget -q -O - https://apt.enterprisedb.com/edb-deb.gpg.key | sudo apt-key add - + ``` + +5. Update the repository metadata: + ```text + apt-get update + ``` + +6. Install the Debian package: + ```text + apt-get install -y edb-pgpool + ``` + + where <xx> is the EDB Pgpool-II release version. + +After installing EDB Pgpool-II on a Debian host, the configuration files are located in the `/etc/edb/edb-pgpool` directory, where <x.y> is the EDB Pgpool-II release version. diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx new file mode 100644 index 00000000000..179f170ab55 --- /dev/null +++ b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx @@ -0,0 +1,17 @@ +--- +title: "Installing EDB PgPool-II on Linux x86 (amd64)" +navTitle: "Intel x86 (amd64)" +--- + +For operating system-specific install instructions, see: + + - [RHEL 8/OL 8](01_pgpool_rhel8_x86) + + - [Rocky Linux 8/AlmaLinux 8](02_pgpool_other_linux8_x86) + - [RHEL 7/OL 7](03_pgpool_rhel7_x86) + - [SLES 15](05_pgpool_sles15_x86) + - [SLES 12](06_pgpool_sles12_x86) + - [Ubuntu 20.04/Debian 10](07_pgpool_ubuntu20_deb10_x86) + - [Ubuntu 18.04/Debian 9](08_pgpool_ubuntu18_deb9_x86) + +After installing Migration Toolkit, you must install the appropriate source-specific drivers before performing a migration. See [Installing source-specific drivers](../../#installing_drivers) for more information. \ No newline at end of file From 68bef561701c6b30e4088220f5c203bb13b222ad Mon Sep 17 00:00:00 2001 From: David Wicinas <93669463+dwicinas@users.noreply.github.com> Date: Tue, 3 May 2022 08:49:29 -0400 Subject: [PATCH 20/32] moved directory for PgPool, fixes to index file --- .../index.mdx | 91 ------------------- .../09_pgpool_rhel8_ppcle.mdx | 0 .../10_pgpool_rhel7_ppcle.mdx | 0 .../11_pgpool_sles15_ppcle.mdx | 0 .../12_pgpool_sles12_ppcle.mdx | 0 .../ibm_power_ppc64le/index.mdx | 0 .../index.mdx | 41 +++++++++ .../x86_amd64/01_pgpool_rhel8_x86.mdx | 0 .../x86_amd64/02_pgpool_other_linux8_x86.mdx | 0 .../x86_amd64/03_pgpool_rhel7_x86.mdx | 0 .../x86_amd64/05_pgpool_sles15_x86.mdx | 0 .../x86_amd64/06_pgpool_sles12_x86.mdx | 0 .../07_pgpool_ubuntu20_deb10_x86.mdx | 0 .../x86_amd64/08_pgpool_ubuntu18_deb9_x86.mdx | 0 .../x86_amd64/index.mdx | 0 .../pgpool_rel_notes/supported_platforms.mdx | 15 +++ 16 files changed, 56 insertions(+), 91 deletions(-) delete mode 100644 product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/index.mdx rename product_docs/docs/pgpool/{ => 4.3}/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx (100%) rename product_docs/docs/pgpool/{ => 4.3}/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx (100%) rename product_docs/docs/pgpool/{ => 4.3}/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/11_pgpool_sles15_ppcle.mdx (100%) rename product_docs/docs/pgpool/{ => 4.3}/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/12_pgpool_sles12_ppcle.mdx (100%) rename product_docs/docs/pgpool/{ => 4.3}/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/index.mdx (100%) create mode 100644 product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/index.mdx rename product_docs/docs/pgpool/{ => 4.3}/01_installing_and_configuring_the_pgpool-II/x86_amd64/01_pgpool_rhel8_x86.mdx (100%) rename product_docs/docs/pgpool/{ => 4.3}/01_installing_and_configuring_the_pgpool-II/x86_amd64/02_pgpool_other_linux8_x86.mdx (100%) rename product_docs/docs/pgpool/{ => 4.3}/01_installing_and_configuring_the_pgpool-II/x86_amd64/03_pgpool_rhel7_x86.mdx (100%) rename product_docs/docs/pgpool/{ => 4.3}/01_installing_and_configuring_the_pgpool-II/x86_amd64/05_pgpool_sles15_x86.mdx (100%) rename product_docs/docs/pgpool/{ => 4.3}/01_installing_and_configuring_the_pgpool-II/x86_amd64/06_pgpool_sles12_x86.mdx (100%) rename product_docs/docs/pgpool/{ => 4.3}/01_installing_and_configuring_the_pgpool-II/x86_amd64/07_pgpool_ubuntu20_deb10_x86.mdx (100%) rename product_docs/docs/pgpool/{ => 4.3}/01_installing_and_configuring_the_pgpool-II/x86_amd64/08_pgpool_ubuntu18_deb9_x86.mdx (100%) rename product_docs/docs/pgpool/{ => 4.3}/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx (100%) create mode 100644 product_docs/docs/pgpool/4.3/pgpool_rel_notes/supported_platforms.mdx diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/index.mdx b/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/index.mdx deleted file mode 100644 index 721fd409062..00000000000 --- a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/index.mdx +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: "Installing EDB Pgpool-II" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/pgpool-ii/user-guides/pgpool-ii-guide/1.0/installing_and_configuring_the_pgpool-II.html" ---- - - - -!!! Note - EDB Pgpool-II runs as a service on Linux systems. EDB Pgpool-II isn't supported on Windows. - -This table lists the latest EDB Pgpool-II versions and their supported corresponding EDB Postgres Advanced Server (EPAS) versions. EDB Pgpool-II is supported on the same platforms as EDB Postgres Advanced Server. See [Product Compatibility](https://www.enterprisedb.com/platform-compatibility#epas) for details. - -| EDB Pgpool-II | EPAS 14 | EPAS 13 | EPAS 12 | EPAS 11 | EPAS 10 | EPAS 9.6 | -| ------ | ------- | ------- | ------- | ------- | ------- | -------- | -| 4.3 | Y | Y | Y | Y | Y | N | -| 4.2 | N | Y | Y | Y | Y | Y | -| 4.1 | N | Y | Y | Y | N | N | -| 4.0 | N | N | Y | Y | N | N | -| 3.7 | N | N | N | Y | Y | N | - - -The documented and supported functionality of each version of EDB Pgpool-II is the same. The information in this documentation applies to all supported versions of EDB Pgpool-II. - -See the following topics to install EDB Pgpool-II on specific hosts. - - -This documentation assumes that the user has some knowledge of installation and system administration procedures and has administrative privileges on the host. - -Before installing the repository configuration, you must have credentials that allow access to the EDB repository. For information about requesting credentials, visit the [EDB website](https://www.enterprisedb.com/user). - - - - - - - - - -## Installing EDB Pgpool-II using the Linux graphical installer - -Graphical installers for EDB Pgpool-II are available via StackBuilder Plus (on EDB Postgres Advanced Server hosts) or Stack Builder (on PostgreSQL hosts). - -!!! Note - EDB Pgpool-II does not support Windows systems. - -Perform the following steps to install EDB Pgpool-II by accessing StackBuilder Plus through your Linux start menu: - -1. Open StackBuilder Plus and select your EDB Postgres Advanced Server installation from the drop-down list. Click `Next` to continue to the application selection page. -2. Expand the `Add-ons, tools and utilities` node, and check the box next to the EDB Pgpool-II version you want to install and download the EDB Pgpool-II installer. -3. Click `Next` to continue. Provide the credentials and click `Next`. -4. The selected packages and the default download directory are displayed. Click `Next`. -5. Once you have downloaded the installation files, a confirmation message is displayed. Click `Next` to start the EDB Pgpool-II installation. -6. Select an installation language and click `OK`. -7. The EDB Pgpool-II installer welcomes you to the setup wizard. - -![The EDB Pgpool-II Welcome window](images/pp1.png) - -Fig. 1: The EDB Pgpool-II Welcome window - -8. Use the `Installation Directory` field to specify the directory where you would install the EDB Pgpool-II software (the default installation directory is `/opt/edb`). Then, click `Next` to continue. - -![The EDB Pgpool-II Installation Details Window](images/pp2.png) - -Fig. 2: The EDB Pgpool-II Installation Details Window - -9. Use the `Operating System User` field to specify the Linux operating system user's name that EDB Pgpool-II will change to after startup. Then, click `Next` to continue. - -![The EDB Pgpool-II Operating User window](images/pgpool3.png) - -Fig. 3: The EDB Pgpool-II Operating User window - -10. The `Ready to Install` window notifies you when the installer has all of the information needed to install EDB Pgpool-II on your system. Click `Next` to install EDB Pgpool-II. - -![The Ready to Install window](images/pgpool4.png) - -Fig. 4: The Ready to Install window - -11. Progress bars inform you as the installation progresses. - -![The installation progresses](images/pgpool5.png) - -Fig. 5: The installation progresses - -12. The installer notifies you when the setup wizard has completed the EDB Pgpool-II installation. Click `Finish` to exit the installer. - -![The installation is complete](images/pp20.png) - -Fig. 6: The installation is complete diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx similarity index 100% rename from product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx rename to product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx similarity index 100% rename from product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx rename to product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/11_pgpool_sles15_ppcle.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/11_pgpool_sles15_ppcle.mdx similarity index 100% rename from product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/11_pgpool_sles15_ppcle.mdx rename to product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/11_pgpool_sles15_ppcle.mdx diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/12_pgpool_sles12_ppcle.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/12_pgpool_sles12_ppcle.mdx similarity index 100% rename from product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/12_pgpool_sles12_ppcle.mdx rename to product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/12_pgpool_sles12_ppcle.mdx diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/index.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/index.mdx similarity index 100% rename from product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/index.mdx rename to product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/index.mdx diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/index.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/index.mdx new file mode 100644 index 00000000000..8800d628a36 --- /dev/null +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/index.mdx @@ -0,0 +1,41 @@ +--- +title: "Installing EDB Pgpool-II" +legacyRedirectsGenerated: + # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. + - "/edb-docs/d/pgpool-ii/user-guides/pgpool-ii-guide/1.0/installing_and_configuring_the_pgpool-II.html" +navigation: +- x86_amd64 +- ibm_power_ppc64le +--- + +To install Migration Toolkit, you must have credentials that allow access to the EnterpriseDB repository. To request credentials that allow you to access an EnterpriseDB repository, see the [EDB Repository Access instructions](https://www.enterprisedb.com/repository-access-request). + +!!! Note + EDB Pgpool-II runs as a service on Linux systems. EDB Pgpool-II isn't supported on Windows. + +The documented and supported functionality of each version of EDB Pgpool-II is the same. The information in this documentation applies to all supported versions of EDB Pgpool-II. + +This documentation assumes that the user has some knowledge of installation and system administration procedures and has administrative privileges on the host. + +For platform-specific install instructions, see: + +- Linux x86-64 (amd64): + - [RHEL 8/OL 8](x86_amd64/01_pgpool_rhel8_x86) + + - [Rocky Linux 8/AlmaLinux 8](x86_amd64/02_pgpool_other_linux8_x86) + - [RHEL 7/OL 7](x86_amd64/03_pgpool_rhel7_x86) + - [CentOS 7](x86_amd64/04_pgpool_centos7_x86) + - [SLES 15](x86_amd64/05_pgpool_sles15_x86) + - [SLES 12](x86_amd64/06_pgpool_sles12_x86) + - [Ubuntu 20.04/Debian 10](x86_amd64/07_pgpool_ubuntu20_deb10_x86) + - [Ubuntu 18.04/Debian 9](x86_amd64/08_pgpool_ubuntu18_deb9_x86) + +- Linux on IBM Power (ppc64le): + - [RHEL 8](ibm_power_ppc64le/09_pgpool_rhel8_ppcle) + + - [RHEL 7](ibm_power_ppc64le/10_pgpool_rhel7_ppcle) + - [SLES 15](ibm_power_ppc64le/11_pgpool_sles15_ppcle) + - [SLES 12](ibm_power_ppc64le/12_pgpool_sles12_ppcle) + + + diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/01_pgpool_rhel8_x86.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/01_pgpool_rhel8_x86.mdx similarity index 100% rename from product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/01_pgpool_rhel8_x86.mdx rename to product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/01_pgpool_rhel8_x86.mdx diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/02_pgpool_other_linux8_x86.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/02_pgpool_other_linux8_x86.mdx similarity index 100% rename from product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/02_pgpool_other_linux8_x86.mdx rename to product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/02_pgpool_other_linux8_x86.mdx diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/03_pgpool_rhel7_x86.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/03_pgpool_rhel7_x86.mdx similarity index 100% rename from product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/03_pgpool_rhel7_x86.mdx rename to product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/03_pgpool_rhel7_x86.mdx diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/05_pgpool_sles15_x86.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/05_pgpool_sles15_x86.mdx similarity index 100% rename from product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/05_pgpool_sles15_x86.mdx rename to product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/05_pgpool_sles15_x86.mdx diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/06_pgpool_sles12_x86.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/06_pgpool_sles12_x86.mdx similarity index 100% rename from product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/06_pgpool_sles12_x86.mdx rename to product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/06_pgpool_sles12_x86.mdx diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/07_pgpool_ubuntu20_deb10_x86.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/07_pgpool_ubuntu20_deb10_x86.mdx similarity index 100% rename from product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/07_pgpool_ubuntu20_deb10_x86.mdx rename to product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/07_pgpool_ubuntu20_deb10_x86.mdx diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/08_pgpool_ubuntu18_deb9_x86.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/08_pgpool_ubuntu18_deb9_x86.mdx similarity index 100% rename from product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/08_pgpool_ubuntu18_deb9_x86.mdx rename to product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/08_pgpool_ubuntu18_deb9_x86.mdx diff --git a/product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx similarity index 100% rename from product_docs/docs/pgpool/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx rename to product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx diff --git a/product_docs/docs/pgpool/4.3/pgpool_rel_notes/supported_platforms.mdx b/product_docs/docs/pgpool/4.3/pgpool_rel_notes/supported_platforms.mdx new file mode 100644 index 00000000000..38ca3629a84 --- /dev/null +++ b/product_docs/docs/pgpool/4.3/pgpool_rel_notes/supported_platforms.mdx @@ -0,0 +1,15 @@ +--- +title: "Supported platforms" +--- + +This table lists the latest EDB Pgpool-II versions and their supported corresponding EDB Postgres Advanced Server (EPAS) versions. EDB Pgpool-II is supported on the same platforms as EDB Postgres Advanced Server. See [Product Compatibility](https://www.enterprisedb.com/platform-compatibility#epas) for details. + +| EDB Pgpool-II | EPAS 14 | EPAS 13 | EPAS 12 | EPAS 11 | EPAS 10 | EPAS 9.6 | +| ------ | ------- | ------- | ------- | ------- | ------- | -------- | +| 4.3 | Y | Y | Y | Y | Y | N | +| 4.2 | N | Y | Y | Y | Y | Y | +| 4.1 | N | Y | Y | Y | N | N | +| 4.0 | N | N | Y | Y | N | N | +| 3.7 | N | N | N | Y | Y | N | + + From ee967e0041cd4e216bb3c33b55e8b600b5e35b76 Mon Sep 17 00:00:00 2001 From: David Wicinas <93669463+dwicinas@users.noreply.github.com> Date: Tue, 3 May 2022 10:54:53 -0400 Subject: [PATCH 21/32] assorted cleanup edits --- .../ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx | 4 ++-- .../ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx | 4 +--- .../ibm_power_ppc64le/index.mdx | 2 -- .../4.3/01_installing_and_configuring_the_pgpool-II/index.mdx | 4 +--- .../x86_amd64/03_pgpool_rhel7_x86.mdx | 2 +- .../x86_amd64/07_pgpool_ubuntu20_deb10_x86.mdx | 2 -- .../x86_amd64/index.mdx | 2 -- 7 files changed, 5 insertions(+), 15 deletions(-) diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx index 49c63643167..e03985e7e12 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx @@ -26,7 +26,7 @@ sudo su - dnf -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm ``` - This creates the /etc/yum.repos.d/edb.repo configuration file. + This creates the `/etc/yum.repos.d/edb.repo` configuration file. 1. Add your EDB credentials to the edb.repo file: @@ -44,7 +44,7 @@ sudo su - dnf makecache ``` -1. Enable the codeready-builder-for-rhel-8-\*-rpms repository since EPEL packages may depend on packages from it: +1. Enable the `codeready-builder-for-rhel-8-\*-rpms` repository because EPEL packages may depend on packages from it: ```shell ARCH=$( /bin/arch ) diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx index f23a1fbc96f..6882224d008 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx @@ -5,8 +5,6 @@ navTitle: "RHEL 7" Before creating the repository configuration file, you must have credentials that allow access to the EDB repository. For information about requesting credentials, visit the [EDB website](https://www.enterprisedb.com/user). -Perform the following steps to install EDB Pgpool-II on an RHEL/CentOS 7 PPC64LE Host: - 1. Install Advance Toolchain: ```text @@ -43,7 +41,7 @@ Perform the following steps to install EDB Pgpool-II on an RHEL/CentOS 7 PPC64LE yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm ``` -5. On RHEL 7, enable the `optional, extras`, and `HA` repositories to satisfy additional package dependencies: +5. Enable the `optional`, `extras`, and `HA` repositories to satisfy additional package dependencies: ```text subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extras-rpms" --enable "rhel-ha-for-rhel-*-server-rpms" diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/index.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/index.mdx index bf30863bbec..3931edb0792 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/index.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/index.mdx @@ -12,6 +12,4 @@ For operating system-specific install instructions, see: - [SLES 15](11_pgpool_sles15_ppcle) - [SLES 12](12_pgpool_sles12_ppcle) -After installing Migration Toolkit, you must install the appropriate source-specific drivers before performing a migration. See [Installing source-specific drivers](../../#installing_drivers) for more information. - diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/index.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/index.mdx index 8800d628a36..f136bfa7ba2 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/index.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/index.mdx @@ -8,13 +8,11 @@ navigation: - ibm_power_ppc64le --- -To install Migration Toolkit, you must have credentials that allow access to the EnterpriseDB repository. To request credentials that allow you to access an EnterpriseDB repository, see the [EDB Repository Access instructions](https://www.enterprisedb.com/repository-access-request). +To install EDB PgPool-II, you must have credentials that allow access to the EnterpriseDB repository. To request credentials that allow you to access an EnterpriseDB repository, see the [EDB Repository Access instructions](https://www.enterprisedb.com/repository-access-request). !!! Note EDB Pgpool-II runs as a service on Linux systems. EDB Pgpool-II isn't supported on Windows. -The documented and supported functionality of each version of EDB Pgpool-II is the same. The information in this documentation applies to all supported versions of EDB Pgpool-II. - This documentation assumes that the user has some knowledge of installation and system administration procedures and has administrative privileges on the host. For platform-specific install instructions, see: diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/03_pgpool_rhel7_x86.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/03_pgpool_rhel7_x86.mdx index 9461d01d6fa..f5e92f92248 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/03_pgpool_rhel7_x86.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/03_pgpool_rhel7_x86.mdx @@ -22,7 +22,7 @@ Perform the following steps to install EDB Pgpool-II: yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm ``` -4. Enable the `optional, extras`, and `HA` repositories to satisfy additional package dependencies: +4. Enable the `optional`, `extras`, and `HA` repositories to satisfy additional package dependencies: ```text subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extras-rpms" --enable "rhel-ha-for-rhel-*-server-rpms" ``` diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/07_pgpool_ubuntu20_deb10_x86.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/07_pgpool_ubuntu20_deb10_x86.mdx index 1370b930d81..1759e2c549c 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/07_pgpool_ubuntu20_deb10_x86.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/07_pgpool_ubuntu20_deb10_x86.mdx @@ -3,8 +3,6 @@ title: "Installing EDB PgPool-II on Ubuntu 20.04/Debian 10 x86" navTitle: "Ubuntu 20.04/Debian 10" --- -## Installing EDB Pgpool-II on a Debian/Ubuntu x86-64 host - To install EDB Pgpool-II on a Debian or Ubuntu host, you must have credentials that allow access to the EDB repository. To request credentials for the repository, visit the [EDB website](https://www.enterprisedb.com/user). Perform the following steps to install a Debian package using the EDB apt repository. diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx index 179f170ab55..e680f9a2413 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx @@ -13,5 +13,3 @@ For operating system-specific install instructions, see: - [SLES 12](06_pgpool_sles12_x86) - [Ubuntu 20.04/Debian 10](07_pgpool_ubuntu20_deb10_x86) - [Ubuntu 18.04/Debian 9](08_pgpool_ubuntu18_deb9_x86) - -After installing Migration Toolkit, you must install the appropriate source-specific drivers before performing a migration. See [Installing source-specific drivers](../../#installing_drivers) for more information. \ No newline at end of file From 5a2fb7e5c3b3a0e5981606f17fd79586836c4603 Mon Sep 17 00:00:00 2001 From: David Wicinas <93669463+dwicinas@users.noreply.github.com> Date: Tue, 3 May 2022 11:21:18 -0400 Subject: [PATCH 22/32] Trying to repair a legacy redirect --- .../x86_amd64/index.mdx | 3 +++ 1 file changed, 3 insertions(+) diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx index e680f9a2413..fcce3ba55d9 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx @@ -1,6 +1,9 @@ --- title: "Installing EDB PgPool-II on Linux x86 (amd64)" navTitle: "Intel x86 (amd64)" +legacyRedirectsGenerated: + # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. + - "/edb-docs/d/pgbouncer/user-guides/pgbouncer-guide/1.0/installing_pgbouncer_on_a_debian_or_ubuntu_host.html" --- For operating system-specific install instructions, see: From cafff72cccb17cdc03d850bea36f522f084b7155 Mon Sep 17 00:00:00 2001 From: David Wicinas <93669463+dwicinas@users.noreply.github.com> Date: Wed, 4 May 2022 08:48:01 -0400 Subject: [PATCH 23/32] moved position of supported platforms topic --- product_docs/docs/pgpool/4.3/index.mdx | 1 + .../pgpool/4.3/{pgpool_rel_notes => }/supported_platforms.mdx | 0 2 files changed, 1 insertion(+) rename product_docs/docs/pgpool/4.3/{pgpool_rel_notes => }/supported_platforms.mdx (100%) diff --git a/product_docs/docs/pgpool/4.3/index.mdx b/product_docs/docs/pgpool/4.3/index.mdx index e2a65e3feba..2b68af6d8bf 100644 --- a/product_docs/docs/pgpool/4.3/index.mdx +++ b/product_docs/docs/pgpool/4.3/index.mdx @@ -4,6 +4,7 @@ directoryDefaults: description: "EDB Pgpool-II documentation and release notes. PostgreSQL connection pooling tool." navigation: - pgpool_rel_notes + - supported_platforms legacyRedirectsGenerated: # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - "/edb-docs/d/pgpool-ii/user-guides/pgpool-ii-guide/1.0/index.html" diff --git a/product_docs/docs/pgpool/4.3/pgpool_rel_notes/supported_platforms.mdx b/product_docs/docs/pgpool/4.3/supported_platforms.mdx similarity index 100% rename from product_docs/docs/pgpool/4.3/pgpool_rel_notes/supported_platforms.mdx rename to product_docs/docs/pgpool/4.3/supported_platforms.mdx From bf30c9bd1811f0d9efdd3ef67071fbc914a7be79 Mon Sep 17 00:00:00 2001 From: David Wicinas <93669463+dwicinas@users.noreply.github.com> Date: Wed, 4 May 2022 12:11:56 -0400 Subject: [PATCH 24/32] setting up extension restructure --- .../docs/pgpool/4.3/02_extensions.mdx | 575 ------------------ .../10_pgpoolext_rhel7_ppcle.mdx | 77 +++ .../02_extensions/ibm_power_ppc64le/index.mdx | 13 + .../docs/pgpool/4.3/02_extensions/index.mdx | 206 +++++++ .../x86_amd64/01_pgpoolext_rhel8_x86.mdx | 37 ++ .../02_pgpoolext_other_linux8_x86.mdx | 35 ++ .../x86_amd64/03_pgpoolext_rhel7_x86.mdx | 41 ++ .../x86_amd64/04_pgpoolext_centos7_x86.mdx | 40 ++ .../x86_amd64/05_pgpoolext_sles15_x86.mdx | 55 ++ .../x86_amd64/06_pgpoolext_sles12_x86.mdx | 40 ++ .../07_pgpoolext_ubuntu20_deb10_x86.mdx | 55 ++ .../08_pgpoolext_ubuntu18_deb9_x86.mdx | 41 ++ .../4.3/02_extensions/x86_amd64/index.mdx | 17 + .../pgpool/4.3/02a_creating_extensions.mdx | 33 + 14 files changed, 690 insertions(+), 575 deletions(-) delete mode 100644 product_docs/docs/pgpool/4.3/02_extensions.mdx create mode 100644 product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/10_pgpoolext_rhel7_ppcle.mdx create mode 100644 product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/index.mdx create mode 100644 product_docs/docs/pgpool/4.3/02_extensions/index.mdx create mode 100644 product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/01_pgpoolext_rhel8_x86.mdx create mode 100644 product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/02_pgpoolext_other_linux8_x86.mdx create mode 100644 product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/03_pgpoolext_rhel7_x86.mdx create mode 100644 product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/04_pgpoolext_centos7_x86.mdx create mode 100644 product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/05_pgpoolext_sles15_x86.mdx create mode 100644 product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/06_pgpoolext_sles12_x86.mdx create mode 100644 product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/07_pgpoolext_ubuntu20_deb10_x86.mdx create mode 100644 product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/08_pgpoolext_ubuntu18_deb9_x86.mdx create mode 100644 product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/index.mdx create mode 100644 product_docs/docs/pgpool/4.3/02a_creating_extensions.mdx diff --git a/product_docs/docs/pgpool/4.3/02_extensions.mdx b/product_docs/docs/pgpool/4.3/02_extensions.mdx deleted file mode 100644 index 3500230e050..00000000000 --- a/product_docs/docs/pgpool/4.3/02_extensions.mdx +++ /dev/null @@ -1,575 +0,0 @@ ---- -title: "Installing and managing extensions" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/pgpool-ii/user-guides/pgpool-ii-guide/1.0/extensions.html" ---- - - - -Modules in the extensions directory are additional features to EDB Postgres Advanced Server that are generally not included in the core database. Once loaded in a database, they can function just like built-in features. They allow you to use simple `SELECT` commands to use PCP remotely. - -!!! Note - EDB Pgpool-II extensions are delivered only for supported combinations of EDB Postgres Advanced Server versions and operating systems. - -Before installing EDB Pgpool-II extensions, install the EDB Postgres Advanced Server on your host system. - -## Installing EDB Pgpool-II extensions - -To request credentials for the repository, visit [the EDB website](https://www.enterprisedb.com/user). - -### Installing EDB Pgpool-II extensions on a CentOS/Rocky Linux/AlmaLinux host - -Assume superuser privileges and perform the following steps to install EDB Pgpool-II extensions on a CentOS host: - -1. To install the repository configuration, assume superuser privileges, and invoke the platform-specific command: - - On CentOS 7: - - ```text - yum -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm - ``` - - On Rocky Linux 8 or AlmaLinux 8: - - ```text - dnf -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm - ``` - -2. Replace the `USERNAME:PASSWORD` variable with the username and password of a registered EDB user: - - ```text - sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo - ``` - -3. Before installing EDB Pgpool-II, execute the following command to install the Extra Packages for Enterprise Linux (EPEL): - - On CentOS 7: - - ```text - yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm - ``` - - On Rocky Linux 8 or AlmaLinux 8: - - ```text - dnf -y install epel-release - ``` - -4. For Rocky Linux 8 or AlmaLinux 8, enable the PowerTools repository to satisfy EPEL package dependencies: - - ```text - dnf config-manager --set-enabled PowerTools - ``` - -5. Use the platform-specific command to install EDB Pgpool-II extensions: - - On CentOS 7: - - ```text - yum -y install edb-as-pgpool-extensions - ``` - - For example, to install Pgpool43 extensions for EDB Postgres Advanced Server 14, execute the following command: - - ```text - yum -y install edb-as14-pgpool43-extensions - ``` - - On Rocky Linux 8 or AlmaLinux 8: - - ```text - dnf install edb-as-pgpool-extensions - ``` - -In the above command, `` is the EDB Postgres Advanced Server version, and `` is the EDB Pgpool-II extension version. The extensions will be available in the `/usr/edb/as/share/extension` directory. - - - -### Installing EDB Pgpool-II extensions on an RHEL host - -Before installing the repository configuration, you must have credentials that allow access to the EDB repository. For information about requesting credentials, visit the [EDB website](https://www.enterprisedb.com/user). - -Perform the following steps to install EDB Pgpool-II extensions on an RHEL host: - -1. To install the repository configuration, assume superuser privileges, and invoke the platform-specific command: - - On RHEL 7: - - ```text - yum -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm - ``` - - On RHEL 8: - - ```text - dnf -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm - ``` - -2. Replace the `USERNAME:PASSWORD` variable in the following command with the username and password of a registered EDB user: - - ```text - sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo - ``` - -3. Before installing EDB Pgpool-II, execute the following command to install the Extra Packages for Enterprise Linux (EPEL): - - On RHEL 7: - - ```text - yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm - ``` - - On RHEL 8: - - ```text - dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm - ``` - -4. Enable the repository: - - On RHEL 7, enable the `optional, extras`, and `HA` repositories to satisfy EPEL package dependencies: - - ```text - subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extras-rpms" --enable "rhel-ha-for-rhel-*-server-rpms" - ``` - - On RHEL 8, enable the `codeready-builder-for-rhel-8-*-rpms` repository to satisfy EPEL packages dependency: - - ```text - ARCH=$( /bin/arch ) - - subscription-manager repos --enable "codeready-builder-for-rhel-8-${ARCH}-rpms" - ``` - -5. Use the platform-specific command to install EDB Pgpool-II extensions: - - On RHEL 7: - - ```text - yum -y install edb-as-pgpool-extensions - ``` - - For example, to install Pgpool43 extensions for EDB Postgres Advanced Server 14, execute the following command: - - ```text - yum -y install edb-as13-pgpool43-extensions - ``` - - On RHEL 8: - - ```text - dnf install edb-as-pgpool-extensions - ``` - -In the above command, `` is the EDB Postgres Advanced Server version, and `` is the EDB Pgpool-II extension version. The extensions will be available in the `/usr/edb/as/share/extension` directory. - - - -### Installing EDB Pgpool-II extensions on an RHEL/CentOS 7 PPCLE host - -Before installing the repository configuration, you must have credentials that allow access to the EDB repository. For information about requesting credentials, visit the [EDB website](https://www.enterprisedb.com/user). - -Perform the following steps to install EDB Pgpool-II extensions on an RHEL/CentOS 7 PPC64LE Host: - -1. Install Advance Toolchain: - - ```text - rpm --import https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/redhat/RHEL7/gpg-pubkey-6976a827-5164221b - - cat > /etc/yum.repos.d/advance-toolchain.repo <:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo - ``` - -4. Before installing EDB Pgpool-II, execute the following command to install the Extra Packages for Enterprise Linux (EPEL): - - ```text - yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm - ``` - -5. On RHEL 7, enable the `optional, extras`, and `HA` repositories to satisfy EPEL package dependencies: - - ```text - subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extras-rpms" --enable "rhel-ha-for-rhel-*-server-rpms" - ``` - -6. Invoke the following command to install EDB Pgpool-II extensions: - - ```text - yum -y install edb-as13-pgpool-extensions - ``` - - Where <xx> is the EDB Pgpool-II version you want to install. - - - -### Installing EDB Pgpool-II extensions on a Debian/Ubuntu host - -To install EDB Pgpool-II extensions on a Debian or Ubuntu host, you must have credentials that allow access to the EDB repository. To request credentials for the repository, visit the [EDB website](https://www.enterprisedb.com/user). - -The following steps walk you through using the EDB apt repository to install a DEB package. - -1. Assume superuser privileges: - - ```text - sudo su – - ``` - -2. Configure the EDB repository. Substitute your EDB credentials for the `username` and `password` placeholders in the following command: - - On Debian 9 and Ubuntu 18: - - ```text - sh -c 'echo "deb https://username:password@apt.enterprisedb.com/$(lsb_release -cs)-edb/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/edb-$(lsb_release -cs).list' - ``` - - On Debian 10: - - a. Set up the EDB repository: - - ```text - sh -c 'echo "deb [arch=amd64] https://apt.enterprisedb.com/$(lsb_release -cs)-edb/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/edb-$(lsb_release -cs).list' - ``` - - b. Substitute your EDB credentials for the `username` and `password` placeholders in the following command: - - ```text - sh -c 'echo "machine apt.enterprisedb.com login password " > /etc/apt/auth.conf.d/edb.conf' - ``` - -3. Add support to your system for secure APT repositories: - - ```text - apt-get install apt-transport-https - ``` - -4. Add the EDB signing key: - - ```text - wget -q -O - https://apt.enterprisedb.com/edb-deb.gpg.key | apt-key add - - ``` - -5. Update the repository metadata: - - ```text - apt-get update - ``` - -6. Install the Debian package: - - ```text - apt-get install -y edb-as-pgpool-extensions - ``` - - In the above command, `` is the EDB Postgres Advanced Server version, and `` is the EDB Pgpool-II extension version you want to install. - - - -### Installing EDB Pgpool-II extensions on an SLES 12 x86_64 host - -You can use the Zypper package manager to install the EDB Pgpool-II extension on an SLES 12 host. Zypper will attempt to satisfy package dependencies as it installs a package but requires access to specific repositories that are not hosted at EDB. - -1. Assume superuser privileges. - - ```text - sudo su - - ``` - -2. Use the following command to add the EDB repository to your SLES host: - - ```text - zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo - ``` - -4. Install `SUSEConnect` to register the host with SUSE to allow access to SUSE repositories: - - ```text - zypper install SUSEConnect - ``` - -5. Register the host with SUSE to allow access to SUSE repositories and replace `'REGISTRATION_CODE'` and `'EMAIL'` with your SUSE registration information: - - ```text - SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' - SUSEConnect -p PackageHub/12.5/x86_64 - SUSEConnect -p sle-sdk/12.5/x86_64 - ``` - -6. Refresh the metadata: - - ```text - zypper refresh - ``` - -7. Then, use the Zypper utility to install EDB Pgpool-II extension: - - ```text - zypper -n install edb-as-pgpool-extensions - ``` - - Where <xx> is the EDB Postgres Advanced Server version and <yy> is the EDB Pgpool-II version you wish to install. - -### Installing EDB Pgpool-II extensions on an SLES 15 x86-64 host - -!!! note - Supported on EDB Pgpool-II 4.3 and later. - -There are two steps to completing an installation: - -- Setting up the repository -- Installing the package - -For each step, you must be logged in as superuser. - -```shell -# To log in as a superuser: -sudo su - -``` - -Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). - -#### Setting up the repository - -Setting up the repository is a one time task. If you have already set up your repository, you do not need to perform these steps. - -```shell -# Install the repository configuration and enter your EDB repository -# credentials when prompted -zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo - -# Install SUSEConnect to register the host with SUSE, allowing access to -# SUSE repositories -zypper install SUSEConnect - -# Register the host with SUSE, allowing access to SUSE repositories -# Replace 'REGISTRATION_CODE' and 'EMAIL' with your SUSE registration -# information -SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' - -# Activate the required SUSE module -SUSEConnect -p PackageHub/15.3/x86_64 - -# Refresh the metadata -zypper refresh -``` - -#### Installing the package - -```shell -zypper -n install edb-as-pgpool-extensions -``` - -Where <xx> is the EDB Postgres Advanced Server version and <yy> is the EDB Pgpool-II version you wish to install. - - -### Installing EDB Pgpool-II extensions on an SLES 12 ppc64le host - -!!! note - Supported on EDB Pgpool-II Extension 4.3 and later. - -There are two steps to completing an installation: - -- Setting up the repository -- Installing the package - - -For each step, you must be logged in as superuser. - -```shell -# To log in as a superuser: -sudo su - -``` - -Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). - -#### Setting up the repository - -Setting up the repository is a one time task. If you have already set up your repository, you do not need to perform these steps. - -```shell -# Install the repository configuration and enter your EDB repository -# credentials when prompted -zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo - -# Install SUSEConnect to register the host with SUSE, allowing access to -# SUSE repositories -zypper install SUSEConnect - -# Register the host with SUSE, allowing access to SUSE repositories -# Replace 'REGISTRATION_CODE' and 'EMAIL' with your SUSE registration -# information -SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' - -# Activate the required SUSE modules -SUSEConnect -p PackageHub/12.5/ppc64le -SUSEConnect -p sle-sdk/12.5/ppc64le - -# Refresh the metadata -zypper refresh -``` - -#### Installing the package - -```shell -zypper -n install edb-as-pgpool-extensions -``` - -Where <xx> is the EDB Postgres Advanced Server version and <yy> is the EDB Pgpool-II version you wish to install. - -### Installing EDB Pgpool-II extensions on an SLES 15 ppc64le host - -!!! note - Supported on EDB Pgpool-II 4.3 and later. - -There are two steps to completing an installation: - -- Setting up the repository -- Installing the package - -For each step, you must be logged in as superuser. - -```shell -# To log in as a superuser: -sudo su - -``` - -Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). - -#### Setting up the repository - -Setting up the repository is a one time task. If you have already set up your repository, you do not need to perform these steps. - -```shell -# Install the repository configuration and enter your EDB repository -# credentials when prompted -zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo - -# Install SUSEConnect to register the host with SUSE, allowing access to -# SUSE repositories -zypper install SUSEConnect - -# Register the host with SUSE, allowing access to SUSE repositories -# Replace 'REGISTRATION_CODE' and 'EMAIL' with your SUSE registration -# information -SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' - -# Activate the required SUSE module -SUSEConnect -p PackageHub/15.3/ppc64le - -# Refresh the metadata -zypper refresh -``` - -#### Installing the package - -```shell -zypper -n install edb-as-pgpool-extensions -``` - -Where <xx> is the EDB Postgres Advanced Server version and <yy> is the EDB Pgpool-II version you wish to install. - - - -### Installing EDB Pgpool-II extensions using the Linux graphical installer - - Graphical installers for EDB Pgpool-II extensions are available via StackBuilder Plus (for EDB Postgres Advanced Server hosts) or Stack Builder (on PostgreSQL hosts). You can access StackBuilder Plus through your Linux start menu. It is not supported on Windows. - - Perform the following steps to install EDB Pgpool-II extensions: - -1. Open StackBuilder Plus and select your EDB Postgres Advanced Server installation from the drop-down list on the `Welcome` window. Click `Next` to continue to the application selection page. - -2. Expand the `Add-ons, tools and utilities` node, and check the box next to the EDB Pgpool-II extension to select and download the installer. Click `Next` to continue. - -3. Provide the credentials and click `Next`. - -4. The selected packages and the default download directory where the package will be installed are displayed; change the download directory location if required. Click `Next`. - -5. Once you have downloaded the installation files, a confirmation message is displayed. Click `Next` to start the installation. - -6. Select an installation language and click `OK`. - -7. The EDB Pgpool-II extensions installer welcomes you to the setup wizard. - - ![The EDB Pgpool-II Extensions Welcome window](images/pg1.png) - - Fig. 1: The EDB Pgpool-II Extensions Welcome window - -8. Use the `Installation Directory` field to specify the directory in which you wish to install the EDB Pgpool-II extensions software (the default installation directory is `/opt/edb/as`) Then, click `Next` to continue. - - ![The EDB Pgpool-II Extensions Installation Details Window](images/pg2.png) - - Fig. 2: The EDB Pgpool-II Extensions Installation Details Window - -9. The `Ready to Install` window notifies you when the installer has all of the information needed to install EDB Pgpool-II extensions on your system. Click `Next` to install EDB Pgpool-II extensions. - - ![The Ready to Install window](images/pg3.png) - - Fig. 3: The Ready to Install window - -10. Progress bars inform you as the installation progresses. - - ![The installation progresses](images/pg4.png) - - Fig. 4: The installation progresses - -11. The installer notifies you when the setup wizard has completed the EDB Pgpool-II installation. Click `Finish` to exit the installer. - - ![The installation is complete](images/pg5.png) - - Fig. 5: The installation is complete - -12. The extensions will be available in the `/opt/edb/as/share/extension/pgpool*` directory. - -## Creating EDB Pgpool-II extensions - -You must install and create the extensions in each database where you will be using EDB Pgpool-II functionality. To ensure all extensions are available for future databases, you can add the extension to the `template1` database; any extensions installed in the `template1` database will be created in each of the databases that uses `template1` as a template during creation. - -**Pgpool_adm Extension** - - - -`Pgpool_adm` is a set of extensions that allows SQL access to PCP commands. To view information about PCP commands, see . - -After installing the `Pgpool_adm` extension, use the psql client application to connect to the database, and execute the following SQL command: - -```text -CREATE EXTENSION pgpool_adm; -``` - -To view more information about `Pgpool_adm`, see . - -**Pgpool_recovery Extension** - - - -The `Pgpool_recovery` extension is required for online recovery and future fail-back mechanisms. - -After installing the `Pgpool_recovery` extension, use psql to connect to the database, and execute the following SQL command to create a `Pgpool_recovery` extension: - -```text -CREATE EXTENSION pgpool_recovery; -``` - -For more information about using the `CREATE EXTENSION` command, see the [PostgreSQL core documentation](https://www.postgresql.org/docs/current/static/sql-createextension.html). diff --git a/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/10_pgpoolext_rhel7_ppcle.mdx b/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/10_pgpoolext_rhel7_ppcle.mdx new file mode 100644 index 00000000000..12708222cbc --- /dev/null +++ b/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/10_pgpoolext_rhel7_ppcle.mdx @@ -0,0 +1,77 @@ +--- +title: "Installing PgPool extensions on RHEL 7 IBM Power (ppc64le)" +navTitle: "RHEL 7" +--- + +You can use an RPM package to install Migration Toolkit on a RHEL ppc64le host. + +Before installing Migration toolkit: + +1. Create the Advance Toolchain repository configuration file; assume superuser privileges and invoke the following command: + + ```text + rpm --import https://public.dhe.ibm.com/software/server/POWER/ + Linux/toolchain/at/redhat/RHEL7/gpg-pubkey-6976a827-5164221b + ``` + +2. After creating the `advance-toolchain.repo` file, use your choice of editor to ensure that the value of the `enabled` parameter is `1`, and replace the `username` and `password` placeholders in the `baseurl` specification with the name and password of a registered EnterpriseDB user. + + ```text + [advance-toolchain] + name=Advance Toolchain IBM FTP + baseurl=https://public.dhe.ibm.com/software/server/POWER/ + Linux/toolchain/at/redhat/RHEL7 + failovermethod=priority + enabled=1 + gpgcheck=1 + gpgkey=ftp://public.dhe.ibm.com/software/server/POWER/Linux/ + toolchain/at/redhat/RHELX/gpg-pubkey-6976a827-5164221b + ``` + +The following steps provide detailed information about accessing the EnterpriseDB repository and installing Migration Toolkit. + +## Creating a repository configuration file + +1. To create the EDB repository configuration file, assume superuser privileges and invoke the following command: + + ```text + yum -y install https://yum.enterprisedb.com/edb-repo-rpms/ + edb-repo-latest.noarch.rpm + ``` + + The repository configuration file is named `edb.repo`. The file resides in `/etc/yum.repos.d`. + +2. After creating the `edb.repo` file, use your choice of editor to ensure that the value of the `enabled` parameter is `1`, and replace the `username` and `password` placeholders in the `baseurl` specification with the name and password of a registered EnterpriseDB user. + + ```text + [edb] + name=EnterpriseDB RPMs $releasever - $basearch + baseurl=https://:@yum.enterprisedb.com/edb/ + redhat/rhel-$releasever-$basearch + enabled=1 + gpgcheck=1 + gpgkey=file:///etc/pki/rpm-gpg/ENTERPRISEDB-GPG-KEY + ``` + +3. After saving your changes to the configuration file, install the EPEL package: + + ```text + yum -y install https://dl.fedoraproject.org/pub/epel/ + epel-release-latest-7.noarch.rpm + ``` + +4. Enable an additional repository to resolve dependencies: + + ```text + subscription-manager repos --enable "rhel-*-optional-rpms" + --enable "rhel-*-extras-rpms" --enable "rhel-ha-for-rhel-* + -server-rpms" + ``` + +## Installing the package +To install Migration Toolkit, run the following command. + +```text +yum -y install edb-migrationtoolkit +``` + diff --git a/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/index.mdx b/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/index.mdx new file mode 100644 index 00000000000..9069bb20482 --- /dev/null +++ b/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/index.mdx @@ -0,0 +1,13 @@ +--- +title: "Installing PgPool extensions on IBM Power (ppc64le)" +navTitle: "IBM Power (ppc64le)" +--- + +For operating system-specific install instructions, see: + + + - [RHEL 8](09_mtk55_rhel8_ppcle) + + - [RHEL 7](10_mtk55_rhel7_ppcle) + - [SLES 15](11_mtk55_sles15_ppcle) + - [SLES 12](12_mtk55_sles12_ppcle) diff --git a/product_docs/docs/pgpool/4.3/02_extensions/index.mdx b/product_docs/docs/pgpool/4.3/02_extensions/index.mdx new file mode 100644 index 00000000000..e19077face8 --- /dev/null +++ b/product_docs/docs/pgpool/4.3/02_extensions/index.mdx @@ -0,0 +1,206 @@ +--- +title: "Installing PgPool-II extensions" + +legacyRedirectsGenerated: + # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. + - "/edb-docs/d/pgpool-ii/user-guides/pgpool-ii-guide/1.0/extensions.html" +--- + + + +Modules in the extensions directory are additional features to EDB Postgres Advanced Server that are generally not included in the core database. Once loaded in a database, they can function just like built-in features. They allow you to use simple `SELECT` commands to use PCP remotely. + +!!! Note + EDB Pgpool-II extensions are delivered only for supported combinations of EDB Postgres Advanced Server versions and operating systems. + +Before installing EDB Pgpool-II extensions, install the EDB Postgres Advanced Server on your host system. + +### Installing EDB Pgpool-II extensions on an SLES 12 ppc64le host + +!!! note + Supported on EDB Pgpool-II Extension 4.3 and later. + +There are two steps to completing an installation: + +- Setting up the repository +- Installing the package + + +For each step, you must be logged in as superuser. + +```shell +# To log in as a superuser: +sudo su - +``` + +Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). + +#### Setting up the repository + +Setting up the repository is a one time task. If you have already set up your repository, you do not need to perform these steps. + +```shell +# Install the repository configuration and enter your EDB repository +# credentials when prompted +zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo + +# Install SUSEConnect to register the host with SUSE, allowing access to +# SUSE repositories +zypper install SUSEConnect + +# Register the host with SUSE, allowing access to SUSE repositories +# Replace 'REGISTRATION_CODE' and 'EMAIL' with your SUSE registration +# information +SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' + +# Activate the required SUSE modules +SUSEConnect -p PackageHub/12.5/ppc64le +SUSEConnect -p sle-sdk/12.5/ppc64le + +# Refresh the metadata +zypper refresh +``` + +#### Installing the package + +```shell +zypper -n install edb-as-pgpool-extensions +``` + +Where <xx> is the EDB Postgres Advanced Server version and <yy> is the EDB Pgpool-II version you wish to install. + +### Installing EDB Pgpool-II extensions on an SLES 15 ppc64le host + +!!! note + Supported on EDB Pgpool-II 4.3 and later. + +There are two steps to completing an installation: + +- Setting up the repository +- Installing the package + +For each step, you must be logged in as superuser. + +```shell +# To log in as a superuser: +sudo su - +``` + +Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). + +#### Setting up the repository + +Setting up the repository is a one time task. If you have already set up your repository, you do not need to perform these steps. + +```shell +# Install the repository configuration and enter your EDB repository +# credentials when prompted +zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo + +# Install SUSEConnect to register the host with SUSE, allowing access to +# SUSE repositories +zypper install SUSEConnect + +# Register the host with SUSE, allowing access to SUSE repositories +# Replace 'REGISTRATION_CODE' and 'EMAIL' with your SUSE registration +# information +SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' + +# Activate the required SUSE module +SUSEConnect -p PackageHub/15.3/ppc64le + +# Refresh the metadata +zypper refresh +``` + +#### Installing the package + +```shell +zypper -n install edb-as-pgpool-extensions +``` + +Where <xx> is the EDB Postgres Advanced Server version and <yy> is the EDB Pgpool-II version you wish to install. + + + +### Installing EDB Pgpool-II extensions using the Linux graphical installer + + Graphical installers for EDB Pgpool-II extensions are available via StackBuilder Plus (for EDB Postgres Advanced Server hosts) or Stack Builder (on PostgreSQL hosts). You can access StackBuilder Plus through your Linux start menu. It is not supported on Windows. + + Perform the following steps to install EDB Pgpool-II extensions: + +1. Open StackBuilder Plus and select your EDB Postgres Advanced Server installation from the drop-down list on the `Welcome` window. Click `Next` to continue to the application selection page. + +2. Expand the `Add-ons, tools and utilities` node, and check the box next to the EDB Pgpool-II extension to select and download the installer. Click `Next` to continue. + +3. Provide the credentials and click `Next`. + +4. The selected packages and the default download directory where the package will be installed are displayed; change the download directory location if required. Click `Next`. + +5. Once you have downloaded the installation files, a confirmation message is displayed. Click `Next` to start the installation. + +6. Select an installation language and click `OK`. + +7. The EDB Pgpool-II extensions installer welcomes you to the setup wizard. + + ![The EDB Pgpool-II Extensions Welcome window](images/pg1.png) + + Fig. 1: The EDB Pgpool-II Extensions Welcome window + +8. Use the `Installation Directory` field to specify the directory in which you wish to install the EDB Pgpool-II extensions software (the default installation directory is `/opt/edb/as`) Then, click `Next` to continue. + + ![The EDB Pgpool-II Extensions Installation Details Window](images/pg2.png) + + Fig. 2: The EDB Pgpool-II Extensions Installation Details Window + +9. The `Ready to Install` window notifies you when the installer has all of the information needed to install EDB Pgpool-II extensions on your system. Click `Next` to install EDB Pgpool-II extensions. + + ![The Ready to Install window](images/pg3.png) + + Fig. 3: The Ready to Install window + +10. Progress bars inform you as the installation progresses. + + ![The installation progresses](images/pg4.png) + + Fig. 4: The installation progresses + +11. The installer notifies you when the setup wizard has completed the EDB Pgpool-II installation. Click `Finish` to exit the installer. + + ![The installation is complete](images/pg5.png) + + Fig. 5: The installation is complete + +12. The extensions will be available in the `/opt/edb/as/share/extension/pgpool*` directory. + +## Creating EDB Pgpool-II extensions + +You must install and create the extensions in each database where you will be using EDB Pgpool-II functionality. To ensure all extensions are available for future databases, you can add the extension to the `template1` database; any extensions installed in the `template1` database will be created in each of the databases that uses `template1` as a template during creation. + +**Pgpool_adm Extension** + + + +`Pgpool_adm` is a set of extensions that allows SQL access to PCP commands. To view information about PCP commands, see . + +After installing the `Pgpool_adm` extension, use the psql client application to connect to the database, and execute the following SQL command: + +```text +CREATE EXTENSION pgpool_adm; +``` + +To view more information about `Pgpool_adm`, see . + +**Pgpool_recovery Extension** + + + +The `Pgpool_recovery` extension is required for online recovery and future fail-back mechanisms. + +After installing the `Pgpool_recovery` extension, use psql to connect to the database, and execute the following SQL command to create a `Pgpool_recovery` extension: + +```text +CREATE EXTENSION pgpool_recovery; +``` + +For more information about using the `CREATE EXTENSION` command, see the [PostgreSQL core documentation](https://www.postgresql.org/docs/current/static/sql-createextension.html). diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/01_pgpoolext_rhel8_x86.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/01_pgpoolext_rhel8_x86.mdx new file mode 100644 index 00000000000..a462699a6ff --- /dev/null +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/01_pgpoolext_rhel8_x86.mdx @@ -0,0 +1,37 @@ +--- +title: "Installing PgPool extensions on RHEL 8/OL 8 x86" +navTitle: "RHEL 8/OL 8" +--- + +Before installing the repository configuration, you must have credentials that allow access to the EDB repository. For information about requesting credentials, visit the [EDB website](https://www.enterprisedb.com/user). + +Perform the following steps to install EDB Pgpool-II extensions on an RHEL host: + +1. To install the repository configuration, assume superuser privileges, and invoke the following command: + ```text + dnf -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm + ``` + +2. Replace the `USERNAME:PASSWORD` variable in the following command with the username and password of a registered EDB user: + ```text + sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo + ``` + +3. Before installing EDB Pgpool-II, execute the following command to install the Extra Packages for Enterprise Linux (EPEL): + ```text + dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm + ``` + +4. Enable the `codeready-builder-for-rhel-8-*-rpms` repository to satisfy EPEL packages dependency: + ```text + ARCH=$( /bin/arch ) + + subscription-manager repos --enable "codeready-builder-for-rhel-8-${ARCH}-rpms" + ``` + +5. Install EDB Pgpool-II extensions: + ```text + dnf install edb-as-pgpool-extensions + ``` + +In the above command, `` is the EDB Postgres Advanced Server version, and `` is the EDB Pgpool-II extension version. The extensions will be available in the `/usr/edb/as/share/extension` directory. diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/02_pgpoolext_other_linux8_x86.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/02_pgpoolext_other_linux8_x86.mdx new file mode 100644 index 00000000000..7718594866e --- /dev/null +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/02_pgpoolext_other_linux8_x86.mdx @@ -0,0 +1,35 @@ +--- +title: "Installing PgPool extensions on Rocky Linux 8/AlmaLinux 8 x86" +navTitle: "Rocky Linux 8/AlmaLinux 8" +--- + +Assume superuser privileges and perform the following steps to install EDB Pgpool-II extensions on a CentOS host: + +1. To install the repository configuration, assume superuser privileges, and invoke the following command: + ```text + dnf -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm + ``` + +2. Replace the `USERNAME:PASSWORD` variable with the username and password of a registered EDB user: + ```text + sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo + ``` + +3. Before installing EDB Pgpool-II, execute the following command to install the Extra Packages for Enterprise Linux (EPEL): + ```text + dnf -y install epel-release + ``` + +4. Enable the PowerTools repository to satisfy EPEL package dependencies: + ```text + dnf config-manager --set-enabled PowerTools + ``` + +5. Install EDB Pgpool-II extensions: + ```text + dnf install edb-as-pgpool-extensions + ``` + + In the above command, `` is the EDB Postgres Advanced Server version, and `` is the EDB Pgpool-II extension version. + + The extensions will be available in the `/usr/edb/as/share/extension` directory. diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/03_pgpoolext_rhel7_x86.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/03_pgpoolext_rhel7_x86.mdx new file mode 100644 index 00000000000..b42ef03b7ee --- /dev/null +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/03_pgpoolext_rhel7_x86.mdx @@ -0,0 +1,41 @@ +--- +title: "Installing PgPool extensions on RHEL 7/OL 7 x86" +navTitle: "RHEL 7/OL 7" +--- + +Before installing the repository configuration, you must have credentials that allow access to the EDB repository. For information about requesting credentials, visit the [EDB website](https://www.enterprisedb.com/user). + +Perform the following steps to install EDB Pgpool-II extensions on an RHEL host: + +1. To install the repository configuration, assume superuser privileges, and invoke the platform-specific command: + ```text + yum -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm + ``` + +2. Replace the `USERNAME:PASSWORD` variable in the following command with the username and password of a registered EDB user: + ```text + sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo + ``` + +3. Before installing EDB Pgpool-II, execute the following command to install the Extra Packages for Enterprise Linux (EPEL): + ```text + yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm + ``` + +4. Enable the `optional`, `extras`, and `HA` repositories to satisfy EPEL package dependencies: + ```text + subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extras-rpms" --enable "rhel-ha-for-rhel-*-server-rpms" + ``` + +5. Install EDB Pgpool-II extensions: + ```text + yum -y install edb-as-pgpool-extensions + ``` + + For example, to install Pgpool43 extensions for EDB Postgres Advanced Server 14, execute the following command: + + ```text + yum -y install edb-as13-pgpool43-extensions + ``` + +In the above command, `` is the EDB Postgres Advanced Server version, and `` is the EDB Pgpool-II extension version. The extensions will be available in the `/usr/edb/as/share/extension` directory. diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/04_pgpoolext_centos7_x86.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/04_pgpoolext_centos7_x86.mdx new file mode 100644 index 00000000000..117e90448b2 --- /dev/null +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/04_pgpoolext_centos7_x86.mdx @@ -0,0 +1,40 @@ +--- +title: "Installing PgPool extensions on CentOS 7 x86" +navTitle: "CentOS 7" +--- + +Assume superuser privileges and perform the following steps to install EDB Pgpool-II extensions on a CentOS host: + +1. To install the repository configuration, assume superuser privileges, and invoke the following command: + ```text + yum -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm + ``` + +2. Replace the `USERNAME:PASSWORD` variable with the username and password of a registered EDB user: + + ```text + sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo + ``` + +3. Before installing EDB Pgpool-II, execute the following command to install the Extra Packages for Enterprise Linux (EPEL): + ```text + yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm + ``` + +5. Install EDB Pgpool-II extensions: + ```text + yum -y install edb-as-pgpool-extensions + ``` + + + ```text + yum -y install edb-as14-pgpool43-extensions + ``` + +In the above command, `` is the EDB Postgres Advanced Server version, and `` is the EDB Pgpool-II extension version. For example, to install Pgpool43 extensions for EDB Postgres Advanced Server 14, execute the following command: + + ```text + yum -y install edb-as14-pgpool43-extensions + ``` + +The extensions will be available in the `/usr/edb/as/share/extension` directory. diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/05_pgpoolext_sles15_x86.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/05_pgpoolext_sles15_x86.mdx new file mode 100644 index 00000000000..8a2b12db3b9 --- /dev/null +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/05_pgpoolext_sles15_x86.mdx @@ -0,0 +1,55 @@ +--- +title: "Installing PgPool extensions on SLES 15 x86" +navTitle: "SLES 15" +--- + +!!! note + Supported on EDB Pgpool-II 4.3 and later. + +There are two steps to completing an installation: + +- Setting up the repository +- Installing the package + +For each step, you must be logged in as superuser. + +```shell +# To log in as a superuser: +sudo su - +``` + +Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). + +## Setting up the repository + +Setting up the repository is a one time task. If you have already set up your repository, you do not need to perform these steps. + +```shell +# Install the repository configuration and enter your EDB repository +# credentials when prompted +zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo + +# Install SUSEConnect to register the host with SUSE, allowing access to +# SUSE repositories +zypper install SUSEConnect + +# Register the host with SUSE, allowing access to SUSE repositories +# Replace 'REGISTRATION_CODE' and 'EMAIL' with your SUSE registration +# information +SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' + +# Activate the required SUSE module +SUSEConnect -p PackageHub/15.3/x86_64 + +# Refresh the metadata +zypper refresh +``` + +## Installing the package + +```shell +zypper -n install edb-as-pgpool-extensions +``` + +Where <xx> is the EDB Postgres Advanced Server version and <yy> is the EDB Pgpool-II version you wish to install. + diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/06_pgpoolext_sles12_x86.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/06_pgpoolext_sles12_x86.mdx new file mode 100644 index 00000000000..5e5c349e2f7 --- /dev/null +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/06_pgpoolext_sles12_x86.mdx @@ -0,0 +1,40 @@ +--- +title: "Installing PgPool extensions on SLES 12 x86" +navTitle: "SLES 12" +--- + +You can use the Zypper package manager to install the EDB Pgpool-II extension on an SLES 12 host. Zypper will attempt to satisfy package dependencies as it installs a package but requires access to specific repositories that are not hosted at EDB. + +1. Assume superuser privileges. + ```text + sudo su - + ``` + +2. Use the following command to add the EDB repository to your SLES host: + ```text + zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo + ``` + +4. Install `SUSEConnect` to register the host with SUSE to allow access to SUSE repositories: + ```text + zypper install SUSEConnect + ``` + +5. Register the host with SUSE to allow access to SUSE repositories and replace `'REGISTRATION_CODE'` and `'EMAIL'` with your SUSE registration information: + ```text + SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' + SUSEConnect -p PackageHub/12.5/x86_64 + SUSEConnect -p sle-sdk/12.5/x86_64 + ``` + +6. Refresh the metadata: + ```text + zypper refresh + ``` + +7. Use the Zypper utility to install EDB Pgpool-II extension: + ```text + zypper -n install edb-as-pgpool-extensions + ``` + + Where <xx> is the EDB Postgres Advanced Server version and <yy> is the EDB Pgpool-II version you wish to install. diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/07_pgpoolext_ubuntu20_deb10_x86.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/07_pgpoolext_ubuntu20_deb10_x86.mdx new file mode 100644 index 00000000000..e994ea6b651 --- /dev/null +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/07_pgpoolext_ubuntu20_deb10_x86.mdx @@ -0,0 +1,55 @@ +--- +title: "Installing PgPool extensions on Debian 10 x86" +navTitle: "Debian 10" +--- + + +To install EDB Pgpool-II extensions on a Debian or Ubuntu host, you must have credentials that allow access to the EDB repository. To request credentials for the repository, visit the [EDB website](https://www.enterprisedb.com/user). + +The following steps walk you through using the EDB apt repository to install a DEB package. + +1. Assume superuser privileges: + + ```text + sudo su – + ``` + +2. Configure the EDB repository. Substitute your EDB credentials for the `username` and `password` placeholders in the following command: + + a. Set up the EDB repository: + + ```text + sh -c 'echo "deb [arch=amd64] https://apt.enterprisedb.com/$(lsb_release -cs)-edb/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/edb-$(lsb_release -cs).list' + ``` + + b. Substitute your EDB credentials for the `username` and `password` placeholders in the following command: + + ```text + sh -c 'echo "machine apt.enterprisedb.com login password " > /etc/apt/auth.conf.d/edb.conf' + ``` + +3. Add support to your system for secure APT repositories: + + ```text + apt-get install apt-transport-https + ``` + +4. Add the EDB signing key: + + ```text + wget -q -O - https://apt.enterprisedb.com/edb-deb.gpg.key | apt-key add - + ``` + +5. Update the repository metadata: + + ```text + apt-get update + ``` + +6. Install the package: + + ```text + apt-get install -y edb-as-pgpool-extensions + ``` + + In the above command, `` is the EDB Postgres Advanced Server version, and `` is the EDB Pgpool-II extension version you want to install. diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/08_pgpoolext_ubuntu18_deb9_x86.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/08_pgpoolext_ubuntu18_deb9_x86.mdx new file mode 100644 index 00000000000..c01255e36e1 --- /dev/null +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/08_pgpoolext_ubuntu18_deb9_x86.mdx @@ -0,0 +1,41 @@ +--- +title: "Installing PgPool extensions on Ubuntu 18.04/Debian 9 x86" +navTitle: "Ubuntu 18.04/Debian 9" +--- + +To install EDB Pgpool-II extensions on a Debian or Ubuntu host, you must have credentials that allow access to the EDB repository. To request credentials for the repository, visit the [EDB website](https://www.enterprisedb.com/user). + +The following steps walk you through using the EDB apt repository to install a DEB package. + +1. Assume superuser privileges: + + ```text + sudo su – + ``` + +2. Configure the EDB repository. Substitute your EDB credentials for the `username` and `password` placeholders in the following command: + ```text + sh -c 'echo "deb https://username:password@apt.enterprisedb.com/$(lsb_release -cs)-edb/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/edb-$(lsb_release -cs).list' + ``` + +3. Add support to your system for secure APT repositories: + ```text + apt-get install apt-transport-https + ``` + +4. Add the EDB signing key: + ```text + wget -q -O - https://apt.enterprisedb.com/edb-deb.gpg.key | apt-key add - + ``` + +5. Update the repository metadata: + ```text + apt-get update + ``` + +6. Install the package: + ```text + apt-get install -y edb-as-pgpool-extensions + ``` + + In the above command, `` is the EDB Postgres Advanced Server version, and `` is the EDB Pgpool-II extension version you want to install. diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/index.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/index.mdx new file mode 100644 index 00000000000..565bcc1c1ea --- /dev/null +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/index.mdx @@ -0,0 +1,17 @@ +--- +title: "Installing PgPool extensions on Linux x86 (amd64)" +navTitle: "Intel x86 (amd64)" +--- + +For operating system-specific install instructions, see: + + - [RHEL 8/OL 8](01_mtk55_rhel8_x86) + + - [Rocky Linux 8/AlmaLinux 8](02_mtk55_other_linux8_x86) + - [RHEL 7/OL 7](03_mtk55_rhel7_x86) + - [CentOS 7](04_mtk55_centos7_x86) + - [SLES 15](05_mtk55_sles15_x86) + - [SLES 12](06_mtk55_sles12_x86) + - [Ubuntu 20.04/Debian 10](07_mtk55_ubuntu20_deb10_x86) + - [Ubuntu 18.04/Debian 9](08_mtk55_ubuntu18_deb9_x86) + diff --git a/product_docs/docs/pgpool/4.3/02a_creating_extensions.mdx b/product_docs/docs/pgpool/4.3/02a_creating_extensions.mdx new file mode 100644 index 00000000000..d70c2b4d98b --- /dev/null +++ b/product_docs/docs/pgpool/4.3/02a_creating_extensions.mdx @@ -0,0 +1,33 @@ +--- +title: "Creating and managing extensions" +--- + +You must install and create the extensions in each database where you will be using EDB Pgpool-II functionality. To ensure all extensions are available for future databases, you can add the extension to the `template1` database; any extensions installed in the `template1` database will be created in each of the databases that uses `template1` as a template during creation. + +**Pgpool_adm Extension** + + + +`Pgpool_adm` is a set of extensions that allows SQL access to PCP commands. To view information about PCP commands, see . + +After installing the `Pgpool_adm` extension, use the psql client application to connect to the database, and execute the following SQL command: + +```text +CREATE EXTENSION pgpool_adm; +``` + +To view more information about `Pgpool_adm`, see . + +**Pgpool_recovery Extension** + + + +The `Pgpool_recovery` extension is required for online recovery and future fail-back mechanisms. + +After installing the `Pgpool_recovery` extension, use psql to connect to the database, and execute the following SQL command to create a `Pgpool_recovery` extension: + +```text +CREATE EXTENSION pgpool_recovery; +``` + +For more information about using the `CREATE EXTENSION` command, see the [PostgreSQL core documentation](https://www.postgresql.org/docs/current/static/sql-createextension.html). From dff06e45b33422718fdd0ed81d7d9d0c6b33d049 Mon Sep 17 00:00:00 2001 From: David Wicinas <93669463+dwicinas@users.noreply.github.com> Date: Fri, 6 May 2022 09:29:49 -0400 Subject: [PATCH 25/32] many changes to implement extensions, including capitalization in product name --- .../09_pgpool_rhel8_ppcle.mdx | 2 +- .../10_pgpool_rhel7_ppcle.mdx | 2 +- .../11_pgpool_sles15_ppcle.mdx | 2 +- .../ibm_power_ppc64le/index.mdx | 2 +- .../index.mdx | 2 +- .../x86_amd64/01_pgpool_rhel8_x86.mdx | 2 +- .../x86_amd64/02_pgpool_other_linux8_x86.mdx | 2 +- .../x86_amd64/05_pgpool_sles15_x86.mdx | 2 +- .../x86_amd64/06_pgpool_sles12_x86.mdx | 2 +- .../x86_amd64/08_pgpool_ubuntu18_deb9_x86.mdx | 2 +- .../x86_amd64/index.mdx | 2 +- .../creating_pgpool_extensions.mdx} | 2 +- .../10_pgpoolext_rhel7_ppcle.mdx | 2 +- .../11_pgpoolext_sles15_ppcle.mdx | 54 +++++ .../12_pgpoolext_sles12_ppcle.mdx | 56 +++++ .../02_extensions/ibm_power_ppc64le/index.mdx | 10 +- .../docs/pgpool/4.3/02_extensions/index.mdx | 208 ++---------------- .../x86_amd64/01_pgpoolext_rhel8_x86.mdx | 2 +- .../02_pgpoolext_other_linux8_x86.mdx | 2 +- .../x86_amd64/03_pgpoolext_rhel7_x86.mdx | 2 +- .../x86_amd64/04_pgpoolext_centos7_x86.mdx | 2 +- .../x86_amd64/05_pgpoolext_sles15_x86.mdx | 2 +- .../x86_amd64/06_pgpoolext_sles12_x86.mdx | 2 +- .../07_pgpoolext_ubuntu20_deb10_x86.mdx | 2 +- .../08_pgpoolext_ubuntu18_deb9_x86.mdx | 2 +- .../4.3/02_extensions/x86_amd64/index.mdx | 18 +- 26 files changed, 164 insertions(+), 224 deletions(-) rename product_docs/docs/pgpool/4.3/{02a_creating_extensions.mdx => 02_extensions/creating_pgpool_extensions.mdx} (97%) create mode 100644 product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/11_pgpoolext_sles15_ppcle.mdx create mode 100644 product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/12_pgpoolext_sles12_ppcle.mdx diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx index e03985e7e12..5562a1eb135 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/09_pgpool_rhel8_ppcle.mdx @@ -1,5 +1,5 @@ --- -title: "Installing EDB PgPool-II on RHEL 8 IBM Power (ppc64le)" +title: "Installing EDB Pgpool-II on RHEL 8 IBM Power (ppc64le)" navTitle: "RHEL 8" --- diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx index 6882224d008..6b79603604e 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/10_pgpool_rhel7_ppcle.mdx @@ -1,5 +1,5 @@ --- -title: "Installing EDB PgPool-II on RHEL 7 IBM Power (ppc64le)" +title: "Installing EDB Pgpool-II on RHEL 7 IBM Power (ppc64le)" navTitle: "RHEL 7" --- diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/11_pgpool_sles15_ppcle.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/11_pgpool_sles15_ppcle.mdx index 080306fbdc1..a5f02e60131 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/11_pgpool_sles15_ppcle.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/11_pgpool_sles15_ppcle.mdx @@ -1,5 +1,5 @@ --- -title: "Installing EDB PgPool-II on SLES 15 IBM Power (ppc64le)" +title: "Installing EDB Pgpool-II on SLES 15 IBM Power (ppc64le)" navTitle: "SLES 15" --- diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/index.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/index.mdx index 3931edb0792..2fb66c95aa1 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/index.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/ibm_power_ppc64le/index.mdx @@ -1,5 +1,5 @@ --- -title: "Installing EDB PgPool-II on IBM Power (ppc64le)" +title: "Installing EDB Pgpool-II on IBM Power (ppc64le)" navTitle: "IBM Power (ppc64le)" --- diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/index.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/index.mdx index f136bfa7ba2..33237366097 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/index.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/index.mdx @@ -8,7 +8,7 @@ navigation: - ibm_power_ppc64le --- -To install EDB PgPool-II, you must have credentials that allow access to the EnterpriseDB repository. To request credentials that allow you to access an EnterpriseDB repository, see the [EDB Repository Access instructions](https://www.enterprisedb.com/repository-access-request). +To install EDB Pgpool-II, you must have credentials that allow access to the EnterpriseDB repository. To request credentials that allow you to access an EnterpriseDB repository, see the [EDB Repository Access instructions](https://www.enterprisedb.com/repository-access-request). !!! Note EDB Pgpool-II runs as a service on Linux systems. EDB Pgpool-II isn't supported on Windows. diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/01_pgpool_rhel8_x86.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/01_pgpool_rhel8_x86.mdx index 11ae3fdb12e..8987d7fbae3 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/01_pgpool_rhel8_x86.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/01_pgpool_rhel8_x86.mdx @@ -1,5 +1,5 @@ --- -title: "Installing EDB PgPool-II on RHEL 8/OL 8 x86" +title: "Installing EDB Pgpool-II on RHEL 8/OL 8 x86" navTitle: "RHEL 8/OL 8" --- diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/02_pgpool_other_linux8_x86.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/02_pgpool_other_linux8_x86.mdx index 9134a79f3fa..410f04dc673 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/02_pgpool_other_linux8_x86.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/02_pgpool_other_linux8_x86.mdx @@ -1,5 +1,5 @@ --- -title: "Installing EDB PgPool-II on Rocky Linux 8/AlmaLinux 8 x86" +title: "Installing EDB Pgpool-II on Rocky Linux 8/AlmaLinux 8 x86" navTitle: "Rocky Linux 8/AlmaLinux 8" --- diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/05_pgpool_sles15_x86.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/05_pgpool_sles15_x86.mdx index 94808b05f72..f0d06f1b83c 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/05_pgpool_sles15_x86.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/05_pgpool_sles15_x86.mdx @@ -1,5 +1,5 @@ --- -title: "Installing EDB PgPool-II on SLES 15 x86" +title: "Installing EDB Pgpool-II on SLES 15 x86" navTitle: "SLES 15" --- diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/06_pgpool_sles12_x86.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/06_pgpool_sles12_x86.mdx index e78d90c1236..52516dd8628 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/06_pgpool_sles12_x86.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/06_pgpool_sles12_x86.mdx @@ -1,5 +1,5 @@ --- -title: "Installing EDB PgPool-II on SLES 12 x86" +title: "Installing EDB Pgpool-II on SLES 12 x86" navTitle: "SLES 12" --- diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/08_pgpool_ubuntu18_deb9_x86.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/08_pgpool_ubuntu18_deb9_x86.mdx index 873e697892d..9ae92311e14 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/08_pgpool_ubuntu18_deb9_x86.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/08_pgpool_ubuntu18_deb9_x86.mdx @@ -1,5 +1,5 @@ --- -title: "Installing EDB PgPool-II on Ubuntu 18.04/Debian 9 x86" +title: "Installing EDB Pgpool-II on Ubuntu 18.04/Debian 9 x86" navTitle: "Ubuntu 18.04/Debian 9" --- diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx index fcce3ba55d9..9562a1c1343 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/x86_amd64/index.mdx @@ -1,5 +1,5 @@ --- -title: "Installing EDB PgPool-II on Linux x86 (amd64)" +title: "Installing EDB Pgpool-II on Linux x86 (amd64)" navTitle: "Intel x86 (amd64)" legacyRedirectsGenerated: # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. diff --git a/product_docs/docs/pgpool/4.3/02a_creating_extensions.mdx b/product_docs/docs/pgpool/4.3/02_extensions/creating_pgpool_extensions.mdx similarity index 97% rename from product_docs/docs/pgpool/4.3/02a_creating_extensions.mdx rename to product_docs/docs/pgpool/4.3/02_extensions/creating_pgpool_extensions.mdx index d70c2b4d98b..bc25c070088 100644 --- a/product_docs/docs/pgpool/4.3/02a_creating_extensions.mdx +++ b/product_docs/docs/pgpool/4.3/02_extensions/creating_pgpool_extensions.mdx @@ -1,5 +1,5 @@ --- -title: "Creating and managing extensions" +title: "Creating Pgpool-II extensions" --- You must install and create the extensions in each database where you will be using EDB Pgpool-II functionality. To ensure all extensions are available for future databases, you can add the extension to the `template1` database; any extensions installed in the `template1` database will be created in each of the databases that uses `template1` as a template during creation. diff --git a/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/10_pgpoolext_rhel7_ppcle.mdx b/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/10_pgpoolext_rhel7_ppcle.mdx index 12708222cbc..62cbe0c0fb0 100644 --- a/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/10_pgpoolext_rhel7_ppcle.mdx +++ b/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/10_pgpoolext_rhel7_ppcle.mdx @@ -1,5 +1,5 @@ --- -title: "Installing PgPool extensions on RHEL 7 IBM Power (ppc64le)" +title: "Installing Pgpool extensions on RHEL 7 IBM Power (ppc64le)" navTitle: "RHEL 7" --- diff --git a/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/11_pgpoolext_sles15_ppcle.mdx b/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/11_pgpoolext_sles15_ppcle.mdx new file mode 100644 index 00000000000..be071c18f6d --- /dev/null +++ b/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/11_pgpoolext_sles15_ppcle.mdx @@ -0,0 +1,54 @@ +--- +title: "Installing Pgpool extensions on SLES 15 IBM Power (ppc64le)" +navTitle: "SLES 15" +--- + +!!! note + Supported on EDB Pgpool-II 4.3 and later. + +There are two steps to completing an installation: + +- Setting up the repository +- Installing the package + +For each step, you must be logged in as superuser. + +```shell +# To log in as a superuser: +sudo su - +``` + +Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). + +## Setting up the repository + +Setting up the repository is a one time task. If you have already set up your repository, you do not need to perform these steps. + +```shell +# Install the repository configuration and enter your EDB repository +# credentials when prompted +zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo + +# Install SUSEConnect to register the host with SUSE, allowing access to +# SUSE repositories +zypper install SUSEConnect + +# Register the host with SUSE, allowing access to SUSE repositories +# Replace 'REGISTRATION_CODE' and 'EMAIL' with your SUSE registration +# information +SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' + +# Activate the required SUSE module +SUSEConnect -p PackageHub/15.3/ppc64le + +# Refresh the metadata +zypper refresh +``` + +## Installing the package + +```shell +zypper -n install edb-as-pgpool-extensions +``` + +Where <xx> is the EDB Postgres Advanced Server version and <yy> is the EDB Pgpool-II version you wish to install. diff --git a/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/12_pgpoolext_sles12_ppcle.mdx b/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/12_pgpoolext_sles12_ppcle.mdx new file mode 100644 index 00000000000..80d67f3af78 --- /dev/null +++ b/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/12_pgpoolext_sles12_ppcle.mdx @@ -0,0 +1,56 @@ +--- +title: "Installing Pgpool extensions on SLES 12 IBM Power (ppc64le)" +navTitle: "SLES 12" +--- + +!!! note + Supported on EDB Pgpool-II Extension 4.3 and later. + +There are two steps to completing an installation: + +- Setting up the repository +- Installing the package + + +For each step, you must be logged in as superuser. + +```shell +# To log in as a superuser: +sudo su - +``` + +Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). + +## Setting up the repository + +Setting up the repository is a one time task. If you have already set up your repository, you do not need to perform these steps. + +```shell +# Install the repository configuration and enter your EDB repository +# credentials when prompted +zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo + +# Install SUSEConnect to register the host with SUSE, allowing access to +# SUSE repositories +zypper install SUSEConnect + +# Register the host with SUSE, allowing access to SUSE repositories +# Replace 'REGISTRATION_CODE' and 'EMAIL' with your SUSE registration +# information +SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' + +# Activate the required SUSE modules +SUSEConnect -p PackageHub/12.5/ppc64le +SUSEConnect -p sle-sdk/12.5/ppc64le + +# Refresh the metadata +zypper refresh +``` + +## Installing the package + +```shell +zypper -n install edb-as-pgpool-extensions +``` + +Where <xx> is the EDB Postgres Advanced Server version and <yy> is the EDB Pgpool-II version you wish to install. diff --git a/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/index.mdx b/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/index.mdx index 9069bb20482..6a8a16b426e 100644 --- a/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/index.mdx +++ b/product_docs/docs/pgpool/4.3/02_extensions/ibm_power_ppc64le/index.mdx @@ -1,13 +1,11 @@ --- -title: "Installing PgPool extensions on IBM Power (ppc64le)" +title: "Installing Pgpool extensions on IBM Power (ppc64le)" navTitle: "IBM Power (ppc64le)" --- For operating system-specific install instructions, see: + - [RHEL 7](10_pgpoolext_rhel7_ppcle) - - [RHEL 8](09_mtk55_rhel8_ppcle) - - - [RHEL 7](10_mtk55_rhel7_ppcle) - - [SLES 15](11_mtk55_sles15_ppcle) - - [SLES 12](12_mtk55_sles12_ppcle) + - [SLES 15](11_pgpoolext_sles15_ppcle) + - [SLES 12](12_pgpoolext_sles12_ppcle) diff --git a/product_docs/docs/pgpool/4.3/02_extensions/index.mdx b/product_docs/docs/pgpool/4.3/02_extensions/index.mdx index e19077face8..245e21e14fa 100644 --- a/product_docs/docs/pgpool/4.3/02_extensions/index.mdx +++ b/product_docs/docs/pgpool/4.3/02_extensions/index.mdx @@ -1,13 +1,15 @@ --- -title: "Installing PgPool-II extensions" +title: "Installing and managing Pgpool-II extensions" legacyRedirectsGenerated: # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/pgpool-ii/user-guides/pgpool-ii-guide/1.0/extensions.html" +- "/edb-docs/d/pgpool-ii/user-guides/pgpool-ii-guide/1.0/extensions.html" +navigation: +- x86_amd64 +- ibm_power_ppc64le +- creating_pgpool_extensions --- - - Modules in the extensions directory are additional features to EDB Postgres Advanced Server that are generally not included in the core database. Once loaded in a database, they can function just like built-in features. They allow you to use simple `SELECT` commands to use PCP remotely. !!! Note @@ -15,192 +17,22 @@ Modules in the extensions directory are additional features to EDB Postgres Adva Before installing EDB Pgpool-II extensions, install the EDB Postgres Advanced Server on your host system. -### Installing EDB Pgpool-II extensions on an SLES 12 ppc64le host - -!!! note - Supported on EDB Pgpool-II Extension 4.3 and later. - -There are two steps to completing an installation: - -- Setting up the repository -- Installing the package - - -For each step, you must be logged in as superuser. - -```shell -# To log in as a superuser: -sudo su - -``` - -Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). - -#### Setting up the repository - -Setting up the repository is a one time task. If you have already set up your repository, you do not need to perform these steps. - -```shell -# Install the repository configuration and enter your EDB repository -# credentials when prompted -zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo - -# Install SUSEConnect to register the host with SUSE, allowing access to -# SUSE repositories -zypper install SUSEConnect - -# Register the host with SUSE, allowing access to SUSE repositories -# Replace 'REGISTRATION_CODE' and 'EMAIL' with your SUSE registration -# information -SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' - -# Activate the required SUSE modules -SUSEConnect -p PackageHub/12.5/ppc64le -SUSEConnect -p sle-sdk/12.5/ppc64le - -# Refresh the metadata -zypper refresh -``` - -#### Installing the package - -```shell -zypper -n install edb-as-pgpool-extensions -``` - -Where <xx> is the EDB Postgres Advanced Server version and <yy> is the EDB Pgpool-II version you wish to install. - -### Installing EDB Pgpool-II extensions on an SLES 15 ppc64le host - -!!! note - Supported on EDB Pgpool-II 4.3 and later. - -There are two steps to completing an installation: - -- Setting up the repository -- Installing the package - -For each step, you must be logged in as superuser. - -```shell -# To log in as a superuser: -sudo su - -``` - -Before setting up the repository, you need to register with EDB. To receive credentials for the EDB repository, visit: [Repository Access Request](https://www.enterprisedb.com/repository-access-request). - -#### Setting up the repository - -Setting up the repository is a one time task. If you have already set up your repository, you do not need to perform these steps. - -```shell -# Install the repository configuration and enter your EDB repository -# credentials when prompted -zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo - -# Install SUSEConnect to register the host with SUSE, allowing access to -# SUSE repositories -zypper install SUSEConnect - -# Register the host with SUSE, allowing access to SUSE repositories -# Replace 'REGISTRATION_CODE' and 'EMAIL' with your SUSE registration -# information -SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' - -# Activate the required SUSE module -SUSEConnect -p PackageHub/15.3/ppc64le - -# Refresh the metadata -zypper refresh -``` - -#### Installing the package - -```shell -zypper -n install edb-as-pgpool-extensions -``` - -Where <xx> is the EDB Postgres Advanced Server version and <yy> is the EDB Pgpool-II version you wish to install. - - - -### Installing EDB Pgpool-II extensions using the Linux graphical installer - - Graphical installers for EDB Pgpool-II extensions are available via StackBuilder Plus (for EDB Postgres Advanced Server hosts) or Stack Builder (on PostgreSQL hosts). You can access StackBuilder Plus through your Linux start menu. It is not supported on Windows. - - Perform the following steps to install EDB Pgpool-II extensions: - -1. Open StackBuilder Plus and select your EDB Postgres Advanced Server installation from the drop-down list on the `Welcome` window. Click `Next` to continue to the application selection page. - -2. Expand the `Add-ons, tools and utilities` node, and check the box next to the EDB Pgpool-II extension to select and download the installer. Click `Next` to continue. - -3. Provide the credentials and click `Next`. - -4. The selected packages and the default download directory where the package will be installed are displayed; change the download directory location if required. Click `Next`. - -5. Once you have downloaded the installation files, a confirmation message is displayed. Click `Next` to start the installation. - -6. Select an installation language and click `OK`. - -7. The EDB Pgpool-II extensions installer welcomes you to the setup wizard. - - ![The EDB Pgpool-II Extensions Welcome window](images/pg1.png) - - Fig. 1: The EDB Pgpool-II Extensions Welcome window - -8. Use the `Installation Directory` field to specify the directory in which you wish to install the EDB Pgpool-II extensions software (the default installation directory is `/opt/edb/as`) Then, click `Next` to continue. - - ![The EDB Pgpool-II Extensions Installation Details Window](images/pg2.png) - - Fig. 2: The EDB Pgpool-II Extensions Installation Details Window - -9. The `Ready to Install` window notifies you when the installer has all of the information needed to install EDB Pgpool-II extensions on your system. Click `Next` to install EDB Pgpool-II extensions. - - ![The Ready to Install window](images/pg3.png) - - Fig. 3: The Ready to Install window - -10. Progress bars inform you as the installation progresses. - - ![The installation progresses](images/pg4.png) - - Fig. 4: The installation progresses - -11. The installer notifies you when the setup wizard has completed the EDB Pgpool-II installation. Click `Finish` to exit the installer. - - ![The installation is complete](images/pg5.png) - - Fig. 5: The installation is complete - -12. The extensions will be available in the `/opt/edb/as/share/extension/pgpool*` directory. - -## Creating EDB Pgpool-II extensions - -You must install and create the extensions in each database where you will be using EDB Pgpool-II functionality. To ensure all extensions are available for future databases, you can add the extension to the `template1` database; any extensions installed in the `template1` database will be created in each of the databases that uses `template1` as a template during creation. - -**Pgpool_adm Extension** - - - -`Pgpool_adm` is a set of extensions that allows SQL access to PCP commands. To view information about PCP commands, see . - -After installing the `Pgpool_adm` extension, use the psql client application to connect to the database, and execute the following SQL command: - -```text -CREATE EXTENSION pgpool_adm; -``` - -To view more information about `Pgpool_adm`, see . - -**Pgpool_recovery Extension** +For platform-specific install instructions for PgPool-II extensions, see: - +- Linux x86-64 (amd64): + - [RHEL 8/OL 8](x86_amd64/01_pgpoolext_rhel8_x86) -The `Pgpool_recovery` extension is required for online recovery and future fail-back mechanisms. + - [Rocky Linux 8/AlmaLinux 8](x86_amd64/02_pgpoolext_other_linux8_x86) + - [RHEL 7/OL 7](x86_amd64/03_pgpoolext_rhel7_x86) + - [CentOS 7](x86_amd64/04_pgpoolext_centos7_x86) + - [SLES 15](x86_amd64/05_pgpoolext_sles15_x86) + - [SLES 12](x86_amd64/06_pgpoolext_sles12_x86) + - [Ubuntu 20.04/Debian 10](x86_amd64/07_pgpoolext_ubuntu20_deb10_x86) + - [Ubuntu 18.04/Debian 9](x86_amd64/08_pgpoolext_ubuntu18_deb9_x86) -After installing the `Pgpool_recovery` extension, use psql to connect to the database, and execute the following SQL command to create a `Pgpool_recovery` extension: +- Linux on IBM Power (ppc64le): + - [RHEL 7](ibm_power_ppc64le/10_pgpoolext_rhel7_ppcle) -```text -CREATE EXTENSION pgpool_recovery; -``` + - [SLES 15](ibm_power_ppc64le/11_pgpoolext_sles15_ppcle) + - [SLES 12](ibm_power_ppc64le/12_pgpoolext_sles12_ppcle) -For more information about using the `CREATE EXTENSION` command, see the [PostgreSQL core documentation](https://www.postgresql.org/docs/current/static/sql-createextension.html). diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/01_pgpoolext_rhel8_x86.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/01_pgpoolext_rhel8_x86.mdx index a462699a6ff..1d387072f58 100644 --- a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/01_pgpoolext_rhel8_x86.mdx +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/01_pgpoolext_rhel8_x86.mdx @@ -1,5 +1,5 @@ --- -title: "Installing PgPool extensions on RHEL 8/OL 8 x86" +title: "Installing Pgpool extensions on RHEL 8/OL 8 x86" navTitle: "RHEL 8/OL 8" --- diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/02_pgpoolext_other_linux8_x86.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/02_pgpoolext_other_linux8_x86.mdx index 7718594866e..3cb9b5a4c45 100644 --- a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/02_pgpoolext_other_linux8_x86.mdx +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/02_pgpoolext_other_linux8_x86.mdx @@ -1,5 +1,5 @@ --- -title: "Installing PgPool extensions on Rocky Linux 8/AlmaLinux 8 x86" +title: "Installing Pgpool extensions on Rocky Linux 8/AlmaLinux 8 x86" navTitle: "Rocky Linux 8/AlmaLinux 8" --- diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/03_pgpoolext_rhel7_x86.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/03_pgpoolext_rhel7_x86.mdx index b42ef03b7ee..5e8c9280212 100644 --- a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/03_pgpoolext_rhel7_x86.mdx +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/03_pgpoolext_rhel7_x86.mdx @@ -1,5 +1,5 @@ --- -title: "Installing PgPool extensions on RHEL 7/OL 7 x86" +title: "Installing Pgpool extensions on RHEL 7/OL 7 x86" navTitle: "RHEL 7/OL 7" --- diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/04_pgpoolext_centos7_x86.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/04_pgpoolext_centos7_x86.mdx index 117e90448b2..d85b7f21a4f 100644 --- a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/04_pgpoolext_centos7_x86.mdx +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/04_pgpoolext_centos7_x86.mdx @@ -1,5 +1,5 @@ --- -title: "Installing PgPool extensions on CentOS 7 x86" +title: "Installing Pgpool extensions on CentOS 7 x86" navTitle: "CentOS 7" --- diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/05_pgpoolext_sles15_x86.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/05_pgpoolext_sles15_x86.mdx index 8a2b12db3b9..4410ec13a0d 100644 --- a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/05_pgpoolext_sles15_x86.mdx +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/05_pgpoolext_sles15_x86.mdx @@ -1,5 +1,5 @@ --- -title: "Installing PgPool extensions on SLES 15 x86" +title: "Installing Pgpool extensions on SLES 15 x86" navTitle: "SLES 15" --- diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/06_pgpoolext_sles12_x86.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/06_pgpoolext_sles12_x86.mdx index 5e5c349e2f7..a7f56b415c9 100644 --- a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/06_pgpoolext_sles12_x86.mdx +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/06_pgpoolext_sles12_x86.mdx @@ -1,5 +1,5 @@ --- -title: "Installing PgPool extensions on SLES 12 x86" +title: "Installing Pgpool extensions on SLES 12 x86" navTitle: "SLES 12" --- diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/07_pgpoolext_ubuntu20_deb10_x86.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/07_pgpoolext_ubuntu20_deb10_x86.mdx index e994ea6b651..8d00b2e062c 100644 --- a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/07_pgpoolext_ubuntu20_deb10_x86.mdx +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/07_pgpoolext_ubuntu20_deb10_x86.mdx @@ -1,5 +1,5 @@ --- -title: "Installing PgPool extensions on Debian 10 x86" +title: "Installing Pgpool extensions on Debian 10 x86" navTitle: "Debian 10" --- diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/08_pgpoolext_ubuntu18_deb9_x86.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/08_pgpoolext_ubuntu18_deb9_x86.mdx index c01255e36e1..2683fdcc18e 100644 --- a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/08_pgpoolext_ubuntu18_deb9_x86.mdx +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/08_pgpoolext_ubuntu18_deb9_x86.mdx @@ -1,5 +1,5 @@ --- -title: "Installing PgPool extensions on Ubuntu 18.04/Debian 9 x86" +title: "Installing Pgpool extensions on Ubuntu 18.04/Debian 9 x86" navTitle: "Ubuntu 18.04/Debian 9" --- diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/index.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/index.mdx index 565bcc1c1ea..d6df0a5c768 100644 --- a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/index.mdx +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/index.mdx @@ -1,17 +1,17 @@ --- -title: "Installing PgPool extensions on Linux x86 (amd64)" +title: "Installing Pgpool extensions on Linux x86 (amd64)" navTitle: "Intel x86 (amd64)" --- For operating system-specific install instructions, see: - - [RHEL 8/OL 8](01_mtk55_rhel8_x86) + - [RHEL 8/OL 8](01_pgpoolext_rhel8_x86) - - [Rocky Linux 8/AlmaLinux 8](02_mtk55_other_linux8_x86) - - [RHEL 7/OL 7](03_mtk55_rhel7_x86) - - [CentOS 7](04_mtk55_centos7_x86) - - [SLES 15](05_mtk55_sles15_x86) - - [SLES 12](06_mtk55_sles12_x86) - - [Ubuntu 20.04/Debian 10](07_mtk55_ubuntu20_deb10_x86) - - [Ubuntu 18.04/Debian 9](08_mtk55_ubuntu18_deb9_x86) + - [Rocky Linux 8/AlmaLinux 8](02_pgpoolext_other_linux8_x86) + - [RHEL 7/OL 7](03_pgpoolext_rhel7_x86) + - [CentOS 7](04_pgpoolext_centos7_x86) + - [SLES 15](05_pgpoolext_sles15_x86) + - [SLES 12](06_pgpoolext_sles12_x86) + - [Debian 10](07_pgpoolext_ubuntu20_deb10_x86) + - [Ubuntu 18.04/Debian 9](08_pgpoolext_ubuntu18_deb9_x86) From bc2388d3ac18509239c65ab49a7f4291593312f8 Mon Sep 17 00:00:00 2001 From: drothery-edb Date: Fri, 6 May 2022 15:01:18 -0400 Subject: [PATCH 26/32] minor cleanup --- .../index.mdx | 1 - .../x86_amd64/04_pgpoolext_centos7_x86.mdx | 13 ++++--------- 2 files changed, 4 insertions(+), 10 deletions(-) diff --git a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/index.mdx b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/index.mdx index 33237366097..17cea5e6e65 100644 --- a/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/index.mdx +++ b/product_docs/docs/pgpool/4.3/01_installing_and_configuring_the_pgpool-II/index.mdx @@ -22,7 +22,6 @@ For platform-specific install instructions, see: - [Rocky Linux 8/AlmaLinux 8](x86_amd64/02_pgpool_other_linux8_x86) - [RHEL 7/OL 7](x86_amd64/03_pgpool_rhel7_x86) - - [CentOS 7](x86_amd64/04_pgpool_centos7_x86) - [SLES 15](x86_amd64/05_pgpool_sles15_x86) - [SLES 12](x86_amd64/06_pgpool_sles12_x86) - [Ubuntu 20.04/Debian 10](x86_amd64/07_pgpool_ubuntu20_deb10_x86) diff --git a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/04_pgpoolext_centos7_x86.mdx b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/04_pgpoolext_centos7_x86.mdx index d85b7f21a4f..171d1ac8f31 100644 --- a/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/04_pgpoolext_centos7_x86.mdx +++ b/product_docs/docs/pgpool/4.3/02_extensions/x86_amd64/04_pgpoolext_centos7_x86.mdx @@ -26,15 +26,10 @@ Assume superuser privileges and perform the following steps to install EDB Pgpoo yum -y install edb-as-pgpool-extensions ``` + In the above command, `` is the EDB Postgres Advanced Server version, and `` is the EDB Pgpool-II extension version. For example, to install Pgpool43 extensions for EDB Postgres Advanced Server 14, execute the following command: - ```text - yum -y install edb-as14-pgpool43-extensions - ``` - -In the above command, `` is the EDB Postgres Advanced Server version, and `` is the EDB Pgpool-II extension version. For example, to install Pgpool43 extensions for EDB Postgres Advanced Server 14, execute the following command: - - ```text - yum -y install edb-as14-pgpool43-extensions - ``` +```text +yum -y install edb-as14-pgpool43-extensions +``` The extensions will be available in the `/usr/edb/as/share/extension` directory. From d796b2ebf85cd015c2f695b45b8913c544681334 Mon Sep 17 00:00:00 2001 From: drothery-edb Date: Sun, 8 May 2022 05:54:07 -0400 Subject: [PATCH 27/32] Mongo FDW: deleted stray copy of rel notes --- .../mongo_data_adapter/mongo5.3.0_rel_notes.mdx | 17 ----------------- 1 file changed, 17 deletions(-) delete mode 100644 product_docs/docs/mongo_data_adapter/mongo5.3.0_rel_notes.mdx diff --git a/product_docs/docs/mongo_data_adapter/mongo5.3.0_rel_notes.mdx b/product_docs/docs/mongo_data_adapter/mongo5.3.0_rel_notes.mdx deleted file mode 100644 index 6ffa1b667b3..00000000000 --- a/product_docs/docs/mongo_data_adapter/mongo5.3.0_rel_notes.mdx +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: "Version 5.3.0" -redirects: -- 01_5.3.0_rel_notes ---- - -Enhancements, bug fixes, and other changes in MongoDB Foreign Data Wrapper 5.3.0 -include: - -| Type | Description | -| ----------- |------------ | -| Enhancement | Support for EDB Postgres Advanced Server 14. | -| Enhancement | Join pushdown: If a query has a join between two foreign tables from the same remote server, you can now push that join down to the remote server instead of fetching all the rows for both the tables and performing a join locally. | -| Bug fix | Improve API performance. | -| Bug fix | Need support for the whole-row reference. | - - From 97b12ad863139965909b110c20219b6a29d70d17 Mon Sep 17 00:00:00 2001 From: nidhibhammar <59045594+nidhibhammar@users.noreply.github.com> Date: Mon, 9 May 2022 14:06:35 +0530 Subject: [PATCH 28/32] Fixed broken links --- ...e_pem_server_to_use_kerberos_authentication.mdx | 2 +- ...e_pem_server_to_use_windows_kerberos_server.mdx | 2 +- product_docs/docs/pem/8/considerations/index.mdx | 14 +++++++------- ...em_server_and_apache_web_server_preferences.mdx | 8 ++++---- .../pem_pgbouncer/configuring_pgBouncer.mdx | 0 .../pem_pgbouncer/configuring_the_pem_agent.mdx | 0 .../pem_pgbouncer/index.mdx | 2 +- ...r_pem_agent_connection_management_mechanism.mdx | 0 .../preparing_the_pem_database_server.mdx | 0 .../ppc64le/pem_server_rhel8_ppcle.mdx | 5 +++-- .../ppc64le/pem_server_sles12_ppcle.mdx | 4 ++-- .../ppc64le/pem_server_sles15_ppcle.mdx | 4 ++-- .../x86/pem_server_centos7_x86.mdx | 7 ++----- .../x86/pem_server_other_linux8_x86.mdx | 4 ++-- .../x86/pem_server_rhel7_x86.mdx | 4 ++-- .../x86/pem_server_rhel8_x86.mdx | 6 ++---- .../x86/pem_server_sles12_x86.mdx | 4 ++-- .../x86/pem_server_sles15_x86.mdx | 4 ++-- .../x86/pem_server_ubuntu18_deb9_x86.mdx | 4 ++-- .../x86/pem_server_ubuntu20_deb10_x86.mdx | 4 ++-- 20 files changed, 37 insertions(+), 41 deletions(-) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/pem_pgbouncer/configuring_pgBouncer.mdx (100%) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/pem_pgbouncer/configuring_the_pem_agent.mdx (100%) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/pem_pgbouncer/index.mdx (95%) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/pem_pgbouncer/pem_server_pem_agent_connection_management_mechanism.mdx (100%) rename product_docs/docs/pem/8/{installing_pem_server => considerations}/pem_pgbouncer/preparing_the_pem_database_server.mdx (100%) diff --git a/product_docs/docs/pem/8/considerations/authentication_options/configuring_the_pem_server_to_use_kerberos_authentication.mdx b/product_docs/docs/pem/8/considerations/authentication_options/configuring_the_pem_server_to_use_kerberos_authentication.mdx index a057fe83041..6986ecc8f44 100644 --- a/product_docs/docs/pem/8/considerations/authentication_options/configuring_the_pem_server_to_use_kerberos_authentication.mdx +++ b/product_docs/docs/pem/8/considerations/authentication_options/configuring_the_pem_server_to_use_kerberos_authentication.mdx @@ -25,7 +25,7 @@ Follow the steps to configure the Kerberos Authentication for the PEM Server: - Install the Kerberos on the machine that functions as the authentication server. -- Install the PEM Server on the separate machine, for more information see [Installing the PEM Server](../installing_on_linux). +- Install the PEM Server on the separate machine, for more information see [Installing the PEM Server](/pem/latest/installing_pem_server/installing_on_linux). - Install the PEM Backend Database (Postgres/EDB Postgres Advanced Server) on same or different machine as PEM Server. For more information see the Installation steps on [EDB Docs Website](https://www.enterprisedb.com/docs). diff --git a/product_docs/docs/pem/8/considerations/authentication_options/configuring_the_pem_server_to_use_windows_kerberos_server.mdx b/product_docs/docs/pem/8/considerations/authentication_options/configuring_the_pem_server_to_use_windows_kerberos_server.mdx index 64e58faaad9..99d3b71887c 100644 --- a/product_docs/docs/pem/8/considerations/authentication_options/configuring_the_pem_server_to_use_windows_kerberos_server.mdx +++ b/product_docs/docs/pem/8/considerations/authentication_options/configuring_the_pem_server_to_use_windows_kerberos_server.mdx @@ -18,7 +18,7 @@ Follow the steps to configure the Kerberos Authentication for the PEM Server: - Install the Active Directory on the Windows Server (Domain Controller) that functions as the authentication server. Also, configure the Active Directory Domain Services to use Kerberos Authentication and it should be up and running. -- Install the PEM Server on the separate Linux machine, for more information see [Installing the PEM Server](../installing_on_linux). +- Install the PEM Server on the separate Linux machine, for more information see [Installing the PEM Server](/pem/latest/installing_pem_server/installing_on_linux). - Install the PEM Backend Database (Postgres/EDB Postgres Advanced Server) on the same or different Linux machine as the PEM Server. For more information, see the Installation steps on [EDB Docs Website](https://www.enterprisedb.com/docs). diff --git a/product_docs/docs/pem/8/considerations/index.mdx b/product_docs/docs/pem/8/considerations/index.mdx index 3de6302d152..9968ea4be70 100644 --- a/product_docs/docs/pem/8/considerations/index.mdx +++ b/product_docs/docs/pem/8/considerations/index.mdx @@ -2,20 +2,20 @@ title: "Deployment considerations" navigation: -- installing_pem_server_and_apache_web_server_preferences -- authentication_options - setup_ha_using_efm - pem_pgbouncer +- authentication_options - pem_security_best_practices +- installing_pem_server_and_apache_web_server_preferences --- There are a number of things to consider before deploying Postgres Enterprise Manager. | Considerations | Implementation instructions | | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | -| Is a standalone server sufficient or do you need a high availability architecture? | [Installing the server](/pem/latest/installing_pem_server/) or [Deploying high availability](/pem/latest/installing_pem_server/setup_ha_using_efm/) | -| Do you need to implement connection pooling? | [Deploying connection pooling](/pem/latest/installing_pem_server/pem_pgbouncer/) | -| What type of authentication to use? | [Authentication options](/pem/latest/installing_pem_server/authentication_options/) | -| What actions should you take to avoid security vulnerabilities? | [Securing your deployment](/pem/latest/installing_pem_server/pem_security_best_practices/) | -| Where to host the Apache web server? | [Web server installation options](/pem/latest/installing_pem_server/installing_on_linux/installing_pem_server_and_apache_web_server_preferences) | +| Is a standalone server sufficient or do you need a high availability architecture? | [Installing the server](/pem/latest/installing_pem_server/) or [Deploying high availability](/pem/latest/considerations/setup_ha_using_efm/) | +| Do you need to implement connection pooling? | [Deploying connection pooling](/pem/latest/considerations/pem_pgbouncer/) | +| What type of authentication to use? | [Authentication options](/pem/latest/considerations/authentication_options/) | +| What actions should you take to avoid security vulnerabilities? | [Securing your deployment](/pem/latest/considerations/pem_security_best_practices/) | +| Where to host the Apache web server? | [Web server installation options](/pem/latest/considerations/installing_pem_server_and_apache_web_server_preferences) | diff --git a/product_docs/docs/pem/8/considerations/installing_pem_server_and_apache_web_server_preferences.mdx b/product_docs/docs/pem/8/considerations/installing_pem_server_and_apache_web_server_preferences.mdx index daa3d11314c..d9304762406 100644 --- a/product_docs/docs/pem/8/considerations/installing_pem_server_and_apache_web_server_preferences.mdx +++ b/product_docs/docs/pem/8/considerations/installing_pem_server_and_apache_web_server_preferences.mdx @@ -12,19 +12,19 @@ During the PEM server installation, you can specify your hosting preferences for ### PEM server and Apache web server on separate hosts -1. Install the PEM server on both the hosts, for steps see [Installing the PEM server on Linux](using_edb_repository). +1. Install the PEM server on both the hosts, for steps see [Installing the PEM server on Linux](/pem/latest/installing_pem_server/installing_on_linux/using_edb_repository). 2. Configure the PEM server host by selecting the `Database` option on the first host. 3. Configure an Apache web server by selecting the `Web Services` option on the second host. -For detailed information about configuring a PEM server, see [Configuring the PEM server on Linux platforms](configuring_the_pem_server_on_linux). +For detailed information about configuring a PEM server, see [Configuring the PEM server on Linux platforms](/pem/latest/installing_pem_server/installing_on_linux/configuring_the_pem_server_on_linux). !!! Note For production environments, it is a best practice to have PEM server and Apache web server on separates hosts. ### PEM server and Apache web server on the same host -1. Install the PEM server, for steps see [Installing the PEM server on Linux](using_edb_repository). -2. Run the configuration script, select the `Web Services and Database` option to install PEM Server and Apache Web Server on the same host, for steps see [Configuring the PEM server on Linux platforms](configuring_the_pem_server_on_linux). +1. Install the PEM server, for steps see [Installing the PEM server on Linux](/pem/latest/installing_pem_server/installing_on_linux/using_edb_repository). +2. Run the configuration script, select the `Web Services and Database` option to install PEM Server and Apache Web Server on the same host, for steps see [Configuring the PEM server on Linux platforms](/pem/latest/installing_pem_server/installing_on_linux/configuring_the_pem_server_on_linux). !!! Note For non-production environments, it is a best practice to have PEM server and Apache web server on same hosts. diff --git a/product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/configuring_pgBouncer.mdx b/product_docs/docs/pem/8/considerations/pem_pgbouncer/configuring_pgBouncer.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/configuring_pgBouncer.mdx rename to product_docs/docs/pem/8/considerations/pem_pgbouncer/configuring_pgBouncer.mdx diff --git a/product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/configuring_the_pem_agent.mdx b/product_docs/docs/pem/8/considerations/pem_pgbouncer/configuring_the_pem_agent.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/configuring_the_pem_agent.mdx rename to product_docs/docs/pem/8/considerations/pem_pgbouncer/configuring_the_pem_agent.mdx diff --git a/product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/index.mdx b/product_docs/docs/pem/8/considerations/pem_pgbouncer/index.mdx similarity index 95% rename from product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/index.mdx rename to product_docs/docs/pem/8/considerations/pem_pgbouncer/index.mdx index 5c1f764203a..5d60c1fd0da 100644 --- a/product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/index.mdx +++ b/product_docs/docs/pem/8/considerations/pem_pgbouncer/index.mdx @@ -22,6 +22,6 @@ This document provides detailed information about using pgBouncer as a connectio - Configuring pgBouncer – provides detailed information about configuring pgBouncer to make it work with the PEM database server. - Configuring the PEM Agent – provides detailed information about configuring a PEM Agent to connect to pgBouncer. -For detailed information about using the PEM web interface, please see the [Accessing the web interface ](../../pem_web_interface). +For detailed information about using the PEM web interface, please see the [Accessing the web interface ](/pem/latest/pem_web_interface). This document uses the term `Postgres` to mean either the PostgreSQL or the Advanced Server database. \ No newline at end of file diff --git a/product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/pem_server_pem_agent_connection_management_mechanism.mdx b/product_docs/docs/pem/8/considerations/pem_pgbouncer/pem_server_pem_agent_connection_management_mechanism.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/pem_server_pem_agent_connection_management_mechanism.mdx rename to product_docs/docs/pem/8/considerations/pem_pgbouncer/pem_server_pem_agent_connection_management_mechanism.mdx diff --git a/product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/preparing_the_pem_database_server.mdx b/product_docs/docs/pem/8/considerations/pem_pgbouncer/preparing_the_pem_database_server.mdx similarity index 100% rename from product_docs/docs/pem/8/installing_pem_server/pem_pgbouncer/preparing_the_pem_database_server.mdx rename to product_docs/docs/pem/8/considerations/pem_pgbouncer/preparing_the_pem_database_server.mdx diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_rhel8_ppcle.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_rhel8_ppcle.mdx index 29e6b96cd24..97d53b6d0a8 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_rhel8_ppcle.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_rhel8_ppcle.mdx @@ -9,11 +9,12 @@ Before you begin the installation process, log in as superuser: # To log in as a superuser: sudo su - ``` + ## Prerequisites -- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](/epas/latest) or [PostgresSQL](/supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. - 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/epas_inst_linux) or [Installing PostgreSQL](/supported-open-source/postgresql/installer/). 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles12_ppcle.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles12_ppcle.mdx index 81042b538ce..a86dc535a15 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles12_ppcle.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles12_ppcle.mdx @@ -12,9 +12,9 @@ sudo su - ## Prerequisites -- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](/epas/latest) or [PostgresSQL](/supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. - 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/epas_inst_linux) or [Installing PostgreSQL](/supported-open-source/postgresql/installer/). 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles15_ppcle.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles15_ppcle.mdx index 8d3ef754afe..6016947c461 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles15_ppcle.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/ppc64le/pem_server_sles15_ppcle.mdx @@ -12,9 +12,9 @@ sudo su - ## Prerequisites -- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](/epas/latest) or [PostgresSQL](/supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. - 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/epas_inst_linux) or [Installing PostgreSQL](/supported-open-source/postgresql/installer/). 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx index 01d0e0a62a9..53574ae3fe6 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx @@ -3,9 +3,6 @@ title: "Installing the PEM server on CentOS 7 x86" navTitle: "CentOS 7" --- - -Before following the detailed instructions that install the PEM server on your specific platform, you must perform the prerequisite steps detailed in [Prerequisites for installing PEM Server](../../prerequisites_for_installing_pem_server/). - On a CentOS system, you can use the `yum` package manager to install a PEM Server; the installation tool you use will be dependent on the version of the host operating system. Before installing the server, you must ensure that your system contains the required prerequisite software listed below. **Install the `epel-release` package** @@ -19,9 +16,9 @@ yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarc ## Prerequisites -- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](/epas/latest) or [PostgresSQL](/supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. - 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/epas_inst_linux) or [Installing PostgreSQL](/supported-open-source/postgresql/installer/). 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx index 9bb9895731e..280d597be5e 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx @@ -22,9 +22,9 @@ dnf config-manager --set-enabled powertools ## Prerequisites -- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](/epas/latest) or [PostgresSQL](/supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. - 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/epas_inst_linux) or [Installing PostgreSQL](/supported-open-source/postgresql/installer/). 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx index db5a082691c..6f577f0edca 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx @@ -26,9 +26,9 @@ subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extr ## Prerequisites -- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](/epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. - 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx index 34ab62ff535..4593929441b 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx @@ -3,8 +3,6 @@ title: "Installing the PEM server on RHEL 8/OL 8 x86" navTitle: "RHEL 8/OL 8 x86" --- -Before following the detailed instructions that install the PEM server on your specific platform, you must perform the prerequisite steps detailed in [Prerequisites for installing PEM Server](../../prerequisites_for_installing_pem_server/). - On a RHEL or OL system, you can use the `dnf` command to install a PEM Server; the installation tool you use will be dependent on the version of the host operating system. Before installing the server, you must ensure that your system contains the required prerequisite software listed below. **Install the `epel-release` package** @@ -24,9 +22,9 @@ subscription-manager repos --enable "codeready-builder-for-rhel-8-${ARCH}-rpms" ## Prerequisites -- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](/epas/latest) or [PostgresSQL](/supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. - 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/epas_inst_linux) or [Installing PostgreSQL](/supported-open-source/postgresql/installer/). 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx index de1fb852c09..8540bc20fd2 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles12_x86.mdx @@ -12,9 +12,9 @@ sudo su - ## Prerequisites -- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](/epas/latest) or [PostgresSQL](/supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. - 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/epas_inst_linux) or [Installing PostgreSQL](/supported-open-source/postgresql/installer/). 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles15_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles15_x86.mdx index 655fe1f2c9b..0bc67929248 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles15_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_sles15_x86.mdx @@ -12,9 +12,9 @@ sudo su - ## Prerequisites -- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](/epas/latest) or [PostgresSQL](/supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. - 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/epas_inst_linux) or [Installing PostgreSQL](/supported-open-source/postgresql/installer/). 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu18_deb9_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu18_deb9_x86.mdx index 22817a141de..a0d7d7d4dfb 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu18_deb9_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu18_deb9_x86.mdx @@ -16,9 +16,9 @@ sudo su - ## Prerequisites -- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](/epas/latest) or [PostgresSQL](/supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. - 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/epas_inst_linux) or [Installing PostgreSQL](/supported-open-source/postgresql/installer/). 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu20_deb10_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu20_deb10_x86.mdx index 36ea251a0f6..984eaced091 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu20_deb10_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_ubuntu20_deb10_x86.mdx @@ -16,9 +16,9 @@ The following steps will walk you through using the EDB `apt` repository to inst ## Prerequisites -- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](/epas/latest) or [PostgresSQL](/supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. - 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](product_docs/docs/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/epas_inst_linux) or [Installing PostgreSQL](/supported-open-source/postgresql/installer/). 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. From a60ab036f4815ab5c1cc8604223a5ff8ea0578b2 Mon Sep 17 00:00:00 2001 From: drothery-edb Date: Mon, 9 May 2022 05:52:09 -0400 Subject: [PATCH 29/32] stashed changes --- .../installing_on_linux/using_edb_repository/index.mdx | 2 +- .../using_edb_repository/x86/pem_server_centos7_x86.mdx | 6 +++--- .../x86/pem_server_other_linux8_x86.mdx | 6 +++--- .../using_edb_repository/x86/pem_server_rhel7_x86.mdx | 6 +++--- .../using_edb_repository/x86/pem_server_rhel8_x86.mdx | 4 ++-- 5 files changed, 12 insertions(+), 12 deletions(-) diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/index.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/index.mdx index 2968a7571e0..3431c065d5d 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/index.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/index.mdx @@ -11,6 +11,6 @@ navigation: For platform-specific detailed information about PEM server install instructions, see: -- [Linux x86-64 (AMD64)](x86) +- [Linux x86-64 (amd64)](x86) - [Linux on IBM Power (ppc64le)](ppc64le) diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx index 53574ae3fe6..7e36a155073 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx @@ -16,9 +16,9 @@ yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarc ## Prerequisites -- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](/epas/latest) or [PostgresSQL](/supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](/epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. - 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/epas_inst_linux) or [Installing PostgreSQL](/supported-open-source/postgresql/installer/). + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. @@ -52,7 +52,7 @@ yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarc yum upgrade ``` -## Install and Configure the edb.repo File +## Install and configure the edb.repo file To create an EnterpriseDB repository configuration file, assume superuser privileges and invoke the following command: diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx index 280d597be5e..cd67064aca7 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_other_linux8_x86.mdx @@ -3,7 +3,7 @@ title: "Installing the PEM server on Rocky Linux 8/AlmaLinux 8 x86" navTitle: "Rocky Linux 8/AlmaLinux 8" --- -Before following the detailed instructions that install the PEM server on your specific platform, you must perform the prerequisite steps detailed in [Prerequisites for installing PEM Server](../../prerequisites_for_installing_pem_server/). +Before following the detailed instructions that install the PEM server on your specific platform, you must perform the prerequisite steps detailed in [Prerequisites](#prerequisites). On a Rocky Linux or AlmaLinux system, you can use the `yum` package manager or `dnf` command to install a PEM Server; the installation tool you use will be dependent on the version of the host operating system. Before installing the server, you must ensure that your system contains the required prerequisite software listed below. @@ -58,7 +58,7 @@ dnf config-manager --set-enabled powertools dnf upgrade ``` -## Install and Configure the edb.repo File +## Install and configure the edb.repo File To create an EnterpriseDB repository configuration file, assume superuser privileges and invoke the following command: @@ -80,7 +80,7 @@ To request credentials for the repository, contact [EDB](https://www.enterprised dnf -qy module disable PostgreSQL ``` -## Install the PEM Server +## Install the PEM server After meeting the platform-specific prerequisites listed above, you can use dnf to install the PEM Server: diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx index 6f577f0edca..2c96359de00 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx @@ -3,7 +3,7 @@ title: "Installing the PEM server on RHEL 7/OL 7 x86" navTitle: "RHEL 7/OL 7" --- -Before following the detailed instructions that install the PEM server on your specific platform, you must perform the prerequisite steps detailed in [Prerequisites for installing PEM Server](../../prerequisites_for_installing_pem_server/). +Before following the detailed instructions that install the PEM server on your specific platform, you must perform the prerequisite steps detailed in [Prerequisites](#prerequisites). On a RHEL or OL system, you can use the `yum` package manager to install a PEM Server; the installation tool you use will be dependent on the version of the host operating system. Before installing the server, you must ensure that your system contains the required prerequisite software listed below. @@ -64,7 +64,7 @@ subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extr -## Install and Configure the edb.repo File +## Install and configure the edb.repo file To create an EnterpriseDB repository configuration file, assume superuser privileges and invoke the following command: @@ -80,7 +80,7 @@ sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo To request credentials for the repository, contact [EDB](https://www.enterprisedb.com/repository-access-request). -## Install the PEM Server +## Install the PEM server After meeting the platform-specific prerequisites listed above, you can use yum to install the PEM Server: diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx index 4593929441b..eb55af7404f 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel8_x86.mdx @@ -59,7 +59,7 @@ subscription-manager repos --enable "codeready-builder-for-rhel-8-${ARCH}-rpms" ``` -## Install and Configure the edb.repo File +## Install and configure the edb.repo file To create an EnterpriseDB repository configuration file, assume superuser privileges and invoke the following command: @@ -75,7 +75,7 @@ sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo To request credentials for the repository, contact [EDB](https://www.enterprisedb.com/repository-access-request). -## Install the PEM Server +## Install the PEM server After meeting the platform-specific prerequisites listed above, you can use dnf to install the PEM Server: From eaf49ff9f9bcbf3753b22a5f2a60ce5c80619792 Mon Sep 17 00:00:00 2001 From: drothery-edb Date: Mon, 9 May 2022 06:19:17 -0400 Subject: [PATCH 30/32] fixed RH 7 link --- .../pem/8/installing_pem_server/installing_on_linux/index.mdx | 2 +- .../installing_on_linux/using_edb_repository/x86/index.mdx | 2 +- .../using_edb_repository/x86/pem_server_rhel7_x86.mdx | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/index.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/index.mdx index 64f3503cba3..533f9e76f39 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/index.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/index.mdx @@ -26,4 +26,4 @@ The `edb-pem` package installs the PEM Server, a PEM Agent, and the required sof - For detailed information about installing a standalone PEM Agent, see [Installing the PEM agent](../../installing_pem_agent). -- For troubleshooting the installation or configuration of the PEM server, see [Troubleshooting PEM server](../../troubleshooting_server/). +- For troubleshooting the installation or configuration of the PEM server, see [Troubleshooting server installation](../../troubleshooting_server/). diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/index.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/index.mdx index 3ac4bec73a7..081963e42e9 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/index.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/index.mdx @@ -1,6 +1,6 @@ --- title: "Installing the PEM server on x86" -navTitle: "Intel x86 (AMD64)" +navTitle: "Intel x86 (amd64)" navigation: - pem_server_rhel8_x86 diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx index 2c96359de00..92813bb215e 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_rhel7_x86.mdx @@ -26,9 +26,9 @@ subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extr ## Prerequisites -- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](/epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](/epas/latest) or [PostgresSQL](/supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. - 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/epas_inst_linux) or [Installing PostgreSQL](/supported-open-source/postgresql/installer/). 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. From 6638bb724b9e989109820b210faa567266db9520 Mon Sep 17 00:00:00 2001 From: drothery-edb Date: Mon, 9 May 2022 07:36:10 -0400 Subject: [PATCH 31/32] fixing conflict resolution --- .../using_edb_repository/x86/pem_server_centos7_x86.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx index 7e36a155073..677c677ffe5 100644 --- a/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx +++ b/product_docs/docs/pem/8/installing_pem_server/installing_on_linux/using_edb_repository/x86/pem_server_centos7_x86.mdx @@ -16,9 +16,9 @@ yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarc ## Prerequisites -- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](/epas/latest) or [PostgresSQL](supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. +- Postres Enterprise Manager requires a Postgres server running either [EDB Postgres Advanced Server](/epas/latest) or [PostgresSQL](/supported-open-source/postgresql/) version 11 or later to hold the Postgres Enterprise Manager backend database. - 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/epas_inst_linux) or [Installing PostgreSQL](docs/supported-open-source/postgresql/installer/). + 1. Install the Postgres server. See [Installing EDB Postgres Advanced Server on Linux](/epas/latest/epas_inst_linux) or [Installing PostgreSQL](/supported-open-source/postgresql/installer/). 2. Configure authentication on the Postgres server by updating the pg_hba.conf file. The pg_hba.conf file manages connections. You must ensure that the pg_hba.conf file allows connections from the PEM server, the monitoring PEM agent, and the host of the Apache web server server. From 31ee0250aaf30fae2e86cac28c2a8cb70f86b8bc Mon Sep 17 00:00:00 2001 From: drothery-edb Date: Mon, 9 May 2022 15:07:53 -0400 Subject: [PATCH 32/32] BART: removing v2.5 - EOL'ed --- .../bart/2.5/bart_inst/02_installing_bart.mdx | 435 ----- .../2.5/bart_inst/03_configuring_bart.mdx | 645 ------- .../bart/2.5/bart_inst/04_upgrading_bart.mdx | 79 - .../2.5/bart_inst/05_uninstalling_bart.mdx | 52 - .../bart/2.5/bart_inst/images/EDB_logo.png | 3 - .../docs/bart/2.5/bart_inst/images/edb.png | 3 - .../bart/2.5/bart_inst/images/edb_logo.svg | 19 - .../bart/2.5/bart_inst/images/edblogo.png | 3 - .../docs/bart/2.5/bart_inst/index.mdx | 56 - .../bart/2.5/bart_qs_7/images/EDB_logo.png | 3 - .../docs/bart/2.5/bart_qs_7/images/edb.png | 3 - .../bart/2.5/bart_qs_7/images/edb_logo.svg | 19 - .../docs/bart/2.5/bart_qs_7/images/image2.png | 3 - .../docs/bart/2.5/bart_qs_7/index.mdx | 325 ---- .../bart/2.5/bart_qs_8/images/EDB_logo.png | 3 - .../docs/bart/2.5/bart_qs_8/images/edb.png | 3 - .../bart/2.5/bart_qs_8/images/edb_logo.svg | 19 - .../docs/bart/2.5/bart_qs_8/images/image2.png | 3 - .../docs/bart/2.5/bart_qs_8/index.mdx | 321 ---- .../01_backup.mdx | 223 --- .../02_check_config.mdx | 70 - .../03_delete.mdx | 146 -- .../01_bart_subcommands_examples/04_init.mdx | 281 ---- .../05_manage.mdx | 233 --- .../06_restore.mdx | 163 -- .../07_show_servers.mdx | 82 - .../08_show_backups.mdx | 105 -- .../09_verify_chksum.mdx | 46 - .../10_running_the_bart_wal_scanner.mdx | 171 -- .../01_bart_subcommands_examples/index.mdx | 118 -- .../2.5/bart_ref/02_additional_examples.mdx | 1476 ----------------- ...with_local_and_remote_database_servers.mdx | 1390 ---------------- .../bart/2.5/bart_ref/images/EDB_logo.png | 3 - .../docs/bart/2.5/bart_ref/images/edb.png | 3 - .../bart/2.5/bart_ref/images/edb_logo.svg | 19 - .../docs/bart/2.5/bart_ref/images/image2.png | 3 - product_docs/docs/bart/2.5/bart_ref/index.mdx | 47 - .../bart/2.5/bart_user/01_introduction.mdx | 59 - ...al_backup_limitations_and_requirements.mdx | 47 - .../02_concept_overview.mdx | 38 - ..._preparation_for_an_incremental_backup.mdx | 59 - .../04_performing_an_incremental_backup.mdx | 81 - .../05_restoring_an_incremental_backup.mdx | 47 - .../index.mdx | 29 - .../02_creating_a_backup_chain.mdx | 27 - .../bart/2.5/bart_user/02_overview/index.mdx | 102 -- .../01_performing_a_restore_operation.mdx | 62 - .../02_point_in_time_recovery_operation.mdx | 56 - .../01_bart_management_overview/index.mdx | 39 - ...aging_backups_using_a_retention_policy.mdx | 28 - .../02_marking_the_backup_status.mdx | 30 - .../03_setting_the_retention_policy.mdx | 87 - ..._backups_based_on_the_retention_policy.mdx | 152 -- .../05_managing_incremental_backups.mdx | 56 - .../index.mdx | 32 - .../01_check_config.mdx | 40 - .../02_init.mdx | 46 - .../03_backup.mdx | 109 -- .../04_show_servers.mdx | 26 - .../05_show_backups.mdx | 30 - .../06_verify_chksum.mdx | 34 - .../07_manage.mdx | 67 - .../08_restore.mdx | 51 - .../09_delete.mdx | 39 - .../03_basic_bart_subcommand_usage/index.mdx | 55 - .../04_running_the_bart_wal_scanner.mdx | 61 - .../2.5/bart_user/03_using_bart/index.mdx | 24 - .../2.5/bart_user/04_using_tablespaces.mdx | 64 - .../bart/2.5/bart_user/images/EDB_logo.png | 3 - .../docs/bart/2.5/bart_user/images/copy_1.png | 3 - .../docs/bart/2.5/bart_user/images/edb.png | 3 - .../bart/2.5/bart_user/images/edb_logo.svg | 19 - .../docs/bart/2.5/bart_user/index.mdx | 38 - product_docs/docs/bart/2.5/index.mdx | 25 - static/_redirects | 1 + 75 files changed, 1 insertion(+), 8344 deletions(-) delete mode 100644 product_docs/docs/bart/2.5/bart_inst/02_installing_bart.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_inst/03_configuring_bart.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_inst/04_upgrading_bart.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_inst/05_uninstalling_bart.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_inst/images/EDB_logo.png delete mode 100644 product_docs/docs/bart/2.5/bart_inst/images/edb.png delete mode 100644 product_docs/docs/bart/2.5/bart_inst/images/edb_logo.svg delete mode 100644 product_docs/docs/bart/2.5/bart_inst/images/edblogo.png delete mode 100644 product_docs/docs/bart/2.5/bart_inst/index.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_qs_7/images/EDB_logo.png delete mode 100644 product_docs/docs/bart/2.5/bart_qs_7/images/edb.png delete mode 100644 product_docs/docs/bart/2.5/bart_qs_7/images/edb_logo.svg delete mode 100644 product_docs/docs/bart/2.5/bart_qs_7/images/image2.png delete mode 100644 product_docs/docs/bart/2.5/bart_qs_7/index.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_qs_8/images/EDB_logo.png delete mode 100644 product_docs/docs/bart/2.5/bart_qs_8/images/edb.png delete mode 100644 product_docs/docs/bart/2.5/bart_qs_8/images/edb_logo.svg delete mode 100644 product_docs/docs/bart/2.5/bart_qs_8/images/image2.png delete mode 100644 product_docs/docs/bart/2.5/bart_qs_8/index.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/01_backup.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/02_check_config.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/03_delete.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/04_init.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/05_manage.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/06_restore.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/07_show_servers.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/08_show_backups.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/09_verify_chksum.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/10_running_the_bart_wal_scanner.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/index.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_ref/02_additional_examples.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_ref/03_sample_bart_system_with_local_and_remote_database_servers.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_ref/images/EDB_logo.png delete mode 100644 product_docs/docs/bart/2.5/bart_ref/images/edb.png delete mode 100644 product_docs/docs/bart/2.5/bart_ref/images/edb_logo.svg delete mode 100644 product_docs/docs/bart/2.5/bart_ref/images/image2.png delete mode 100644 product_docs/docs/bart/2.5/bart_ref/index.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/01_introduction.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/01_incremental_backup_limitations_and_requirements.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/02_concept_overview.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/03_wal_scanning_preparation_for_an_incremental_backup.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/04_performing_an_incremental_backup.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/05_restoring_an_incremental_backup.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/index.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/02_overview/02_creating_a_backup_chain.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/02_overview/index.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/01_bart_management_overview/01_performing_a_restore_operation.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/01_bart_management_overview/02_point_in_time_recovery_operation.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/01_bart_management_overview/index.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/01_overview_managing_backups_using_a_retention_policy.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/02_marking_the_backup_status.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/03_setting_the_retention_policy.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/04_managing_the_backups_based_on_the_retention_policy.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/05_managing_incremental_backups.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/index.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/01_check_config.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/02_init.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/03_backup.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/04_show_servers.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/05_show_backups.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/06_verify_chksum.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/07_manage.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/08_restore.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/09_delete.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/index.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/04_running_the_bart_wal_scanner.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/03_using_bart/index.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/04_using_tablespaces.mdx delete mode 100644 product_docs/docs/bart/2.5/bart_user/images/EDB_logo.png delete mode 100644 product_docs/docs/bart/2.5/bart_user/images/copy_1.png delete mode 100644 product_docs/docs/bart/2.5/bart_user/images/edb.png delete mode 100644 product_docs/docs/bart/2.5/bart_user/images/edb_logo.svg delete mode 100644 product_docs/docs/bart/2.5/bart_user/index.mdx delete mode 100644 product_docs/docs/bart/2.5/index.mdx diff --git a/product_docs/docs/bart/2.5/bart_inst/02_installing_bart.mdx b/product_docs/docs/bart/2.5/bart_inst/02_installing_bart.mdx deleted file mode 100644 index 09fbd867bbf..00000000000 --- a/product_docs/docs/bart/2.5/bart_inst/02_installing_bart.mdx +++ /dev/null @@ -1,435 +0,0 @@ ---- -title: 'Installing BART' - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.4/installing_bart.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.5/installing_bart.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.7/installing_bart.html" ---- - -This section will walk you through performing a fresh installation of BART on a host. Installation instructions are organized into the following platform/installer specific sections: - -- [Installing BART on a CentOS/Rocky Linux/AlmaLinux Host](#installing-bart-on-a-centos-host) -- [Installing BART on a RHEL Host](#installing-bart-on-a-rhel-host) -- [Installing BART on a RHEL/CentOS 7 PPCLE Host](#installing-bart-on-a-rhelcentos-7-ppcle-host) -- [Installing BART on a Debian or Ubuntu Host](#installing-bart-on-a-debian-or-ubuntu-host) -- [Installing BART on an SLES 12 Host](#installing-bart-on-an-sles-12-host) - -!!! Note - If you are using the pdf version of this document, using the cut/paste command to copy may result in extra spaces or carriage returns in the pasted command. If a command fails, check the command carefully for additional characters. - -## Installing BART on a CentOS/Rocky Linux/AlmaLinux Host - -The following section demonstrates installing BART on a CentOS/Rocky Linux/AlmaLinux host using an RPM package.  This section assumes that the user has some knowledge of installation and system administration procedures, and has administrative privileges on the host. - -1. To install the repository configuration, assume superuser privileges and invoke one of the following platform-specific commands: - - On CentOS 7: - - ```text - yum -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm - ``` - - On Rocky Linux 8 or AlmaLinux 8: - - ```text - dnf -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm - ``` - -2. Replace the `USERNAME:PASSWORD` in the following command with the username and password of a registered EnterpriseDB user: - - ```text - sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo - ``` - - To request credentials for the repository, visit the [EDB website](https://www.enterprisedb.com/user). - -3. Before installing BART, execute the following command to install the Extra Packages for Enterprise Linux (EPEL) release package: - - On CentOS 7: - - ```text - yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm - ``` - - On Rocky Linux 8 or AlmaLinux 8: - - ```text - dnf -y install epel-release - ``` - -4. For Rocky Linux 8 or AlmaLinux 8, enable the PowerTools repository to satisfy EPEL package dependencies: - - ```text - dnf config-manager --set-enabled PowerTools - ``` - -5. For Rocky Linux 8 or AlmaLinux 8, disable the built-in PostgreSQL module: - - ```text - dnf -qy module disable postgresql - ``` - -6. Optionally, install the `pg_basebackup` utility program using the server client package. If you do not already have the `pg_basebackup` program installed on the BART host, you can install a limited number of files that include the `pg_basebackup` program by invoking the following command: - - On CentOS 7: - - ```text - yum install edb-as-server-client - ``` - - On Rocky Linux 8 or AlmaLinux 8: - - ```text - dnf install edb-as-server-client - ``` - - In the above command, replace `` with the required Advanced Server version. The `pg_basebackup` version must be the same or more recent than the database server to be backed up. For example, `pg_basebackup` version 10 can be used to back up database server version 10, but cannot be used to back up database server version 11. - -7. Use the following command to install BART: - - On CentOS 7: - - ```text - yum -y install edb-bart-2.5.9 - ``` - - On Rocky Linux 8 or AlmaLinux 8: - - ```text - dnf -y install edb-bart-2.5.9 - ``` - - Repeat the installation process described in this section to install BART on each remote host on which an incremental backup is to be restored. - - To verify the BART installation, navigate to the `/usr/edb/bart/bin` directory and execute the following command: - - ```text - bart --version - ``` - - The `bart --version` command should return the current BART version. If the `bart --version` command returns an error stating the PATH is not available after switching from the root user to another BART user account, adjust the setting of the `PATH` environment variable to include the directory location of the BART `bin` subdirectory in the `~/.bashrc` or `~/.bash_profile` files of the following user accounts: - - - The BART user account on the BART host. See [Configuring BART](03_configuring_bart/#path) for details. - - The remote user account on the remote host to which incremental backups are to be restored. For details, see the *EDB Backup and Recovery User Guide* available at the [EDB website](/bart/latest/bart_user/). - - Upon successful installation, BART is installed in the `BART_HOME` directory: - - `/usr/edb/bart` - - The installation includes the following files: - -| File Name | Location | Description | -| ------------------- | ----------------- | ------------------------------------- | -| bart | ``/bin | BART command line, executable program | -| bart-scanner | ``/bin | BART WAL scanner program | -| bart.cfg.sample | ``/etc | Sample BART configuration file | -| xlogreader_ident.so | ``/lib | Libraries supporting WAL versions | -| bart_license.txt | `` | License agreement | - -After BART is installed successfully, you need to [configure the installation](03_configuring_bart/#configuration). - -## Installing BART on a RHEL Host - -The following section demonstrates installing BART on a RHEL host using an RPM package.  This section assumes that the user has some knowledge of installation and system administration procedures, and has administrative privileges on the host. - -1. To install the repository configuration, assume superuser privileges and invoke one of the following platform-specific commands: - - On RHEL 7: - - ```text - yum -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm - ``` - - On RHEL 8: - - ```text - dnf -y install https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm - ``` - -2. Replace the `USERNAME:PASSWORD` in the following command with the username and password of a registered EnterpriseDB user: - - ```text - sed -i "s@:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo - ``` - - To request credentials for the repository, visit the [EDB website](https://www.enterprisedb.com/user). - -3. Before installing BART, execute the following command to install the Extra Packages for Enterprise Linux (EPEL) release package: - - On RHEL 7: - - ```text - yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm - ``` - - On RHEL 8: - - ```text - dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm - ``` - -4. Enable the repository: - - On RHEL 7, enable the `optional, extras`, and `HA` repositories to satisfy EPEL package dependencies: - - ```text - subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extras-rpms" --enable "rhel-ha-for-rhel-*-server-rpms" - ``` - - On RHEL 8, enable the `codeready-builder-for-rhel-8-*-rpms` repository to satisfy EPEL packages dependency: - - ```text - ARCH=$( /bin/arch ) - - subscription-manager repos --enable "codeready-builder-for-rhel-8-${ARCH}-rpms" - ``` - -5. For RHEL 8, disable the built-in PostgreSQL module: - - ```text - dnf -qy module disable postgresql - ``` - -6. Optionally, install the `pg_basebackup` utility program using the server client package. If you do not already have the `pg_basebackup` program installed on the BART host, you can install a limited number of files that include the `pg_basebackup` program by invoking the following command: - - On RHEL 7: - - ```text - yum install edb-as-server-client - ``` - - On RHEL 8: - - ```text - dnf install edb-as-server-client - ``` - - In the above command, replace `` with the required Advanced Server version. The `pg_basebackup` version must be the same or more recent than the database server to be backed up. For example, `pg_basebackup` version 10 can be used to back up database server version 10, but cannot be used to back up database server version 11. - -7. Use the following command to install the BART: - - On RHEL 7: - - ```text - yum -y install edb-bart-2.5.9 - ``` - - On RHEL 8: - - ```text - dnf -y install edb-bart-2.5.9 - ``` - - Repeat the installation process described in this section to install BART on each remote host on which an incremental backup is to be restored. - - To verify the BART installation, navigate to the `/usr/edb/bart/bin` directory and execute the following command: - - ```text - bart --version - ``` - - The `bart --version` command should return the current BART version. If the `bart --version` command returns an error stating the PATH is not available after switching from the root user to another BART user account, adjust the setting of the `PATH` environment variable to include the directory location of the BART `bin` subdirectory in the `~/.bashrc` or `~/.bash_profile` files of the following user accounts: - - - The BART user account on the BART host. See [Configuring BART](03_configuring_bart/#path) for details. - - The remote user account on the remote host to which incremental backups are to be restored. For details, see the *EDB Backup and Recovery User Guide* available at the [EDB website](/bart/latest/bart_user/). - - Upon successful installation, BART is installed in the `BART_HOME` directory: - - `/usr/edb/bart` - - The installation includes the following files: - -| File Name | Location | Description | -| ------------------- | ----------------- | ------------------------------------- | -| bart | ``/bin | BART command line, executable program | -| bart-scanner | ``/bin | BART WAL scanner program | -| bart.cfg.sample | ``/etc | Sample BART configuration file | -| xlogreader_ident.so | ``/lib | Libraries supporting WAL versions | -| bart_license.txt | `` | License agreement | - -After BART is installed successfully, you need to [configure the installation](03_configuring_bart/#configuration). - - - -## Installing BART on a RHEL/CentOS 7 PPCLE Host - -The following section demonstrates installing BART on a RHEL host using an RPM package.  This section assumes that the user has some knowledge of installation and system administration procedures, and has administrative privileges on the host. - -1. Install Advance Toolchain: - - ```text - rpm --import https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/redhat/RHEL7/gpg-pubkey-6976a827-5164221b - - cat > /etc/yum.repos.d/advance-toolchain.repo <:@USERNAME:PASSWORD@" /etc/yum.repos.d/edb.repo - ``` - - To request credentials for the repository, visit the [EDB website](https://www.enterprisedb.com/user). - -4. Before installing BART, execute the following command to install the Extra Packages for Enterprise Linux (EPEL) release package: - - ```text - yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm - ``` - -5. On RHEL 7, enable the `optional, extras`, and `HA` repositories to satisfy EPEL package dependencies: - - ```text - subscription-manager repos --enable "rhel-*-optional-rpms" --enable "rhel-*-extras-rpms" --enable "rhel-ha-for-rhel-*-server-rpms" - ``` - -6. Invoke the following command to install BART: - - ```text - yum -y install edb-bart-2.5.9 - ``` - - - -## Installing BART on a Debian or Ubuntu Host - -Perform the following steps to install a Debian package using the EnterpriseDB apt repository. - -To request credentials for the repository, visit the [EDB website](https://www.enterprisedb.com/repository-access-request). - -1. Assume the superuser privileges. - - ```text - sudo su - - ``` - -2. To configure the EnterpriseDB repository on Debian 9 and Ubuntu 18: - - ```text - sh -c 'echo "deb https://username:password@apt.enterprisedb.com/$(lsb_release -cs)-edb/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/edb-$(lsb_release -cs).list' - ``` - - On Debian 10: - - a. Set up the EnterpriseDB repository: - - ```text - sh -c 'echo "deb [arch=amd64] https://apt.enterprisedb.com/$(lsb_release -cs)-edb/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/edb-$(lsb_release -cs).list' - ``` - - b. Substitute your EnterpriseDB credentials for the `username` and `password` placeholders in the following command: - - ```text - sh -c 'echo "machine apt.enterprisedb.com login password " > /etc/apt/auth.conf.d/edb.conf' - ``` - -3. Add support to your system for secure APT repositories. - - ```text - apt-get install apt-transport-https - ``` - -4. Add the EDB signing key; When invoking the command, replace the `username` and `password` with the credentials provided by EnterpriseDB. - - ```text - wget -q -O - https://apt.enterprisedb.com/edb-deb.gpg.key | apt-key add – - ``` - -5. Update the repository metadata. - - ```text - apt-get update - ``` - -6. Install the Debian package: - - a. Contact [EDB Support](https://support.enterprisedb.com) for information about how to install the BART 2.5.9 package. - - b. Navigate to the download directory and execute the following command: - - ```text - apt-get install ./edb-bart_2.5.9-1-deb10_amd64.deb - ``` - - - -## Installing BART on an SLES 12 Host - -This section provides instructions for installing BART on an SLES 12 SP4 host using the zypper package manager. BART is supported on SLES SP4 and SP5 versions. - -1. Assume superuser privileges. - - ```text - sudo su - - ``` - -2. Use the following command to add the EDB repository to your SLES host: - - ```text - zypper addrepo https://zypp.enterprisedb.com/suse/edb-sles.repo - ``` - -3. Invoke the following command to refresh the metadata: - - ```text - zypper refresh - ``` - -4. Install `SUSEConnect` to register the host with SUSE to allow access to SUSE repositories: - - ```text - zypper install SUSEConnect - ``` - -5. Register the host with SUSE to allow access to SUSE repositories and replace `'REGISTRATION_CODE'` and `'EMAIL'` with your SUSE registration information: - - ```text - SUSEConnect -r 'REGISTRATION_CODE' -e 'EMAIL' - ``` - - ```text - SUSEConnect -p PackageHub/12.4/x86_64 - ``` - - ```text - SUSEConnect -p sle-sdk/12.4/x86_64 - ``` - -6. Install the following repository for PEM dependencies: - - ```text - zypper addrepo https://download.opensuse.org/repositories/Apache:/Modules/SLE_12_SP4/Apache:Modules.repo - ``` - -7. Refresh the metadata: - - ```text - zypper refresh - ``` - -8. Then, use the zypper utility to install BART: - - ```text - zypper install edb-bart-2.5.9 - ``` diff --git a/product_docs/docs/bart/2.5/bart_inst/03_configuring_bart.mdx b/product_docs/docs/bart/2.5/bart_inst/03_configuring_bart.mdx deleted file mode 100644 index c3e8f23d1ba..00000000000 --- a/product_docs/docs/bart/2.5/bart_inst/03_configuring_bart.mdx +++ /dev/null @@ -1,645 +0,0 @@ ---- -title: "Configuring BART" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.4/configuring_bart.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.5/configuring_bart.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.7/configuring_bart.html" ---- - - - -To configure BART, you must establish the BART user account, [configure the BART host](#configuring-the-bart-host), and [configure the database server](#configuring_database_server) that will be backed up. - - - -## Establishing the BART User Account - -The BART user account is an operating system user that will run the BART command line program. The BART user account must: - -- own the BART backup catalog. -- be able to run the `bart` program and the `bart-scanner` program. -- be able to establish a SSH/SCP connection to and from each database server managed by BART. - -You can optionally use the `enterprisedb` database user as the BART user account for an Advanced Server database and `postgres` database user as the BART user account for a PostgreSQL server. If you do not wish to use an existing database user as the BART user account, you must create an operating system user to assume the role. - - - -## Configuring BART and Database Server - -As stated earlier, to configure BART, you must [configure the BART host](#configuring-the-bart-host) as well as the [database server](#configuring_database_server). The following table acts as a configuration parameter reference listing the mandatory and optional parameters with default values for `[SERVER]` as well as `[BART]` sections. - -- Parameters set in the `[BART]` section are applicable to all BART managed database servers. -- Parameters set in the `Server` section are applicable only to the specific server; the `Server` parameter setting overrides the `[BART]` section setting. - -For information about configuring BART host parameters, see the [BART Host Parameter Reference](#bart) and for information about configuring the database server parameters, see the [Database Server Parameter Reference](#server). - -| **Parameter** | **Type** | **Default** | **\[SERVER]** | **\[BART]** | -| -------------------------- | --------- | ------------------------------------------------------------ | ------------- | ----------- | -| `[BART]` | Mandatory | N/A | N/A | Yes | -| `` | Mandatory | N/A | N/A | Yes | -| `` | Mandatory | N/A | N/A | Yes | -| `` | Mandatory | N/A | N/A | Yes | -| `retention_policy` | Optional | `BACKUPS` | Yes | Yes | -| `wal_compression` | Optional | `Disabled` | Yes | Yes | -| `copy_wals_during_restore` | Optional | `Disabled` | Yes | Yes | -| `xlog_method` | Optional | `fetch` | Yes | Yes | -| `logfile` | Optional | `/tmp/bart.log` | N/A | Yes | -| `scanner_logfile` | Optional | `/tmp/bart_scanner.log` | N/A | Yes | -| `` | Optional | `/tmp` | N/A | Yes | -| `` | Optional | `` | N/A | Yes | -| `` | Optional | `1` | Yes | Yes | -| `` | Optional | `49152` | Yes | Yes | -| `` | Optional | `0` | Yes | Yes | -| `` | Optional | `20 seconds` | Yes | Yes | -| `` | Optional | `1` | Yes | Yes | -| `[Server Name]` | Mandatory | N/A | Yes | N/A | -| `` | Optional | N/A | Yes | N/A | -| `host` | Mandatory | N/A | Yes | N/A | -| `port` | Mandatory | `5444` for EPAS; `5432` for Postgres | Yes | N/A | -| `user` | Mandatory | N/A | Yes | N/A | -| `` | Optional | `BART backup catalog` | Yes | N/A | -| `` | Optional | N/A | Yes | N/A | -| `` | Mandatory | `enterprisedb` for EPAS

`postgres` for PostgreSQL | Yes | N/A | -| `` | Optional | N/A | Yes | N/A | -| `` | Optional | N/A | Yes | N/A | -| `allow_incremental_backup` | Optional | `Disabled` | Yes | N/A | -| `description` | Optional | N/A | Yes | N/A | - - - -### Configuring the BART Host - -To configure the BART host, perform the following steps on the BART host as a root user: - -**Step 1.** Navigate to the `usr/edb/bart/etc` directory and make a copy of the `bart.cfg.sample` file to create the `bart.cfg` file that will contain the parameter settings. - -**Step 2.** Confirm that the Postgres `pg_basebackup` utility program is installed on the BART host. The `pg_basebackup` utility resides in the `bin` directory under your Postgres installation. - - - -**Step 3.** Ensure the `LD_LIBRARY_PATH` environment variable includes the location of the `libpq` library. If your `libpq` library does not reside in the default location (`POSTGRES_INSTALL_HOME/lib`), you must add the library path to the `LD_LIBRARY_PATH` environment variable in the BART user account’s profile (`bash_profile`) located in `/home/`: - -```text -# .bash_profile -# Get the aliases and functions -if [ -f ~/.bashrc ]; then -. ~/.bashrc -fi -# User specific environment and startup programs -export LD_LIBRARY_PATH=/usr/edb/as11/lib:$LD_LIBRARY_PATH -``` - -**Step 4.** Create the BART backup catalog and ensure the BART user account holds privileges on the BART backup catalog. In the following example, the BART configuration file specifies `/opt/backup` as the parent directory for the BART backup catalog in the `` parameter: - -```text -[BART] - -bart_host = bartuser@192.168.2.22 -backup_path = /opt/backup -pg_basebackup_path = /usr/edb/as11/bin/pg_basebackup -logfile = /tmp/bart.log -scanner_logfile = /tmp/bart_scanner.log -``` - -In the following example, `bartuser` is the BART user account. The example creates and sets the ownership and permissions on the BART backup catalog: - -```text -su root -mkdir /opt/backup -chown bartuser /opt/backup -chgrp bartuser /opt/backup -chmod 700 /opt/backup -``` - -If the subdirectory does not exist, BART creates a subdirectory for each database server listed in the configuration file when you invoke the `bart` command line program. - -**Step 5.** Use your choice of editor to open the BART configuration file (located in the `usr/edb/bart/etc` directory) and edit the configuration as required. You must add the mandatory parameters to the `[BART]` section. Default values may be used for optional parameters. - -The following table describes the `[BART]` host parameters. - - - -| **Parameters/Placeholder** | **Type** | **Description** | -| -------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `[BART}` | Mandatory | Identifies the global section of the configuration file. It must be named BART. | -| `bart_host` | Mandatory | Specify the bart user name and the IP address of the bart host on which the BART utility resides. You must specify it in the form of <bart_user>@<bart_host_address>. | -| `backup_path` | Mandatory | Specify the path to the file system parent directory where all BART backups are stored. | -| `pg_basebackup_path` | Mandatory | Specify the path to the `pg_basebackup` program that you installed on the BART host. For information about `pg_basebackup` version-specific restrictions, see the EDB Backup and Recovery User Guide available at the [EDB website](/bart/latest/bart_user/). | -| `wal_compression` | Optional | Set this parameter to `enabled` to compress the archived WAL files in gzip format in the BART backup catalog when the `MANAGE` subcommand is invoked. By default it is set to `disabled`. The gzip compression program must be in the BART user account’s `PATH` and the WAL compression setting must not be enabled for those database servers where you need to take incremental backups. | -| `copy_wals_during_restore` | Optional | Set this parameter to `enabled` to copy the archived WAL files from the BART backup catalog to the `restore_path/archived_wals` directory prior to the database server archive recovery. Enabling this option helps you save time during the restore operation. Set this parameter to `disabled` (default) to retrieve the archived WAL files directly from the BART backup catalog during the database server archive recovery. During the restore operation, recovery settings will be saved in the `postgresql.auto.conf` file. The `restore_command` in the `postgresql.auto.conf` file will be determined by the value specified in the `copy_wals_during_restore` parameter. If the `RESTORE` subcommand is invoked with the `-c` option, the archived WAL files are copied from the BART backup catalog to the `restore_path/archived_wals` directory, thus overriding any setting of the `copy_wals_during_restore` parameter. If the `RESTORE` subcommand is invoked without the `-c` option, the value specified by the `copy_wals_during_restore` parameter is used. | -| `xlog_method` | Optional | Specify how the transaction log is collected during the execution of `pg_basebackup` through the `BACKUP` subcommand. Set `xlog_method` to `fetch` (default) to collect the transaction log files after the backup is completed. Set to `stream` to stream the transaction log in parallel with the full backup creation. | -| `retention_policy` | Optional | Set this parameter to determine when an active backup should be marked as `obsolete` when the `MANAGE` subcommand is used. You can specify the retention policy either in terms of number of backups or duration (days, weeks, or months). ` BACKUPS` (default), ` DAYS`, ` WEEKS`, or ` MONTHS` where `` is a positive integer. For information about managing backups using a retention policy, see the EDB Backup and Recovery User Guide available at the [EDB website](/bart/latest/bart_user/). | -| `logfile` | Optional | Use this parameter to specify the path to the BART log file. The default log file location is `/tmp/bart.log`. The log file will be created the first time you invoke the `bart` command line program using the sample configuration file value. To change the default setting, you must delete the `bart.log` file from the `/tmp` directory and create a new log file in another directory so that a new log file will be created and owned by the new BART user account. If no path to a log file is specified, BART does not create a log file. | -| `scanner_logfile` | Optional | Use this parameter to specify the path to the XLOG/WAL scanner log file. The default location is `/tmp/bart_scanner.log`. The scanner log file will be created the first time you invoke the `bart_scanner` program using the sample configuration file value. To change the default setting, you must delete the `bart_scanner.log` file from the `/tmp` directory and create a new log file in another directory so that a new log file will be created and owned by the new BART user account. If no path to a log file is specified, BART does not create a WAL scanner log file. | -| `` | Optional | Specify the socket directory path where all BART sockets will be stored. The default directory is `/tmp`. While specifying the `bart_socket_directory` path, you must ensure that the directory exists and the BART user has the required access permissions to the directory. | -| `` | Optional | Specify a user-friendly BART socket file name. Using this option overrides the default BART socket name generated using MD5 checksum. You must shut down the bart-scanner before setting this option. You can view the `` in the `sockPath` field after starting the bart-scanner in the debug mode. This option helps in preventing the use of MD5 during the bart-scanner startup, thus making BART more compliant in FIPS mode. | -| `` | Optional | Specify the number of worker threads for copying blocks (for incremental backups) or data files (for full backup) from the database server to the `archive_path` when the `BACKUP` subcommand is invoked. The default value is `1`. The same set of worker threads are used for the compression operation when taking full backups in order to provide parallel, compressed backups when the `BACKUP` subcommand is specified with the `-z` or `-c` options. The compression operation does not apply to incremental backups. See [thread count](#thread_count) for more information. | -| `` | Optional | Specify the number of blocks of memory used for copying modified blocks from the database server to the `archive_path` when the `BACKUP` subcommand is invoked for incremental backups. The default value is 49152 blocks; each block is 8192 bytes. The maximum permitted value is 131072 blocks and the minimum permitted value is 1 block. Reduce the `` setting if the server runs out of memory while executing the `pg_read_binary_file()`. | -| `` | Optional | Specify the number of seconds after which the WAL scanner should initiate force scanning of the new WAL files. The default value is 0, which means no brute-force scanning will be started. After upgrading to the latest version of BART, users who have set this parameter to a non-default value may see increased CPU consumption on the part of bart-scanner. If this is an issue, consider increasing the configured value of `scan_interval` parameter, or removing the setting if it is not required. | -| `` | Optional | Specify the number of seconds to wait for MBM files before timing out; this parameter is applicable only for incremental backup. You must set the `scan_interval` to a value significantly less than the MBM scan timeout. The default value is 20 seconds. The `mbm_scan_timeout` parameter value must be greater than 0. If the value is 0 or negative, then an error will be displayed during an incremental backup. | -| `` | Optional | Specify the number of parallel worker processes required to stream the modified blocks of an incremental backup to the restore host. The default value is 1. | - - - -**Thread Count** - -If the `BACKUP` subcommand is invoked with the `--thread-count` option, then the number of worker threads specified by this option overrides any setting of the `thread_count` parameter in the BART configuration file. If the `BACKUP` subcommand is invoked without the `--thread-count` option, then the following determines the number of worker threads used: - -- The setting of the `thread_count` parameter in the server section of the BART configuration file overrides the setting of `thread_count` in the global section for that particular database server. -- If omitted in the server section, the setting of `thread_count` in the global section is used. -- If the `thread_count` parameter is not specified in either section, the default is 1. -- When taking a full backup, if the `thread count` in effect is only 1, then the `pg_basebackup` utility is used to take the full backup unless the `--no-pg_basebackup` option is specified with the `BACKUP` subcommand. - -`` will not be effective if the backup is taken on a standby server. - -If parallel backup is run with `N` number of worker threads, then it will initiate `N + 1` concurrent connections with the server. - -**Step 6** Invoke the `CHECK-CONFIG` subcommand, omitting the `-s` option to check the parameter settings in the BART configuration file. It should return the current BART version. - -```text -bart CHECK-CONFIG -``` - -The `CHECK-CONFIG` subcommand displays an error message if the required configuration is not properly set. You need to check the logfile to fix this. - - - -### Configuring the Database Server - -To configure the database server, you must: - -1. [Authorize SSH/SCP access without a password prompt](#authorizing_ssh_scp_access). -2. [Create and configure a replication database user](#setting_up_a_replication_database_user). -3. [Adding the database server to the configuration file (server section)](#adding_a_database_server). -4. [Enable WAL archiving of the server](#enabling_wal_archiving). -5. [Verify the server configuration settings](#verifying_configuration_settings). - -The following section will walk you through the configuration process. - -!!! Note - You must authorize SSH/SCP access and set up a replication database user before restarting the database server with WAL archiving enabled. - - - -**Authorizing SSH/SCP Access** - -BART uses the Secure Shell (`ssh`) and Secure Copy (`scp`) Linux utility programs to copy the backup and WAL files from the BART managed database servers to the BART host as well as to restore backups. - -- The client/server `ssh` and `scp` commands must not prompt for a password when establishing a connection with the target server (the server to which a passwordless connection is being made). -- A passwordless connection uses *authorized public keys* (public key of a client user account) to authenticate with the target server. -- You must add the public key of each client user account to the target user account’s authorized public keys list on the target server. - -For BART usage, there are two scenarios that require a passwordless SSH/SCP connection: - -- When connecting from each BART managed database server (SSH/SCP client) to the BART host (target SSH/SCP server) to support WAL archiving as implemented by the `archive_command` parameter. - - In this case, the database server user account should generate the public key file (`id_rsa.pub`) with the `ssh-keygen –t rsa` command on the database server host. - - The public key file name should be appended to the `~/.ssh/authorized_keys` file on the BART host. The `authorized_keys` file is in the BART user account’s home directory. -- When connecting from the BART host (SSH/SCP client) to each BART managed database server (target SSH/SCP server) for taking incremental backups and for supporting restoration of the full backup, the archived WAL files, and the modified blocks, which occurs when the BART `RESTORE` subcommand is given. - - In this case, the BART user account should generate the public key file (`id_rsa.pub`) with the `ssh-keygen –t rsa` command on the BART host. - - The public key file name should be appended to the `~/.ssh/authorized_keys` file on the database server host. The `authorized_keys` file is in the home directory of the user account that owns the directory where the database backup is to be restored. -- If backups are to be taken from a given database server host, but restored to a different database server host, the passwordless SSH/SCP connections must be configured from the BART host to the database server host from which the backup is to be taken as well as from the BART host to the database server host to which the backup is to be restored. - -See the EDB Backup and Recovery Reference Guide available at the [EDB website](/bart/latest/bart_ref/) to view examples of creating a passwordless connection. - -**Enabling Public Key Authentication** - -The following example enables SSH/SCP access on a CentOS 7.x host; similar (platform-specific) steps will apply to other platforms/versions. - -1. In the SSH server daemon configuration file (`sshd_config`) located in the `/etc/ssh`, set the `PubkeyAuthentication` parameter to `yes`. -2. Reload the configuration file: - -```text -service sshd reload -``` - -If you get any SSH or SCP errors, examine the `/var/log/secure` log file. - -**Creating a Passwordless Connection** - -The following general instructions will walk you through generating a client’s public key file, creating the target server’s authorized public keys file, and creating a passwordless connection. - -**Step 1.** On the client system, log in as the user account that will be initiating the SSH or SCP connection. - -**Step 2.** Navigate to the user account’s home directory and check for an existing `.ssh` subdirectory. If the `.ssh` directory does not exist, create one and assign the required privileges to the user. - -**Step 3.** Generate the public key file with the following command. Accept all prompted defaults and do not specify a passphrase when prompted for one. - -```text -ssh-keygen –t rsa -``` - -The public key file named `id_rsa.pub` is created in the `.ssh` subdirectory. - -**Step 4.** While logged into the client where you just generated the public key file, use `SCP` to make a temporary copy of it on the target server: - -```text -scp ~/.ssh/id_rsa.pub @:tmp.pub -``` - -**Step 5.** Navigate into the target user account’s home directory and check for an existing `.ssh` subdirectory. If it does not exist, create one and assign the required privileges to the user. - -**Step 6.** Append the temporary, client’s public key file, `tmp.pub`, to the `authorized_keys` file. If an `authorized keys` file does not exist, create a new file, but do not completely replace any existing `authorized keys` file. - -```text -cat tmp.pub >> ~/.ssh/authorized_keys -``` - -Make sure the `authorized_keys` file is only accessible by the file owner and not by groups or other users. If the `authorized_keys` file does not have the required permission setting or it was newly created, change the file permissions as follows: - -```text -chmod 600 ~/.ssh/authorized_keys -``` - -**Step 7.** Delete the temporary public key file: - -```text -rm tmp.pub -``` - -Now, when logged into the client system as `user` there should be no prompt for a password when commands such as the following is given: - -```text -ssh target_user@host_address -``` - - - -**Setting up a Replication Database User** - -For each database server that is to be managed by BART, a database user must be chosen to serve as the *replication database user*. The replication database user sets the Postgres `archive_command` configuration parameter when the `INIT` subcommand in invoked and creates backups when the `BACKUP` subcommand is invoked. The replication database user must be a `superuser`. - -When executed with the PSQL client, the following PostgreSQL command creates a superuser to be the replication database user: - -`CREATE ROLE repuser WITH LOGIN SUPERUSER PASSWORD 'password';` - -The `pg_hba.conf` file must minimally permit the replication database user to have access to the database. - -In the following example, the `pg_hba.conf` file permits the `repuser` (replication database user) to have access to the `template1` database. The IP address from which `repuser` has access to `template1` database is the location of the BART host: - -**For pg_basebackup only:** If `pg_basebackup` is to be used for taking any backups (such as for standby servers), the replication database user must also be included in the `pg_hba.conf` file as a `replication` database connection as shown by the last entry in the following example. - -```text -# TYPE DATABASE USER ADDRESS METHOD -# "local" is for Unix domain socket connections only -local all all md5 -# IPv4 local connections: -host template1 repuser 192.168.2.22/32 md5 -host all enterprisedb 127.0.0.1/32 md5 -# IPv6 local connections: -host all all ::1/128 md5 -# Allow replication connections from localhost, by a user with the -# replication privilege. -host replication repuser 192.168.2.22/32 md5 -``` - -The replication database user must be specified for the `user` parameter in the BART configuration file for the database server as shown in the following example: - -```text -[ACCTG] -host = 192.168.2.24 -port = 5444 -user = repuser -cluster_owner = enterprisedb -remote_host = enterprisedb@192.168.2.24 -description = "Accounting" -``` - -There must be no password prompt when connecting to the database server with the replication database user. There are several ways to permit this; one recommended method is to use a `.pgpass` file located in the BART user account’s home directory. - -For example, if `bartuser` is the BART user account, then the `.pgpass` file located in the `/home/bartuser` directory must contain the following entry: - -`192.168.2.24:5444::repuser:password` - -When `bartuser` invokes a BART backup, the password for the replication database user, `repuser`, is obtained from the `.pgpass` file of `bartuser` to connect to the database server running at `192.168.2.24` on `port 5444`. - -The `.pgpass` file must contain an entry for each BART managed database server and its corresponding replication database user and password. - - - -**Adding a Database Server to the BART Configuration File** - -To manage the backup and recovery of a database server, you must add entries to the `[SERVER]` section of the BART configuration file, which is located in `/etc` directory. - - - -*Database Server Parameter Reference* - -Set the following parameters in the \[`SERVER`] section of the BART configuration file. The parameter setting in the \[`SERVER`] section overrides the setting in the global \[`BART`] section for that particular database server. If omitted, the default value will be used. - -For each cluster serviced by BART, the following parameters are mandatory: - -```text -[HR] - -host = 192.168.2.24 -port = 5432 -user = postgres -cluster_owner = postgres -``` - -!!! Note - The port parameter setting is required only if the database server listens on a port other than the default (for example if Postgres listens on a port other than 5432). - -The following table describes the database server parameters. - - - - - - - - - -| **Parameters/Placeholder** | Type | **Description** | -| --------------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `[ServerName]` | Mandatory | Specify the server name that you want to backup using BART. It is not case-sensitive when referenced with BART subcommand options. A lowercase conversion of this name is used to create a subdirectory in the BART backup catalog for storing the backups and WAL files for this database server (for eg., epas12). | -| `` | Optional | Specify a [template](#backup_name_template) for user-defined, friendly names that will be assigned to the backups of the database server. The maximum permitted length of backup name is 49 characters. The `` parameter can be overridden by the `--backup-name` option of the `BACKUP` subcommand. If this parameter is omitted from the BART configuration file, and the `--backup-name` option with a user-defined name is not specified with the `BACKUP` subcommand, then the backup can only be referenced in BART subcommands by the BART assigned, integer backup identifier. | -| `host` | Mandatory | Specify the IP address of the database server to be configured for backup. | -| `port` | Mandatory | Specify the port number identifying the database server instance (that is, the relevant database cluster) to be backed up. The default port number for EPAS is `5444` and for Postgres it is `5432`. The port parameter setting is only required if the database server listens on a port other than the default value. | -| `User` | Mandatory | Specify the replication database user name used by BART to establish the connection to the database server for full backups. See [Setting up a Replication Database User](#setting_up_a_replication_database_user) for more information. | -| `` | Optional | Specify the path where archived WAL files will be stored. The default location is the BART backup catalog (`//archived_wals`). | -| `` | Optional | When the `INIT` subcommand is used, the content and variables specified in the BART `` result in the archive command string to be generated into the `Postgres archive_command` parameter in the `postgresql.auto.conf` file. To configure the BART `` parameter, enclose the command string within single quotes ('). If you do not specify the `` parameter in the configuration file, the default setting is taken as `'scp %p %h:%a/%f'`. See [Archive Command Auto Configuration](#archive_command_auto_configuration) for information about variables. The BART `` parameter in the BART configuration file, and the Postgres `` parameter in the `postgresql.conf` file (or the `postgresql.auto.conf` file) refer to two different parameters that are to be set in different manner. | -| `` | Mandatory | Specify the Linux operating system user account that owns the database cluster. This is typically `enterprisedb` for Advanced Server database clusters installed in the Oracle compatible mode, or `postgres` for Advanced Server database clusters installed in the PostgreSQL compatible mode and PostgreSQL database clusters. | -| `` | Optional | Specify the IP address of the remote server to which a backup is to be restored. Specify this parameter in the form of `@`. `` is the user account on the target database server host that accepts a passwordless SSH/SCP login connection and owns the directory where the backup is to be restored. `` is the IP address of the remote host. For restoring a backup to a remote host or for restoring any backup where `` and the BART user account are not the same users, either this parameter must be set or it may be specified with the `-r` option with the BART `RESTORE` subcommand. | -| `` | Optional | Specify path to which tablespaces are to be restored in the format `OID = `; If the backup is to be restored to a remote host specified by the `` parameter, then the tablespace paths must exist on the remote host. | -| `allow_incremental_backups` | Optional | Set this parameter to `enabled` to enable use of the WAL scanner and permit taking incremental backups when the `BACKUP` subcommand is invoked with the `--parent` option. Set it to `disabled` (default) to disallow incremental backups and thus permit only full backups. For information about using the `BACKUP` subcommand and running the WAL scanner, please see the EDB Backup and Recovery User Guide available at the [EDB website](/bart/latest/bart_user/). | -| `Description` | Optional | Specify the description that will be used to identify the database server. | - -For information regarding the following parameters, see [configuring the BART host](#configuring-the-bart-host). - -- `retention_policy` -- `xlog_method` -- `wal_compression` -- `copy_wals_during_restore`. -- `thread_count`. -- `batch_size`. -- `scan_interval`. -- `mbm_scan_timeout`. -- `workers` - - - -**Backup Name Template** - -- The template is an alphanumeric string that may include the following variables that will be replaced with the timestamp values when the backup is taken: - - - `%year` to be replaced by 4-digit year - - `%month` to be replaced by 2-digit month - - `%day` to be replaced by 2-digit day - - `%hour` to be replaced by 2-digit hour - - `%minute` to be replaced by 2-digit minute - - `%second` to be replaced by 2-digit second - -- To include a percent sign (`%`) as a character in the backup name, specify `%%` in the template. - -- Do not enclose the template string in quotes even if you want the template to include space characters, otherwise the enclosing quotes are stored as part of the backup name. However, when referenced with the `-i` option by BART subcommands use of space characters in the backup name requires enclosing the backup name in quotes. - -The following example shows the configuration settings of three database servers: - -```text -[ACCTG] - -host = 127.0.0.1 -port = 5444 -user = enterprisedb -cluster_owner = enterprisedb -backup_name = acctg_%year-%month-%dayT%hour:%minute:%second -archive_command = 'cp %p %a/%f' -allow_incremental_backups = enabled -retention_policy = 8 BACKUPS -description = "Accounting" - -[MKTG] - -host = 192.168.2.24 -port = 5444 -user = repuser -cluster_owner = enterprisedb -remote_host = enterprisedb@192.168.2.24 -allow_incremental_backups = enabled -description = "Marketing" - -[HR] - -host = 127.0.0.1 -port = 5432 -user = postgres -cluster_owner = postgres -retention_policy = 4 DAYS -description = "Human Resources" -``` - - - -**Enabling WAL Archiving** - -WAL archiving must be enabled for the database server for which BART is to perform backup and recovery management. - -- The WAL Archiving Configuration section describes the manual WAL archiving configuration process. -- The Archive Command Auto Configuration section describes an automated WAL archiving process. - -*WAL Archiving Configuration* - -Set the following configuration parameters in the `postgresql.conf` file to enable WAL archiving - -- Set `wal_level` to `replica` or higher. -- Set `archive_mode` to `on`. -- Set the PostgreSQL `archive_command` parameter to copy the WAL files to the `archive_path`. The `archive_command` configuration parameter mentioned here is located in the `postgresql.conf` file; the PostgreSQL `archive_command` parameter is used in a different manner than the BART [archive_command](#archive_command). -- Set `max_wal_senders` to a value high enough to leave at least one session available for the backup. If the `xlog_method=stream` parameter setting is to be used by this database server, the `max_wal_senders` setting must account for an additional session for the transaction log streaming (the setting must be a minimum of 2). See [Configuring the BART host](#configuring-the-bart-host) for information about the `xlog_method` parameter. - -For detailed information about WAL archiving, see the [PostgreSQL Core Documentation](https://www.postgresql.org/docs/current/static/continuous-archiving.html). - -The `ARCHIVE PATH` field displayed by the BART `SHOW-SERVERS` subcommand displays the full directory path where the WAL files should be copied as specified in the `archive_command` configuration parameter in the `postgresql.conf` file: - -```text --bash-4.1$ bart SHOW-SERVERS -s acctg -SERVER NAME : acctg -HOST NAME : 192.168.2.24 -USER NAME : repuser -PORT : 5444 -REMOTE HOST : -RETENTION POLICY : none -DISK UTILIZATION : 0.00 bytes -NUMBER OF ARCHIVES : 0 -ARCHIVE PATH : /opt/backup/acctg/archived_wals -ARCHIVE COMMAND : (disabled) -XLOG METHOD : fetch -WAL COMPRESSION : disabled -TABLESPACE PATH(s) : -INCREMENTAL BACKUP : DISABLED -DESCRIPTION : "Accounting" -``` - -The parameter settings in the following example will copy the WAL files to a directory named `/opt/backup/acctg/archived_wals` on the BART host located at `192.168.2.22` as the `bartuser` user account. Using the `bartuser` account ensures that the operation will have sufficient permissions to copy to the BART backup catalog owned by `bartuser`. - -```text -archive_mode = on # allows archiving to be done - # (change requires restart) -archive_command = 'scp %p bartuser@192.168.2.22:/opt/backup/acctg/archived_wals/%f' - # command to use to archive a logfile segment - # placeholders: %p = path of file to archive - # %f = file name only -... - -max_wal_senders = 1 # max number of walsender processes - # (change requires restart) -``` - -The database server must be restarted in order to initiate WAL archiving, but do not do so until you have verified that the full path of the BART backup catalog has been created by a prior BART subcommand or the archive operation will fail. - -Start the WAL scanner by executing the following command: - -```text -./bart-scanner -``` - - - -*Archive Command Auto Configuration* - -To enable WAL archiving: - -- In the `postgresql.conf` file, set the `wal_level` to `replica` or higher, `archive_mode` to `on`, and `max_wal_senders` to a value high enough to leave at least one session available for the backup. If the `xlog_method=stream` parameter setting is to be used by this database server as determined in the BART configuration file, the `max_wal_senders` setting must account for an additional session for the transaction log streaming (that is, the setting must be a minimum of `2`). See [Configuring the BART host](#configuring-the-bart-host) for information on the `xlog_method` parameter. - -- Configure the Postgres `archive_command` parameter automatically with the `INIT` subcommand and restart the database server when you are ready to initiate WAL archiving. The `INIT` subcommand invokes the Postgres `ALTER SYSTEM` command to set the Postgres `archive_command` configuration parameter in the `postgresql.auto.conf` file located in the managed database server’s `POSTGRES_INSTALL_HOME data directory`. For additional information about the `INIT` subcommand, see the EDB Backup and Recovery User Guide available at the [EDB website](/bart/latest/bart_user/). - - The archive command string that the `INIT` subcommand generates into the `postgresql.auto.conf` file is determined by the parameter setting of the BART `archive_command` parameter in the server section of the BART configuration file. If the BART `archive_command` parameter is not set in the server section for a given database server, the command string that is configured uses the following default format: - - `'scp %p %h:%a/%f'` - - The following table describes these variables: - -| **Variable** | **Description** | -| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `%p` | The path of the file to archive used by the Postgres archiving process. | -| `%h` | Will be replaced by the `@` as specified in the <bart_host> parameter setting. | -| `%a` | Will be replaced by the BART `archived_wals` directory as specified in the [archive path](#archive_path) parameter setting. If the `` is not specified, then the default directory is `//archived_wals`. `` is the lowercase conversion of the database server name. | -| `%f` | The archived file name used by the Postgres archiving process. | - -The placeholders `%h` and `%a` are replaced by the `INIT` subcommand when creating the archive command string. The placeholders `%p` and `%f` are not replaced by the `INIT` subcommand, but are kept as given to be used by the Postgres archiving process. - -For example, to use the default archive command format, the BART configuration file contains the following settings where the BART `archive_command` parameter is omitted from the server section for `ACCTG`: - -```text -[BART] - -bart_host= bartuser@192.168.2.22 -backup_path = /opt/backup -pg_basebackup_path = /usr/edb/as11/bin/pg_basebackup -logfile = /tmp/bart.log -scanner_logfile = /tmp/bart_scanner.log - -[ACCTG] - -host = 127.0.0.1 -port = 5444 -user = repuser -cluster_owner = enterprisedb -description = "Accounting" -``` - -The `INIT` subcommand is invoked by BART user account `bartuser` as follows: - -```text -[bartuser@localhost ~]$ bart INIT -s acctg -o -INFO: setting archive_command for server 'acctg' -WARNING: archive_command is set. server restart is required -``` - -If the BART backup catalog directory is not already complete, it will be completed. - -The resulting archive command string in the `postgresql.auto.conf` file located in the managed database server’s `POSTGRES_INSTALL_HOME/data directory` appears as follows: - -```text -# Do not edit this file manually! -# It will be overwritten by ALTER SYSTEM command. -archive_command = 'scp %p -bartuser@192.168.2.22:/opt/backup/acctg/archived_wals/%f' -``` - -Run the `INIT` subcommand with the `-o` option to override any existing `archive_command` setting in the `postgresql.conf` or the `postgresql.auto.conf` file. In addition, the `-o` option must be used to generate the command string if the `archive_mode` is set to off even if there are no existing settings of the `archive_command` in the `postgresql.conf` or `postgresql.auto.conf` files. - -In this example, the following BART configuration file is used with an explicit setting of the BART `archive_command` parameter: - -```text -[BART] - -bart_host= enterprisedb@192.168.2.22 -backup_path = /opt/backup -pg_basebackup_path = /usr/edb/as11/bin/pg_basebackup -logfile = /tmp/bart.log -scanner_logfile = /tmp/bart_scanner.log - -[ACCTG] - -host = 127.0.0.1 -port = 5444 -user = repuser -cluster_owner = enterprisedb -archive_command = 'cp %p %a/%f' -description = "Accounting" -``` - -The `INIT` subcommand is invoked by BART user account `enterprisedb` as follows: - -```text --bash-4.1$ bart INIT -s acctg -o -INFO: setting archive_command for server 'acctg' -WARNING: archive_command is set. server restart is required -``` - -The resulting Postgres `archive_command` parameter in the `postgresql.auto.conf` file appears as follows: - -```text -# Do not edit this file manually! -# It will be overwritten by ALTER SYSTEM command. -archive_command = 'cp %p /opt/backup/acctg/archived_wals/%f' -``` - -When the database server has been restarted, the `ARCHIVE COMMAND` field of the `SHOW-SERVERS` subcommand displays the active Postgres archive command as shown by the following example: - -```text --bash-4.1$ bart SHOW-SERVERS -s acctg -SERVER NAME : acctg -HOST NAME : 127.0.0.1 -USER NAME : repuser -PORT : 5444 -REMOTE HOST : -RETENTION POLICY : none -DISK UTILIZATION : 48.00 MB -NUMBER OF ARCHIVES : 0 -ARCHIVE PATH : /opt/backup/acctg/archived_wals -ARCHIVE SCOMMAND : `cp %p /opt/backup/acctg/archived_wals/%f` -XLOG METHOD : fetch -WAL COMPRESSION : disabled -TABLESPACE PATH(s) : -INCREMENTAL BACKUP : DISABLED -DESCRIPTION : "Accounting" -``` - - - -**Verifying Configuration Settings** - -To verify the parameter settings of the database server specified, execute tthe `CHECK-CONFIG` subcommand with the `–s` option: - -```text -bart CHECK-CONFIG [ –s server_name ] -``` - -The `CHECK-CONFIG` subcommand confirms the following: - -- The `cluster_owner` parameter is set to the user account owning the database cluster directory. -- A passwordless SSH/SCP connection is set between the BART user and the user account specified by the `cluster_owner` parameter. -- The BART `user` parameter specifies a database superuser. -- The BART `user` has access to the backup directory catalog. -- The `pg_hba.conf` file contains a replication entry for the database superuser specified by the BART `user` parameter. -- The `archive_mode` parameter in the `postgresql.conf` file is enabled. -- The `archive_command` parameter in the `postgresql.auto.conf` or the `postgresql.conf` file is set. -- The `allow_incremental_backups` parameter in the BART configuration file is enabled for database servers for which incremental backups are to be taken. -- Archiving of WAL files to the `archive_path` is in process. -- The WAL scanner program is running. - -After configuring the BART host and the database server(s), you can start using BART. For information about using BART, see the EDB Backup and Recovery User Guide available at the [EDB website](/bart/latest/bart_user/). diff --git a/product_docs/docs/bart/2.5/bart_inst/04_upgrading_bart.mdx b/product_docs/docs/bart/2.5/bart_inst/04_upgrading_bart.mdx deleted file mode 100644 index b71efc61e1d..00000000000 --- a/product_docs/docs/bart/2.5/bart_inst/04_upgrading_bart.mdx +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: "Upgrading BART" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.4/upgrading_bart.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.5/upgrading_bart.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.7/upgrading_bart.html" ---- - - - -This section outlines the process of upgrading BART from an existing version to the latest version. - -**Upgrade Restrictions** - -The following restrictions apply with regard to previous BART versions. - -- You can take incremental backups using the latest version only when the parent backup (full or incremental backup) has also been taken with the latest version. -- Using the latest version, you can restore incremental backups that are taken only with the latest version of BART. However, using the latest version you can restore full backups that were taken with older versions. - - - -## Upgrading from Older Versions of BART - -Perform the following steps to upgrade from older versions of BART to the latest version: - -**Step 1:** Assume the identity of the BART user account and invoke the following command to stop the BART WAL scanner program (`bart-scanner`): - -```text -bart-scanner STOP -``` - -**Step 2:** As the `root` user, upgrade to the latest BART version with the `yum upgrade` command. - -- To upgrade the BART RPM package directly from the *EDB Yum Repository* website, specify only the package name: - - On CentOS 7: - - ```text - yum upgrade edb-bart - ``` - - You can also use a downloaded RPM package file to upgrade. To use a downloaded BART RPM package file to upgrade, use the `yum` command, specifying the complete RPM package file name: - - ```text - yum upgrade edb-bart-x.y.z rhel7.x86_64.rpm - ``` - - Where x denotes the major version of BART, and y and z denotes the minor version. - - On a Debian or Ubuntu Host: - On a Debian or Ubuntu Host: - - ```text - apt-get upgrade edb-bart - ``` - - On a SLES Host: - - ```text - zypper update edb-bart - ``` - -**Step 3:** Repeat the process described in this section to upgrade to the latest BART version on each remote hosts where an incremental backup will be restored. - -For additional information about restoration of incremental backups on remote hosts, see the EDB Backup and Recovery User Guide available at the [EDB website](/bart/latest/bart_user/). - -**Step 4:** If the `bart --version` command returns an error stating the `PATH` is not available after switching from `root` user to another BART user account, adjust the setting of the `PATH` environment variable to include the location of the BART x.y.z executable (the `bin` subdirectory) in the `~/.bashrc` or `~/.bash_profile` files of the following user accounts: - -- The BART user account on the BART host. -- The remote user account on the remote host to which incremental backups are to be restored. For details, see the EDB Backup and Recovery User Guide available at the [EDB website](/bart/latest/bart_user/). - -The `PATH` setting should be the same as set for BART x.y.z since all versions use `/usr/edb/bart/bin`. - -!!! Note - After upgrading to the latest BART version, you must take a new full backup of your system before performing an incremental backup. - - \ No newline at end of file diff --git a/product_docs/docs/bart/2.5/bart_inst/05_uninstalling_bart.mdx b/product_docs/docs/bart/2.5/bart_inst/05_uninstalling_bart.mdx deleted file mode 100644 index adc34d7f9c6..00000000000 --- a/product_docs/docs/bart/2.5/bart_inst/05_uninstalling_bart.mdx +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: "Uninstalling BART" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.4/uninstalling_bart.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.5/uninstalling_bart.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.7/uninstalling_bart.html" ---- - - - -This section walks you through uninstalling BART. - -## Uninstalling BART on a RHEL/CentOS/Rocky Linux/AlmaLinux Host - -To uninstall BART on a RHEL/CentOS/Rocky Linux/AlmaLinux host, assume the identity of the `root` user and invoke the following command: - -On RHEL/CentOS 7: - -```text -yum remove edb-bart -``` - -On RHEL/Rocky Linux/AlmaLinux 8: - -```text -dnf remove edb-bart -``` - -Uninstalling BART does not delete the backup files and archived WAL files that reside in the BART backup catalog. To permanently delete the backup files and archived WAL files in the BART backup catalog (`/opt/backup`), use one of the following commands: - -- `rm –rf /opt/backup` -- BART `DELETE` subcommand - -For information about the BART `DELETE` subcommand, see the *EDB Backup and Recovery User Guide* available at the [EDB website](/bart/latest/bart_user/). - -## Uninstalling BART on an SLES 12 Host - -To uninstall BART on an SLES 12 host, assume the identity of the `root` user and invoke the following command: - -```text -zypper remove edb-bart -``` - -## Uninstalling BART on a Debian/Ubuntu Host - -To uninstall BART on a Debian or Ubuntu host, invoke the following command: - -```text -apt-get remove edb-bart -``` diff --git a/product_docs/docs/bart/2.5/bart_inst/images/EDB_logo.png b/product_docs/docs/bart/2.5/bart_inst/images/EDB_logo.png deleted file mode 100644 index f4a93cf57f5..00000000000 --- a/product_docs/docs/bart/2.5/bart_inst/images/EDB_logo.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:07423b012a855204780fe5a2a5a1e33607304a5c3020ae4acbf3d575691dedd6 -size 12136 diff --git a/product_docs/docs/bart/2.5/bart_inst/images/edb.png b/product_docs/docs/bart/2.5/bart_inst/images/edb.png deleted file mode 100644 index 3e8d3c76655..00000000000 --- a/product_docs/docs/bart/2.5/bart_inst/images/edb.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:df8233799fa8616e3762286196fbaf567f3ef45830c65bfcb42214e86a5d69fc -size 12049 diff --git a/product_docs/docs/bart/2.5/bart_inst/images/edb_logo.svg b/product_docs/docs/bart/2.5/bart_inst/images/edb_logo.svg deleted file mode 100644 index f24d1dfefee..00000000000 --- a/product_docs/docs/bart/2.5/bart_inst/images/edb_logo.svg +++ /dev/null @@ -1,19 +0,0 @@ - - - edb-logo-disc-dark - - - - \ No newline at end of file diff --git a/product_docs/docs/bart/2.5/bart_inst/images/edblogo.png b/product_docs/docs/bart/2.5/bart_inst/images/edblogo.png deleted file mode 100644 index 3e8d3c76655..00000000000 --- a/product_docs/docs/bart/2.5/bart_inst/images/edblogo.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:df8233799fa8616e3762286196fbaf567f3ef45830c65bfcb42214e86a5d69fc -size 12049 diff --git a/product_docs/docs/bart/2.5/bart_inst/index.mdx b/product_docs/docs/bart/2.5/bart_inst/index.mdx deleted file mode 100644 index 025e4d9d669..00000000000 --- a/product_docs/docs/bart/2.5/bart_inst/index.mdx +++ /dev/null @@ -1,56 +0,0 @@ ---- -navTitle: Installation Guide -title: "EDB Postgres Backup and Recovery Installation Guide" -legacyRedirects: - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.6.1/requirements_overview.html" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.1/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.1/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.2/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.2/conclusion.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.2/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.4/conclusion.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.4/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.4/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.3/conclusion.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.3/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.3/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.5/conclusion.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.5/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.5/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.7/conclusion.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.7/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/installation-getting-started/installation-upgrade-guide/2.5.7/index.html" ---- - -This guide provides information about how to install and configure the EDB Backup and Recovery Tool (BART) 2.5. - - - -## Requirements Overview - -### Supported Platforms and Database Versions - -- To view a complete list of platforms that EDB supports, see [Platform Compatibility](https://www.enterprisedb.com/platform-compatibility). - -- BART supports the following database versions: - - - Advanced Server versions 9.6, 10, 11, and 12. - - PostgreSQL versions 9.6, 10, 11, and 12. - -### Software Requirements - -You require the following components to install BART. - -- BART Host Components - Use EDB packages to add BART host components; see [Installing BART](02_installing_bart/#installing-bart) for information about how to install these components. - -- Additional Components - In addition to the BART host components, the following components are required: - - - The [Secure Shell (SSH) server daemon and Secure Copy (SCP) client programs](03_configuring_bart/#authorizing_ssh_scp_access) must be enabled and activated on the BART host as well as on the remote database server hosts on which BART will be managing backup and recovery. - - BART uses the `pg_basebackup` utility program when taking full backups. - -### Limitation - -BART supports taking only a full backup of standby servers; it does not support taking incremental or parallel backups of standby servers. diff --git a/product_docs/docs/bart/2.5/bart_qs_7/images/EDB_logo.png b/product_docs/docs/bart/2.5/bart_qs_7/images/EDB_logo.png deleted file mode 100644 index f4a93cf57f5..00000000000 --- a/product_docs/docs/bart/2.5/bart_qs_7/images/EDB_logo.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:07423b012a855204780fe5a2a5a1e33607304a5c3020ae4acbf3d575691dedd6 -size 12136 diff --git a/product_docs/docs/bart/2.5/bart_qs_7/images/edb.png b/product_docs/docs/bart/2.5/bart_qs_7/images/edb.png deleted file mode 100644 index 3e8d3c76655..00000000000 --- a/product_docs/docs/bart/2.5/bart_qs_7/images/edb.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:df8233799fa8616e3762286196fbaf567f3ef45830c65bfcb42214e86a5d69fc -size 12049 diff --git a/product_docs/docs/bart/2.5/bart_qs_7/images/edb_logo.svg b/product_docs/docs/bart/2.5/bart_qs_7/images/edb_logo.svg deleted file mode 100644 index f24d1dfefee..00000000000 --- a/product_docs/docs/bart/2.5/bart_qs_7/images/edb_logo.svg +++ /dev/null @@ -1,19 +0,0 @@ - - - edb-logo-disc-dark - - - - \ No newline at end of file diff --git a/product_docs/docs/bart/2.5/bart_qs_7/images/image2.png b/product_docs/docs/bart/2.5/bart_qs_7/images/image2.png deleted file mode 100644 index edc64a0ff46..00000000000 --- a/product_docs/docs/bart/2.5/bart_qs_7/images/image2.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:50824c247a9be22f3c0e10a02d4ed308dce6ce9a86adfd87bb439a00d8c121c1 -size 92905 diff --git a/product_docs/docs/bart/2.5/bart_qs_7/index.mdx b/product_docs/docs/bart/2.5/bart_qs_7/index.mdx deleted file mode 100644 index 70add9e84c1..00000000000 --- a/product_docs/docs/bart/2.5/bart_qs_7/index.mdx +++ /dev/null @@ -1,325 +0,0 @@ ---- -title: "Quick Start Guide for RHEL/CentOS 7" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/quick-start/quick-start-guide-for-rhelcentos-7/2.5.4/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/quick-start/quick-start-guide-for-rhelcentos-7/2.5.4/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/quick-start/quick-start-guide-for-rhelcentos-7/2.5.5/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/quick-start/quick-start-guide-for-rhelcentos-7/2.5.5/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/quick-start/quick-start-guide-for-rhelcentos-7/2.5.7/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/quick-start/quick-start-guide-for-rhelcentos-7/2.5.7/genindex.html" ---- - -This tutorial demonstrates using `yum` to [install](#installing) and [configure](../bart_qs_8/#configuring) Backup and Recovery Tool (BART) 2.5 on a CentOS 7 host with minimal configuration settings.  The tutorial assumes that the user has some knowledge of installation and system administration procedures, and has administrative privileges on the host. - -For detailed information about BART installation and configuration, see the *BART Installation and Upgrade Guide*, available at the [EDB website](/bart/latest/bart_inst/). - -- BART is tested with the following database versions: - - - Advanced Server - 9.6, 10, 11, and 12. - - PostgreSQL - 9.6, 10, 11, and 12. - - - -**Installing BART** - -The following steps describe installing BART on CentOS 7.x OS using `yum`. - -1. Assume superuser privileges and use `yum` to create the repository configuration file: - - ```text - yum install -y https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm - ``` - -2. Create an EDB user account to request credentials to the EDB repository; for a user account visit the [EnterpriseDB website](https://www.enterprisedb.com/repository-access-request). - -3. Use your choice of editor to open the repository configuration file (named `edb.repo`, located in `/etc/yum.repos.d`), and set the `enabled` parameter value to `1`, and replace the `username` and `password` placeholders in the `baseurl` specification with the username and password of a registered EnterpriseDB user. - -4. Update the cache: - - ```text - yum makecache - ``` - -5. Install an Advanced Server or PostgreSQL database server. - - To install Advanced Server, execute the following command: - - ```text - yum -y install edb-as12-server - ``` - - Use sudo to assume the identity of the `enterprisedb` database superuser - - ```text - sudo su - enterprisedb - ``` - - Create an Advanced Server cluster named `acctg` on listener port `5444`: - - ```text - /usr/edb/as12/bin/initdb -D /var/lib/edb/as12/acctg - ``` - - As the `enterprisedb` user, start the cluster: - - ```text - /usr/edb/as12/bin/pg_ctl start -D /var/lib/edb/as12/acctg - ``` - - You can check the status of the cluster with the following command: - - ```text - /usr/edb/as12/bin/pg_ctl status -D /var/lib/edb/as12/acctg - ``` - - !!! Note - The BART host server is not required to have an Advanced Server or PostgreSQL installation, but must include a copy of the Postgres `libpq` library, the `pg_basebackup` utility program, and Boost Libraries 1.53 version for CentOS 7. - -6. If you do not already have the `pg_basebackup` program installed on the BART host, you can use the following command to install a limited number of files that include the `pg_basebackup` program: - - ```text - yum install edb-as-server-client - ``` - - Where <xx> is the Advanced Server version. - -7. As a root user, execute the following command to install BART: - - ```text - yum install edb-bart - ``` - -BART (the bart program and bart-scanner) is installed in the `/usr/edb/bart/bin` directory, referred to as ``. Repeat the installation process described in this section to install BART on all remote hosts where incremental backups are to be restored. - - - -**Configuring BART** - -Before configuring BART, establish the BART user account (the operating system user) that will run the BART command line program. Then, to configure the BART host and each database server that is to be managed by BART, perform the following steps: - -1. Assume superuser privileges, create the directory that will hold the BART backup catalog, and assign its ownership (with restrictive privileges) to the BART user account: - - In this example, `bartuser` is the BART user account and `/opt/backup` is the BART backup catalog. - - ```text - su root - mkdir /opt/backup - chown bartuser /opt/backup - chgrp bartuser /opt/backup - chmod 700 /opt/backup - ``` - -2. Navigate to the `/usr/edb/bart/etc` directory and copy the `bart.cfg.sample` file to create the BART configuration file (`bart.cfg`): - - ```text - cp bart.cfg.sample bart.cfg - ``` - -3. Open the BART configuration file (`bart.cfg`) using an editor of your choice and scroll through the BART configuration file to edit the file as required; sample settings are included for your reference. You must add the mandatory parameters to the `[BART]` and `[ServerName]` sections. Default values may be used for optional parameters. For detailed information about parameter settings, see the *BART Installation and Upgrade Guide*, available at the [EDB website](/bart/latest/bart_inst/). - - Parameters set in the `[BART]` section are applicable to all BART managed database servers, while parameters set in the `[ServerName]` section are applicable only to the specific server; `[ServerName]` settings override `[BART]` section settings. - - In the following example, only mandatory parameters are set: - - ```text - [BART] - bart_host= bartuser@192.168.169.199 - backup_path = /opt/backup - pg_basebackup_path = /usr/edb/as12/bin/pg_basebackup - - [EPAS12] - host = 127.0.0.1 - user = repuser - cluster_owner = enterprisedb - ``` - -The following table describes only mandatory parameters: - -| **Parameters/Placeholder** | **Section** | **Description** | -| -------------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `bart_host` | `[BART]` | Use this field to specify the BART user and the IP address of the host on which the BART utility is installed. Specify the value in the form of `@`. | -| `backup_path` | `[BART]` | Use this field to specify the path where all BART backups and archived WAL files will be stored. Ensure the BART user account holds privileges to create subdirectories and files within the location specified in the `backup_path` parameter. The default `backup_path` is BART backup catalog (`/opt/backup`). | -| `pg_basebackup_path` | `[BART]` | Use this field to specify the path to the pg_basebackup utility (`/usr/edb/as/bin/pg_basebackup`). | -| `[ServerName]` | `[ServerName]` | Specify the name of the database server to be backed up (for example, \[EPAS12]). | -| `host` | `[ServerName]` | Specify the IP address of the database server to be configured for backup. | -| `user` | `[ServerName]` | Specify the replication database user name used by BART to establish the connection to the database server for full backups. | -| `cluster_owner` | `[ServerName]` | Specify the Linux operating system user account that owns the database cluster. | - -4. As a BART user, navigate to `/usr/edb/bart/bin` and invoke the following subcommand (omitting the `-s` option) to verify the \[BART] section parameter settings: - - ```text - bart CHECK-CONFIG - ``` - -5. Authorize [SSH/SCP access](../bart_qs_8/#passwordless) between the server and the BART host without a password prompt. - -6. Create a [replication database user](../bart_qs_8/#replication) for each database server that BART manages. - -7. To enable continuous WAL archiving for any database server for which BART is to perform a backup, modify the `postgresql.conf` file, setting: - - - `wal_level` to `replica` or higher (for Postgres 9.6 or later) - - `archive_mode` to `on` - - `archive_command` (if it is not set in the `bart.cfg` file) - - `max_wal_senders` to a value high enough to leave at least one session available for the backup. - - After setting the parameters, restart the database server. - -8. To start the WAL scanner, navigate to `/usr/edb/bart/bin` as a BART user and execute the following command: - - ```text - ./bart-scanner - ``` - -9. If you are using the default `archive_command`, then navigate to `/usr/edb/bart/bin` as a BART user, run the `INIT` subcommand without the `-o` option, and restart the database server: - - ```text - bart INIT [ -s { | all } ] - ``` - - Where `` is the name of the database server to be backed up. - - If you have customized the `archive_command` setting in the `bart.cfg` file, run the `INIT` subcommand with the `-o` option to override any existing Postgresql `archive_command` setting in the `postgresql.conf` or the `postgresql.auto.conf` file, and restart the database server. - - ```text - bart INIT [ -s { | all } ] [ -o ] - ``` - -10. To verify the database server parameter settings, as a BART user navigate to `/usr/edb/bart/bin` and invoke the `CHECK-CONFIG` subcommand with the -s option: - - ```text - bart CHECK-CONFIG [ -s ] - ``` - - BART is now configured successfully. For detailed information about using BART, see the *EDB Backup and Recovery Tool User Guide*, available at the [EDB website](/bart/latest/bart_user/). - - - -**Creating a Passwordless Connection** - -The following example enables SSH/SCP access on a CentOS 7.x host; similar (platform-specific) steps will apply to other platforms/versions. You must create a passwordless connection between the BART host (SSH/SCP client) and the database server (target SSH/SCP server), as well as a passwordless connection between the database server (SSH/SCP client) and the BART host (target SSH/SCP server). - -1. Log in as the user account on the BART host that will be initiating the SSH or SCP connection and navigate to the user account’s home directory and check for an existing `.ssh` subdirectory. If the `.ssh` directory does not exist, create one with the required privileges. - -2. As a root user navigate to `/usr/edb/bart`, open the `/etc/ssh/sshd_config` file and set the `PubkeyAuthentication` parameter to `yes`. - -3. Reload the configuration file: - - ```text - service sshd reload - ``` - - If you get any SSH or SCP errors, examine the log file (`/var/log/secure`). - -4. As a BART user, use the following command to generate the public key file; you can accept the default responses: - - ```text - ssh-keygen -t rsa - ``` - - The public key file named `id_rsa.pub` is created in the `.ssh` subdirectory. - -5. Use `SCP` to make a temporary copy of the public key file on the target server: - - ```text - scp ~/.ssh/id_rsa.pub target_user@host_address:tmp.pub - ``` - -6. As a `target_user`, log into the target server using `ssh target_user@host_address` command and navigate to the user account’s home directory to check if there is an existing `.ssh` subdirectory. If it does not exist, create one with the required privileges. - -7. Append the client’s temporary public key file, `tmp.pub`, to the `authorized_keys` file: - - ```text - cat tmp.pub >> ~/.ssh/authorized_keys - ``` - - If an `authorized_keys` file does not exist, create a new file, but be careful not to completely replace any existing `authorized_keys` file. - -8. Ensure only the file owner (and not other groups or users) has access to `authorized_keys` file: - - ```text - chmod 600 ~/.ssh/authorized_keys - ``` - -9. Delete the temporary public key file: - - ```text - rm tmp.pub - ``` - - Now, when logged into the BART host as a user, there should be no prompt for a password when you are connecting to the target database server: - - ```text - ssh target_user@database_server_address - ``` - -**Creating a Passwordless Connection Between the Database Server and the BART Host** - -If backups are to be taken from a given database server host, but restored to a different database server host, the passwordless SSH/SCP connections must be configured from the BART host to the database server host from which the backup is to be taken as well as from the BART host to the database server host to which the backup is to be restored. - -An example of how to create a passwordless connection is documented in the *EDB Backup and Recovery Reference Guide*, available at the [EDB website](/bart/latest/bart_ref/). - -Even when the Advanced Server database is on the same host as BART, and the Advanced Server database cluster owner is also the BART user account, a passwordless SSH/SCP connection must be established from the same user account to itself. - -1. On the database server, navigate into the target user account’s home directory to check for an existing `.ssh` subdirectory. If it does does not exist, create one in the user account’s home directory with the required privileges. - -2. As a database server user, generate the public key file: - - ```text - ssh-keygen -t rsa - ``` - -3. Create a temporary copy of the public key file: - - ```text - scp ~/.ssh/id_rsa.pub target_user@host_address:tmp.pub - ``` - -4. As a target user, log into the BART host and navigate to the user account’s home directory to check if there is an existing `.ssh` subdirectory. If it does not exist, create one with the required privileges: - - ```text - ssh target_user@host_address - ``` - -5. Append the temporary, client’s public key file to the `authorized_keys` file: - - ```text - cat tmp.pub >> ~/.ssh/authorized_keys - ``` - -If an `authorized_keys` file does not exist, create a new file, but do not completely replace any existing `authorized_keys` file. - -6. Ensure only the file owner (and not other groups or users) has access to `authorized_keys` file: - - ```text - chmod 600 ~/.ssh/authorized_keys - ``` - -7. Delete the temporary public key file: - - ```text - rm tmp.pub - ``` - - Now, when logged into the database server as a user, there should be no prompt for a password when you are connecting to the BART host: - - ```text - ssh bart_user@bartip_address - ``` - - - -**Creating a Replication Database User** - -1. To create a replication database user (a superuser), connect to the database server with the psql client, and invoke the following PostgreSQL command: - - ```text - CREATE ROLE WITH LOGIN SUPERUSER PASSWORD ''; - ``` - -2. Specify this replication database user in the `user` parameter of the `bart.cfg` file. - -3. The [pg_hba.conf](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html) file must minimally permit the replication database user to have access to the database. The IP address from which the replication database user has access to the database is the BART host location. The replication database user must also be included in the `pg_hba.conf` file as a replication database connection if `pg_basebackup` is to be used for taking any backups. - -4. To ensure there is no password prompt when connecting to the database server with the replication database user, a recommended method is to use the `.pgpass` file located in the BART user account’s home directory (if it does not exist, you need to create the `.pgpass` file with the required privileges). The `.pgpass` file must contain an entry for each BART managed database server, and its corresponding replication database user and password. diff --git a/product_docs/docs/bart/2.5/bart_qs_8/images/EDB_logo.png b/product_docs/docs/bart/2.5/bart_qs_8/images/EDB_logo.png deleted file mode 100644 index f4a93cf57f5..00000000000 --- a/product_docs/docs/bart/2.5/bart_qs_8/images/EDB_logo.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:07423b012a855204780fe5a2a5a1e33607304a5c3020ae4acbf3d575691dedd6 -size 12136 diff --git a/product_docs/docs/bart/2.5/bart_qs_8/images/edb.png b/product_docs/docs/bart/2.5/bart_qs_8/images/edb.png deleted file mode 100644 index 3e8d3c76655..00000000000 --- a/product_docs/docs/bart/2.5/bart_qs_8/images/edb.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:df8233799fa8616e3762286196fbaf567f3ef45830c65bfcb42214e86a5d69fc -size 12049 diff --git a/product_docs/docs/bart/2.5/bart_qs_8/images/edb_logo.svg b/product_docs/docs/bart/2.5/bart_qs_8/images/edb_logo.svg deleted file mode 100644 index f24d1dfefee..00000000000 --- a/product_docs/docs/bart/2.5/bart_qs_8/images/edb_logo.svg +++ /dev/null @@ -1,19 +0,0 @@ - - - edb-logo-disc-dark - - - - \ No newline at end of file diff --git a/product_docs/docs/bart/2.5/bart_qs_8/images/image2.png b/product_docs/docs/bart/2.5/bart_qs_8/images/image2.png deleted file mode 100644 index edc64a0ff46..00000000000 --- a/product_docs/docs/bart/2.5/bart_qs_8/images/image2.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:50824c247a9be22f3c0e10a02d4ed308dce6ce9a86adfd87bb439a00d8c121c1 -size 92905 diff --git a/product_docs/docs/bart/2.5/bart_qs_8/index.mdx b/product_docs/docs/bart/2.5/bart_qs_8/index.mdx deleted file mode 100644 index be21d871cc2..00000000000 --- a/product_docs/docs/bart/2.5/bart_qs_8/index.mdx +++ /dev/null @@ -1,321 +0,0 @@ ---- -title: "Quick Start Guide for RHEL/Rocky Linux 8" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/quick-start/quick-start-guide-for-rhelcentos-8/2.5.4/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/quick-start/quick-start-guide-for-rhelcentos-8/2.5.4/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/quick-start/quick-start-guide-for-rhelcentos-8/2.5.5/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/quick-start/quick-start-guide-for-rhelcentos-8/2.5.5/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/quick-start/quick-start-guide-for-rhelcentos-8/2.5.7/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/quick-start/quick-start-guide-for-rhelcentos-8/2.5.7/genindex.html" ---- - -This tutorial demonstrates using the `dnf` command to install and configure the EDB Backup and Recovery Tool (BART) 2.5 on a Rocky Linux 8 host with minimal configuration settings.  The tutorial assumes that the user has some knowledge of installation and system administration procedures and has administrative privileges on the host. - -For detailed information about BART installation and configuration, see the *BART Installation and Upgrade Guide* available at the [EDB website](/bart/latest/bart_inst/). - -- BART is tested with the following database versions: - - - Advanced Server - 9.6, 10, 11, and 12. - - PostgreSQL - 9.6, 10, 11, and 12. - -**Installing BART** - -The following steps describe installing BART on Rocky Linux 8.x OS. - -1. Assume superuser privileges and use `dnf` to create the repository configuration file: - - ```text - dnf install -y https://yum.enterprisedb.com/edbrepos/edb-repo-latest.noarch.rpm - ``` - -2. Create an EDB user account to request credentials to the EDB repository; for a user account visit the [EnterpriseDB website](https://www.enterprisedb.com/repository-access-request). - -3. Use your choice of editor to open the repository configuration file (named `edb.repo`, located in `/etc/yum.repos.d`), set the `enabled` parameter value to `1`, and replace the `username` and `password` placeholders in the `baseurl` specification with the username and password of a registered EnterpriseDB user. - -4. Update the cache: - - ```text - dnf makecache - ``` - -5. Install an Advanced Server or PostgreSQL database server. - - To install Advanced Server, execute the following command: - - ```text - dnf -y install edb-as12-server - ``` - - Use sudo to assume the identity of the `enterprisedb` database superuser: - - ```text - sudo su - enterprisedb - ``` - - Create an Advanced Server cluster named `acctg` on listener port `5444`: - - ```text - /usr/edb/as12/bin/initdb -D /var/lib/edb/as12/acctg - ``` - - As the `enterprisedb` user, start the cluster: - - ```text - /usr/edb/as12/bin/pg_ctl start -D /var/lib/edb/as12/acctg - ``` - - You can check the status of the cluster with the following command: - - ```text - /usr/edb/as12/bin/pg_ctl status -D /var/lib/edb/as12/acctg - ``` - - !!! Note - The BART host server is not required to have an Advanced Server or PostgreSQL installation, but must include a copy of the Postgres `libpq` library, the `pg_basebackup` utility program, and Boost Libraries 1.66 version for Rocky Linux 8. - -6. If you do not already have the `pg_basebackup` program installed on the BART host, you can use the following command to install a limited number of files that include the `pg_basebackup` program: - - ```text - dnf install edb-asxx-server-client - ``` - -7. As a root user, use the following command to install the BART RPM package: - - ```text - dnf install edb-bart - ``` - -BART (the `bart` program and `bart-scanner`) is installed in the `/usr/edb/bart/bin` directory, referred to as ``. Repeat the installation process described in this section to install BART on all remote hosts where incremental backups are to be restored. - - - -**Configuring BART** - -Before configuring BART, establish the BART user account (the operating system user) to run the BART command line program. Then, to configure the BART host and each database server that is to be managed by BART, perform the following steps: - -1. Assume superuser privileges, create the directory that will hold the BART backup catalog, and assign its ownership (with restrictive privileges) to the BART user account: - - In this example, `bartuser` is the BART user account and `/opt/backup` is the BART backup catalog. - - ```text - su root - mkdir /opt/backup - chown bartuser /opt/backup - chgrp bartuser /opt/backup - chmod 700 /opt/backup - ``` - -2. Navigate to the `/usr/edb/bart/etc` directory and copy the `bart.cfg.sample` file to create the BART configuration file (`bart.cfg`): - - ```text - cp bart.cfg.sample bart.cfg - ``` - -3. Open the BART configuration file (`bart.cfg`) using an editor of your choice and scroll through the BART configuration file to edit the file as required; sample settings are included for your reference. You must add the mandatory parameters to the `[BART]` and `[ServerName]` sections. Default values may be used for optional parameters. For detailed information about parameter settings, see the *BART Installation and Upgrade Guide*, available at the [EDB website](/bart/latest/bart_inst/). - - Parameters set in the `[BART]` section are applicable to all BART managed database servers, while parameters set in the `[ServerName]` section are applicable only to the specific server; `[ServerName]` settings override `[BART]` section settings. - - In the following example, only mandatory parameters are set: - - ```text - [BART] - bart_host= bartuser@192.168.169.199 - backup_path = /opt/backup - pg_basebackup_path = /usr/edb/as12/bin/pg_basebackup - - [EPAS12] - host = 127.0.0.1 - user = repuser - cluster_owner = enterprisedb - ``` - -The following table describes only mandatory parameters: - -| **Parameters/Placeholder** | **Section** | **Description** | -| -------------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `bart_host` | `[BART]` | Use this field to specify the BART user and the IP address of the host on which the BART utility is installed. Specify the value in the form of `@`. | -| `backup_path` | `[BART]` | Use this field to specify the path where all BART backups and archived WAL files will be stored. Ensure the BART user account holds privileges to create subdirectories and files within the location specified in the `backup_path` parameter. The default `backup_path` is BART backup catalog (`/opt/backup`). | -| `pg_basebackup_path` | `[BART]` | Use this field to specify the path to the pg_basebackup utility (`/usr/edb/as/bin/pg_basebackup`). | -| `[ServerName]` | `[ServerName]` | Specify the name of the database server to be backed up (for example, \[EPAS12]). | -| `host` | `[ServerName]` | Specify the IP address of the database server to be configured for backup. | -| `user` | `[ServerName]` | Specify the replication database user name used by BART to establish the connection to the database server for full backups. | -| `cluster_owner` | `[ServerName]` | Specify the Linux operating system user account that owns the database cluster. | - -4. As a BART user, navigate to `/usr/edb/bart/bin` and invoke the following subcommand (omitting the `-s` option) to verify the \[BART] section parameter settings: - - ```text - bart CHECK-CONFIG - ``` - -5. Authorize [SSH/SCP access](#passwordless) between the server and the BART host without a password prompt. - -6. Create a [replication database user](#replication) for each database server that BART manages. - -7. To enable continuous WAL archiving for any database server for which BART is to perform a backup, modify the `postgresql.conf` fil and set it to: - - - `wal_level` to `replica` or higher (for Postgres 9.6 or later) - - `archive_mode` to `on` - - `archive_command` (if it is not set in the `bart.cfg` file) - - `max_wal_senders` to a value high enough to leave at least one session available for the backup. - - After setting the parameters, restart the database server. - -8. To start the WAL scanner, navigate to `/usr/edb/bart/bin` as a BART user and execute the following command: - - ```text - ./bart-scanner - ``` - -9. If you are using the default `archive_command`, then navigate to `/usr/edb/bart/bin` as a BART user, run the `INIT` subcommand without the `-o` option, and restart the database server: - - ```text - bart INIT [ -s { | all } ] - ``` - - Where `` is the name of the database server to be backed up. - - If you have customized the `archive_command` setting in the `bart.cfg` file, run the `INIT` subcommand with the `-o` option to override any existing Postgresql `archive_command` setting in the `postgresql.conf` or the `postgresql.auto.conf` file, and restart the database server. - - ```text - bart INIT [ -s { | all } ] [ -o ] - ``` - -10. To verify the database server parameter settings, as a BART user navigate to `/usr/edb/bart/bin` and invoke the `CHECK-CONFIG` subcommand with the -s option: - - ```text - bart CHECK-CONFIG [ -s ] - ``` - - BART is now configured successfully. For detailed information about using BART, see the *EDB Backup and Recovery Tool User Guide* available at the [EDB website](/bart/latest/bart_user/). - - - -**Creating a Passwordless Connection** - -The following example enables SSH/SCP access on a Rocky Linux 8.x host; similar (platform-specific) steps will apply to other platforms/versions. You must create a passwordless connection between the BART host (SSH/SCP client) and the database server (target SSH/SCP server), as well as a passwordless connection between the database server (SSH/SCP client) and the BART host (target SSH/SCP server). - -1. Log in as the user account on the BART host that will be initiating the SSH or SCP connection and navigate to the user account’s home directory and check for an existing `.ssh` subdirectory. If the `.ssh` directory does not exist, create one with the required privileges. - -2. As a root user navigate to `/usr/edb/bart`, open the `/etc/ssh/sshd_config` file and set the `PubkeyAuthentication` parameter to `yes`. - -3. Reload the configuration file: - - ```text - service sshd reload - ``` - - If you get any SSH or SCP errors, examine the log file (`/var/log/secure`). - -4. As a BART user, use the following command to generate the public key file; you can accept the default responses: - - ```text - ssh-keygen -t rsa - ``` - - The public key file named `id_rsa.pub` is created in the `.ssh` subdirectory. - -5. Use `SCP` to make a temporary copy of the public key file on the target server: - - ```text - scp ~/.ssh/id_rsa.pub target_user@host_address:tmp.pub - ``` - -6. As a `target_user`, log into the target server using `ssh target_user@host_address` command and navigate to the user account’s home directory to check if there is an existing `.ssh` subdirectory. If it does not exist, create one with the required privileges. - -7. Append the temporary client’s public key file, `tmp.pub`, to the `authorized_keys` file: - - ```text - cat tmp.pub >> ~/.ssh/authorized_keys - ``` - - If an `authorized_keys` file does not exist, create a new file, but be careful not to completely replace any existing `authorized_keys` file. - -8. Ensure only the file owner (and not other groups or users) has access to `authorized_keys` file: - - ```text - chmod 600 ~/.ssh/authorized_keys - ``` - -9. Delete the temporary public key file: - - ```text - rm tmp.pub - ``` - - Now, when logged into the BART host as a user, there should be no prompt for a password when you are connecting to the target database server: - - ```text - ssh target_user@database_server_address - ``` - -**Creating a Passwordless Connection Between the Database Server and the BART Host** - -If backups are to be taken from a given database server host, but restored to a different database server host, the passwordless SSH/SCP connections must be configured from the BART host to the database server host from which the backup is to be taken as well as from the BART host to the database server host to which the backup is to be restored. - -An example of how to create a passwordless connection is documented in the *EDB Backup and Recovery Reference Guide*, available at the [EDB website](/bart/latest/bart_ref/). - -Even when the Advanced Server database is on the same host as BART, and the Advanced Server database cluster owner is also the BART user account, a passwordless SSH/SCP connection must be established from the same user account to itself. - -1. On the database server, navigate into the target user account’s home directory to check for an existing `.ssh` subdirectory. If it does does not exist, create one in the user account’s home directory with the required privileges. - -2. As a database server user, generate the public key file: - - ```text - ssh-keygen -t rsa - ``` - -3. Create a temporary copy of the public key file: - - ```text - scp ~/.ssh/id_rsa.pub target_user@host_address:tmp.pub - ``` - -4. As a target user, log into the BART host and navigate to the user account’s home directory to check if there is an existing `.ssh` subdirectory. If it does not exist, create one with the required privileges: - - ```text - ssh target_user@host_address - ``` - -5. Append the client’s temporary public key file to the `authorized_keys` file: - - ```text - cat tmp.pub >> ~/.ssh/authorized_keys - ``` - -If the `authorized_keys file` does not exist, create a new file, but do not completely replace any existing `authorized_keys` file. - -6. Ensure that only the file owner (and not other groups or users) has access to `authorized_keys` file: - - ```text - chmod 600 ~/.ssh/authorized_keys - ``` - -7. Delete the temporary public key file: - - ```text - rm tmp.pub - ``` - - Now, when logged into the database server as a user, there should be no prompt for a password when you are connecting to the BART host: - - ```text - ssh bart_user@bartip_address - ``` - - - -**Creating a Replication Database User** - -1. To create a replication database user (a superuser), connect to the database server with the psql client, and invoke the following PostgreSQL command: - - ```text - CREATE ROLE WITH LOGIN SUPERUSER PASSWORD ''; - ``` - -2. Specify this replication database user in the `user` parameter of the `bart.cfg` file. - -3. The [pg_hba.conf](https://www.postgresql.org/docs/current/auth-pg-hba-conf.html) file must minimally permit the replication database user to have access to the database. The IP address from which the replication database user has access to the database is the BART host location. The replication database user must also be included in the `pg_hba.conf` file as a replication database connection if `pg_basebackup` is to be used for taking any backups. - -4. To ensure there is no password prompt when connecting to the database server with the replication database user, a recommended method is to use the `.pgpass` file located in the BART user account’s home directory (if it does not exist, you need to create the `.pgpass` file with the required privileges). The `.pgpass` file must contain an entry for each BART managed database server, and its corresponding replication database user and password. diff --git a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/01_backup.mdx b/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/01_backup.mdx deleted file mode 100644 index c906b1ef08c..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/01_backup.mdx +++ /dev/null @@ -1,223 +0,0 @@ ---- -title: "BACKUP" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.1/backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.2/backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.4/backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.3/backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.5/backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.7/backup.html" ---- - -Use the `BACKUP` subcommand to create a full or incremental backup. - -**Syntax for a Full Backup:** - -```text -bart BACKUP –s { | all } [ -F { p | t } ] - -[ -z ] [ –c ] - -[ --backup-name ] - -[ --thread-count ] - -[ { --with-pg_basebackup | --no-pg_basebackup } ] -``` - -**Syntax for an Incremental Backup:** - -```text -bart BACKUP –s [-Fp] - -[ --parent { | } ] - -[ --backup-name ] - -[ --thread-count ] - -``` - -Before performing an incremental backup, you must take a full backup. For more details about incremental backup, refer to *Block-Level Incremental Backup* in the *EDB Backup and Recovery User Guide* available at the [EDB website](/bart/latest/bart_user/). - -The following table describes the `BACKUP` options: - -| Options | Description | -| ---------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-s { \| all }`
`--server { \| all }` | Use this option to specify the database server to be backed up.
Specify `` to take a backup of the database server (as specified in the BART configuration file).
Specify `all` to take a backup of all servers. | -| `-F { p \| t }`
`--format { p \| t }` | Use this option to specify the backup file format.
Specify `p` option to take backup in plain text format and specify `t` option to take backup in tar format. If the `p` or `t` option is omitted, the default is tar format.
Use `p` option with the `BACKUP` subcommand when streaming is used as a backup method.
An incremental backup can only be taken in plain text format (`p`). | -| `-z`
`(--gzip)` | This option is applicable only for full backup and `tar` format. Use this option to enable gzip compression of tar files using the default compression level (typically 6). | -| `-c `
`--compress-level ` | This is applicable only for full backup and tar format. Use this option to specify the gzip compression level on the tar file output. `` is a digit from 1 through 9, with 9 being the best compression. | -| `--backup-name ` | Use this option to assign a user-defined, alphanumeric friendly name to the backup. The maximum permitted length of backup name is 49 characters.
For detailed information about this parameter, see the EDB Backup and Recovery User Guide available at the [EDB website](/bart/latest/bart_user/).
If the option `--backup-name` is not specified and the `backup_name` parameter is not set for this database server in the BART configuration file, then the backup can only be referenced in other BART subcommands by the BART assigned backup identifier. | -| `--thread-count ` | Use this option to specify the number of worker threads to run in parallel to copy blocks for a backup.
For detailed information about the `--thread-count` parameter, see the EDB Backup and Recovery Installation and Upgrade Guide available at the [EDB website](/bart/latest/bart_inst/). | -| `--with-pg_basebackup` | This is applicable only for full backup. Use this option to specify the use of `pg_basebackup` to take a full backup. The number of thread counts in effect is ignored as given by the `thread_count` parameter in the BART configuration file.
When taking a full backup, if the thread count in effect is greater than `1`, then the `pg_basebackup` utility is not used to take the full backup (parallel worker threads are used) unless the `--with-pg_basebackup` option is specified with the `BACKUP` subcommand. | -| `--no-pg_basebackup` | This is applicable only for full backup. Use this option to specify that `pg_basebackup` is not to be used to take a full backup.
When taking a full backup, if the thread count in effect is only `1`, then the `pg_basebackup` utility is used to take the full backup unless the `--no-pg_basebackup` option is specified with the `BACKUP` subcommand. | -| `--parent { \| }` | Use this option to take an incremental backup. The parent backup is a backup taken prior to the incremental backup; it can be either a full backup or an incremental backup. `` is the backup identifier of a parent backup and `` is the user-defined alphanumeric name of a parent backup. | -| `--check` | This is applicable only for incremental backup. Use this option to verify if the required MBM files are present in the BART backup catalog before taking an incremental backup. However, an actual incremental backup is not taken when the `--check` option is specified.
The `--parent` option must be used along with the `--check` option. | - -**Examples** - -The following code sample demonstrates using variables with the `BACKUP` subcommand: - -```text -./bart backup -s ppas12 -Ft --backup-name "YEAR = %year MONTH = -%month DAY = %day" -``` - -```text -./bart backup -s ppas12 -Ft --backup-name "YEAR = %year MONTH = -%month DAY = %day %%" -``` - -```text -./bart show-backups -s ppas12 -i "test backup" -``` - -The following code sample displays the result of creating a full backup in the default tar format with gzip compression when the `BACKUP` subcommand was invoked. Note that checksums are generated for the full backup and user-defined tablespaces for the tar format backup: - -```text -[edb@localhost bin]$ ./bart BACKUP -s hr -z -INFO: DebugTarget - getVar(checkDiskSpace.bytesAvailable) -INFO: new backup identifier generated 1567591909098 -INFO: creating 5 harvester threads -NOTICE: all required WAL segments have been archived -INFO: backup completed successfully -INFO: -BART VERSION: 2.5 -BACKUP DETAILS: -BACKUP STATUS: active -BACKUP IDENTIFIER: 1567591909098 -BACKUP NAME: none -BACKUP PARENT: none -BACKUP LOCATION: /home/edb/bkup_new/hr/1567591909098 -BACKUP SIZE: 13.91 MB -BACKUP FORMAT: tar.gz -BACKUP TIMEZONE: America/New_York -XLOG METHOD: fetch -BACKUP CHECKSUM(s): 0 -TABLESPACE(s): 3 -Oid Name Location -16387 test1 /home/edb/tbl1 -16388 test2 /home/edb/tbl2 -16389 test3 /home/edb/tbl3 - -START WAL LOCATION: 000000010000000000000025 -STOP WAL LOCATION: 000000010000000000000026 -BACKUP METHOD: streamed -BACKUP FROM: master -START TIME: 2019-09-04 06:11:49 EDT -STOP TIME: 2019-09-04 06:11:53 EDT -TOTAL DURATION: 4 sec(s) -``` - -The following code sample displays information about the directory containing the full backup: - -```text -[edb@localhost bin]$number_of_threads> -[edb@localhost bin]$ ls -l /home/edb/bkup_new/hr/ -total 8 -drwxrwxr-x. 3 edb edb 34 Aug 27 05:57 1566899819709 -drwxrwxr-x. 3 edb edb 58 Aug 27 05:57 1566899827751 -drwxrwxr-x. 3 edb edb 4096 Sep 4 06:11 1567591909098 -drwxrwxr-x. 2 edb edb 4096 Sep 4 06:11 archived_wals -[edb@localhost bin]$ -``` - -The following code sample displays information about the creation of a full backup while streaming the transaction log. Note that the `-Fp` option must be specified with the `BACKUP` subcommand when streaming is used as a backup method. - -```text -[edb@localhost bin]$ ./bart BACKUP -s ACCTG -Fp -INFO: DebugTarget - getVar(checkDiskSpace.bytesAvailable) -INFO: new backup identifier generated 1566898964200 -INFO: creating 5 harvester threads -NOTICE: pg_stop_backup complete, all required WAL segments have been archived -INFO: backup completed successfully -INFO: -BART VERSION: 2.5 -BACKUP DETAILS: -BACKUP STATUS: active -BACKUP IDENTIFIER: 1566898964200 -BACKUP NAME: none -BACKUP PARENT: none -BACKUP LOCATION: /home/edb/bkup_new/acctg/1566898964200 -BACKUP SIZE: 46.03 MB -BACKUP FORMAT: plain -BACKUP TIMEZONE: US/Eastern -XLOG METHOD: fetch -BACKUP CHECKSUM(s): 0 -TABLESPACE(s): 0 -START WAL LOCATION: 000000010000000000000017 -BACKUP METHOD: streamed -BACKUP FROM: master -START TIME: 2019-08-27 05:42:44 EDT -STOP TIME: 2019-08-27 05:42:46 EDT -TOTAL DURATION: 2 sec(s) -``` - -The following code sample displays the assignment of a user-defined backup name with the `--backup-name` option: - -```text -[edb@localhost bin]$ ./bart BACKUP -s acctg --backup-name acctg_%year-%month-%day -INFO: DebugTarget - getVar(checkDiskSpace.bytesAvailable) -INFO: new backup identifier generated 1566899004804 -INFO: creating 5 harvester threads -NOTICE: pg_stop_backup complete, all required WAL segments have been archived -INFO: backup completed successfully -INFO: -BART VERSION: 2.5 -BACKUP DETAILS: -BACKUP STATUS: active -BACKUP IDENTIFIER: 1566899004804 -BACKUP NAME: acctg_2019-08-27 -BACKUP PARENT: none -BACKUP LOCATION: /home/edb/bkup_new/acctg/1566899004804 -BACKUP SIZE: 46.86 MB -BACKUP FORMAT: tar -BACKUP TIMEZONE: US/Eastern -XLOG METHOD: fetch -BACKUP CHECKSUM(s): 0 -TABLESPACE(s): 0 -START WAL LOCATION: 00000001000000000000001A -BACKUP METHOD: streamed -BACKUP FROM: master -START TIME: 2019-08-27 05:43:24 EDT -STOP TIME: 2019-08-27 05:43:24 EDT -TOTAL DURATION: 0 sec(s) -``` - -The following code sample displays an incremental backup taken by specifying the `--parent` option. The option `-Fp` must be specified while taking an incremental backup as incremental backup can be taken only in plain text format. - -```text -[edb@localhost bin]$ ./bart BACKUP -s hr -Fp --parent hr_full_1 --backup-name -hr_incr_1 -INFO: DebugTarget - getVar(checkDiskSpace.bytesAvailable) -INFO: checking /home/edb/bkup_new/hr/archived_wals for MBM files from 0/20000028 to -0/22000000 -INFO: new backup identifier generated 1566899827751 -INFO: creating 5 harvester threads -NOTICE: all required WAL segments have been archived -INFO: backup completed successfully -INFO: -BART VERSION: 2.5 -BACKUP DETAILS: -BACKUP STATUS: active -BACKUP IDENTIFIER: 1566899827751 -BACKUP NAME: hr_incr_1 -BACKUP PARENT: 1566899819709 -BACKUP LOCATION: /home/edb/bkup_new/hr/1566899827751 -BACKUP SIZE: 7.19 MB -BACKUP FORMAT: plain -BACKUP TIMEZONE: America/New_York -XLOG METHOD: fetch -BACKUP CHECKSUM(s): 0 -TABLESPACE(s): 0 -START WAL LOCATION: 000000010000000000000022 -STOP WAL LOCATION: 000000010000000000000023 -BACKUP METHOD: streamed -BACKUP FROM: master -START TIME: 2019-08-27 05:57:07 EDT -STOP TIME: 2019-08-27 05:57:08 EDT -TOTAL DURATION: 1 sec(s) -``` \ No newline at end of file diff --git a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/02_check_config.mdx b/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/02_check_config.mdx deleted file mode 100644 index 58e36c7c192..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/02_check_config.mdx +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: "CHECK-CONFIG" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.1/check_config.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.2/check_config.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.4/check_config.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.3/check_config.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.5/check_config.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.7/check_config.html" ---- - -The `CHECK-CONFIG` subcommand checks the global parameter settings as well as the database server configuration in the BART configuration file. - -The following syntax is used to check the BART configuration file global section settings. - -```text -bart CHECK-CONFIG -``` - -The following syntax is used to check the database server configuration settings. - -```text -bart CHECK-CONFIG [ –s ] -``` - -The following table describes the `CHECK-CONFIG` option: - -| Option | Description | -| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | -| `-s ` `--server ` | `` is the name of the database server whose configuration parameter settings are to be checked. | - -**Example** - -The following code sample demonstrates successfully checking the BART configuration file global parameters with the `bart CHECK-CONFIG` command: - -```text -bash-4.1$ bart CHECK-CONFIG -INFO: Verifying that pg_basebackup is executable -INFO: success - -INFO: success - pg_basebackup(/usr/edb/as11/bin/pg_basebackup) returns -version 11.400000 -``` - -The following code sample demonstrates successfully checking the BART configuration file database server parameters with the `bart CHECK-CONFIG` command with the `–s` option: - -```text -[edb@localhost bin]$ ./bart check-config -s hr -INFO: Checking server hr -INFO: Verifying cluster_owner and ssh/scp connectivity -INFO: success -INFO: Verifying user, host, and replication connectivity -INFO: success -INFO: Verifying that user is a database superuser -INFO: success -INFO: Verifying that cluster_owner can read cluster data files -INFO: success -INFO: Verifying that you have permission to write to vault -INFO: success -INFO: /home/edb/bkup_new/hr -INFO: Verifying database server configuration -INFO: success -INFO: Verifying that WAL archiving is working -INFO: waiting 30 seconds for -/home/edb/bkup_new/hr/archived_wals/00000001000000000000001E -INFO: success -INFO: Verifying that bart-scanner is configured and running -INFO: success -``` diff --git a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/03_delete.mdx b/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/03_delete.mdx deleted file mode 100644 index db2c111f44b..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/03_delete.mdx +++ /dev/null @@ -1,146 +0,0 @@ ---- -title: "DELETE" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.1/delete.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.2/delete.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.4/delete.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.3/delete.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.5/delete.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.7/delete.html" ---- - -The `DELETE` subcommand removes the subdirectory and data files from the BART backup catalog for the specified backups along with archived WAL files. - -**Syntax:** - -```text -bart DELETE –s --i { all | [']{ | },... }['] } -[ -n ] -``` - -Note that when invoking the `DELETE` subcommand, you must specify a database server. - -For database servers under a retention policy, there are conditions where certain backups may not be deleted. For more information, see the EDB Backup and Recovery User Guide available at the [EDB website](/bart/latest/bart_user/). - -The following table describes the `DELETE` options: - -| Options | Description | -| -------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-s `
`--server ` | `` is the name of the database server whose backups are to be deleted. | -| ``-i { all \| [']{ \| }',... }[`] }``

``--backupid { all \| [']{ \| }',... }[`] }`` | `` is the backup identifier of the backup to be deleted. `` is the user-defined alphanumeric name for the backup.
Multiple backup identifiers and backup names may be specified in a comma-separated list. The list must be enclosed within single quotes if there is any white space appearing before or after each comma (see [Example](#deleting_multiple_backups_with_space_characters)).
If `all` is specified, all backups and their archived WAL files for the specified database server are deleted. | -| `-n`
`--dry-run` | Performs the test run and displays the results prior to physically removing files; no files are actually deleted. | - -**Example** - -The following code sample demonstrates deleting a backup from the specified database server: - -```text -[edb@localhost bin]$ ./bart DELETE -s acctg -i acctg_2019-08-27 -INFO: deleting backup 'acctg_2019-08-27' of server 'acctg' -INFO: deleting backup '1566900093665' -INFO: WALs of deleted backup(s) will belong to prior backup(if any), or will -be marked unused -WARNING: not marking any WALs as unused WALs, the WAL file -'/home/edb/bkup_new/acctg/archived_wals/000000010000000000000025' -is required, yet not available in archived_wals directory -INFO: backup(s) deleted -[edb@localhost bin]$ -``` - -After the deletion, the BART backup catalog for the database server no longer contains the corresponding directory for the deleted `backup ID`. The following code sample displays information about `archived_wals` subdirectory that no longer contains the backup WAL files: - -```text -[edb@localhost acctg]$ ls -l -total 16 -drwxrwxr-x. 3 edb edb 4096 Aug 27 06:03 1566900199604 -drwxrwxr-x. 3 edb edb 4096 Aug 27 06:03 1566900204377 -drwxrwxr-x. 3 edb edb 4096 Aug 27 06:03 1566900209087 -drwxrwxr-x. 3 edb edb 4096 Aug 27 06:05 1566900321228 -drwxrwxr-x. 2 edb edb 6 Aug 27 06:01 archived_wals -``` - -The following code sample demonstrates deleting multiple backups from the database server. - -```text -[edb@localhost bin]$ ./bart DELETE -s acctg -i `1566988095633,1566988100760, -acctg_2019-08-28` -INFO: deleting backup `1566988095633` of server `acctg` -INFO: deleting backup `1566988095633` -INFO: WALs of deleted backup(s) will belong to prior backup(if any), or will -be marked unused -WARNING: not marking any WALs as unused WALs, the WAL file -`/home/edb/bkup_new/acctg/archived_wals/000000010000000000000037` is required, -yet not available in archived_wals directory -INFO: backup(s) deleted -INFO: deleting backup `1566988100760` of server `acctg` -INFO: deleting backup `1566988100760` -INFO: WALs of deleted backup(s) will belong to prior backup(if any), or will -be marked unused -WARNING: not marking any WALs as unused WALs, the WAL file -`/home/edb/bkup_new/acctg/archived_wals/000000010000000000000039` is -required, yet not available in archived_wals directory -INFO: backup(s) deleted -INFO: deleting backup `acctg_2019-08-28` of server `acctg` -INFO: deleting backup `1566988115512` -INFO: WALs of deleted backup(s) will belong to prior backup(if any), or will -be marked unused -WARNING: not marking any WALs as unused WALs, the WAL file -`/home/edb/bkup_new/acctg/archived_wals/00000001000000000000003C` is required, -yet not available in archived_wals directory -INFO: backup(s) deleted -[edb@localhost bin]$ -[edb@localhost bin]$ -[edb@localhost bin]$ -[edb@localhost acctg]$ -[edb@localhost acctg]$ ls -l -total 8 -drwxrwxr-x. 3 edb edb 4096 Aug 28 06:28 1566988105086 -drwxrwxr-x. 3 edb edb 4096 Aug 28 06:28 1566988109477 -drwxrwxr-x. 2 edb edb 6 Aug 28 06:09 archived_wals -[edb@localhost acctg]$ -``` - - - -**Deleting Multiple Backups with Space Characters** - -The following code sample demonstrates deleting multiple backups; since there are space characters in the comma-separated list, the entire list must be enclosed within single quotes: - -```text -[edb@localhost bin]$ ./bart DELETE -s acctg -i -`1566900199604,1566900204377,1566900209087`; -INFO: deleting backup `1566900199604` of server `acctg` -INFO: deleting backup `1566900199604` -INFO: WALs of deleted backup(s) will belong to prior backup(if any), or will -be marked unused -WARNING: not marking any WALs as unused WALs, the WAL file -`/home/edb/bkup_new/acctg/archived_wals/000000010000000000000028` is required, -yet not available in archived_wals directory -INFO: backup(s) deleted -INFO: deleting backup `1566900204377` of server `acctg` -INFO: deleting backup `1566900204377` -INFO: WALs of deleted backup(s) will belong to prior backup(if any), or will -be marked unused -WARNING: not marking any WALs as unused WALs, the WAL file -`/home/edb/bkup_new/acctg/archived_wals/00000001000000000000002A` is required, -yet not available in archived_wals directory -INFO: backup(s) deleted -INFO: deleting backup `1566900209087` of server `acctg` -INFO: deleting backup `1566900209087` -INFO: WALs of deleted backup(s) will belong to prior backup(if any), or will -be marked unused -WARNING: not marking any WALs as unused WALs, the WAL file -`/home/edb/bkup_new/acctg/archived_wals/00000001000000000000002C` is required, -yet not available in archived_wals directory -INFO: backup(s) deleted -[edb@localhost bin]$ -[edb@localhost bin]$ -[edb@localhost acctg]$ ls -l -total 4 -drwxrwxr-x. 3 edb edb 4096 Aug 27 06:05 1566900321228 -drwxrwxr-x. 2 edb edb 6 Aug 27 06:01 archived_wals -[edb@localhost acctg]$ -``` diff --git a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/04_init.mdx b/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/04_init.mdx deleted file mode 100644 index eb4787a6271..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/04_init.mdx +++ /dev/null @@ -1,281 +0,0 @@ ---- -title: "INIT" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.1/init.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.2/init.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.4/init.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.3/init.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.5/init.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.7/init.html" ---- - - - -The `INIT` subcommand is used to create the BART backup catalog directory, rebuild the BART `backupinfo` file, and set the `archive_command` in the server based on the `archive_command` setting in the `bart.cfg` file. - -**Syntax:** - -```text -bart INIT [ –s { | all } ] [ -o ] - -[ -r [ -i { | | all } ] ] - -[--no-configure] -``` - -The following table describes the `INIT` options: - -| Options | Description | -| ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-s { \| all }`
`--server { \| all }` | `` is the name of the database server to which the `INIT` actions are to be applied. If `all` is specified or if the option is omitted, actions are applied to all servers. | -| `-o`
`--override` | Overrides the existing Postgres `archive_command` configuration parameter setting in the `postgresql.conf` file or the `postgresql.auto.conf` file using the BART `archive_command` parameter in the BART configuration file. The `INIT` generated `archive command` string is written to the `postgresql.auto.conf` file. | -| `-r`
`--rebuild` | Rebuilds the `backupinfo` file located in each backup subdirectory. If `all` is specified or if the option is omitted, the `backupinfo` files of all backups for the database servers specified by the `-s` option are recreated. This option is only intended for recovering from a situation where the backupinfo file has become corrupt.
If the backup was initially created with a user-defined backup name, and then the `INIT -r` option is invoked to rebuild that `backupinfo` file, the user-defined backup name is no longer available. Thus, future references to the backup must use the backup identifier. | -| `-i { \| \| all }`
`--backupid { \| \| all }` | `` is an integer, backup identifier and `` is the user-defined alphanumeric name for the backup. The `-i` option can only be used with the `-r` option. | -| `--no-configure` | Prevents the `archive_command` from being set in the PostgreSQL server. | - -**Examples** - -In the following code sample, you can see that `archive_mode = off` and `archive_command` is not set. After invoking the BART `INIT` subcommand, `archive_mode` is set to `on` and `archive_command` is set: - -```text -archive_mode = off # enables archiving; off, on, or always -# (change requires restart) -archive_command = '' -# command to use to archive a logfile segment -[edb@localhost bin]$ ./bart init -s ppas11 -INFO: setting archive_mode/archive_command for server 'ppas11' -WARNING: archive_mode/archive_command is set. Restart the PostgreSQL -server using 'pg_ctl restart' -[edb@localhost bin]$ -# Do not edit this file manually! -# It will be overwritten by the ALTER SYSTEM command. -archive_mode = 'on' -archive_command = 'scp %p -edb@127.0.0.1:/home/edb/bkup/ppas11/archived_wals/%f' -``` - -In the following code sample, you can see that `archive_mode = on`, and `archive_command` is not set. After invoking the `INIT` subcommand, `archive_command` is set: - -```text -archive_mode = on # enables archiving; off, on, or always -# (change requires restart) -archive_command = '' # command to use to archive a logfile segment -[edb@localhost bin]$ ./bart init -s ppas11 -INFO: setting archive_mode/archive_command for server 'ppas11' -WARNING: archive_command is set. Reload the configuration in the -PostgreSQL server using pg_reload_conf() or 'pg_ctl reload' -[edb@localhost bin]$ -# Do not edit this file manually! -# It will be overwritten by the ALTER SYSTEM command. -archive_command = 'scp %p -edb@127.0.0.1:/home/edb/bkup/ppas11/archived_wals/%f' -``` - -In the following code sample, you can see that `archive_mode = on` and `archive_command` are already set. After invoking the `INIT` subcommand, there is no change in their settings. Note that to override the existing `archive_command`, you must include the `-o` option. - -```text -archive_mode = on # enables archiving; off, on, or always -# (change requires restart) -archive_command = 'scp %p -edb@127.0.0.1:/home/edb/bkup/ppas11/archived_wals/%f' # command to use -to archive a logfile segment -# placeholders: %p = path of file to archive -[edb@localhost bin]$ ./bart init -s ppas11 -INFO: setting archive_mode/archive_command for server 'ppas11' -WARNING: archive_command is not set for server 'ppas11' -[edb@localhost bin]$ -# Do not edit this file manually! -# It will be overwritten by the ALTER SYSTEM command. -``` - -In the following code sample, you can see that `archive_mode = off` and `archive_command` is already set. After invoking the `INIT` subcommand `archive_mode` is set to `on`: - -```text -archive_mode = off # enables archiving; off, on, or always -# (change requires restart) -archive_command = 'scp %p -edb@127.0.0.1:/home/edb/bkup/ppas11/archived_wals/%f' # command to use -to archive a log file segment -[edb@localhost bin]$ ./bart init -s ppas11 -INFO: setting archive_mode/archive_command for server 'ppas11' -WARNING: archive_mode/archive_command is set. Restart the PostgreSQL -server using 'pg_ctl restart' -# Do not edit this file manually! -# It will be overwritten by the ALTER SYSTEM command. -archive_mode = 'on' -archive_command = 'scp %p -edb@127.0.0.1:/home/edb/bkup/ppas11/archived_wals/%f' -``` - -In the following code sample an existing `archive command` setting is overridden by resetting the `archive_command` in the PostgreSQL server with the `archive_command = 'cp %p %a/%f'` parameter from the `bart.cfg` file: - -```text -[BART] - -bart_host= enterprisedb@192.168.2.22 -backup_path = /opt/backup_edb -pg_basebackup_path = /usr/edb/as11/bin/pg_basebackup -logfile = /tmp/bart.log -scanner_logfile = /tmp/bart_scanner.log - -[ACCTG] - -host = 127.0.0.1 -port = 5444 -user = repuser -cluster_owner = enterprisedb -archive_command = 'cp %p %a/%f' -description = "Accounting" -``` - -The `archive_mode` and `archive_command` parameters in the database server are set as follows: - -```text -edb=# SHOW archive_mode; -archive_mode --------------- -on -(1 row) -edb=# SHOW archive_command; -archive_command ------------------------------------------------------------------- -scp %p bartuser@192.168.2.22:/opt/backup/acctg/archived_wals/%f - -(1 row) -``` - -Invoke the `INIT` subcommand with the `-o` option to override the current `archive_command` setting in the PostgreSQL server: - -```text --bash-4.1$ bart INIT -s acctg -o -INFO: setting archive_mode/archive_command for server 'acctg' -WARNING: archive_command is set. Reload the configuration in the -PostgreSQL server using pg_reload_conf() or 'pg_ctl reload' -``` - -Reload the database server configuration; a restart of the database server is not necessary to reset only the `archive_command` parameter: - -```text -[root@localhost tmp]# service ppas11 reload -``` - -The `archive_command` in the PostgreSQL server is now set as follows: - -```text -edb=# SHOW archive_command; - archive_command ------------------------------------------------ -cp %p /opt/backup_edb/acctg/archived_wals/%f -(1 row) -``` - -The new command string is written to the `postgresql.auto.conf` file: - -```text -# Do not edit this file manually! -# It will be overwritten by ALTER SYSTEM command. -archive_command = 'cp %p /opt/backup_edb/acctg/archived_wals/%f' -``` - -When you invoke the BART `INIT` command with the `-r` option, BART rebuilds the `backupinfo` file using the content of the backup directory for the server specified or for all servers. The BART `backupinfo` file is initially created by the `BACKUP` subcommand and contains the backup information used by BART. - -!!! Note - If the backup was initially created with a user-defined backup name, and then the `INIT -r` option is invoked to rebuild the `backupinfo` file, the user-defined backup name is no longer available. Thus, future references to the backup must use the backup identifier. - -The following code sample shows the `backupinfo` file location in a backup subdirectory: - -```text -[root@localhost acctg]# pwd -/opt/backup/acctg -[root@localhost acctg]# ls -l -total 4 -drwx------ 2 enterprisedb enterprisedb 38 Oct 26 10:21 1477491569966 -drwxrwxr-x 2 enterprisedb enterprisedb 4096 Oct 26 10:19 archived_wals -[root@localhost acctg]# ls -l 1477491569966 -total 61144 --rw-rw-r-- 1 enterprisedb enterprisedb 703 Oct 26 10:19 backupinfo --rw-rw-r-- 1 enterprisedb enterprisedb 62603776 Oct 26 10:19 base.tar -``` - -The following code sample displays the `backupinfo` file content: - -```text -BACKUP DETAILS: -BACKUP STATUS: active -BACKUP IDENTIFIER: 1477491569966 -BACKUP NAME: none -BACKUP PARENT: none -BACKUP LOCATION: /opt/backup/acctg/1477491569966 -BACKUP SIZE: 59.70 MB -BACKUP FORMAT: tar -BACKUP TIMEZONE: -XLOG METHOD: fetch -BACKUP CHECKSUM(s): 1 -ChkSum File -84b3eeb1e3f7b3e75c2f689570d04f10 base.tar -TABLESPACE(s): 0 -START WAL LOCATION: 2/A5000028 (file 0000000100000002000000A5) -STOP WAL LOCATION: 2/A50000C0 (file 0000000100000002000000A5) -CHECKPOINT LOCATION: 2/A5000028 -BACKUP METHOD: streamed -BACKUP FROM: master -START TIME: 2016-10-26 10:19:30 EDT -LABEL: pg_basebackup base backup -STOP TIME: 2016-10-26 10:19:30 EDT -TOTAL DURATION: 0 sec(s) -``` - -The following code sample displays an error message if the `backupinfo` file is missing when invoking a BART subcommand: - -```text --bash-4.2$ bart SHOW-BACKUPS -ERROR: 'backupinfo' file does not exist for backup '1477491569966' -please use 'INIT -r' to generate the file -``` - -The `backupinfo` file may be missing if the `BACKUP` subcommand did not complete successfully. - -The following code sample displays information about rebuilding the `backupinfo` file of the specified backup for database server `acctg`: - -```text --bash-4.1$ bart INIT -s acctg -r -i 1428346620427 -INFO: rebuilding BACKUPINFO for backup '1428346620427' of server 'acctg' -INFO: backup checksum: ced59b72a7846ff8fb8afb6922c70649 of base.tar -``` - -The following code sample displays information about how the `backupinfo` files of all backups are rebuilt for all database servers: - -```text --bash-4.1$ bart INIT -r - -INFO: rebuilding BACKUPINFO for backup '1428347191544' of server 'acctg' -INFO: backup checksum: 1ac5c61f055c910db314783212f2544f of base.tar -INFO: rebuilding BACKUPINFO for backup '1428346620427' of server 'acctg' -INFO: backup checksum: ced59b72a7846ff8fb8afb6922c70649 of base.tar -INFO: rebuilding BACKUPINFO for backup '1428347198335' of server 'dev' -INFO: backup checksum: a8890dd8ab7e6be5d5bc0f38028a237b of base.tar -INFO: rebuilding BACKUPINFO for backup '1428346957515' of server 'dev' -INFO: backup checksum: ea62549cf090573625d4adeb7d919700 of base.tar -``` - -The following code sample displays information about invoking `BART INIT` with the `-r - i` option: - -```text -edb@localhost bin]$ ./bart init -s ppas11 -i 1551778898392 -r -INFO: rebuilding BACKUPINFO for backup '1551778898392' of server -'ppas11' -[edb@localhost bin]$ ls /home/edb/bkup/ppas11/1551778898392/ -backupinfo backup_label base base-1.tar base-2.tar base-3.tar -base-4.tar base-5.tar base.tar -``` - -The following code sample displays information about invoking the `BART INIT` command with the `--no-configure` option. You can use the `--no-configure` option with the `INIT` subcommand to prevent the `archive_command` option from being set in the PostgreSQL server. - -```text -[edb@localhost bin]$ ./bart init -s ppas11 -o --no-configure -[edb@localhost bin]$ -# Do not edit this file manually! -# It will be overwritten by the ALTER SYSTEM command. -``` diff --git a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/05_manage.mdx b/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/05_manage.mdx deleted file mode 100644 index 1ad4db55e15..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/05_manage.mdx +++ /dev/null @@ -1,233 +0,0 @@ ---- -title: "MANAGE" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.1/manage.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.2/manage.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.4/manage.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.3/manage.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.5/manage.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.7/manage.html" ---- - -The `MANAGE` subcommand can be invoked to: - -- Evaluate backups, mark their status, and delete obsolete backups based on the `retention_policy` parameter in the BART configuration file. -- Compress the archived WAL files based on the `wal_compression` parameter in the BART configuration file. - -**Syntax:** - -```text -bart MANAGE [ –s { | all} ] -[ -l ] [ -d ] -[ -c { keep | nokeep } --i { | | all } ] -[ -n ] -``` - -To view detailed information about the `MANAGE` subcommand and retention policy management, see *the EDB Backup and Recovery User Guide*. For information about setting the `wal_compression` parameter, see the *EDB Backup and Recovery Installation and Upgrade Guide*. These guides are available at the [EDB website](/bart/latest/bart_user/). - -The following table describes the `MANAGE` options: - -| Options | Description | -| ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `-s [ \| all ]`
`--server [ \| all ]` | `` is the name of the database server to which the `MANAGE` actions are to be applied.
If `all` is specified or if the `-s` option is omitted, actions are applied to all database servers. | -| `-l`
`--list-obsolete` | Lists the backups marked as obsolete. | -| `-d`
`--delete-obsolete` | Deletes the backups marked as obsolete. This action physically deletes the backup along with its archived WAL files and any MBM files for incremental backups. | -| `-c { keep \| nokeep }`
`--change-status { keep \| nokeep }` | Specify `keep` to change the backup status to `keep` to retain the backup indefinitely.

Specify `nokeep` to change the backup status back to `active`. You can then re-evaluate and possibly mark the backup as `obsolete` (according to the retention policy) using the `MANAGE` subcommand.

The `-c` option can only be used with the `-i` option. | -| `-i { \| \| all` }

`--backupid { \| \| all` } | `` is a backup identifier and `` is the user-defined alphanumeric name for the backup.
If `all` is specified, actions are applied to all backups.
The `-i` option can only be used with the `-c` option. | -| `-n`
`--dry-run` | Performs the test run and displays the results prior to actually implementing the actions as if the operation was performed, however, no changes are actually made.
If you specify `-n` with the `-d` option, it displays which backups would be deleted, but does not actually delete the backups.
If you specify `-n` with the `-c` option, it displays the keep or nokeep action, but does not actually change the backup status.
If you specify `-n` alone with no other options or if you specify `-n` with only the `-s` option, it displays which active backups would be marked as obsolete, but does not actually change the backup status. In addition, no compression is performed on uncompressed, archived WAL files even if WAL compression is enabled for the database server. | - -**Example** - -The following code sample performs a dry run for the specified database server displaying which active backups are evaluated as obsolete according to the retention policy, but does not actually change the backup status: - -```text --bash-4.2$ bart MANAGE -s acctg -n -INFO: processing server 'acctg', backup '1482770807519' -INFO: processing server 'acctg', backup '1482770803000' -INFO: marking backup '1482770803000' as obsolete -INFO: 1 WAL file(s) marked obsolete -INFO: processing server 'acctg', backup '1482770735155' -INFO: marking backup '1482770735155' as obsolete -INFO: 2 incremental(s) of backup '1482770735155' will be marked obsolete -INFO: marking incremental backup '1482770780423' as obsolete -INFO: marking incremental backup '1482770763227' as obsolete -INFO: 3 WAL file(s) marked obsolete -INFO: 1 Unused WAL file(s) present -INFO: 2 Unused file(s) (WALs included) present, use 'MANAGE -l' for the -list -``` - -The following code sample marks active backups as obsolete according to the retention policy for the specified database server: - -```text --bash-4.2$ bart MANAGE -s acctg -INFO: processing server 'acctg', backup '1482770807519' -INFO: processing server 'acctg', backup '1482770803000' -INFO: marking backup '1482770803000' as obsolete -INFO: 1 WAL file(s) marked obsolete -INFO: processing server 'acctg', backup '1482770735155' -INFO: marking backup '1482770735155' as obsolete -INFO: 2 incremental(s) of backup '1482770735155' will be marked obsolete -INFO: marking incremental backup '1482770780423' as obsolete -INFO: marking incremental backup '1482770763227' as obsolete -INFO: 3 WAL file(s) marked obsolete -INFO: 1 Unused WAL file(s) present -INFO: 2 Unused file(s) (WALs included) present, use 'MANAGE -l' for the -list -``` - -The following code sample lists backups marked as obsolete for the specified database server: - -```text --bash-4.2$ bart MANAGE -s acctg -l -SERVER NAME: acctg -BACKUP ID: 1482770803000 -BACKUP STATUS: obsolete -BACKUP TIME: 2016-12-26 11:46:43 EST -BACKUP SIZE: 59.52 MB -WAL FILE(s): 1 -WAL FILE: 000000010000000100000055 -SERVER NAME: acctg -BACKUP ID: 1482770735155 -BACKUP STATUS: obsolete -BACKUP TIME: 2016-12-26 11:45:35 EST -BACKUP SIZE: 59.52 MB -INCREMENTAL BACKUP(s): 2 -BACKUP ID: 1482770780423 -BACKUP PARENT: 1482770735155 -BACKUP STATUS: obsolete -BACKUP TIME: 2016-12-26 11:45:35 EST -BACKUP SIZE: 59.52 MB -BACKUP ID: 1482770763227 -BACKUP PARENT: 1482770735155 -BACKUP STATUS: obsolete -BACKUP TIME: 2016-12-26 11:45:35 EST -BACKUP SIZE: 59.52 MB -WAL FILE(s): 3 -WAL FILE: 000000010000000100000054 -WAL FILE: 000000010000000100000053 -WAL FILE: 000000010000000100000052 -UNUSED FILE(s): 2 -UNUSED FILE: 000000010000000100000051 -UNUSED FILE: 0000000100000001510000280000000152000000.mbm -``` - -The following code sample deletes the obsolete backups for the specified database server: - -```text --bash-4.2$ bart MANAGE -s acctg -d -INFO: removing all obsolete backups of server 'acctg' -INFO: removing obsolete backup '1482770803000' -INFO: 1 WAL file(s) will be removed -INFO: removing WAL file '000000010000000100000055' -INFO: removing obsolete backup '1482770735155' -INFO: 3 WAL file(s) will be removed -INFO: 2 incremental(s) of backup '1482770735155' will be removed -INFO: removing obsolete incremental backup '1482770780423' -INFO: removing obsolete incremental backup '1482770763227' -INFO: removing WAL file '000000010000000100000054' -INFO: removing WAL file '000000010000000100000053' -INFO: removing WAL file '000000010000000100000052' -INFO: 8 Unused file(s) will be removed -INFO: removing (unused) file '000000010000000100000056.00000028.backup' -INFO: removing (unused) file '000000010000000100000056' -INFO: removing (unused) file '000000010000000100000055.00000028.backup' -INFO: removing (unused) file '000000010000000100000054.00000028.backup' -INFO: removing (unused) file '000000010000000100000053.00000028.backup' -INFO: removing (unused) file '000000010000000100000052.00000028.backup' -INFO: removing (unused) file '000000010000000100000051' -INFO: removing (unused) file -'0000000100000001510000280000000152000000.mbm' -``` - -The following code sample changes the specified backup to keep status to retain it indefinitely: - -```text --bash-4.2$ bart MANAGE -s acctg -c keep -i 1482770807519 -INFO: changing status of backup '1482770807519' of server 'acctg' from -'active' to 'keep' -INFO: 1 WAL file(s) changed --bash-4.2$ bart SHOW-BACKUPS -s acctg -i 1482770807519 -t -SERVER NAME : acctg -BACKUP ID : 1482770807519 -BACKUP NAME : none -BACKUP PARENT : none -BACKUP STATUS : keep -BACKUP TIME : 2016-12-26 11:46:47 EST -BACKUP SIZE : 59.52 MB -WAL(S) SIZE : 16.00 MB -NO. OF WALS : 1 -FIRST WAL FILE : 000000010000000100000057 -CREATION TIME : 2016-12-26 11:52:47 EST -LAST WAL FILE : 000000010000000100000057 -CREATION TIME : 2016-12-26 11:52:47 EST -``` - -The following code sample resets the specified backup to active status: - -```text --bash-4.2$ bart MANAGE -s acctg -c nokeep -i 1482770807519 -INFO: changing status of backup '1482770807519' of server 'acctg' from -'keep' to 'active' -INFO: 1 WAL file(s) changed --bash-4.2$ bart SHOW-BACKUPS -s acctg -i 1482770807519 -t -SERVER NAME : acctg -BACKUP ID : 1482770807519 -BACKUP NAME : none -BACKUP PARENT : none -BACKUP STATUS : active -BACKUP TIME : 2016-12-26 11:46:47 EST -BACKUP SIZE : 59.52 MB -WAL(S) SIZE : 16.00 MB -NO. OF WALS : 1 -FIRST WAL FILE : 000000010000000100000057 -CREATION TIME : 2016-12-26 11:52:47 EST -LAST WAL FILE : 000000010000000100000057 -CREATION TIME : 2016-12-26 11:52:47 EST -``` - -The following code sample uses the enabled `wal_compression` parameter in the BART configuration file as shown by the following: - -```text -[ACCTG] - -host = 127.0.0.1 -port = 5445 -user = enterprisedb -cluster_owner = enterprisedb -allow_incremental_backups = disabled -wal_compression = enabled -description = "Accounting" -``` - -When the `MANAGE` subcommand is invoked, the following message is displayed indicating that WAL file compression is performed: - -```text --bash-4.2$ bart MANAGE -s acctg -INFO: 4 WAL file(s) compressed -WARNING: 'retention_policy' is not set for server 'acctg' -``` - -The following code sample shows the archived WAL files in compressed format: - -```text --bash-4.2$ pwd -/opt/backup/acctg --bash-4.2$ ls -l archived_wals -total 160 --rw------- 1 enterprisedb enterprisedb 27089 Dec 26 12:16 -00000001000000010000005B.gz --rw------- 1 enterprisedb enterprisedb 305 Dec 26 12:17 -00000001000000010000005C.00000028.backup --rw------- 1 enterprisedb enterprisedb 27112 Dec 26 12:17 -00000001000000010000005C.gz --rw------- 1 enterprisedb enterprisedb 65995 Dec 26 12:18 -00000001000000010000005D.gz --rw------- 1 enterprisedb enterprisedb 305 Dec 26 12:18 -00000001000000010000005E.00000028.backup --rw------- 1 enterprisedb enterprisedb 27117 Dec 26 12:18 -00000001000000010000005E.gz -``` diff --git a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/06_restore.mdx b/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/06_restore.mdx deleted file mode 100644 index 599cc80d248..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/06_restore.mdx +++ /dev/null @@ -1,163 +0,0 @@ ---- -title: "RESTORE" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.1/restore.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.2/restore.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.4/restore.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.3/restore.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.5/restore.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.7/restore.html" ---- - -The `RESTORE` subcommand restores a backup and its archived WAL files for the designated database server to the specified directory location. - -**Syntax for Restore**: - -```text -bart RESTORE –s -p -[ –i { | } ] -[ -r @ ] -[ -w ] -[ -t ] -[ { -x | -g } ] -[ -c ] -``` - -To view detailed information about the `RESTORE` subcommand, see the *EDB Backup and Recovery User Guide* available at the [EDB website](/bart/latest/bart_user/). - -If the backup is restored to a different database cluster directory than where the original database cluster resided, then some operations dependent upon the database cluster location may fail. This happens if the supporting service scripts are not updated to reflect the new directory location of restored backup. - -For information about the use and modification of service scripts, see the EDB Advanced Server Installation Guide available at the [EDB website](/epas/latest/). - -The following table describes the `RESTORE` options: - -| Options | Description | -| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-s `
`--server ` | `` is the name of the database server to be restored. | -| `-p --restore-path `
`--restore-path ` | `` is the directory path where the backup of the database server is to be restored. The directory must be empty and have the proper ownership and privileges assigned to it. | -| `-i { \| }`

`--backupid { \| }` | `backup_id` is the backup identifier of the backup to be used for the restoration and `` is the user-defined alphanumeric name for the backup.
If the option is omitted, the latest backup is restored by default. | -| `-r `

`--remote-host ` | `` is the user account on the remote database server host that accepts a passwordless SSH/SCP login connection and is the owner of the directory where the backup is to be restored.
`` is the IP address of the remote host to which the backup is to be restored. This option must be specified if the `remote_host` parameter for this database server is not set in the BART configuration file.
For information about the `remote_host` parameter, see the *EDB Backup and Recovery Installation and Upgrade Guide* available at the [EDB website](/bart/latest/bart_inst/). | -| `-w `
`--workers ` | `` is the number of worker processes to run in parallel to stream the modified blocks of an incremental backup to the restore location. If the `-w` option is omitted, the default is `1` worker process.
For example, if four worker processes are specified, four receiver processes on the restore host and four streamer processes on the BART host are used. The output of each streamer process is connected to the input of a receiver process.
When the receiver gets to the point where it needs a modified block file, it obtains those modified blocks from its input. With this method, the modified block files are never written to the restore host disk. | -| `-t `
`--target-tli ` | `` is the integer identifier of the timeline to be used for replaying the archived WAL files for point-in-time recovery. | -| `-x `
`--target-xid ` | `` is the integer identifier of the transaction ID that determines the transaction up to and including, which point-in-time recovery encompasses. | -| `-g `

`--target-timestamp ` | `` is the timestamp that determines the point in time up to and including, which point-in-time recovery encompasses. | -| `-c`

`--copy-wals` | Specify this option to copy archived WAL files from the BART backup catalog to `/archived_wals` directory.
The `restore_command` retrieves the WAL files from `/archived_wals` for the database server archive recovery.
If the `-c` option is omitted and the `copy_wals_during_restore` parameter in the BART configuration file is not enabled in a manner applicable to this database server, then the `restore_command` in the `postgresql.conf` retrieves the archived WAL files directly from the BART backup catalog.
For information about the `copy_wals_during_restore` parameter, see the EDB Backup and Recovery Installation and Upgrade Guide available at the [EDB website](/bart/latest/bart_inst/). | - -**Examples** - -The following code sample restores a database server(named `mktg`) to the `/opt/restore` directory up to timestamp `2015-12-15 10:47:00`: - -```text --bash-4.1$ bart RESTORE -s mktg -i 1450194208824 -p /opt/restore -t 1 -g -'2015-12-15 10:47:00' -INFO: restoring backup '1450194208824' of server 'mktg' -INFO: restoring backup to enterprisedb@192.168.2.24:/opt/restore -INFO: base backup restored -INFO: WAL file(s) will be streamed from the BART host -INFO: writing recovery settings to postgresql.auto.conf file -INFO: archiving is disabled -INFO: tablespace(s) restored -``` - -The following parameters are set in the `postgresql.auto.conf` file: - -```text -restore_command = 'scp -o BatchMode=yes -o PasswordAuthentication=no -enterprisedb@192.168.2.22:/opt/backup/mktg/archived_wals/%f %p' -recovery_target_time = '2015-12-15 10:47:00' -recovery_target_timeline = 1 -``` - -The following is a list of the restored files and subdirectories: - -```text -[root@localhost restore]# pwd -/opt/restore -[root@localhost restore]# ls -l -total 108 --rw------- 1 enterprisedb enterprisedb 208 Dec 15 10:43 backup_label -drwx------ 6 enterprisedb enterprisedb 4096 Dec 2 10:38 base -drwx------ 2 enterprisedb enterprisedb 4096 Dec 15 10:42 dbms_pipe -drwx------ 2 enterprisedb enterprisedb 4096 Dec 15 11:00 global -drwx------ 2 enterprisedb enterprisedb 4096 Nov 10 15:38 pg_clog\ --rw------- 1 enterprisedb enterprisedb 4438 Dec 2 10:38 pg_hba.conf --rw------- 1 enterprisedb enterprisedb 1636 Nov 10 15:38 pg_ident.conf -drwxr-xr-x 2 enterprisedb enterprisedb 4096 Dec 15 10:42 pg_log -drwx------ 4 enterprisedb enterprisedb 4096 Nov 10 15:38 pg_multixact -drwx------ 2 enterprisedb enterprisedb 4096 Dec 15 10:42 pg_notify -drwx------ 2 enterprisedb enterprisedb 4096 Nov 10 15:38 pg_serial -drwx------ 2 enterprisedb enterprisedb 4096 Nov 10 15:38 pg_snapshots -drwx------ 2 enterprisedb enterprisedb 4096 Dec 15 10:42 pg_stat -drwx------ 2 enterprisedb enterprisedb 4096 Dec 15 10:43 pg_stat_tmp -drwx------ 2 enterprisedb enterprisedb 4096 Nov 10 15:38 pg_subtrans -drwx------ 2 enterprisedb enterprisedb 4096 Dec 15 11:00 pg_tblspc -drwx------ 2 enterprisedb enterprisedb 4096 Nov 10 15:38 pg_twophase --rw------- 1 enterprisedb enterprisedb 4 Nov 10 15:38 PG_VERSION -drwx------ 2 enterprisedb enterprisedb 4096 Dec 15 11:00 pg_xlog --rw------- 1 enterprisedb enterprisedb 23906 Dec 15 11:00 -postgresql.conf --rw-r--r-- 1 enterprisedb enterprisedb 217 Dec 15 11:00 -postgresql.auto.conf -``` - -**Example** - -The following code sample performs a `RESTORE` operation with the `copy_wals_during_restore` parameter enabled to copy the archived WAL files to the local `/archived_wals` directory: - -```text --bash-4.1$ bart RESTORE -s hr -i hr_2017-03-29T13:50 -p -/opt/restore_pg96 -t 1 -g '2017-03-29 14:01:00' -INFO: restoring backup 'hr_2017-03-29T13:50' of server 'hr' -INFO: base backup restored -INFO: copying WAL file(s) to -postgres@192.168.2.24:/opt/restore_pg96/archived_wals -INFO: writing recovery settings to postgresql.auto.conf file -INFO: archiving is disabled -INFO: permissions set on $PGDATA -INFO: restore completed successfully -``` - -The following parameters are set in the `postgresql.auto.conf` file: - -```text -restore_command = 'cp archived_wals/%f %p' -recovery_target_time = '2017-03-29 14:01:00' -recovery_target_timeline = 1 -``` - -The following is a list of the restored files and subdirectories: - -```text --bash-4.1$ pwd -/opt/restore_pg96 --bash-4.1$ ls -l -total 128 -drwxr-xr-x 2 postgres postgres 4096 Mar 29 14:27 archived_wals --rw------- 1 postgres postgres 206 Mar 29 13:50 backup_label -drwx------ 5 postgres postgres 4096 Mar 29 12:25 base -drwx------ 2 postgres postgres 4096 Mar 29 14:27 global -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_clog -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_commit_ts -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_dynshmem --rw------- 1 postgres postgres 4212 Mar 29 13:18 pg_hba.conf --rw------- 1 postgres postgres 1636 Mar 29 12:25 pg_ident.conf -drwxr-xr-x 2 postgres postgres 4096 Mar 29 13:45 pg_log -drwx------ 4 postgres postgres 4096 Mar 29 12:25 pg_logical -drwx------ 4 postgres postgres 4096 Mar 29 12:25 pg_multixact -drwx------ 2 postgres postgres 4096 Mar 29 13:43 pg_notify -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_replslot -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_serial -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_snapshots -drwx------ 2 postgres postgres 4096 Mar 29 13:43 pg_stat -drwx------ 2 postgres postgres 4096 Mar 29 13:50 pg_stat_tmp -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_subtrans -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_tblspc -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_twophase --rw------- 1 postgres postgres 4 Mar 29 12:25 PG_VERSION -drwx------ 3 postgres postgres 4096 Mar 29 14:27 pg_xlog --rw------- 1 postgres postgres 169 Mar 29 13:24 postgresql.auto.conf --rw-r--r-- 1 postgres postgres 21458 Mar 29 14:27 postgresql.conf --rw-r--r-- 1 postgres postgres 118 Mar 29 14:27 postgresql.auto.conf -``` \ No newline at end of file diff --git a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/07_show_servers.mdx b/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/07_show_servers.mdx deleted file mode 100644 index 960629f126b..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/07_show_servers.mdx +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: "SHOW-SERVERS" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.1/show_servers.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.2/show_servers.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.4/show_servers.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.3/show_servers.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.5/show_servers.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.7/show_servers.html" ---- - -The `SHOW-SERVERS` subcommand displays information for the managed database servers listed in the BART configuration file. - -**Syntax:** - -```text -bart SHOW-SERVERS [ –s { | all } ] -``` - -The following table describes the `SHOW-SERVERS` option: - -| Option | Description | -| ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-s { \| all` }
`--server { \| all` } | `` is the name of the database server to which the `SHOW-SERVERS` actions are to be applied.
If `all` is specified or if the `-s` option is omitted, the actions are applied to all database servers. | - -**Example** - -The following code sample shows all the database servers managed by BART as returned by the `SHOW-SERVERS` subcommand: - -```text --bash-4.2$ bart SHOW-SERVERS -SERVER NAME : acctg -BACKUP FRIENDLY NAME: acctg_%year-%month-%dayT%hour:%minute -HOST NAME : 127.0.0.1 -USER NAME : enterprisedb -PORT : 5444 -REMOTE HOST : -RETENTION POLICY : 6 Backups -DISK UTILIZATION : 0.00 bytes -NUMBER OF ARCHIVES : 0 -ARCHIVE PATH : /opt/backup/acctg/archived_wals -ARCHIVE COMMAND : (disabled) -XLOG METHOD : fetch -WAL COMPRESSION : disabled -TABLESPACE PATH(s) : -INCREMENTAL BACKUP : DISABLED -DESCRIPTION : "Accounting" -SERVER NAME : hr -BACKUP FRIENDLY NAME: hr_%year-%month-%dayT%hour:%minute -HOST NAME : 192.168.2.24 -USER NAME : postgres -PORT : 5432 -REMOTE HOST : postgres@192.168.2.24 -RETENTION POLICY : 6 Backups -DISK UTILIZATION : 0.00 bytes -NUMBER OF ARCHIVES : 0 -ARCHIVE PATH : /opt/backup/hr/archived_wals -ARCHIVE COMMAND : (disabled) -XLOG METHOD : fetch -WAL COMPRESSION : disabled -TABLESPACE PATH(s) : -INCREMENTAL BACKUP : DISABLED -DESCRIPTION : "Human Resources" -SERVER NAME : mktg -BACKUP FRIENDLY NAME: mktg_%year-%month-%dayT%hour:%minute -HOST NAME : 192.168.2.24 -USER NAME : repuser -PORT : 5444 -REMOTE HOST : enterprisedb@192.168.2.24 -RETENTION POLICY : 6 Backups -DISK UTILIZATION : 0.00 bytes -NUMBER OF ARCHIVES : 0 -ARCHIVE PATH : /opt/backup/mktg/archived_wals -ARCHIVE COMMAND : (disabled) -XLOG METHOD : fetch -WAL COMPRESSION : disabled -TABLESPACE PATH(s) : -INCREMENTAL BACKUP : DISABLED\ -DESCRIPTION : "Marketing" -``` diff --git a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/08_show_backups.mdx b/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/08_show_backups.mdx deleted file mode 100644 index cc80aea6e34..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/08_show_backups.mdx +++ /dev/null @@ -1,105 +0,0 @@ ---- -title: "SHOW-BACKUPS" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.1/show_backups.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.2/show_backups.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.4/show_backups.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.3/show_backups.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.5/show_backups.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.7/show_backups.html" ---- - -The `SHOW-BACKUPS` subcommand displays the backup information for the managed database servers. - -**Syntax:** - -```text -bart SHOW-BACKUPS [ –s { | all } ] -[ -i { | | all } ] -[ -t ] -``` - -The following table describes the `SHOW-BACKUPS` options: - -| Options | Description | -| ------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-s { \| all` }

`--server { \| all` } | `` is the name of the database server whose backup information is to be displayed.
If `all` is specified or if the option is omitted, the backup information for all database servers is displayed. | -| `-i { \| \| all }`

`--backupid { \| \| all }` | `` is a backup identifier and `` is the user-defined alphanumeric name for the backup.
If `all` is specified or if the option is omitted, all backup information for the relevant database server is displayed. | -| `-t`
`--toggle` | Displays detailed backup information in list format. If the option is omitted, the default is a tabular format. | - -**Example** - -The following code sample shows the backup from database server `dev`: - -```text --bash-4.2$ bart SHOW-BACKUPS -s dev -SERVER NAME BACKUP ID BACKUP NAME BACKUP PARENT -BACKUP TIME BACKUP SIZE WAL(s) SIZE WAL FILES STATUS -dev 1477579596637 dev_2016-10-27T10:46:36 none -2016-10-27 10:46:37 EDT 54.50 MB 96.00 MB 6 active -``` - -The following code sample shows detailed information using the `-t` option: - -```text --bash-4.2$ bart SHOW-BACKUPS -s dev -i 1477579596637 -t -SERVER NAME : dev -BACKUP ID : 1477579596637 -BACKUP NAME : dev_2016-10-27T10:46:36 -BACKUP PARENT : none -BACKUP STATUS : active -BACKUP TIME : 2016-10-27 10:46:37 EDT -BACKUP SIZE : 54.50 MB -WAL(S) SIZE : 80.00 MB -NO. OF WALS : 5 -FIRST WAL FILE : 0000000100000001000000EC -CREATION TIME : 2016-10-27 10:46:37 EDT -LAST WAL FILE : 0000000100000001000000F0 -CREATION TIME : 2016-10-27 11:22:01 EDT -``` - -The following code sample shows a listing of an incremental backup along with its parent backup: - -```text --bash-4.2$ bart SHOW-BACKUPS -SERVER NAME BACKUP ID BACKUP NAME BACKUP PARENT -BACKUP TIME BACKUP SIZE WAL(s) SIZE WAL FILES STATUS -acctg 1477580293193 acctg_2016-10-27 none -2016-10-27 10:58:13 EDT 16.45 MB 16.00 MB 1 active -acctg 1477580111358 acctg_2016-10-27 none 2016-10-27 10:55:11 EDT 59.71 -MB 16.00 MB 1 active -``` - -The following code sample shows the complete, detailed information of the incremental backup and the parent backup: - -```text --bash-4.2$ bart SHOW-BACKUPS -t -SERVER NAME : acctg -BACKUP ID : 1477580293193 -BACKUP NAME : none -BACKUP PARENT : acctg_2016-10-27 -BACKUP STATUS : active -BACKUP TIME : 2016-10-27 10:58:13 EDT -BACKUP SIZE : 16.45 MB -WAL(S) SIZE : 16.00 MB -NO. OF WALS : 1 -FIRST WAL FILE : 0000000100000002000000D9 -CREATION TIME : 2016-10-27 10:58:13 EDT -LAST WAL FILE : 0000000100000002000000D9 -CREATION TIME : 2016-10-27 10:58:13 EDT -SERVER NAME : acctg -BACKUP ID : 1477580111358 -BACKUP NAME : acctg_2016-10-27 -BACKUP PARENT : none -BACKUP STATUS : active -BACKUP TIME : 2016-10-27 10:55:11 EDT -BACKUP SIZE : 59.71 MB -WAL(S) SIZE : 16.00 MB -NO. OF WALS : 1 -FIRST WAL FILE : 0000000100000002000000D8 -CREATION TIME : 2016-10-27 10:55:12 EDT -LAST WAL FILE : 0000000100000002000000D8 -CREATION TIME : 2016-10-27 10:55:12 EDT -``` diff --git a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/09_verify_chksum.mdx b/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/09_verify_chksum.mdx deleted file mode 100644 index c783da461ea..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/09_verify_chksum.mdx +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: "VERIFY-CHKSUM" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.1/verify_chksum.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.2/verify_chksum.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.4/verify_chksum.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.3/verify_chksum.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.5/verify_chksum.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.7/verify_chksum.html" ---- - -The `VERIFY-CHKSUM` subcommand verifies the MD5 checksums of the full backups and any user-defined tablespaces for the specified database server or for all database servers. The checksum is verified by comparing the current checksum of the backup against the checksum when the backup was taken. - -!!! Note - The `VERIFY-CHKSUM` subcommand is only used for tar format backups. - -**Syntax:** - -```text -bart VERIFY-CHKSUM -[ –s { | all } ] -[ -i { | | all } ] -``` - -The following table describes the `VERIFY-CHKSUM` options: - -| Options | Description | -| ---------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-s { \| all }`
`--server { \| all` } | `` is the name of the database server whose tar backup checksums are to be verified.
If `all` is specified or if the `-s` option is omitted, the checksums of all tar backups are verified for all database servers. | -| `-i { \| \| all` }

`--backupid { \| \| all` } | `` is the backup identifier of a tar format full backup whose checksum is to be verified along with any user-defined tablespaces. `` is the user-defined alphanumeric name for the full backup.
If `all` is specified or if the `-i` option is omitted, the checksums of all tar backups for the relevant database server are verified. | - -**Example** - -The following code sample verifies the checksum of all tar format backups of the specified database server: - -```text --bash-4.1$ bart VERIFY-CHKSUM -s acctg -i all -SERVER NAME BACKUP ID VERIFY -acctg 1430239348243 OK -acctg 1430232284202 OK -acctg 1430232016284 OK -acctg 1430231949065 OK -acctg 1429821844271 OK -``` diff --git a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/10_running_the_bart_wal_scanner.mdx b/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/10_running_the_bart_wal_scanner.mdx deleted file mode 100644 index c174e74145e..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/10_running_the_bart_wal_scanner.mdx +++ /dev/null @@ -1,171 +0,0 @@ ---- -title: "Running the BART WAL Scanner" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.1/running_the_bart_wal_scanner.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.2/running_the_bart_wal_scanner.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.4/running_the_bart_wal_scanner.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.3/running_the_bart_wal_scanner.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.5/running_the_bart_wal_scanner.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.7/running_the_bart_wal_scanner.html" ---- - -The BART WAL scanner is used to process each WAL file to find and record modified blocks in a corresponding MBM file. As a BART account user, use the BART WAL scanner to invoke the `bart-scanner` program located in the `/bin` directory. - -For detailed information about the WAL scanner and its usage, see the EDB Backup and Recovery User Guide available at the [EDB website](/bart/latest/bart_user/). - -**Syntax:** - -```text -bart-scanner -[ -d ] -[ -c ] -{ –h | --v | ---daemon | --p | - | -RELOAD | -STOP -``` - -When the `bart-scanner` program is invoked, it forks a separate process for each database server enabled with the `allow_incremental_backups` parameter. - -The WAL scanner processes can run in either the foreground or background depending upon usage of the `--daemon` option: - -- If the `--daemon` option is specified, the WAL scanner process runs in the background. All output messages can be viewed in the BART log file. -- If the `--daemon` option is omitted, the WAL scanner process runs in the foreground. All output messages can be viewed from the terminal running the program as well as in the BART log file. - -The following table describes the `VERIFY-CHKSUM` options. - -| Options | Description | -| ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-h` `--help` | Displays general syntax and information on WAL scanner usage. | -| `-v` `--version` | Displays the WAL scanner version information. | -| `-d` `--debug` | Displays debugging output while executing the WAL scanner with any of its options. | -| `-c ` `--config-path ` | Specifies `` as the full directory path to a BART configuration file. Use this option if you do not want to use the default BART configuration file `/etc/bart.cfg` | -| `--daemon` | Runs the WAL scanner as a background process. | -| `-p ` `--print ` | Specifies the full directory path to an MBM file whose content is to be printed. The `archived_wals` directory as specified in the the `archive_path` parameter in the `bart.cfg` file contains the MBM files. | -| `` | Specifies the full directory path to a WAL file to be scanned. The archive path directory contains the WAL files. Use it if a WAL file in the archive path is missing its MBM file. This option is to be used for assisting the EnterpriseDB support team for debugging problems that may have been encountered. | -| `RELOAD` | Reloads the BART configuration file. The keyword `RELOAD` is case-insensitive. The `RELOAD` option is useful if you make changes to the configuration file after the WAL scanner has been started. It will reload the configuration file and adjust the WAL scanners accordingly. For example, if a server section allowing incremental backups is removed from the BART configuration file, then the process attached to that server will stop. Similarly, if a server allowing incremental backups is added, a new WAL scanner process will be launched to scan the WAL files of that server. | -| `STOP` | Stops the WAL scanner. The keyword `STOP` is not case-sensitive. | - -**Example** - -The following code sample demonstrates starting the WAL scanner to run interactively. The WAL scanner begins scanning existing WAL files in the archive path that have not yet been scanned (that is, there is no corresponding MBM file for the WAL file): - -```text --bash-4.2$ bart-scanner -INFO: process created for server 'acctg', pid = 5287 -INFO: going to parse backlog of WALs, if any. -INFO: WAL file to be processed: 0000000100000000000000ED -INFO: WAL file to be processed: 0000000100000000000000EE -INFO: WAL file to be processed: 0000000100000000000000EF -INFO: WAL file to be processed: 0000000100000000000000F0 -INFO: WAL file to be processed: 0000000100000000000000F1 -``` - -The following code sample is the content of the archive path showing the MBM files created for the WAL files. (The user name and group name of the files have been removed from the example to list the WAL files and MBM files in a more readable manner): - -```text -[root@localhost archived_wals]# pwd -/opt/backup/acctg/archived_wals -[root@localhost archived_wals]# ls -l -total 81944 --rw------- 1 ... ... 16777216 Dec 20 09:10 0000000100000000000000ED --rw------- 1 ... ... 16777216 Dec 20 09:06 0000000100000000000000EE --rw------- 1 ... ... 16777216 Dec 20 09:11 0000000100000000000000EF --rw------- 1 ... ... 16777216 Dec 20 09:15 0000000100000000000000F0 --rw------- 1 ... ... 16777216 Dec 20 09:16 0000000100000000000000F1 --rw------- 1 ... ... 305 Dec 20 09:16 0000000100000000000000F1.00000028.backup --rw-rw-r-- 1 ... ... 161 Dec 20 09:18 -0000000100000000ED00002800000000EE000000.mbm --rw-rw-r-- 1 ... ... 161 Dec 20 09:18 -0000000100000000EE00002800000000EF000000.mbm --rw-rw-r-- 1 ... ... 161 Dec 20 09:18 -0000000100000000EF00002800000000F0000000.mbm --rw-rw-r-- 1 ... ... 161 Dec 20 09:18 -0000000100000000F000002800000000F1000000.mbm --rw-rw-r-- 1 ... ... 161 Dec 20 09:18 -0000000100000000F100002800000000F2000000.mbm -``` - -To stop the interactively running WAL scanner, either enter `ctrl-C` at the terminal running the WAL scanner or invoke the `bart-scanner` program from another terminal with the `STOP` option: - -```text --bash-4.2$ bart-scanner STOP --bash-4.2$ -``` - -The terminal on which the WAL scanner was running interactively appears as follows after it has been stopped: - -```text --bash-4.2$ bart-scanner -INFO: process created for server 'acctg', pid = 5287 -INFO: going to parse backlog of WALs, if any. -INFO: WAL file to be processed: 0000000100000000000000ED -INFO: WAL file to be processed: 0000000100000000000000EE -INFO: WAL file to be processed: 0000000100000000000000EF -INFO: WAL file to be processed: 0000000100000000000000F0 -INFO: WAL file to be processed: 0000000100000000000000F1 -INFO: bart-scanner stopped --bash-4.2$ -``` - -The following code sample demonstrates invoking the WAL scanner to run as a background process with the `--daemon` option: - -```text --bash-4.2$ bart-scanner --daemon --bash-4.2$ -``` - -The WAL scanner runs as a background process. There is also a separate background process for each database server that has been enabled for WAL scanning with the `allow_incremental_backups` parameter in the BART configuration file: - -```text --bash-4.2$ ps -ef | grep bart - enterpr+ 4340 1 0 09:48 ? 00:00:00 bart-scanner --daemon - enterpr+ 4341 4340 0 09:48 ? 00:00:00 bart-scanner --daemon - enterpr+ 4415 3673 0 09:50 pts/0 00:00:00 grep --color=auto bart -``` - -To stop the WAL scanner processes, invoke the WAL scanner with the `STOP` option: - -```text --bash-4.2$ bart-scanner STOP --bash-4.2$ -``` - -The following command demonstrates scanning an individual WAL file: - -```text --bash-4.2$ bart-scanner /opt/backup/acctg/archived_wals/0000000100000000000000FF --bash-4.2$ -``` - -To print the content of an MBM file for assisting the EnterpriseDB support team for debugging problems that may have been encountered, use the `-p` option to specify the file as shown in the following code sample: - -```text --bash-4.2$ bart-scanner -p -/opt/backup/acctg/archived_wals/0000000100000000FF0000280000000100000000.mbm - -Header: -Version: 1.0:90500:1.2.0 -Scan Start: 2016-12-20 10:02:11 EST, Scan End: 2016-12-20 10:02:11 EST, Diff: 0 sec(s) -Start LSN: ff000028, End LSN: 100000000, TLI: 1 -flags: 0, Check Sum: f9cfe66ae2569894d6746b61503a767d - -Path: base/14845/16384 -NodeTag: BLOCK_CHANGE -Relation: relPath base/14845/16384, isTSNode 0, Blocks -*............................................................................. -First modified block: 0 -Total modified blocks: 1 - -Path: base/14845/16391 -NodeTag: BLOCK_CHANGE -Relation: relPath base/14845/16391, isTSNode 0, Blocks -*.............................................................................. -First modified block: 0 -Total modified blocks: 1 -``` diff --git a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/index.mdx b/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/index.mdx deleted file mode 100644 index 9d81ffe2837..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/01_bart_subcommands_examples/index.mdx +++ /dev/null @@ -1,118 +0,0 @@ ---- -title: "BART Subcommand Syntax and Examples" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.4/bart_subcommands_examples.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.3/bart_subcommands_examples.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.5/bart_subcommands_examples.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.7/bart_subcommands_examples.html" ---- - - - -This section briefly describes each BART subcommand and provides an example. - -**Invoking BART** - -BART subcommands are invoked at the Linux command line as a BART user. You can invoke the `bart` program (located in the `/bin` directory) with the desired options to manage your BART installation. - -The following examples demonstrate ways of invoking BART. In these examples, the BART user account is named `bartuser`. - -```text -$ su bartuser -Password: -$ export -LD_LIBRARY_PATH=/opt/PostgresPlus/9.6AS/lib/:$LD_LIBRARY_PATH -$ ./bart SHOW-SERVERS -``` - -To run BART from any current working directory: - -```text -$ su bartuser -Password: -$ export -LD_LIBRARY_PATH=/opt/PostgresPlus/9.6AS/lib/:$LD_LIBRARY_PATH -$ bart SHOW-SERVERS -``` - -**Syntax for invoking BART** - -```text -bart [ ]... [ ] []... -``` - -You can use either abbreviated or long option forms on the command line (for example `-h` or `--help`). - -**General Options** - -You can specify the following general options with `bart`. - -`-h` or (`--help`) - -- Displays general syntax and information about BART usage. -- All subcommands support a help option (`-h, --help`). If the help option is specified, information is displayed regarding that particular subcommand. The subcommand, itself, is not executed. - -The following code sample displays the result of invoking the `--help` option for the `BACKUP` subcommand: - -```text --bash-4.2$ bart BACKUP --help -bart: backup and recovery tool - -Usage: -bart BACKUP [OPTION]... - -Options: --h, --help Show this help message and exit --s, --server Name of the server or 'all' (full backups only) to specify all servers --F, --format=p|t Backup output format (tar (default) or plain) --z, --gzip Enables gzip compression of tar files --c, --compress-level Specifies the compression level (1 through 9, 9 being - best compression) ---backup-name Specify a friendly name for the current backup ---parent Specify parent backup for incremental backup ---check Verify checksum of required mbm files -``` - -`-v` (or `--version`) - -The following code sample displays information returned by the `bart --version` subcommand: - -```text -[edb@localhost bin]$ bart --version -bart (EnterpriseDB) 2.5.2 -[edb@localhost bin]$ -``` - -`-d` (or `--debug`) - -The following code sample displays debugging output returned by the `bart MANAGE` subcommand: - -```text --bash-4.1$ bart -d MANAGE -n -DEBUG: Server: acctg, Now: 2015-04-17 16:34:03 EDT, RetentionWindow: -259200 (secs) ==> 72 hour(s) -DEBUG: Server: dev, Now: 2015-04-17 16:34:03 EDT, RetentionWindow: -1814400 (secs) ==> 504 hour(s) -DEBUG: Server: hr, Now: 2015-04-17 16:34:03 EDT, RetentionWindow: -7776000 (secs) ==> 2160 hour(s) -``` - -`-c` (or `--config-path) ` - -The following code sample demonstrates using the `-c` option to specify a non-default configuration file name and installation location: - -```text -$ su bartuser -Password: -$ export -LD_LIBRARY_PATH=/opt/PostgresPlus/9.6AS/lib/:$LD_LIBRARY_PATH -$ bart -c /home/bartuser/bart.cfg SHOW-SERVERS -``` - -
- -backup check_config delete init manage restore show_servers show_backups verify_chksum running_the_bart_wal_scanner - -
diff --git a/product_docs/docs/bart/2.5/bart_ref/02_additional_examples.mdx b/product_docs/docs/bart/2.5/bart_ref/02_additional_examples.mdx deleted file mode 100644 index b2572737d1a..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/02_additional_examples.mdx +++ /dev/null @@ -1,1476 +0,0 @@ ---- -title: "Additional Examples" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.4/additional_examples.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.3/additional_examples.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.5/additional_examples.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.7/additional_examples.html" ---- - - - -This section lists examples of the following BART operations. - -- Restoring a database cluster with tablespaces. -- Restoring an incremental backup. -- Managing backups. -- Managing incremental backups. - -## Restoring a Database Cluster with Tablespaces - -The following code sample illustrates taking a backup and restoring a database cluster on a remote host containing tablespaces. For detailed information regarding using tablespaces, see the EDB Backup and Recovery User Guide available at the [EDB website](/bart/latest/bart_user/). - -On an Advanced Server database running on a remote host, the following tablespaces are created for use by two tables: - -```text -edb=# CREATE TABLESPACE tblspc_1 LOCATION '/mnt/tablespace_1'; -CREATE TABLESPACE -edb=# CREATE TABLESPACE tblspc_2 LOCATION '/mnt/tablespace_2'; -CREATE TABLESPACE -edb=# \db - List of tablespaces -Name | Owner | Location -------------+-----------------+------------------- -pg_default | enterprisedb | -pg_global | enterprisedb | -tblspc_1 | enterprisedb | /mnt/tablespace_1 -tblspc_2 | enterprisedb | /mnt/tablespace_2 -(4 rows) - -edb=# CREATE TABLE tbl_tblspc_1 (c1 TEXT) TABLESPACE tblspc_1; -CREATE TABLE -edb=# CREATE TABLE tbl_tblspc_2 (c1 TEXT) TABLESPACE tblspc_2; -CREATE TABLE -edb=# \d tbl_tblspc_1 -Table "enterprisedb.tbl_tblspc_1" -Column | Type | Modifiers --------+------+----------- -c1 | text | -Tablespace: "tblspc_1" - -edb=# \d tbl_tblspc_2 -Table "enterprisedb.tbl_tblspc_2" -Column | Type | Modifiers --------+------+----------- -c1 | text | -Tablespace: "tblspc_2" -``` - -The following code sample shows the OIDs assigned to the tablespaces and the symbolic links to the tablespace directories: - -```text --bash-4.1$ pwd -/opt/PostgresPlus/9.6AS/data/pg_tblspc --bash-4.1$ ls -l -total 0 -lrwxrwxrwx 1 enterprisedb enterprisedb 17 Nov 16 16:17 16587 ->/mnt/tablespace_1 -lrwxrwxrwx 1 enterprisedb enterprisedb 17 Nov 16 16:17 16588 ->/mnt/tablespace_2 -``` - -The BART configuration file contains the following settings. Note that the `tablespace_path` parameter does not have to be set at this point. - -```text -[BART] -bart_host= enterprisedb@192.168.2.22 -backup_path = /opt/backup -pg_basebackup_path = /usr/edb/as11/bin/pg_basebackup -logfile = /tmp/bart.log -scanner_logfile = /tmp/bart_scanner.log - -[ACCTG] -host = 192.168.2.24 -port = 5444 -user = repuser -cluster_owner = enterprisedb -remote_host = enterprisedb@192.168.2.24 -tablespace_path = -description = "Accounting" -``` - -After the necessary configuration steps are performed to ensure BART manages the remote database server, a full backup is taken as shown in the following code sample: - -```text --bash-4.1$ bart BACKUP -s acctg - -INFO: creating backup for server 'acctg' -INFO: backup identifier: '1447709811516' -54521/54521 kB (100%), 3/3 tablespaces - -INFO: backup completed successfully -INFO: backup checksum: 594f69fe7d26af991d4173d3823e174f of 16587.tar -INFO: backup checksum: 7a5507567729a21c98a15c948ff6c015 of base.tar -INFO: backup checksum: ae8c62604c409635c9d9e82b29cc0399 of 16588.tar -INFO: -BACKUP DETAILS: -BACKUP STATUS: active -BACKUP IDENTIFIER: 1447709811516 -BACKUP NAME: none -BACKUP LOCATION: /opt/backup/acctg/1447709811516 -BACKUP SIZE: 53.25 MB -BACKUP FORMAT: tar -XLOG METHOD: fetch -BACKUP CHECKSUM(s): 3 -ChkSum File -594f69fe7d26af991d4173d3823e174f 16587.tar -7a5507567729a21c98a15c948ff6c015 base.tar -ae8c62604c409635c9d9e82b29cc0399 16588.tar - -TABLESPACE(s): 2 -Oid Name Location -16587 tblspc_1 /mnt/tablespace_1 -16588 tblspc_2 /mnt/tablespace_2 -START WAL LOCATION: 00000001000000000000000F -BACKUP METHOD: streamed -BACKUP FROM: master -START TIME: 2015-11-16 16:36:51 EST -STOP TIME: 2015-11-16 16:36:52 EST -TOTAL DURATION: 1 sec(s) -``` - -Note that in the output from the preceding example, checksums are generated for the tablespaces as well as the full backup. - -Within the backup subdirectory `1447709811516` of the BART backup catalog, the tablespace data is stored with file names `16587.tar.gz` and `16588.tar.gz` as shown below: - -```text --bash-4.1$ pwd -/opt/backup/acctg --bash-4.1$ ls -l -total 8 -drwx------ 2 enterprisedb enterprisedb 4096 Nov 16 16:36 1447709811516 -drwx------ 2 enterprisedb enterprisedb 4096 Nov 16 16:43 archived_wals --bash-4.1$ ls -l 1447709811516 -total 54536 --rw-rw-r-- 1 enterprisedb enterprisedb 19968 Nov 16 16:36 16587.tar --rw-rw-r-- 1 enterprisedb enterprisedb 19968 Nov 16 16:36 16588.tar --rw-rw-r-- 1 enterprisedb enterprisedb 949 Nov 16 17:05 backupinfo --rw-rw-r-- 1 enterprisedb enterprisedb 55792640 Nov 16 16:36 base.tar -``` - -When you are ready to restore the backup, in addition to creating the directory to which the main database cluster is to be restored, you must prepare the directories to which the tablespaces are to be restored. - -On the remote host, directories `/opt/restore_tblspc_1` and `/opt/restore_tblspc_2` are created and assigned the proper ownership and permissions as shown by the following example. The main database cluster is to be restored to `/opt/restore`. - -```text -[root@localhost opt]# mkdir restore_tblspc_1 -[root@localhost opt]# chown enterprisedb restore_tblspc_1 -[root@localhost opt]# chgrp enterprisedb restore_tblspc_1 -[root@localhost opt]# chmod 700 restore_tblspc_1 - -[root@localhost opt]# mkdir restore_tblspc_2 -[root@localhost opt]# chown enterprisedb restore_tblspc_2 -[root@localhost opt]# chgrp enterprisedb restore_tblspc_2 -[root@localhost opt]# chmod 700 restore_tblspc_2 -[root@localhost opt]# ls -l -total 20 -drwxr-xr-x 3 root daemon 4096 Nov 10 15:38 PostgresPlus -drwx------ 2 enterprisedb enterprisedb 4096 Nov 16 17:40 restore -drwx------ 2 enterprisedb enterprisedb 4096 Nov 16 17:40 -restore_tblspc_1 -drwx------ 2 enterprisedb enterprisedb 4096 Nov 16 17:41 -restore_tblspc_2 -drwxr-xr-x. 2 root root 4096 Nov 22 2013 rh -``` - -Set the `tablespace_path` parameter in the BART configuration file to specify the tablespace directories. The remote host user and IP address are specified by the `remote_host` configuration parameter. - -```text -[ACCTG] - -host = 192.168.2.24 -port = 5444 -user = repuser -cluster_owner = enterprisedb -remote_host = enterprisedb@192.168.2.24 -tablespace_path = -16587=/opt/restore_tblspc_1;16588=/opt/restore_tblspc_2 - -description = "Accounting" -``` - -The following code sample demonstrates invoking the `RESTORE` subcommand: - -```text --bash-4.1$ bart RESTORE -s acctg -i 1447709811516 -p /opt/restore -INFO: restoring backup '1447709811516' of server 'acctg' -INFO: restoring backup to enterprisedb@192.168.2.24:/opt/restore -INFO: base backup restored -INFO: archiving is disabled -INFO: tablespace(s) restored -``` - -The following code sample shows the restored full backup (including the restored tablespaces): - -```text -bash-4.1$ pwd -/opt --bash-4.1$ ls -l restore -total 104 --rw------- 1 enterprisedb enterprisedb 206 Nov 16 16:36 backup_label.old -drwx------ 6 enterprisedb enterprisedb 4096 Nov 10 15:38 base -drwx------ 2 enterprisedb enterprisedb 4096 Nov 16 17:46 global -drwx------ 2 enterprisedb enterprisedb 4096 Nov 10 15:38 pg_clog --rw------- 1 enterprisedb enterprisedb 4438 Nov 10 16:23 pg_hba.conf --rw------- 1 enterprisedb enterprisedb 1636 Nov 10 15:38 pg_ident.conf -drwxr-xr-x 2 enterprisedb enterprisedb 4096 Nov 16 17:45 pg_log -drwx------ 4 enterprisedb enterprisedb 4096 Nov 10 15:38 pg_multixact -drwx------ 2 enterprisedb enterprisedb 4096 Nov 16 17:45 pg_notify -drwx------ 2 enterprisedb enterprisedb 4096 Nov 10 15:38 pg_serial -drwx------ 2 enterprisedb enterprisedb 4096 Nov 10 15:38 pg_snapshots -drwx------ 2 enterprisedb enterprisedb 4096 Nov 16 17:47 pg_stat -drwx------ 2 enterprisedb enterprisedb 4096 Nov 16 17:47 pg_stat_tmp -drwx------ 2 enterprisedb enterprisedb 4096 Nov 10 15:38 pg_subtrans -drwx------ 2 enterprisedb enterprisedb 4096 Nov 16 17:42 pg_tblspc -drwx------ 2 enterprisedb enterprisedb 4096 Nov 10 15:38 pg_twophase --rw------- 1 enterprisedb enterprisedb 4 Nov 10 15:38 PG_VERSION -drwx------ 3 enterprisedb enterprisedb 4096 Nov 16 17:47 pg_xlog --rw------- 1 enterprisedb enterprisedb 23906 Nov 16 17:42 postgresql.conf --rw------- 1 enterprisedb enterprisedb 61 Nov 16 17:45 postmaster.opts --bash-4.1$ --bash-4.1$ ls -l restore_tblspc_1 -total 4 -drwx------ 3 enterprisedb enterprisedb 4096 Nov 16 16:18 -PG_9.6_201306121 --bash-4.1$ ls -l restore_tblspc_2 -total 4 -drwx------ 3 enterprisedb enterprisedb 4096 Nov 16 16:18 -PG_9.6_201306121 -``` - -The symbolic links in the `pg_tblspc` subdirectory point to the restored directory location: - -```text -bash-4.1$ pwd -/opt/restore/pg_tblspc --bash-4.1$ ls -l -total 0 -lrwxrwxrwx 1 enterprisedb enterprisedb 21 Nov 16 17:42 16587 -> -/opt/restore_tblspc_1 -lrwxrwxrwx 1 enterprisedb enterprisedb 21 Nov 16 17:42 16588 -> -/opt/restore_tblspc_2 -``` - -`psql` queries also show the restored tablespaces: - -```text -edb=# \db - - List of tablespaces -Name | Owner | Location -------------+--------------+----------------------- -pg_default | enterprisedb | -pg_global | enterprisedb | -tblspc_1 | enterprisedb | /opt/restore_tblspc_1 -tblspc_2 | enterprisedb | /opt/restore_tblspc_2 -``` - -## Restoring an Incremental Backup - -Restoring an incremental backup may require additional setup steps depending upon the host on which the incremental backup is to be restored. For more information, see the EDB Backup and Recovery User Guide available at the [EDB website](/bart/latest/bart_user/). - -This section provides an example of creating backup chains and then restoring an incremental backup. - -**Creating a Backup Chain** - -A *backup chain* is the set of backups consisting of a full backup and all of its successive incremental backups. Tracing back on the parent backups of all incremental backups in the chain eventually leads back to that single, full backup. - -In the following example, the `allow_incremental_backups` parameter is set to `enabled` in the BART configuration file to permit incremental backups on the listed database server: - -```text -[BART] - -bart_host= enterprisedb@192.168.2.27 -backup_path = /opt/backup -pg_basebackup_path = /usr/edb/as11/bin/pg_basebackup -logfile = /tmp/bart.log -scanner_logfile = /tmp/bart_scanner.log - -[ACCTG] - -host = 127.0.0.1 -port = 5445 -user = enterprisedb -cluster_owner = enterprisedb -allow_incremental_backups = enabled -description = "Accounting" -``` - -After the database server has been started with WAL archiving enabled to the BART backup catalog, the WAL scanner is started: - -```text --bash-4.2$ bart-scanner --daemon -``` - -First, a full backup is taken. - -```text --bash-4.2$ bart BACKUP -s acctg --backup-name full_1 -INFO: creating backup for server 'acctg' -INFO: backup identifier: '1490649204327'\ -63364/63364 kB (100%), 1/1 tablespace -INFO: backup completed successfully -INFO: backup checksum: aae27d4a7c09dffc82f423221154db7e of base.tar -INFO: -BACKUP DETAILS: -BACKUP STATUS: active -BACKUP IDENTIFIER: 1490649204327 -BACKUP NAME: full_1 -BACKUP PARENT: none -BACKUP LOCATION: /opt/backup/acctg/1490649204327 -BACKUP SIZE: 61.88 MB -BACKUP FORMAT: tar -BACKUP TIMEZONE: US/Eastern -XLOG METHOD: fetch -BACKUP CHECKSUM(s): 1 -ChkSum File -aae27d4a7c09dffc82f423221154db7e base.tar -TABLESPACE(s): 0 -START WAL LOCATION: 00000001000000000000000E -BACKUP METHOD: streamed -BACKUP FROM: master -START TIME: 2017-03-27 17:13:24 EDT -STOP TIME: 2017-03-27 17:13:25 EDT -TOTAL DURATION: 1 sec(s) -``` - -A series of incremental backups are taken. The first incremental backup specifies the full backup as the parent. Each successive incremental backup then uses the preceding incremental backup as its parent. - -```text --bash-4.2$ bart BACKUP -s acctg -F p --parent full_1 --backup-name -incr_1-a -INFO: creating incremental backup for server 'acctg' -INFO: checking mbm files /opt/backup/acctg/archived_wals -INFO: new backup identifier generated 1490649255649 -INFO: reading directory /opt/backup/acctg/archived_wals -INFO: all files processed -NOTICE: pg_stop_backup complete, all required WAL segments have been -archived -INFO: incremental backup completed successfully -INFO: -BACKUP DETAILS: -BACKUP STATUS: active -BACKUP IDENTIFIER: 1490649255649 -BACKUP NAME: incr_1-a -BACKUP PARENT: 1490649204327 -BACKUP LOCATION: /opt/backup/acctg/1490649255649 -BACKUP SIZE: 16.56 MB -BACKUP FORMAT: plain -BACKUP TIMEZONE: US/Eastern -XLOG METHOD: fetch -BACKUP CHECKSUM(s): 0 -TABLESPACE(s): 0 -START WAL LOCATION: 000000010000000000000010 -STOP WAL LOCATION: 000000010000000000000010 -BACKUP METHOD: pg_start_backup -BACKUP FROM: master -START TIME: 2017-03-27 17:14:15 EDT -STOP TIME: 2017-03-27 17:14:16 EDT -TOTAL DURATION: 1 sec(s) --bash-4.2$ bart BACKUP -s acctg -F p --parent incr_1-a --backup-name -incr_1-b -INFO: creating incremental backup for server 'acctg' -INFO: checking mbm files /opt/backup/acctg/archived_wals -INFO: new backup identifier generated 1490649336845 -INFO: reading directory /opt/backup/acctg/archived_wals -INFO: all files processed -NOTICE: pg_stop_backup complete, all required WAL segments have been -archived -INFO: incremental backup completed successfully -. -. -. --bash-4.2$ bart BACKUP -s acctg -F p --parent incr_1-b --backup-name -incr_1-c -INFO: creating incremental backup for server 'acctg' -INFO: checking mbm files /opt/backup/acctg/archived_wals -INFO: new backup identifier generated 1490649414316 -INFO: reading directory /opt/backup/acctg/archived_wals -INFO: all files processed -NOTICE: pg_stop_backup complete, all required WAL segments have been -archived -INFO: incremental backup completed successfully -. -. -. -``` - -The following output of the `SHOW-BACKUPS` subcommand lists the backup chain, which are backups `full_1, incr_1-a, incr_1-b, and incr_1-c`. - -```text --bash-4.2$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID BACKUP NAME BACKUP PARENT BACKUP TIME ... -acctg 1490649414316 incr_1-c incr_1-b 2017-03-27 17:16:55 ... -acctg 1490649336845 incr_1-b incr_1-a 2017-03-27 17:15:37 ... -acctg 1490649255649 incr_1-a full_1 2017-03-27 17:14:16 ... -acctg 1490649204327 full_1 none 2017-03-27 17:13:25 ... -``` - -For the `full backup full_1`, the `BACKUP PARENT` field contains `none`. For each incremental backup, the `BACKUP PARENT` field contains the backup identifier or name of its parent backup. - -A second backup chain is created in the same manner with the `BACKUP` subcommand. The following example shows the addition of the resulting, second backup chain consisting of full backup `full_2` and incremental backups `incr_2-a` and `incr_2-b`. - -```text --bash-4.2$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID BACKUP NAME BACKUP PARENT BACKUP TIME ... -acctg 1490649605607 incr_2-b incr_2-a 2017-03-27 17:20:06 ... -acctg 1490649587702 incr_2-a full_2 2017-03-27 17:19:48 ... -acctg 1490649528633 full_2 none 2017-03-27 17:18:49 ... -acctg 1490649414316 incr_1-c incr_1-b 2017-03-27 17:16:55 ... -acctg 1490649336845 incr_1-b incr_1-a 2017-03-27 17:15:37 ... -acctg 1490649255649 incr_1-a full_1 2017-03-27 17:14:16 ... -acctg 1490649204327 full_1 none 2017-03-27 17:13:25 ... -``` - -The following additional incremental backups starting with `incr_1-b-1`, which designates `incr_1-b` as the parent, results in the forking from that backup into a second line of backups in the chain consisting of `full_1, incr_1-a, incr_1-b, incr_1-b-1, incr_1-b-2`, and `incr_1-b-3` as shown in the following list: - -```text --bash-4.2$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID BACKUP NAME BACKUP PARENT BACKUP TIME ... -acctg 1490649791430 incr_1-b-3 incr_1-b-2 2017-03-27 17:23:12 ... -acctg 1490649763929 incr_1-b-2 incr_1-b-1 2017-03-27 17:22:44 ... -acctg 1490649731672 incr_1-b-1 incr_1-b 2017-03-27 17:22:12 ... -acctg 1490649605607 incr_2-b incr_2-a 2017-03-27 17:20:06 ... -acctg 1490649587702 incr_2-a full_2 2017-03-27 17:19:48 ... -acctg 1490649528633 full_2 none 2017-03-27 17:18:49 ... -acctg 1490649414316 incr_1-c incr_1-b 2017-03-27 17:16:55 ... -acctg 1490649336845 incr_1-b incr_1-a 2017-03-27 17:15:37 ... -acctg 1490649255649 incr_1-a full_1 2017-03-27 17:14:16 ... -acctg 1490649204327 full_1 none 2017-03-27 17:13:25 ... -``` - -**Restoring an Incremental Backup** - -Restoring an incremental backup is done with the `RESTORE` subcommand in the same manner as for restoring a full backup. Specify the backup identifier or backup name of the incremental backup to be restored as shown in the following example. - -```text --bash-4.2$ bart RESTORE -s acctg -p /opt/restore -i incr_1-b -INFO: restoring incremental backup 'incr_1-b' of server 'acctg' -INFO: base backup restored -INFO: archiving is disabled -INFO: permissions set on $PGDATA -INFO: incremental restore completed successfully -``` - -Restoring incremental backup `incr_1-b` as shown by the preceding example results in the restoration of full backup `full_1`, then incremental backups `incr_1-a` and finally, `incr_1-b`. - -## Managing Backups - -This section illustrates evaluating, marking, and deleting backups using the `MANAGE` subcommand using a redundancy retention policy and a recovery window retention policy. For detailed information about the `MANAGE` subcommand, see the *EDB Backup and Recovery User Guide* available at the [EDB website](/bart/latest/bart_user/). - - - -### Using a Redundancy Retention Policy - -The following code sample uses a redundancy retention policy to evaluate, mark, and delete backups as shown by the following server configuration: - -```text -[ACCTG] -host = 127.0.0.1 -port = 5444 -user = enterprisedb -archive_command = 'cp %p %a/%f' -retention_policy = 3 BACKUPS -description = "Accounting" -``` - -The following list is the set of backups. Note that the last backup in the list has been marked as `keep`. - -```text --bash-4.1$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID BACKUP TIME BACKUP SIZE WAL(s) SIZE -WAL FILES STATUS -acctg 1428768344061 2015-04-11 12:05:46 EDT 5.72 MB 48.00 MB -3 active -acctg 1428684537299 2015-04-10 12:49:00 EDT 5.72 MB 272.00 MB -17 active -acctg 1428589759899 2015-04-09 10:29:27 EDT 5.65 MB 96.00 MB -6 active -acctg 1428502049836 2015-04-08 10:07:30 EDT 55.25 MB 96.00 MB -6 active -acctg 1428422324880 2015-04-07 11:58:45 EDT 54.53 MB 32.00 MB -2 active -acctg 1428355371389 2015-04-06 17:22:53 EDT 5.71 MB 16.00 MB -1 keep -``` - -Invoke the `MANAGE` subcommand with the `-n` option to perform a dry run to observe which active backups would be changed to obsolete according to the retention policy as shown in the following code sample: - -```text --bash-4.1$ bart MANAGE -s acctg -n -INFO: processing server 'acctg', backup '1428768344061' -INFO: processing server 'acctg', backup '1428684537299' -INFO: processing server 'acctg', backup '1428589759899' -INFO: processing server 'acctg', backup '1428502049836' -INFO: marking backup '1428502049836' as obsolete -INFO: 6 WAL file(s) marked obsolete -INFO: processing server 'acctg', backup '1428422324880' -INFO: marking backup '1428422324880' as obsolete -INFO: 2 WAL file(s) marked obsolete -INFO: processing server 'acctg', backup '1428355371389' -``` - -The dry run shows that backups `1428502049836` and `1428422324880` would be marked as `obsolete`. - -!!! Note - A dry run does not change the backup status. The two backups that would be considered obsolete are still marked as `active`: - -```text --bash-4.1$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID BACKUP TIME BACKUP SIZE WAL(s) SIZE -WAL FILES STATUS -acctg 1428768344061 2015-04-11 12:05:46 EDT 5.72 MB 48.00 MB -3 active -acctg 1428684537299 2015-04-10 12:49:00 EDT 5.72 MB 272.00 MB -17 active -acctg 1428589759899 2015-04-09 10:29:27 EDT 5.65 MB 96.00 MB -6 active -acctg 1428502049836 2015-04-08 10:07:30 EDT 55.25 MB 96.00 MB -6 active -acctg 1428422324880 2015-04-07 11:58:45 EDT 54.53 MB 32.00 MB -2 active -acctg 1428355371389 2015-04-06 17:22:53 EDT 5.71 MB 16.00 MB -1 keep -``` - -Invoke the `MANAGE` subcommand omitting the `-n` option to change and mark the status of the backups as `obsolete`: - -```text --bash-4.1$ bart MANAGE -s acctg -INFO: processing server 'acctg', backup '1428768344061' -INFO: processing server 'acctg', backup '1428684537299' -INFO: processing server 'acctg', backup '1428589759899' -INFO: processing server 'acctg', backup '1428502049836' -INFO: marking backup '1428502049836' as obsolete -INFO: 6 WAL file(s) marked obsolete -INFO: processing server 'acctg', backup '1428422324880' -INFO: marking backup '1428422324880' as obsolete -INFO: 2 WAL file(s) marked obsolete -INFO: processing server 'acctg', backup '1428355371389' -``` - -The obsolete backups can be observed in a number of ways. Use the `MANAGE` subcommand with the `-l` option to list the `obsolete` backups: - -```text --bash-4.1$ bart MANAGE -s acctg -l -INFO: 6 WAL file(s) will be removed -SERVER NAME: acctg -BACKUP ID: 1428502049836 -BACKUP STATUS: obsolete -BACKUP TIME: 2015-04-08 10:07:30 EDT -BACKUP SIZE: 55.25 MB -WAL FILE(s): 6 -WAL FILE: 000000010000000100000003 -WAL FILE: 000000010000000100000002 -WAL FILE: 000000010000000100000001 -WAL FILE: 000000010000000100000000 -WAL FILE: 0000000100000000000000E3 -WAL FILE: 0000000100000000000000E2 -INFO: 2 WAL file(s) will be removed -SERVER NAME: acctg -BACKUP ID: 1428422324880 -BACKUP STATUS: obsolete -BACKUP TIME: 2015-04-07 11:58:45 EDT -BACKUP SIZE: 54.53 MB -WAL FILE(s): 2 -WAL FILE: 0000000100000000000000E1 -WAL FILE: 0000000100000000000000E0 -``` - -The `STATUS` field of the `SHOW-BACKUPS` subcommand displays the current status: - -```text --bash-4.1$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID BACKUP TIME BACKUP SIZE WAL(s) SIZE -WAL FILES STATUS -acctg 1428768344061 2015-04-11 12:05:46 EDT 5.72 MB 48.00 MB -3 active -acctg 1428684537299 2015-04-10 12:49:00 EDT 5.72 MB 272.00 MB -17 active -acctg 1428589759899 2015-04-09 10:29:27 EDT 5.65 MB 96.00 MB -6 active -acctg 1428502049836 2015-04-08 10:07:30 EDT 55.25 MB 96.00 MB -6 obsolete -acctg 1428422324880 2015-04-07 11:58:45 EDT 54.53 MB 32.00 MB -2 obsolete -acctg 1428355371389 2015-04-06 17:22:53 EDT 5.71 MB 16.00 MB -1 keep -``` - -The details of an individual backup can be displayed using the `SHOW-BACKUPS` subcommand with the `-t` option. Note the status in the `BACKUP STATUS` field. - -```text --bash-4.1$ bart SHOW-BACKUPS -s acctg -i 1428502049836 -t -SERVER NAME : acctg -BACKUP ID : 1428502049836 -BACKUP NAME : none -BACKUP STATUS : obsolete -BACKUP TIME : 2015-04-08 10:07:30 EDT -BACKUP SIZE : 55.25 MB -WAL(S) SIZE : 96.00 MB -NO. OF WALS : 6 -FIRST WAL FILE : 0000000100000000000000E2 -CREATION TIME : 2015-04-08 10:07:30 EDT -LAST WAL FILE : 000000010000000100000003 -CREATION TIME : 2015-04-09 10:25:46 EDT -``` - -Use the `MANAGE` subcommand with the `-d` option to physically delete the `obsolete` backups including the unneeded WAL files. - -```text --bash-4.1$ bart MANAGE -s acctg -d -INFO: removing all obsolete backups of server 'acctg' -INFO: removing obsolete backup '1428502049836' -INFO: 6 WAL file(s) will be removed -INFO: removing WAL file '000000010000000100000003' -INFO: removing WAL file '000000010000000100000002' -INFO: removing WAL file '000000010000000100000001' -INFO: removing WAL file '000000010000000100000000' -INFO: removing WAL file '0000000100000000000000E3' -INFO: removing WAL file '0000000100000000000000E2' -INFO: removing obsolete backup '1428422324880' -INFO: 2 WAL file(s) will be removed -INFO: removing WAL file '0000000100000000000000E1' -INFO: removing WAL file '0000000100000000000000E0' -``` - -The `SHOW-BACKUPS` subcommand now displays the remaining backups marked as `active` or `keep`: - -```text --bash-4.1$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID BACKUP TIME BACKUP SIZE WAL(s) SIZE -WAL FILES STATUS -acctg 1428768344061 2015-04-11 12:05:46 EDT 5.72 MB 48.00 MB -3 active -acctg 1428684537299 2015-04-10 12:49:00 EDT 5.72 MB 272.00 MB -17 active -acctg 1428589759899 2015-04-09 10:29:27 EDT 5.65 MB 96.00 MB -6 active -acctg 1428355371389 2015-04-06 17:22:53 EDT 5.71 MB 16.00 MB -1 keep -``` - - - -### Using a Recovery Window Retention Policy - -This section illustrates the evaluation, marking, and deletion of backup using a recovery window retention policy. To use the recovery window retention policy, set the `retention_policy` parameter to the desired length of time for the recovery window. - -This section provides examples of the following: - -- How to view the calculated recovery window. -- How to evaluate, mark, and delete backup using a recovery window retention policy. - -#### Viewing the Recovery Window - -You can view the actual, calculated recovery window by invoking any of the following subcommands: - -- `MANAGE` subcommand in debug mode (along with the `-n` option). -- `SHOW-SERVERS` subcommand. - -##### Viewing the Recovery Window Using the Manage Subcommand - -When invoking BART in debug mode with the `MANAGE` subcommand and the `-n` option, the length of the recovery window is calculated based on the `retention_policy` setting and the current date/time. - -For example, using the following `retention_policy` settings: - -```text -[ACCTG] - -host = 127.0.0.1 -port = 5444 -user = enterprisedb -archive_command = 'cp %p %a/%f' -retention_policy = 3 DAYS -backup-name = acctg_%year-%month-%dayT%hour:%minute:%second -description = "Accounting" - -[DEV] - -host = 127.0.0.1 -port = 5445 -user = enterprisedb -archive_command = 'cp %p %a/%f' -retention_policy = 3 WEEKS -description = "Development" - -[HR] - -host = 127.0.0.1 -port = 5432 -user = postgres -retention_policy = 3 MONTHS -description = "Human Resources" -``` - -If the `MANAGE` subcommand is invoked in debug mode along with the `-n` option on 2015-04-17, the following results are displayed: - -```text --bash-4.1$ bart -d MANAGE -n -DEBUG: Server: acctg, Now: 2015-04-17 16:34:03 EDT, RetentionWindow: -259200 (secs) ==> 72 hour(s) -DEBUG: Server: dev, Now: 2015-04-17 16:34:03 EDT, RetentionWindow: -1814400 (secs) ==> 504 hour(s) -DEBUG: Server: hr, Now: 2015-04-17 16:34:03 EDT, RetentionWindow: -7776000 (secs) ==> 2160 hour(s) -``` - -For server `acctg`, 72 hours translates to a recovery window of 3 days. - -For server `dev`, 504 hours translates to a recovery window of 21 days (3 weeks). - -For server `hr`, 2160 hours translates to a recovery window of 90 days (3 months). - -For a setting of ` MONTHS`, the calculated total number of days for the recovery window is dependent upon the actual number of days in the preceding months from the current date/time. Thus, ` MONTHS` is not always exactly equivalent to ` x 30 DAYS`. For example, if the current date/time is in the month of March, a 1-month recovery window would be equivalent to only 28 days because the preceding month is February. Thus, for a current date of March 31, a 1-month recovery window would start on March 3. However, the typical result is that the day of the month of the starting recovery window boundary will be the same day of the month of when the `MANAGE` subcommand is invoked. - -##### Viewing the Recovery Window Using the Show-Servers Subcommand - -This section provides an example of viewing the recovery window using the `SHOW-SERVERS` subcommand; the `RETENTION POLICY` field displays the start of the recovery window. - -In the following code sample, the recovery window retention policy setting considers the backups taken within a 3-day recovery window as the active backups. - -```text -[ACCTG] -host = 127.0.0.1 -port = 5444 -user = enterprisedb -archive_command = 'cp %p %a/%f' -retention_policy = 3 DAYS -description = "Accounting" -``` - -The start of the 3-day recovery window displayed in the `RETENTION POLICY` field is `2015-04-07 14:57:36 EDT` when the `SHOW-SERVERS` subcommand is invoked on `2015-04-10`. - -At this current point in time, backups taken on or after `2015-04-07 14:57:36 EDT` would be considered active. Backups taken prior to `2015-04-07 14:57:36 EDT` would be considered obsolete except for backups marked as `keep`. - -```text --bash-4.1$ date -Fri Apr 10 14:57:33 EDT 2015 --bash-4.1$ --bash-4.1$ bart SHOW-SERVERS -s acctg -SERVER NAME : acctg -HOST NAME : 127.0.0.1 -USER NAME : enterprisedb -PORT : 5444 -REMOTE HOST : -RETENTION POLICY : 2015-04-07 14:57:36 EDT -DISK UTILIZATION : 824.77 MB -NUMBER OF ARCHIVES : 37 -ARCHIVE PATH : /opt/backup/acctg/archived_wals -ARCHIVE COMMAND : cp %p /opt/backup/acctg/archived_wals/%f -XLOG METHOD : fetch -WAL COMPRESSION : disabled -TABLESPACE PATH(s) : -DESCRIPTION : "Accounting" -``` - -In the following code sample, the recovery window retention policy setting considers the backups taken within a 3-week recovery window as the `active` backups. - -```text -[DEV] -host = 127.0.0.1 -port = 5445 -user = enterprisedb -archive_command = 'cp %p %a/%f' -retention_policy = 3 WEEKS -description = "Development" -``` - -The start of the 3-week recovery window displayed in the `RETENTION POLICY` field is `2015-03-20 14:59:42 EDT` when the `SHOW-SERVERS` subcommand is invoked on `2015-04-10`. - -At this current point in time, backups taken on or after `2015-03-20 14:59:42 EDT` would be considered `active`. Backups taken prior to `2015-03-20 14:59:42 EDT` would be considered `obsolete` except for backups marked as `keep`. - -```text --bash-4.1$ date -Fri Apr 10 14:59:39 EDT 2015 --bash-4.1$ --bash-4.1$ bart SHOW-SERVERS -s dev -SERVER NAME : dev -HOST NAME : 127.0.0.1 -USER NAME : enterprisedb -PORT : 5445 -REMOTE HOST : -RETENTION POLICY : 2015-03-20 14:59:42 EDT -DISK UTILIZATION : 434.53 MB -NUMBER OF ARCHIVES : 22 -ARCHIVE PATH : /opt/backup/dev/archived_wals -ARCHIVE COMMAND : cp %p /opt/backup/dev/archived_wals/%f -XLOG METHOD : fetch -WAL COMPRESSION : disabled -TABLESPACE PATH(s) : -DESCRIPTION : "Development" -``` - -In the following code sample, the recovery window retention policy setting considers the backups taken within a 3-month recovery window as the `active` backups. - -```text -[HR] -host = 127.0.0.1 -port = 5432 -user = postgres -retention_policy = 3 MONTHS -description = "Human Resources" -``` - -The start of the 3-month recovery window displayed in the `RETENTION POLICY` field is `2015-01-10 14:04:23 EST` when the `SHOW-SERVERS` subcommand is invoked on `2015-04-10`. - -At this current point in time, backups taken on or after `2015-01-10 14:04:23 EST` would be considered `active`. Backups taken prior to `2015-01-10 14:04:23 EST` would be considered `obsolete`, except for backups marked as `keep`. - -```text --bash-4.1$ date -Fri Apr 10 15:04:19 EDT 2015 --bash-4.1$ --bash-4.1$ bart SHOW-SERVERS -s hr -SERVER NAME : hr -HOST NAME : 127.0.0.1 -USER NAME : postgres -PORT : 5432 -REMOTE HOST : -RETENTION POLICY : 2015-01-10 14:04:23 EST -DISK UTILIZATION : 480.76 MB -NUMBER OF ARCHIVES : 26 -ARCHIVE PATH : /opt/backup/hr/archived_wals -ARCHIVE COMMAND : scp %p -enterprisedb@192.168.2.22:/opt/backup/hr/archived_wals/%f -XLOG METHOD : fetch -WAL COMPRESSION : disabled -TABLESPACE PATH(s) : -DESCRIPTION : "Human Resources" -``` - -#### Evaluating, Marking, and Deleting Backup Using a Recovery Window Retention Policy - -The following code sample uses a recovery window retention policy to evaluate, mark, and delete backups as shown by the following server configuration: - -```text -[DEV] -host = 127.0.0.1 -port = 5445 -user = enterprisedb -archive_command = 'cp %p %a/%f' -retention_policy = 3 DAYS -description = "Development" -``` - -The following is the current set of backups. Note that the last backup in the list has been marked as `keep`. - -```text --bash-4.1$ bart SHOW-BACKUPS -s dev -SERVER NAME BACKUP ID BACKUP TIME BACKUP SIZE WAL(s) SIZE -WAL FILES STATUS -dev 1428933278236 2015-04-13 09:54:40 EDT 5.65 MB 16.00 MB -1 active -dev 1428862187757 2015-04-12 14:09:50 EDT 5.65 MB 32.00 MB -2 active -dev 1428768351638 2015-04-11 12:05:54 EDT 5.65 MB 32.00 MB -2 active -dev 1428684544008 2015-04-10 12:49:06 EDT 5.65 MB 224.00 MB -14 active -dev 1428590536488 2015-04-09 10:42:18 EDT 5.65 MB 48.00 MB -3 active -dev 1428502171990 2015-04-08 10:09:34 EDT 5.65 MB 80.00 MB -5 keep -``` - -The current date and time is `2015-04-13 16:46:35 EDT` as shown below: - -```text --bash-4.1$ date -Mon Apr 13 16:46:35 EDT 2015 -``` - -Thus, a 3-day recovery window would evaluate backups prior to `2015-04-10 16:46:35 EDT` as `obsolete` except for those marked as `keep`. - -Invoke the `MANAGE` subcommand with the `-n` option to perform a dry run to observe which active backups would be changed to `obsolete` according to the retention policy. - -```text --bash-4.1$ bart MANAGE -s dev -n -INFO: processing server 'dev', backup '1428933278236' -INFO: processing server 'dev', backup '1428862187757' -INFO: processing server 'dev', backup '1428768351638' -INFO: processing server 'dev', backup '1428684544008' -INFO: marking backup '1428684544008' as obsolete -INFO: 14 WAL file(s) marked obsolete -INFO: 1 Unused WAL file(s) present -INFO: processing server 'dev', backup '1428590536488' -INFO: marking backup '1428590536488' as obsolete -INFO: 3 WAL file(s) marked obsolete -INFO: 1 Unused WAL file(s) present -INFO: processing server 'dev', backup '1428502171990' -``` - -The dry run shows that backups `1428684544008` and `1428590536488` would be marked as `obsolete`. - -Also note that a dry run does not change the backup status. The two backups that would be considered obsolete are still marked as `active`: - -```text --bash-4.1$ bart SHOW-BACKUPS -s dev\ - SERVER NAME BACKUP ID BACKUP TIME BACKUP SIZE WAL(s) SIZE - WAL FILES STATUS - dev 1428933278236 2015-04-13 09:54:40 EDT 5.65 MB 16.00 MB - 1 active - dev 1428862187757 2015-04-12 14:09:50 EDT 5.65 MB 32.00 MB - 2 active - dev 1428768351638 2015-04-11 12:05:54 EDT 5.65 MB 32.00 MB - 2 active - dev 1428684544008 2015-04-10 12:49:06 EDT 5.65 MB 224.00 MB - 14 active - dev 1428590536488 2015-04-09 10:42:18 EDT 5.65 MB 48.00 MB - 3 active - dev 1428502171990 2015-04-08 10:09:34 EDT 5.65 MB 80.00 MB - 5 keep -``` - -Invoke the `MANAGE` subcommand omitting the `-n` option to change and mark the status of the backups as `obsolete`: - -```text --bash-4.1$ bart MANAGE -s dev -INFO: processing server 'dev', backup '1428933278236' -INFO: processing server 'dev', backup '1428862187757' -INFO: processing server 'dev', backup '1428768351638' -INFO: processing server 'dev', backup '1428684544008' -INFO: marking backup '1428684544008' as obsolete -INFO: 14 WAL file(s) marked obsolete -INFO: 1 Unused WAL file(s) present -INFO: processing server 'dev', backup '1428590536488' -INFO: marking backup '1428590536488' as obsolete -INFO: 3 WAL file(s) marked obsolete -INFO: 1 Unused WAL file(s) present -INFO: processing server 'dev', backup '1428502171990' -``` - -The obsolete backups can be observed in a number of ways. Use the `MANAGE` subcommand with the `-l` option to list the `obsolete` backups: - -```text --bash-4.1$ bart MANAGE -s dev -l -INFO: 14 WAL file(s) will be removed -INFO: 1 Unused WAL file(s) will be removed -SERVER NAME: dev -BACKUP ID: 1428684544008 -BACKUP STATUS: obsolete -BACKUP TIME: 2015-04-10 12:49:06 EDT -BACKUP SIZE: 5.65 MB -WAL FILE(s): 14 -UNUSED WAL FILE(s): 1 -WAL FILE: 00000001000000000000002E -WAL FILE: 00000001000000000000002D -WAL FILE: 00000001000000000000002C -WAL FILE: 00000001000000000000002B -WAL FILE: 00000001000000000000002A -WAL FILE: 000000010000000000000029 -WAL FILE: 000000010000000000000028 -WAL FILE: 000000010000000000000027 -WAL FILE: 000000010000000000000026 -WAL FILE: 000000010000000000000025 -WAL FILE: 000000010000000000000024 -WAL FILE: 000000010000000000000023 -WAL FILE: 000000010000000000000022 -WAL FILE: 000000010000000000000021 -UNUSED WAL FILE: 00000001000000000000000F.00000028 -INFO: 3 WAL file(s) will be removed -INFO: 1 Unused WAL file(s) will be removed -SERVER NAME: dev -BACKUP ID: 1428590536488 -BACKUP STATUS: obsolete -BACKUP TIME: 2015-04-09 10:42:18 EDT\ -BACKUP SIZE: 5.65 MB -WAL FILE(s): 3 -UNUSED WAL FILE(s): 1 -WAL FILE: 000000010000000000000020 -WAL FILE: 00000001000000000000001F -WAL FILE: 00000001000000000000001E -UNUSED WAL FILE: 00000001000000000000000F.00000028 -``` - -The `STATUS` field of the `SHOW-BACKUPS` subcommand displays the current status: - -```text --bash-4.1$ bart SHOW-BACKUPS -s dev -SERVER NAME BACKUP ID BACKUP TIME BACKUP SIZE WAL(s) SIZE -WAL FILES STATUS -dev 1428933278236 2015-04-13 09:54:40 EDT 5.65 MB 16.00 MB -1 active -dev 1428862187757 2015-04-12 14:09:50 EDT 5.65 MB 32.00 MB -2 active -dev 1428768351638 2015-04-11 12:05:54 EDT 5.65 MB 32.00 MB -2 active -dev 1428684544008 2015-04-10 12:49:06 EDT 5.65 MB 224.00 MB -14 obsolete -dev 1428590536488 2015-04-09 10:42:18 EDT 5.65 MB 48.00 MB -3 obsolete -dev 1428502171990 2015-04-08 10:09:34 EDT 5.65 MB 80.00 MB -5 keep -``` - -The details of an individual backup can be displayed using the `SHOW-BACKUPS` subcommand with the `-t` option. Note the status in the `BACKUP STATUS` field. - -```text --bash-4.1$ bart SHOW-BACKUPS -s dev -i 1428684544008 -t -SERVER NAME : dev -BACKUP ID : 1428684544008 -BACKUP NAME : none -BACKUP STATUS : obsolete -BACKUP TIME : 2015-04-10 12:49:06 EDT -BACKUP SIZE : 5.65 MB -WAL(S) SIZE : 224.00 MB -NO. OF WALS : 14 -FIRST WAL FILE : 000000010000000000000021 -CREATION TIME : 2015-04-10 12:49:06 EDT -LAST WAL FILE : 00000001000000000000002E -CREATION TIME : 2015-04-11 12:02:15 EDT -``` - -Use the `MANAGE` subcommand with the `-d` option to physically delete the obsolete backups including the unneeded WAL files. - -```text --bash-4.1$ bart MANAGE -s dev -d -INFO: removing all obsolete backups of server 'dev' -INFO: removing obsolete backup '1428684544008' -INFO: 14 WAL file(s) will be removed -INFO: 1 Unused WAL file(s) will be removed -INFO: removing WAL file '00000001000000000000002E' -INFO: removing WAL file '00000001000000000000002D' -INFO: removing WAL file '00000001000000000000002C' -INFO: removing WAL file '00000001000000000000002B' -INFO: removing WAL file '00000001000000000000002A' -INFO: removing WAL file '000000010000000000000029' -INFO: removing WAL file '000000010000000000000028' -INFO: removing WAL file '000000010000000000000027' -INFO: removing WAL file '000000010000000000000026' -INFO: removing WAL file '000000010000000000000025' -INFO: removing WAL file '000000010000000000000024' -INFO: removing WAL file '000000010000000000000023' -INFO: removing WAL file '000000010000000000000022' -INFO: removing WAL file '000000010000000000000021' -INFO: removing (unused) WAL file '00000001000000000000000F.00000028' -INFO: removing obsolete backup '1428590536488' -INFO: 3 WAL file(s) will be removed -INFO: removing WAL file '000000010000000000000020' -INFO: removing WAL file '00000001000000000000001F' -INFO: removing WAL file '00000001000000000000001E' -``` - -The `SHOW-BACKUPS` subcommand now displays the remaining backups marked as `active` or `keep`: - -```text --bash-4.1$ bart SHOW-BACKUPS -s dev -SERVER NAME BACKUP ID BACKUP TIME BACKUP SIZE WAL(s) SIZE -WAL FILES STATUS -dev 1428933278236 2015-04-13 09:54:40 EDT 5.65 MB 16.00 MB -1 active -dev 1428862187757 2015-04-12 14:09:50 EDT 5.65 MB 32.00 MB -2 active -dev 1428768351638 2015-04-11 12:05:54 EDT 5.65 MB 32.00 MB -2 active -dev 1428502171990 2015-04-08 10:09:34 EDT 5.65 MB 80.00 MB -5 keep -``` - -## Managing Incremental Backups - -This section illustrates evaluating, marking, and deleting incremental backups using the `MANAGE` and `DELETE` subcommands utilizing redundancy retention policy and recovery window retention policy. For detailed information about the `MANAGE` and `DELETE` subcommands, as well as the redundancy retention and recovery window retention policy, see the *EDB Backup and Recovery User Guide* available at the [EDB website](/bart/latest/bart_user/). - -- [Using a Redundancy Retention Policy](#redundancy_retention_policy) provides an example of using the `MANAGE` and `DELETE` subcommands when a 3 backup redundancy retention policy is in effect. -- [Using a Recovery Window Retention Policy](#recovery_window_retention_policy) provides an example of using the `MANAGE` and `DELETE` subcommands when a 1-day recovery window retention policy is in effect. - - - -### Using a Redundancy Retention Policy - -The following code sample uses the `MANAGE` and `DELETE` subcommands to evaluate, mark, and delete incremental backups when a 3 backup redundancy retention policy is in effect. The example uses the following server configuration: - -```text -[ACCTG] - -host = 192.168.2.24 -port = 5445 -user = enterprisedb -cluster_owner = enterprisedb -remote_host = enterprisedb@192.168.2.24 -allow_incremental_backups = enabled -retention_policy = 3 BACKUPS -description = "Accounting" -``` - -The example uses the following set of backups. In these code samples, some columns have been omitted from the `SHOW-BACKUPS` output to display the relevant information in a more observable manner. - -```text --bash-4.2$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID ... BACKUP PARENT BACKUP TIME ... STATUS -acctg 1481749696905 ... 1481749673603 2016-12-14 16:08:17 EST ... active -acctg 1481749673603 ... 1481749651927 2016-12-14 16:07:53 EST ... active -acctg 1481749651927 ... 1481749619582 2016-12-14 16:07:32 EST ... active -acctg 1481749619582 ... none 2016-12-14 16:07:00 EST ... active -``` - -There is one backup chain. The first backup is the initial full backup. - -Backup chain: `1481749619582 => 1481749651927 => 1481749673603 => 1481749696905` - -The `MANAGE` subcommand is invoked as shown by the following: - -```text --bash-4.2$ bart MANAGE -s acctg -INFO: processing server 'acctg', backup '1481749619582' -INFO: 2 Unused WAL file(s) present -INFO: 4 Unused file(s) (WALs included) present, use 'MANAGE -l' for the -list -``` - -The following code sample shows the resulting status of the backups: - -```text --bash-4.2$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID ... BACKUP PARENT BACKUP TIME ... STATUS -acctg 1481749696905 ... 1481749673603 2016-12-14 16:08:17 EST ... active -acctg 1481749673603 ... 1481749651927 2016-12-14 16:07:53 EST ... active -acctg 1481749651927 ... 1481749619582 2016-12-14 16:07:32 EST ... active -acctg 1481749619582 ... none 2016-12-14 16:07:00 EST ... active -``` - -The status remains active for all backups. Even though the total number of backups exceeds the 3 backup redundancy retention policy, it is only the total number of full backups that is used to determine if the redundancy retention policy has been exceeded. Additional full backups are added including a second backup chain. The following example shows the resulting list of backups: - -```text --bash-4.2$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID ... BACKUP PARENT BACKUP TIME ... STATUS -acctg 1481750365397 ... none 2016-12-14 16:19:26 EST ... active -acctg 1481750098924 ... 1481749997807 2016-12-14 16:14:59 EST ... active -acctg 1481749997807 ... none 2016-12-14 16:13:18 EST ... active -acctg 1481749992003 ... none 2016-12-14 16:13:12 EST ... active -acctg 1481749696905 ... 1481749673603 2016-12-14 16:08:17 EST ... active -acctg 1481749673603 ... 1481749651927 2016-12-14 16:07:53 EST ... active -acctg 1481749651927 ... 1481749619582 2016-12-14 16:07:32 EST ... active -acctg 1481749619582 ... none 2016-12-14 16:07:00 EST ... active -``` - -Second backup chain: `1481749997807 => 1481750098924` - -The `MANAGE` subcommand is invoked, but now with a total of four active full backups. - -```text --bash-4.2$ bart MANAGE -s acctg -INFO: processing server 'acctg', backup '1481750365397' -INFO: processing server 'acctg', backup '1481749997807' -INFO: processing server 'acctg', backup '1481749992003' -INFO: processing server 'acctg', backup '1481749619582' -INFO: marking backup '1481749619582' as obsolete -INFO: 3 incremental(s) of backup '1481749619582' will be marked obsolete -INFO: marking incremental backup '1481749696905' as obsolete -INFO: marking incremental backup '1481749673603' as obsolete -INFO: marking incremental backup '1481749651927' as obsolete -INFO: 4 WAL file(s) marked obsolete -INFO: 2 Unused WAL file(s) present -INFO: 4 Unused file(s) (WALs included) present, use 'MANAGE -l' for the -list -``` - -The oldest full backup and its chain of incremental backups are now marked as obsolete. - -```text --bash-4.2$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID ... BACKUP PARENT BACKUP TIME ... STATUS -acctg 1481750365397 ... none 2016-12-14 16:19:26 EST ... active -acctg 1481750098924 ... 1481749997807 2016-12-14 16:14:59 EST ... active -acctg 1481749997807 ... none 2016-12-14 16:13:18 EST ... active -acctg 1481749992003 ... none 2016-12-14 16:13:12 EST ... active -acctg 1481749696905 ... 1481749673603 2016-12-14 16:08:17 EST ... obsolete -acctg 1481749673603 ... 1481749651927 2016-12-14 16:07:53 EST ... obsolete -acctg 1481749651927 ... 1481749619582 2016-12-14 16:07:32 EST ... obsolete -acctg 1481749619582 ... none 2016-12-14 16:07:00 EST ... obsolete -``` - -Invoking the `MANAGE` subcommand with the `-d` option deletes the entire obsolete backup chain. - -```text --bash-4.2$ bart MANAGE -s acctg -d -INFO: removing all obsolete backups of server 'acctg' -INFO: removing obsolete backup '1481749619582' -INFO: 4 WAL file(s) will be removed -INFO: 3 incremental(s) of backup '1481749619582' will be removed -INFO: removing obsolete incremental backup '1481749696905' -INFO: removing obsolete incremental backup '1481749673603' -INFO: removing obsolete incremental backup '1481749651927' -INFO: removing WAL file '000000010000000100000000' -INFO: removing WAL file '0000000100000000000000FF' -INFO: removing WAL file '0000000100000000000000FE' -INFO: removing WAL file '0000000100000000000000FD' -INFO: 16 Unused file(s) will be removed -INFO: removing (unused) file '000000010000000100000004.00000028.backup' -. -. -. -INFO: removing (unused) file -'0000000100000000FB00002800000000FC000000.mbm' -``` - -The following code sample shows the remaining full backups and the second backup chain. - -```text --bash-4.2$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID ... BACKUP PARENT BACKUP TIME ... STATUS -acctg 1481750365397 ... none 2016-12-14 16:19:26 EST ... active -acctg 1481750098924 ... 1481749997807 2016-12-14 16:14:59 EST ... active -acctg 1481749997807 ... none 2016-12-14 16:13:18 EST ... active -acctg 1481749992003 ... none 2016-12-14 16:13:12 EST ... active -``` - - - -### Using a Recovery Window Retention Policy - -The following example demonstrates using the `MANAGE` and `DELETE` subcommands to evaluate, mark, and delete incremental backups when a 1-day recovery window retention policy is in effect. The example uses the following server configuration: - -```text -[ACCTG] - -host = 192.168.2.24 -port = 5445 -user = enterprisedb -cluster_owner = enterprisedb -remote_host = enterprisedb@192.168.2.24 -allow_incremental_backups = enabled -retention_policy = 1 DAYS -description = "Accounting" -``` - -The example uses the following set of backups. In the samples, some columns have been omitted from the `SHOW-BACKUPS` output to display the relevant information in a more observable manner. - -```text --bash-4.2$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID ... BACKUP PARENT BACKUP TIME ... STATUS -acctg 1481559303348 ... 1481554203288 2016-12-12 11:15:03 EST ... active -acctg 1481559014359 ... 1481554802918 2016-12-12 11:10:14 EST ... active -acctg 1481554802918 ... 1481553914533 2016-12-12 10:00:03 EST ... active -acctg 1481554203288 ... 1481553651165 2016-12-12 09:50:03 EST ... active -acctg 1481553914533 ... 1481553088053 2016-12-12 09:45:14 EST ... active -acctg 1481553651165 ... none 2016-12-12 09:40:51 EST ... active -acctg 1481553088053 ... 1481552078404 2016-12-12 09:31:28 EST ... active -acctg 1481552078404 ... none 2016-12-12 09:14:39 EST ... active -``` - -There are two backup chains. In each of the following chains, the first backup is the initial full backup. - -First backup chain: `1481552078404 => 1481553088053 => 1481553914533 => 1481554802918 => 1481559014359` - -Second backup chain: `1481553651165 => 1481554203288 => 1481559303348` - -The `MANAGE` subcommand is invoked when the first full backup `1481552078404` falls out of the recovery window. When the `MANAGE` subcommand is invoked, it is `2016-12-13 09:20:03 EST`, thus making the start of the 1-day recovery window at `2016-12-12 09:20:03 EST` exactly one day earlier. This backup was taken at `2016-12-12 09:14:39 EST`, which is about 5 ½ minutes before the start of the recovery window, thus making the backup obsolete. - -```text --bash-4.2$ date -Tue Dec 13 09:20:03 EST 2016 --bash-4.2$ bart MANAGE -s acctg -INFO: processing server 'acctg', backup '1481553651165' -INFO: processing server 'acctg', backup '1481552078404' -INFO: marking backup '1481552078404' as obsolete -INFO: 4 incremental(s) of backup '1481552078404' will be marked obsolete -INFO: marking incremental backup '1481559014359' as obsolete -INFO: marking incremental backup '1481554802918' as obsolete -INFO: marking incremental backup '1481553914533' as obsolete -INFO: marking incremental backup '1481553088053' as obsolete -INFO: 7 WAL file(s) marked obsolete -INFO: 1 Unused WAL file(s) present -INFO: 2 Unused file(s) (WALs included) present, use 'MANAGE -l' for the list -``` - -The incremental backup date and time are within the recovery window since they were taken after the start of the recovery window of `2016-12-12 09:20:03 EST`, but all backups in the chain are marked as `obsolete`. - -```text --bash-4.2$ bart SHOW-BACKUPS -s acctg\ -SERVER NAME BACKUP ID ... BACKUP PARENT BACKUP TIME -... STATUS -acctg 1481559303348 ... 1481554203288 2016-12-12 11:15:03 EST -... active -acctg 1481559014359 ... 1481554802918 2016-12-12 11:10:14 EST -... obsolete -acctg 1481554802918 ... 1481553914533 2016-12-12 10:00:03 EST -... obsolete -acctg 1481554203288 ... 1481553651165 2016-12-12 09:50:03 EST -... active -acctg 1481553914533 ... 1481553088053 2016-12-12 09:45:14 EST -... obsolete -acctg 1481553651165 ... none 2016-12-12 09:40:51 EST -... active -acctg 1481553088053 ... 1481552078404 2016-12-12 09:31:28 EST -... obsolete -acctg 1481552078404 ... none 2016-12-12 09:14:39 EST -... obsolete -``` - -The following code sample shows how the entire backup chain is changed back to active status by invoking the `MANAGE` subcommand with the `-c nokeep` option on the full backup of the chain. - -```text --bash-4.2$ bart MANAGE -s acctg -c nokeep -i 1481552078404 -INFO: changing status of backup '1481552078404' of server 'acctg' from -'obsolete' to 'active' -INFO: status of 4 incremental(s) of backup '1481552078404' will be -changed -INFO: changing status of incremental backup '1481559014359' of server -'acctg' from 'obsolete' to 'active' -INFO: changing status of incremental backup '1481554802918' of server -'acctg' from 'obsolete' to 'active' -INFO: changing status of incremental backup '1481553914533' of server -'acctg' from 'obsolete' to 'active' -INFO: changing status of incremental backup '1481553088053' of server -'acctg' from 'obsolete' to 'active' -INFO: 7 WAL file(s) changed -``` - -The backup chain has now been reset to active status. - -```text --bash-4.2$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID ... BACKUP PARENT BACKUP TIME ... STATUS -acctg 1481559303348 ... 1481554203288 2016-12-12 11:15:03 EST ... active -acctg 1481559014359 ... 1481554802918 2016-12-12 11:10:14 EST ... active -acctg 1481554802918 ... 1481553914533 2016-12-12 10:00:03 EST ... active -acctg 1481554203288 ... 1481553651165 2016-12-12 09:50:03 EST ... active -acctg 1481553914533 ... 1481553088053 2016-12-12 09:45:14 EST ... active -acctg 1481553651165 ... none 2016-12-12 09:40:51 EST ... active -acctg 1481553088053 ... 1481552078404 2016-12-12 09:31:28 EST ... active -acctg 1481552078404 ... none 2016-12-12 09:14:39 EST ... active -``` - -The following code sample shows usage of the `DELETE` subcommand on an incremental backup. The specified incremental backup `1481554802918` in the first backup chain as well as its successive incremental backup `1481559014359` are deleted. - -```text --bash-4.2$ bart DELETE -s acctg -i 1481554802918 -INFO: deleting backup '1481554802918' of server 'acctg' -INFO: deleting backup '1481554802918' -INFO: 1 incremental backup(s) will be deleted -INFO: deleting incremental backup '1481559014359' -INFO: WALs of deleted backup(s) will belong to prior backup(if any), or -will be marked unused -INFO: 2 Unused file(s) will be removed -INFO: removing (unused) file '0000000100000000000000BA' -INFO: removing (unused) file -'0000000100000000BA00002800000000BB000000.mbm' -INFO: backup(s) deleted -``` - -The results show that the backups `1481554802918` and `1481559014359` are no longer listed by the `SHOW-BACKUPS` subcommand. - -```text --bash-4.2$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID ... BACKUP PARENT BACKUP TIME ... STATUS -acctg 1481559303348 ... 1481554203288 2016-12-12 11:15:03 EST ... active -acctg 1481554203288 ... 1481553651165 2016-12-12 09:50:03 EST ... active -acctg 1481553914533 ... 1481553088053 2016-12-12 09:45:14 EST ... active -acctg 1481553651165 ... none 2016-12-12 09:40:51 EST ... active -acctg 1481553088053 ... 1481552078404 2016-12-12 09:31:28 EST ... active -acctg 1481552078404 ... none 2016-12-12 09:14:39 EST ... active -``` - -The `MANAGE` subcommand is invoked again. This time both backup chains are marked `obsolete` since the full backups of both chains fall out of the start of the recovery window, which is now `2016-12-12 09:55:03 EST`. - -```text --bash-4.2$ date -Tue Dec 13 09:55:03 EST 2016 --bash-4.2$ bart MANAGE -s acctg -INFO: processing server 'acctg', backup '1481553651165' -INFO: marking backup '1481553651165' as obsolete -INFO: 2 incremental(s) of backup '1481553651165' will be marked obsolete -INFO: marking incremental backup '1481559303348' as obsolete -INFO: marking incremental backup '1481554203288' as obsolete -INFO: 38 WAL file(s) marked obsolete -INFO: processing server 'acctg', backup '1481552078404' -INFO: marking backup '1481552078404' as obsolete -INFO: 2 incremental(s) of backup '1481552078404' will be marked obsolete -INFO: marking incremental backup '1481553914533' as obsolete -INFO: marking incremental backup '1481553088053' as obsolete -INFO: 7 WAL file(s) marked obsolete -``` - -The following code sample shows both backup chains marked as `obsolete`. - -```text --bash-4.2$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID ... BACKUP PARENT BACKUP TIME -... STATUS -acctg 1481559303348 ... 1481554203288 2016-12-12 11:15:03 EST -... obsolete -acctg 1481554203288 ... 1481553651165 2016-12-12 09:50:03 EST -... obsolete -acctg 1481553914533 ... 1481553088053 2016-12-12 09:45:14 EST -... obsolete -acctg 1481553651165 ... none 2016-12-12 09:40:51 EST -... obsolete -acctg 1481553088053 ... 1481552078404 2016-12-12 09:31:28 EST -... obsolete -acctg 1481552078404 ... none 2016-12-12 09:14:39 EST -... obsolete -``` - -The following code sample demonstrates using the `MANAGE` subcommand with the `-c keep` option to keep a backup chain indefinitely. The `MANAGE` subcommand with the `-c keep` option must specify the backup identifier or backup name of the full backup of the chain, and not any incremental backup. - -```text --bash-4.2$ bart MANAGE -s acctg -c keep -i 1481553651165 -INFO: changing status of backup '1481553651165' of server 'acctg' from -'obsolete' to 'keep' -INFO: status of 2 incremental(s) of backup '1481553651165' will be -changed -INFO: changing status of incremental backup '1481559303348' of server -'acctg' from 'obsolete' to 'keep' -INFO: changing status of incremental backup '1481554203288' of server -'acctg' from 'obsolete' to 'keep' -INFO: 38 WAL file(s) changed -``` - -The full backup `1481553651165` and its successive incremental backups `1481554203288` and `1481559303348` have been changed to `keep` status: - -```text --bash-4.2$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID ... BACKUP PARENT BACKUP TIME -... STATUS -acctg 1481559303348 ... 1481554203288 2016-12-12 11:15:03 EST -... keep -acctg 1481554203288 ... 1481553651165 2016-12-12 09:50:03 EST -... keep -acctg 1481553914533 ... 1481553088053 2016-12-12 09:45:14 EST -... obsolete -acctg 1481553651165 ... none 2016-12-12 09:40:51 EST -... keep -acctg 1481553088053 ... 1481552078404 2016-12-12 09:31:28 EST -... obsolete -acctg 1481552078404 ... none 2016-12-12 09:14:39 EST -... obsolete -``` - -Finally, the `MANAGE` subcommand with the `-d` option is used to delete the `obsolete` backup chain: - -```text --bash-4.2$ bart MANAGE -s acctg -d -INFO: removing all obsolete backups of server 'acctg' -INFO: removing obsolete backup '1481552078404' -INFO: 7 WAL file(s) will be removed -INFO: 2 incremental(s) of backup '1481552078404' will be removed -INFO: removing obsolete incremental backup '1481553914533' -INFO: removing obsolete incremental backup '1481553088053' -INFO: removing WAL file '0000000100000000000000C1' -INFO: removing WAL file '0000000100000000000000C0' -INFO: removing WAL file '0000000100000000000000BF' -INFO: removing WAL file '0000000100000000000000BE' -INFO: removing WAL file '0000000100000000000000BD' -INFO: removing WAL file '0000000100000000000000BC' -INFO: removing WAL file '0000000100000000000000BB' -INFO: 48 Unused file(s) will be removed -INFO: removing (unused) file '0000000100000000000000FA' -. -. -. -INFO: removing (unused) file '0000000100000000000000BB.00000028.backup' -``` - -Only the backup chain with the `keep` status remains as shown below: - -```text --bash-4.2$ bart SHOW-BACKUPS -s acctg -SERVER NAME BACKUP ID ... BACKUP PARENT BACKUP TIME -... STATUS -acctg 1481559303348 ... 1481554203288 2016-12-12 11:15:03 EST -... keep -acctg 1481554203288 ... 1481553651165 2016-12-12 09:50:03 EST -... keep -acctg 1481553651165 ... none 2016-12-12 09:40:51 EST -... keep -``` diff --git a/product_docs/docs/bart/2.5/bart_ref/03_sample_bart_system_with_local_and_remote_database_servers.mdx b/product_docs/docs/bart/2.5/bart_ref/03_sample_bart_system_with_local_and_remote_database_servers.mdx deleted file mode 100644 index 7630e22fddc..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/03_sample_bart_system_with_local_and_remote_database_servers.mdx +++ /dev/null @@ -1,1390 +0,0 @@ ---- -title: "Sample BART System with Local and Remote Database Servers" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.1/sample_bart_system_with_local_and_remote_database_servers.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.2/sample_bart_system_with_local_and_remote_database_servers.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.4/sample_bart_system_with_local_and_remote_database_servers.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.3/sample_bart_system_with_local_and_remote_database_servers.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.5/sample_bart_system_with_local_and_remote_database_servers.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.7/sample_bart_system_with_local_and_remote_database_servers.html" ---- - - - -This section describes a sample BART managed backup and recovery system consisting of both local and remote database servers. The complete steps to configure and operate the system are provided. - -For detailed information about configuring a BART system, see the *EDB Backup and Recovery Installation and Upgrade Guide*. For detailed information about the operational procedures and BART subcommands, see the *EDB Backup and Recovery User Guide*. These guides are available at the [EDB website](/bart/latest/bart_inst/). - -The environment for this sample system is as follows: - -- BART on host `192.168.2.22` running with BART user account `enterprisedb` -- Local Advanced Server on host `192.168.2.22` running with user account `enterprisedb` -- Remote Advanced Server on host `192.168.2.24` running with user account `enterprisedb` -- Remote PostgreSQL server on host `192.168.2.24` running with user account `postgres` - -Passwordless SSH/SCP connections are required between the following: - -- BART on host `192.168.2.22` and the local Advanced Server on the same host `192.168.2.22` -- BART on host `192.168.2.22` and the remote Advanced Server on host `192.168.2.24` -- BART on host `192.168.2.22` and the remote PostgreSQL server on host `192.168.2.24` - -The following sections demonstrate configuring and taking full backups only. To support incremental backups as well, enable the `allow_incremental_backups` parameter for the desired database servers and use the `WAL scanner` program. - -- [The BART Configuration File](#bart_configuration_file) shows the settings used in the BART configuration file. -- [Establishing SSH/SCP Passwordless Connections](#establishing-sshscp-passwordless-connections) provides an example of how to establish an SSH/SCP passwordless connection. -- [Configuring a Replication Database User](#configuring-a-replication-database-user) provides an example of how to configure the replication database user. -- [WAL Archiving Configuration Parameters](#wal-archiving-configuration-parameters) provides an example of how to configure WAL archiving. -- [Creating the BART Backup Catalog](#creating-the-bart-backup-catalog-backup_path) provides information about creating a BART Backup Catalog. -- [Starting the Database Servers with WAL Archiving](#starting-the-database-servers-with-wal-archiving) provides example of starting the database servers with WAL archiving. -- [Taking a Full Backup](#taking-a-full-backup) illustrates taking the first full backup of the database servers. -- [Using Point-In-Time Recovery](#using-point-in-time-recovery) demonstrates the point-in-time recovery operation on the remote PostgreSQL database server. - - - -## The BART Configuration File - -The following code sample shows the settings used in the BART configuration file for the examples that follow: - -```text -[BART] -bart_host= enterprisedb@192.168.2.22 -backup_path = /opt/backup -pg_basebackup_path = /usr/edb/as11/bin/pg_basebackup -retention_policy = 6 BACKUPS -logfile = /tmp/bart.log -scanner_logfile = /tmp/bart_scanner.log - -[ACCTG] -host = 127.0.0.1 -port = 5444 -user = enterprisedb -cluster_owner = enterprisedb -backup_name = acctg_%year-%month-%dayT%hour:%minute -archive_command = 'cp %p %a/%f' -description = "Accounting" - -[MKTG] - -host = 192.168.2.24 -port = 5444 -user = repuser -cluster_owner = enterprisedb -backup_name = mktg_%year-%month-%dayT%hour:%minute -remote_host = enterprisedb@192.168.2.24 -description = "Marketing" - -[HR] - -host = 192.168.2.24 -port = 5432 -user = postgres -cluster_owner = postgres -backup_name = hr_%year-%month-%dayT%hour:%minute -remote_host = postgres@192.168.2.24 -copy_wals_during_restore = enabled -description = "Human Resources" -``` - - - -## Establishing SSH/SCP Passwordless Connections - -This section demonstrates how passwordless SSH/SCP connections are established with the authorized public keys files. - - - -### Generating a Public Key File for the BART User Account - -The BART user account is `enterprisedb` with a home directory of `/opt/PostgresPlus/9.6AS`. - -To generate the public key file, as a root user, first create the `.ssh` subdirectory in the BART user’s home directory and assign ownership of this directory to the `enterprisedb` user, ensuring there are no groups or other users that can access the `.ssh` directory. - -```text -[root@localhost 9.6AS]# pwd -/opt/PostgresPlus/9.6AS -[root@localhost 9.6AS]# mkdir .ssh -[root@localhost 9.6AS]# chown enterprisedb .ssh -[root@localhost 9.6AS]# chgrp enterprisedb .ssh -[root@localhost 9.6AS]# chmod 700 .ssh -[root@localhost 9.6AS]# ls -la | grep ssh -drwx------ 2 enterprisedb enterprisedb 4096 Apr 23 13:02 .ssh -``` - -Generate the public key file: - -```text -[user@localhost ~]$ su - enterprisedb -Password: --bash-4.1$ pwd -/opt/PostgresPlus/9.6AS --bash-4.1$ ssh-keygen -t rsa -Generating public/private rsa key pair. -Enter file in which to save the key -(/opt/PostgresPlus/9.6AS/.ssh/id_rsa): -Enter passphrase (empty for no passphrase): -Enter same passphrase again: -Your identification has been saved in -/opt/PostgresPlus/9.6AS/.ssh/id_rsa. -Your public key has been saved in -/opt/PostgresPlus/9.6AS/.ssh/id_rsa.pub. -The key fingerprint is: -de:65:34:d6:b1:d2:32:3c:b0:43:c6:a3:c0:9f:f4:64 -enterprisedb@localhost.localdomain -The key's randomart image is: -+----[ RSA 2048]----+ -| . .+ . | -| o .oE+ o o | -| + * o.X + | -| + .+ * | -| S o | -| . . o | -| . . | -| - | -| | -+-------------------+ -``` - -The following are the resulting files. `id_rsa.pub` is the public key file of BART user account `enterprisedb`. - -```text --bash-4.1$ ls -l .ssh -total 8 --rw------- 1 enterprisedb enterprisedb 1675 Apr 23 13:04 id_rsa --rw-r--r-- 1 enterprisedb enterprisedb 416 Apr 23 13:04 id_rsa.pub -``` - -### Configuring Access between Local Advanced Server and the BART Host - -Even when the Advanced Server database is on the same host as the BART user account, and the Advanced Server database cluster owner is also the BART user account (`enterprisedb` is this case), a passwordless SSH/SCP connection must be established from the same user account to itself. - -On the BART host where the public key file was just generated (as shown in [Generating a Public Key File for the BART User Account](#generating-a-public-key-file-for-the-bart-user-account)), create the authorized keys file by appending the public key file to any existing authorized keys file. - -Log into the BART host as the BART user account and append the public key file, `id_rsa.pub` onto the `authorized_keys` file in the same `.ssh` directory. - -```text -[user@localhost ~]$ su - enterprisedb -Password: -Last login: Thu Mar 23 10:27:35 EDT 2017 on pts/0 --bash-4.2$ pwd -/opt/PostgresPlus/9.6AS --bash-4.2$ ls -l .ssh -total 12 --rw------- 1 enterprisedb enterprisedb 1675 Mar 23 09:54 id_rsa --rw-r--r-- 1 enterprisedb enterprisedb 416 Mar 23 09:54 id_rsa.pub --rw-r--r-- 1 enterprisedb enterprisedb 345 Mar 23 10:05 known_hosts --bash-4.2$ cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys --bash-4.2$ ls -l .ssh -total 16 --rw-rw-r-- 1 enterprisedb enterprisedb 416 Mar 23 10:33 authorized_keys --rw------- 1 enterprisedb enterprisedb 1675 Mar 23 09:54 id_rsa --rw-r--r-- 1 enterprisedb enterprisedb 416 Mar 23 09:54 id_rsa.pub --rw-r--r-- 1 enterprisedb enterprisedb 345 Mar 23 10:05 known_hosts -``` - -The `authorized_keys` file must have file permission `600` as set by the following `chmod 600` command, or the passwordless connection will fail: - -```text --bash-4.2$ chmod 600 ~/.ssh/authorized_keys --bash-4.2$ ls -l .ssh -total 16 --rw------- 1 enterprisedb enterprisedb 416 Mar 23 10:33 authorized_keys --rw------- 1 enterprisedb enterprisedb 1675 Mar 23 09:54 id_rsa --rw-r--r-- 1 enterprisedb enterprisedb 416 Mar 23 09:54 id_rsa.pub --rw-r--r-- 1 enterprisedb enterprisedb 345 Mar 23 10:05 known_hosts -``` - -Test the passwordless connection. Use the `ssh` command to verify that you can access the same user account as you are currently logged in as (`enterprisedb`) without being prompted for a password: - -```text --bash-4.2$ ssh enterprisedb@127.0.0.1 -Last login: Thu Mar 23 10:27:50 2017 --bash-4.2$ exit -logout -Connection to 127.0.0.1 closed. -``` - -### Configuring Access from Remote Advanced Server to BART Host - -On the remote host `192.168.2.24`, create the public key file for the remote database server user account, `enterprisedb`, for access to the BART user account, `enterprisedb`, on the BART host 192.168.2.22. - -Create the `.ssh` directory for user account `enterprisedb` on the remote host: - -```text -[root@localhost 9.6AS]# pwd -/opt/PostgresPlus/9.6AS -[root@localhost 9.6AS]# mkdir .ssh -[root@localhost 9.6AS]# chown enterprisedb .ssh -[root@localhost 9.6AS]# chgrp enterprisedb .ssh -[root@localhost 9.6AS]# chmod 700 .ssh -[root@localhost 9.6AS]# ls -la | grep ssh -drwx------ 2 enterprisedb enterprisedb 4096 Apr 23 13:08 .ssh -``` - -Generate the public key file on the remote host for user account `enterprisedb`: - -```text -[user@localhost ~]$ su - enterprisedb -Password: --bash-4.1$ ssh-keygen -t rsa -Generating public/private rsa key pair. -Enter file in which to save the key -(/opt/PostgresPlus/9.6AS/.ssh/id_rsa): -Enter passphrase (empty for no passphrase): -Enter same passphrase again: -Your identification has been saved in -/opt/PostgresPlus/9.6AS/.ssh/id_rsa. -Your public key has been saved in -/opt/PostgresPlus/9.6AS/.ssh/id_rsa.pub. -The key fingerprint is: -15:27:1e:1e:61:4b:48:66:67:0b:b2:be:fc:ea:ea:e6 -enterprisedb@localhost.localdomain -The key's randomart image is: -+--[ RSA 2048]---+ -| ..=.@.. | -| =.O O | -| . * | -| . . | -| . S | -| . . | -| o | -| . . | -| +Eoo.. | -+----------------+ -``` - -Copy the generated public key file, `id_rsa.pub`, to the BART user account, `enterprisedb`, on the BART host, `192.168.2.22`: - -```text --bash-4.1$ scp ~/.ssh/id_rsa.pub enterprisedb@192.168.2.22:/tmp/tmp.pub -The authenticity of host '192.168.2.22 (192.168.2.22)' can't be -established. -RSA key fingerprint is b8:a9:97:31:79:16:b8:2b:b0:60:5a:91:38:d7:68:22. -Are you sure you want to continue connecting (yes/no)? yes -Warning: Permanently added '192.168.2.22' (RSA) to the list of known hosts. -enterprisedb@192.168.2.22's password: -id_rsa.pub -``` - -Log into the BART host as the BART user account and append the temporary public key file, `/tmp/tmp.pub` onto the `authorized_keys` file owned by the BART user account. - -```text --bash-4.1$ ssh enterprisedb@192.168.2.22 -enterprisedb@192.168.2.22's password: -Last login: Tue Apr 21 17:03:24 2015 from 192.168.2.22 --bash-4.1$ pwd -/opt/PostgresPlus/9.6AS --bash-4.1$ cat /tmp/tmp.pub >> ~/.ssh/authorized_keys --bash-4.1$ ls -l .ssh -total 12 --rw-rw-r-- 1 enterprisedb enterprisedb 416 Apr 23 13:15 authorized_keys --rw------- 1 enterprisedb enterprisedb 1675 Apr 23 13:04 id_rsa --rw-r--r-- 1 enterprisedb enterprisedb 416 Apr 23 13:04 id_rsa.pub -``` - -The `authorized_keys` file must have file permission `600` as set by the following `chmod 600` command, otherwise the passwordless connection fails: - -```text --bash-4.1$ chmod 600 ~/.ssh/authorized_keys --bash-4.1$ ls -l .ssh -total 12 --rw------- 1 enterprisedb enterprisedb 416 Apr 23 13:15 authorized_keys --rw------- 1 enterprisedb enterprisedb 1675 Apr 23 13:04 id_rsa --rw-r--r-- 1 enterprisedb enterprisedb 416 Apr 23 13:04 id_rsa.pub --bash-4.1$ rm /tmp/tmp.pub --bash-4.1$ exit -logout -Connection to 192.168.2.22 closed. -``` - -Test the passwordless connection. From the remote host, verify that you can log into the BART host with the BART user account without being prompted for a password: - -```text --bash-4.1$ ssh enterprisedb@192.168.2.22 -Last login: Thu Apr 23 13:14:48 2015 from 192.168.2.24 --bash-4.1$ exit -logout -Connection to 192.168.2.22 closed. -``` - -### Configuring Access from the BART Host to a Remote Advanced Server - -On the BART host `192.168.2.22`, copy the public key file for the BART user account, `enterprisedb`, for access to the remote database server user account, `enterprisedb`, on the remote host `192.168.2.24`. - -The following lists the current SSH keys files in the BART user’s `.ssh` directory on the BART host: - -```text -[user@localhost ~]$ su - enterprisedb -Password: --bash-4.1$ pwd -/opt/PostgresPlus/9.6AS --bash-4.1$ ls -l .ssh -total 12 --rw------- 1 enterprisedb enterprisedb 416 Apr 23 13:15 authorized_keys --rw------- 1 enterprisedb enterprisedb 1675 Apr 23 13:04 id_rsa --rw-r--r-- 1 enterprisedb enterprisedb 416 Apr 23 13:04 id_rsa.pub -``` - -The public key file, `id_rsa.pub`, for BART user account `enterprisedb` on the BART host that was earlier generated in [Generating a Public Key File for the BART User Account](#generating-a-public-key-file-for-the-bart-user-account), is now copied to the remote Advanced Server host on `192.168.2.24`: - -```text --bash-4.1$ scp ~/.ssh/id_rsa.pub enterprisedb@192.168.2.24:/tmp/tmp.pub -The authenticity of host '192.168.2.24 (192.168.2.24)' can't be -established. -RSA key fingerprint is 59:41:fb:0c:ae:64:3d:3f:a2:d9:90:95:cf:2c:99:f2. -Are you sure you want to continue connecting (yes/no)? yes -Warning: Permanently added '192.168.2.24' (RSA) to the list of known -hosts. -enterprisedb@192.168.2.24's password: -id_rsa.pub -``` - -Log into the `enterprisedb` user account on the remote host and copy the public key file onto the `authorized_keys` file of the remote `enterprisedb` user account under its `.ssh` directory: - -```text --bash-4.1$ ssh enterprisedb@192.168.2.24 -enterprisedb@192.168.2.24's password: -Last login: Tue Apr 21 09:53:18 2015 from 192.168.2.22 --bash-4.1$ pwd -/opt/PostgresPlus/9.6AS --bash-4.1$ ls -l .ssh -total 12 --rw------- 1 enterprisedb enterprisedb 1675 Apr 23 13:11 id_rsa --rw-r--r-- 1 enterprisedb enterprisedb 416 Apr 23 13:11 id_rsa.pub --rw-r--r-- 1 enterprisedb enterprisedb 394 Apr 23 13:12 known_hosts --bash-4.1$ cat /tmp/tmp.pub >> ~/.ssh/authorized_keys -``` - -Adjust the file permission on `authorized_keys`: - -```text --bash-4.1$ chmod 600 ~/.ssh/authorized_keys --bash-4.1$ ls -l .ssh -total 16 --rw------- 1 enterprisedb enterprisedb 416 Apr 23 13:26 authorized_keys --rw------- 1 enterprisedb enterprisedb 1675 Apr 23 13:11 id_rsa --rw-r--r-- 1 enterprisedb enterprisedb 416 Apr 23 13:11 id_rsa.pub --rw-r--r-- 1 enterprisedb enterprisedb 394 Apr 23 13:12 known_hosts --bash-4.1$ rm /tmp/tmp.pub --bash-4.1$ exit -logout -Connection to 192.168.2.24 closed. -``` - -While logged into the BART host, test the passwordless connection from the BART host to the remote Advanced Server host: - -```text --bash-4.1$ ssh enterprisedb@192.168.2.24 -Last login: Thu Apr 23 13:25:53 2015 from 192.168.2.22 --bash-4.1$ exit -logout -Connection to 192.168.2.24 closed. -``` - -### Configuring Access from a Remote PostgreSQL Server to a BART Host - -On the remote host (192.168.2.24), create a public key file owned by the database server user account (`postgres`), allowing access to the BART user account (`enterprisedb`) on the BART host (192.168.2.22). - -Create the `.ssh` directory for the `postgres` user account on the remote host: - -```text -[root@localhost 9.6]# cd /opt/PostgreSQL/9.6 -[root@localhost 9.6]# mkdir .ssh -[root@localhost 9.6]# chown postgres .ssh -[root@localhost 9.6]# chgrp postgres .ssh -[root@localhost 9.6]# chmod 700 .ssh -[root@localhost 9.6]# ls -la | grep ssh -drwx------ 2 postgres postgres 4096 Apr 23 13:32 .ssh -``` - -Create and copy the generated public key file, `id_rsa.pub`, to the BART user account (`enterprisedb`), on the BART host (`192.168.2.22`): - -```text -[user@localhost ~]$ su - postgres -Password: --bash-4.1$ pwd -/opt/PostgreSQL/9.6 --bash-4.1$ ssh-keygen -t rsa -Generating public/private rsa key pair. -Enter file in which to save the key (/opt/PostgreSQL/9.6/.ssh/id_rsa): -Enter passphrase (empty for no passphrase): -Enter same passphrase again: -Your identification has been saved in /opt/PostgreSQL/9.6/.ssh/id_rsa. -Your public key has been saved in /opt/PostgreSQL/9.6/.ssh/id_rsa.pub. -The key fingerprint is: -1f:f8:76:d6:fc:a5:1a:c5:5a:66:66:01:d0:a0:ca:ba -postgres@localhost.localdomain -The key's randomart image is: -+--[ RSA 2048]----+ -| o+. | -| . .. | -| . . | -| . . . . . | -| o S . O | -| . o . @ | -| . + = o .| -| . . o . o.| -| E ... .| -+-----------------+ --bash-4.1$ ls -l .ssh -total 8 --rw------- 1 postgres postgres 1671 Apr 23 13:36 id_rsa --rw-r--r-- 1 postgres postgres 412 Apr 23 13:36 id_rsa.pub --bash-4.1$ scp ~/.ssh/id_rsa.pub enterprisedb@192.168.2.22:/tmp/tmp.pub -The authenticity of host '192.168.2.22 (192.168.2.22)' can't be -established. -RSA key fingerprint is b8:a9:97:31:79:16:b8:2b:b0:60:5a:91:38:d7:68:22. -Are you sure you want to continue connecting (yes/no)? yes -Warning: Permanently added '192.168.2.22' (RSA) to the list of known -hosts. -enterprisedb@192.168.2.22's password: -id_rsa.pub -``` - -Log into the BART host as the BART user account and append the temporary public key file, `/tmp/tmp.pub`, onto the `authorized_keys` file owned by the BART user account. - -```text --bash-4.1$ ssh enterprisedb@192.168.2.22 -enterprisedb@192.168.2.22's password: -Last login: Thu Apr 23 13:19:25 2015 from 192.168.2.24 --bash-4.1$ pwd -/opt/PostgresPlus/9.6AS --bash-4.1$ cat /tmp/tmp.pub >> ~/.ssh/authorized_keys --bash-4.1$ ls -l .ssh -total 16 --rw------- 1 enterprisedb enterprisedb 828 Apr 23 13:40 authorized_keys --rw------- 1 enterprisedb enterprisedb 1675 Apr 23 13:04 id_rsa --rw-r--r-- 1 enterprisedb enterprisedb 416 Apr 23 13:04 id_rsa.pub --rw-r--r-- 1 enterprisedb enterprisedb 394 Apr 23 13:24 known_hosts --bash-4.1$ rm /tmp/tmp.pub --bash-4.1$ exit -logout -Connection to 192.168.2.22 closed. -``` - -Make sure the `authorized_keys` file has file permission 600 as shown, or the passwordless connection will fail. Test the passwordless connection; from the remote host, while logged in as user account `postgres`, verify that you can log into the BART host with the BART user account without being prompted for a password: - -```text --bash-4.1$ pwd -/opt/PostgreSQL/9.6 --bash-4.1$ ssh enterprisedb@192.168.2.22 -Last login: Thu Apr 23 13:40:10 2015 from 192.168.2.24 --bash-4.1$ exit -logout -Connection to 192.168.2.22 closed. -``` - -### Configuring Access from the BART Host to Remote PostgreSQL - -Copy the public key file on the BART host that is owned by the BART user account (`enterprisedb`) to the remote database server user account (`postgres`), on the remote host (192.168.2.24). - -The following lists the current SSH keys files in the BART user’s `.ssh` directory on the BART host: - -```text -[user@localhost ~]$ su - enterprisedb -Password: --bash-4.1$ ls -l .ssh -total 16 --rw------- 1 enterprisedb enterprisedb 828 Apr 23 13:40 authorized_keys --rw------- 1 enterprisedb enterprisedb 1675 Apr 23 13:04 id_rsa --rw-r--r-- 1 enterprisedb enterprisedb 416 Apr 23 13:04 id_rsa.pub --rw-r--r-- 1 enterprisedb enterprisedb 394 Apr 23 13:24 known_hosts -``` - -The public key file, `id_rsa.pub`, for BART user account `enterprisedb` on the BART host that was earlier generated in [Generating a Public Key File for the BART User Account](#generating-a-public-key-file-for-the-bart-user-account), now resides on the remote PostgreSQL host: - -```text --bash-4.1$ scp ~/.ssh/id_rsa.pub postgres@192.168.2.24:/tmp/tmp.pub -postgres@192.168.2.24's password: -id_rsa.pub -``` - -Log into the `postgres` user account on the remote host and copy the public key file onto the `authorized_keys` file of `postgres` under its `.ssh` directory: - -```text --bash-4.1$ ssh postgres@192.168.2.24 -postgres@192.168.2.24's password: -Last login: Mon Jan 26 18:08:36 2015 from 192.168.2.19 --bash-4.1$ pwd -/opt/PostgreSQL/9.6 --bash-4.1$ cat /tmp/tmp.pub >> ~/.ssh/authorized_keys -``` - -Adjust the file permissions on `authorized_keys`: - -```text --bash-4.1$ ls -l .ssh -total 16 --rw-rw-r-- 1 postgres postgres 416 Apr 23 13:52 authorized_keys --rw------- 1 postgres postgres 1671 Apr 23 13:36 id_rsa --rw-r--r-- 1 postgres postgres 412 Apr 23 13:36 id_rsa.pub --rw-r--r-- 1 postgres postgres 394 Apr 23 13:36 known_hosts --bash-4.1$ chmod 600 ~/.ssh/authorized_keys --bash-4.1$ ls -l .ssh -total 16 --rw------- 1 postgres postgres 416 Apr 23 13:52 authorized_keys --rw------- 1 postgres postgres 1671 Apr 23 13:36 id_rsa --rw-r--r-- 1 postgres postgres 412 Apr 23 13:36 id_rsa.pub --rw-r--r-- 1 postgres postgres 394 Apr 23 13:36 known_hosts --bash-4.1$ rm /tmp/tmp.pub --bash-4.1$ exit -logout -Connection to 192.168.2.24 closed. -``` - -Test the passwordless connection from the BART host to the remote PostgreSQL host: - -```text -[user@localhost ~]$ su - enterprisedb -Password: --bash-4.1$ ssh postgres@192.168.2.24 -Last login: Thu Apr 23 13:52:25 2015 from 192.168.2.22 --bash-4.1$ exit -logout -Connection to 192.168.2.24 closed. -``` - - - -## Configuring a Replication Database User - -This section demonstrates how a replication database user is established. - -**All database servers must use a superuser as the replication database user.** - -The replication database user for each database server is specified by the `user` parameter in the BART configuration file as shown by the following: - -```text -[ACCTG] - -host = 127.0.0.1 -port = 5444 -user = enterprisedb <=== Replication Database User -cluster_owner = enterprisedb -backup_name = acctg_%year-%month-%dayT%hour:%minute -archive_command = 'cp %p %a/%f' -description = "Accounting" - -[MKTG] -host = 192.168.2.24 -port = 5444 -user = repuser <=== Replication Database User -cluster_owner = enterprisedb -backup_name = mktg_%year-%month-%dayT%hour:%minute -remote_host = enterprisedb@192.168.2.24 -description = "Marketing" - -[HR] - -host = 192.168.2.24 -port = 5432 -user = postgres <=== Replication Database User -cluster_owner = enterprisedb -backup_name = hr_%year-%month-%dayT%hour:%minute -remote_host = postgres@192.168.2.24 -copy_wals_during_restore = enabled -description = "Human Resources" -``` - -Add entries to the `.pgpass` file on each server to allow the BART user account to initiate a backup without being prompted for credentials. The `.pgpass` file is located in `/opt/PostgresPlus/9.6AS/.pgpass`: - -```text -127.0.0.1:5444:*:enterprisedb:password -192.168.2.24:5444:*:repuser:password -192.168.2.24:5432:*:postgres:password -``` - -For more information about using a `.pgpass` file, please see the [PostgreSQL documentation](https://www.postgresql.org/docs/current/libpq-pgpass.html). - -While connected to `MKTG` on 192.168.2.24, execute the following `CREATE ROLE` command to create the replication database superuser: - -```text -CREATE ROLE repuser WITH LOGIN SUPERUSER PASSWORD 'password'; -``` - -Access is granted in the `pg_hba.conf` file for the local Advanced Server: - -```text -# TYPE DATABASE USER ADDRESS METHOD -# "local" is for Unix domain socket connections only -local all all md5 -# IPv4 local connections: -host template1 enterprisedb 127.0.0.1/32 md5 -host edb enterprisedb 127.0.0.1/32 md5 -#host all all 127.0.0.1/32 md5 -# IPv6 local connections: -host all all ::1/128 md5 -# Allow replication connections from localhost, by a user with the -# replication privilege. -#local replication enterprisedb md5 -host replication enterprisedb 127.0.0.1/32 md5 -``` - -Similarly, access is granted in the `pg_hba.conf` file for the remote Advanced Server installation: - -```text -# TYPE DATABASE USER ADDRESS METHOD -# "local" is for Unix domain socket connections only -local all all md5 -# IPv4 local connections: -host template1 repuser 192.168.2.22/32 md5 -host all enterprisedb 127.0.0.1/32 md5 -#host all all 127.0.0.1/32 md5 -# IPv6 local connections: -host all all ::1/128 md5 -# Allow replication connections from localhost, by a user with the -# replication privilege. -#local replication enterprisedb md5 -host replication repuser 192.168.2.22/32 md5 -``` - -Access is also granted in the `pg_hba.conf` file for the remote PostgreSQL server: - -```text -# TYPE DATABASE USER ADDRESS METHOD -# "local" is for Unix domain socket connections only -local all all md5 -# IPv4 local connections: -host template1 postgres 192.168.2.22/32 md5 -host all all 127.0.0.1/32 md5 -# IPv6 local connections: -host all all ::1/128 md5 -# Allow replication connections from localhost, by a user with the -q# replication privilege. -#local replication postgres md5 -host replication postgres 192.168.2.22/32 md5 -``` - - - -## WAL Archiving Configuration Parameters - -Use the following parameters in the `postgresql.conf` file to enable WAL archiving. The `postgresql.conf` file for the local Advanced Server database (`ACCTG`) is set as follows: - -```text -wal_level = archive -archive_mode = on # allows archiving to be done - # (change requires restart) -#archive_command = '' # command to use to archive - a logfile segment - # placeholders: %p = path of - file to archive - # %f = file name only -max_wal_senders = 3 -``` - -When the `INIT` subcommand is invoked, the Postgres `archive_command` configuration parameter in the `postgresql.auto.conf` file will be set based on the BART `archive_command` parameter located in the BART configuration file. - -!!! Note - If the Postgres `archive_command` is already set, invoke the `INIT` subcommand with the `-- no-configure` option to prevent the `archive_command` from being reset. For details, see [INIT](../bart_user/03_using_bart/03_basic_bart_subcommand_usage/02_init/#init). - -```text -[BART] -bart_host= enterprisedb@192.168.2.22 -backup_path = /opt/backup -pg_basebackup_path = /usr/edb/as11/bin/pg_basebackup -retention_policy = 6 BACKUPS -logfile = /tmp/bart.log -scanner_logfile = /tmp/bart_scanner.log - -[ACCTG] -host = 127.0.0.1 -port = 5444 -user = enterprisedb -cluster_owner = enterprisedb -backup_name = acctg_%year-%month-%dayT%hour:%minute -archive_command = 'cp %p %a/%f' -description = "Accounting" -``` - -When the `INIT` subcommand is invoked, the `postgresql.auto.conf` file contains the following: - -```text -# Do not edit this file manually! -# It will be overwritten by ALTER SYSTEM command. -archive_command = 'cp %p /opt/backup/acctg/archived_wals/%f' -``` - -The `archive_command` uses the `cp` command instead of `scp` since the BART backup catalog is local to this database cluster and the BART user account (the account that owns the backup catalog, `enterprisedb`), is the same user account running Advanced Server. The result is that there is no directory permission conflict during the archive operation. - -The `postgresql.conf` file for the remote Advanced Server, `MKTG` is set as follows: - -```text -wal_level = archive -archive_mode = on # allows archiving to be done - # (change requires restart) -archive_command = '' # command to use to archive a - logfile segment - # placeholders: %p = path of - file to archive - # %f = file name only -max_wal_senders = 3 -``` - -When the `INIT` subcommand is invoked, the Postgres `archive_command` configuration parameter in the `postgresql.auto.conf` file will be set by the default BART format of the BART `archive_command` parameter (since it is not explicitly set for this database server in the BART configuration file). - -```text -[BART] -bart_host= enterprisedb@192.168.2.22 -backup_path = /opt/backup -pg_basebackup_path = /usr/edb/as11/bin/pg_basebackup -retention_policy = 6 BACKUPS -logfile = /tmp/bart.log -scanner_logfile = /tmp/bart_scanner.log -. -. -. -[MKTG] - -host = 192.168.2.24 -port = 5444 -user = repuser -cluster_owner = enterprisedb -backup_name = mktg_%year-%month-%dayT%hour:%minute -remote_host = enterprisedb@192.168.2.24 -description = "Marketing" -``` - -The default BART `archive_command` format is: - -```text -archive_command = 'scp %p %h:%a/%f' -``` - -The `postgresql.auto.conf` file contains the following after the `INIT` subcommand is invoked: - -```text -# Do not edit this file manually! -# It will be overwritten by ALTER SYSTEM command. -archive_command = 'scp %p -enterprisedb@192.168.2.22:/opt/backup/hr/archived_wals/%f' -``` - -The `archive_command` uses the `scp` command since the BART backup catalog is remote relative to this database cluster. The BART user account, `enterprisedb`, is specified on the `scp` command since this is the user account owning the BART backup catalog where the archived WAL files are to be copied. The result is that there is no directory permission conflict during the archive operation. - -The `postgresql.conf` file for the remote PostgreSQL server (`HR`) is set as follows: - -```text -wal_level = archive -archive_mode = on # allows archiving to be done - # (change requires restart) -#archive_command = '' # command to use to archive a - logfile segment - # placeholders: %p = path of - file to archive - # %f = file name only -max_wal_senders = 3 -``` - -When the `INIT` subcommand is invoked, the Postgres `archive_command` configuration parameter in the `postgresql.auto.conf` file will be set by the default BART format of the BART `archive_command` parameter (since it is not explicitly set for this database server in the BART configuration file): - -```text -[BART] - -bart_host= enterprisedb@192.168.2.22 -backup_path = /opt/backup -pg_basebackup_path = /usr/edb/as11/bin/pg_basebackup -retention_policy = 6 BACKUPS -logfile = /tmp/bart.log -scanner_logfile = /tmp/bart_scanner.log -. -. -. -[HR] - -host = 192.168.2.24 -port = 5432 -user = postgres -cluster_owner = postgres -backup_name = hr_%year-%month-%dayT%hour:%minute -remote_host = postgres@192.168.2.24 -copy_wals_during_restore = enabled -description = "Human Resources" -``` - -The default BART `archive_command` format is: - -```text -archive_command = 'scp %p %h:%a/%f' -``` - -The `postgresql.auto.conf` file contains the following after the `INIT` subcommand is invoked: - -```text -# Do not edit this file manually! -# It will be overwritten by ALTER SYSTEM command. -archive_command = 'scp %p -enterprisedb@192.168.2.22:/opt/backup/hr/archived_wals/%f' -``` - -The `archive_command` uses the `scp` command since the BART backup catalog is remote relative to this database cluster. The BART user account, `enterprisedb`, is specified on the `scp` command since this is the user account owning the BART backup catalog where the archived WAL files are to be copied. The result is that there is no directory permission conflict during the archive operation. - - - -## Creating the BART Backup Catalog (backup_path) - -Create the directory specified by the `backup_path` configuration parameter. - -```text -[BART] - -bart_host= enterprisedb@192.168.2.22 -backup_path = /opt/backup -pg_basebackup_path = /usr/edb/as11/bin/pg_basebackup -retention_policy = 6 BACKUPS -logfile = /tmp/bart.log -scanner_logfile = /tmp/bart_scanner.log -``` - -Ensure that the directory is owned by the BART user account: - -```text -[root@localhost opt]# pwd -/opt -[root@localhost opt]# mkdir backup -[root@localhost opt]# chown enterprisedb backup -[root@localhost opt]# chgrp enterprisedb backup -[root@localhost opt]# chmod 700 backup -[root@localhost opt]# ls -l | grep backup -drwx------ 2 enterprisedb enterprisedb 4096 Apr 23 15:36 backup -``` - -Use the BART `INIT` subcommand to complete the directory structure and set the Postgres `archive_command` configuration parameter. - -Before invoking any BART subcommands, set up a profile under the BART user account’s home directory to set the `LD_LIBRARY_PATH` and `PATH` environment variables. For more information regarding setting this variable, see the EDB Backup and Recovery Installation and Upgrade Guide available at the [EDB website](/bart/latest/bart_inst/). - -The `-o` option is specified with the `INIT` subcommand to force the setting of the Postgres `archive_command` configuration parameter when `archive_mode` is `off` or if the Postgres `archive_command` parameter is already set and needs to be overridden. - -```text -[user@localhost ~]$ su - enterprisedb -Password: --bash-4.1$ bart INIT -o -INFO: setting archive_command for server 'acctg' -WARNING: archive_command is set. server restart is required -INFO: setting archive_command for server 'hr' -WARNING: archive_command is set. server restart is required -INFO: setting archive_command for server 'mktg' -WARNING: archive_command is set. server restart is required -``` - -The BART `SHOW-SERVERS` subcommand displays the following: - -```text --bash-4.1$ bart SHOW-SERVERS -SERVER NAME : acctg -BACKUP FRIENDLY NAME: acctg_%year-%month-%dayT%hour:%minute -HOST NAME : 127.0.0.1 -USER NAME : enterprisedb -PORT : 5444 -REMOTE HOST : -RETENTION POLICY : 6 Backups -DISK UTILIZATION : 0.00 bytes -NUMBER OF ARCHIVES : 0 -ARCHIVE PATH : /opt/backup/acctg/archived_wals -ARCHIVE COMMAND : (disabled) -XLOG METHOD : fetch -WAL COMPRESSION : disabled -TABLESPACE PATH(s) : -INCREMENTAL BACKUP : DISABLED -DESCRIPTION : "Accounting" -SERVER NAME : hr -BACKUP FRIENDLY NAME: hr_%year-%month-%dayT%hour:%minute -HOST NAME : 192.168.2.24 -USER NAME : postgres -PORT : 5432 -REMOTE HOST : postgres@192.168.2.24 -RETENTION POLICY : 6 Backups -DISK UTILIZATION : 0.00 bytes -NUMBER OF ARCHIVES : 0 -ARCHIVE PATH : /opt/backup/hr/archived_wals -ARCHIVE COMMAND : (disabled) -XLOG METHOD : fetch -WAL COMPRESSION : disabled -TABLESPACE PATH(s) : -INCREMENTAL BACKUP : DISABLED -DESCRIPTION : "Human Resources" -SERVER NAME : mktg -BACKUP FRIENDLY NAME: mktg_%year-%month-%dayT%hour:%minute -HOST NAME : 192.168.2.24 -USER NAME : repuser -PORT : 5444 -REMOTE HOST : enterprisedb@192.168.2.24 -RETENTION POLICY : 6 Backups -DISK UTILIZATION : 0.00 bytes -NUMBER OF ARCHIVES : 0 -ARCHIVE PATH : /opt/backup/mktg/archived_wals -ARCHIVE COMMAND : (disabled) -XLOG METHOD : fetch -WAL COMPRESSION : disabled -TABLESPACE PATH(s) : -INCREMENTAL BACKUP : DISABLED -DESCRIPTION : "Marketing" --bash-4.1$ cd /opt/backup --bash-4.1$ pwd -/opt/backup --bash-4.1$ ls -l -total 12 -drwxrwxr-x 3 enterprisedb enterprisedb 4096 Mar 29 13:16 acctg -drwxrwxr-x 3 enterprisedb enterprisedb 4096 Mar 29 13:16 hr -drwxrwxr-x 3 enterprisedb enterprisedb 4096 Mar 29 13:16 mktg --bash-4.1$ ls -l acctg -total 4 -drwxrwxr-x 2 enterprisedb enterprisedb 4096 Mar 29 13:16 archived_wals --bash-4.1$ ls -l hr -total 4 -drwxrwxr-x 2 enterprisedb enterprisedb 4096 Mar 29 13:16 archived_wals --bash-4.1$ ls -l mktg -total 4 -drwxrwxr-x 2 enterprisedb enterprisedb 4096 Mar 29 13:16 archived_wals -``` - -The `ARCHIVE PATH` field displays the full directory path to where the WAL files are copied. This directory path must match the directory path specified in the Postgres `archive_command` parameter of the `postgresql.conf` file or the `postgresql.auto.conf` file of each database server. - - - -### Starting the Database Servers with WAL Archiving - -After the BART backup catalog directory structure has been configured, start the archiving of WAL files from the database servers by restarting each database server. - -On BART host 192.168.2.22: - -```text -[root@localhost data]# service ppas-9.6 restart -``` - -On remote host 192.168.2.24: - -```text -[root@localhost data]# service ppas-9.6 restart - -[root@localhost data]# service postgresql-9.6 restart -``` - -In the BART backup catalog, verify that the WAL files are archiving. - -Archived WAL files may not appear very frequently depending upon how often WAL archiving is set to switch to a new segment file with the `archive_timeout` parameter in your database server configuration settings. - -Verify that there are no archiving-related errors in the database server log files. - -## Taking a Full Backup - -The following code sample shows the first full backup of the database servers. - -```text --bash-4.1$ bart BACKUP -s acctg -z -INFO: creating backup for server 'acctg' -INFO: backup identifier: '1490809695281' -60776/60776 kB (100%), 1/1 tablespace - -INFO: backup completed successfully -INFO: backup checksum: 37f3defb98ca88dcf05079815555dfc2 of base.tar.gz -INFO: -BACKUP DETAILS: -BACKUP STATUS: active -BACKUP IDENTIFIER: 1490809695281 -BACKUP NAME: acctg_2017-03-29T13:48 -BACKUP PARENT: none -BACKUP LOCATION: /opt/backup/acctg/1490809695281 -BACKUP SIZE: 6.10 MB -BACKUP FORMAT: tar.gz -BACKUP TIMEZONE: US/Eastern -XLOG METHOD: fetch -BACKUP CHECKSUM(s): 1 -ChkSum File -37f3defb98ca88dcf05079815555dfc2 base.tar.gz - -TABLESPACE(s): 0 -START WAL LOCATION: 000000010000000000000004 -STOP WAL LOCATION: 000000010000000000000004 -BACKUP METHOD: streamed -BACKUP FROM: primary -START TIME: 2017-03-29 13:48:15 EDT -STOP TIME: 2017-03-29 13:48:17 EDT -TOTAL DURATION: 2 sec(s) - --bash-4.1$ bart BACKUP -s mktg -z -INFO: creating backup for server 'mktg' -INFO: backup identifier: '1490809751193' -61016/61016 kB (100%), 1/1 tablespace - -INFO: backup completed successfully -INFO: backup checksum: 8b010e130a105e76d01346bb56dfcf14 of base.tar.gz -INFO: -BACKUP DETAILS: -BACKUP STATUS: active -BACKUP IDENTIFIER: 1490809751193 -BACKUP NAME: mktg_2017-03-29T13:49 -BACKUP PARENT: none -BACKUP LOCATION: /opt/backup/mktg/1490809751193 -BACKUP SIZE: 6.13 MB -BACKUP FORMAT: tar.gz -BACKUP TIMEZONE: US/Eastern -XLOG METHOD: fetch -BACKUP CHECKSUM(s): 1 -ChkSum File -8b010e130a105e76d01346bb56dfcf14 base.tar.gz - -TABLESPACE(s): 0 -START WAL LOCATION: 000000010000000100000085 -BACKUP METHOD: streamed -BACKUP FROM: primary -START TIME: 2017-03-29 13:49:11 EDT -STOP TIME: 2017-03-29 13:49:14 EDT -TOTAL DURATION: 3 sec(s) - --bash-4.1$ bart BACKUP -s hr -z -INFO: creating backup for server 'hr' -INFO: backup identifier: '1490809824946' -38991/38991 kB (100%), 1/1 tablespace -INFO: backup completed successfully -INFO: backup checksum: 277e8a1a80ba3474f541eb316a417c9a of base.tar.gz -INFO: -BACKUP DETAILS: -BACKUP STATUS: active -BACKUP IDENTIFIER: 1490809824946 -BACKUP NAME: hr_2017-03-29T13:50 -BACKUP PARENT: none -BACKUP LOCATION: /opt/backup/hr/1490809824946 -BACKUP SIZE: 2.59 MB -BACKUP FORMAT: tar.gz -BACKUP TIMEZONE: US/Eastern -XLOG METHOD: fetch -BACKUP CHECKSUM(s): 1 -ChkSum File -277e8a1a80ba3474f541eb316a417c9a base.tar.gz - -TABLESPACE(s): 0 -START WAL LOCATION: 000000010000000000000002 -BACKUP METHOD: streamed -BACKUP FROM: primary -START TIME: 2017-03-29 13:50:25 EDT -STOP TIME: 2017-03-29 13:50:26 EDT -TOTAL DURATION: 1 sec(s) -``` - -The following code sample shows the backup directories created for each backup of each database server. The backup ID is used as the backup directory name. - -```text --bash-4.1$ cd /opt/backup --bash-4.1$ ls -l -total 12 -drwxrwxr-x 4 enterprisedb enterprisedb 4096 Mar 29 13:48 acctg -drwxrwxr-x 4 enterprisedb enterprisedb 4096 Mar 29 13:50 hr -drwxrwxr-x 4 enterprisedb enterprisedb 4096 Mar 29 13:49 mktg --bash-4.1$ ls -l acctg -total 8 -drwx------ 2 enterprisedb enterprisedb 4096 Mar 29 13:48 1490809695281 -drwxrwxr-x 2 enterprisedb enterprisedb 4096 Mar 29 13:48 archived_wals --bash-4.1$ ls -l hr -total 8 -drwx------ 2 enterprisedb enterprisedb 4096 Mar 29 13:50 1490809824946 -drwxrwxr-x 2 enterprisedb enterprisedb 4096 Mar 29 13:50 archived_wals --bash-4.1$ ls -l mktg -total 8 -drwx------ 2 enterprisedb enterprisedb 4096 Mar 29 13:49 1490809751193 -drwxrwxr-x 2 enterprisedb enterprisedb 4096 Mar 29 13:49 archived_wals -``` - - - -## Using Point-In-Time Recovery - -This section demonstrates using the point-in-time recovery operation on the remote PostgreSQL database server. - -The following tables were created about two minutes apart with WAL archiving enabled: - -```text -postgres=# \dt - - List of relations -Schema | Name | Type | Owner - ---------+----------------+---------+--------- -public | hr_rmt_t1_1356 | table | postgres -public | hr_rmt_t1_1358 | table | postgres -public | hr_rmt_t1_1400 | table | postgres -public | hr_rmt_t1_1402 | table | postgres -public | hr_rmt_t1_1404 | table | postgres -public | hr_rmt_t1_1406 | table | postgres -(6 rows) -``` - -In the table name `hr_rmt_t_, n` represents the active timeline. `` is the approximate time the table was created. For example, `hr_rmt_t1_1356` was created at approximately 1:56 PM while timeline #1 is active. - -The PostgreSQL database server was then stopped. WAL files that have been created, but not yet archived must be identified, and then saved. The following archived WAL files are in the BART backup catalog: - -```text --bash-4.1$ ls -l hr/archived_wals -total 49156 --rw------- 1 enterprisedb enterprisedb 16777216 Mar 29 13:50 -000000010000000000000001 --rw------- 1 enterprisedb enterprisedb 16777216 Mar 29 13:50 -000000010000000000000002 --rw------- 1 enterprisedb enterprisedb 302 Mar 29 13:50 -000000010000000000000002.00000028.backup --rw------- 1 enterprisedb enterprisedb 16777216 Mar 29 14:07 -000000010000000000000003 -``` - -The following sample lists the current PostgreSQL server WAL files. The unarchived WAL files are marked with two stars (\*\*). - -```text --bash-4.1$ cd /opt/PostgreSQL/9.6/data/pg_xlog --bash-4.1$ pwd -/opt/PostgreSQL/9.6/data/pg_xlog --bash-4.1$ ls -l -total 49160 --rw------- 1 postgres postgres 302 Mar 29 13:50 -000000010000000000000002.00000028.backup --rw------- 1 postgres postgres 16777216 Mar 29 14:07 -000000010000000000000003 --rw------- 1 postgres postgres 16777216 Mar 29 14:07 -**000000010000000000000004** --rw------- 1 postgres postgres 16777216 Mar 29 13:50 -**000000010000000000000005** -drwx------ 2 postgres postgres 4096 Mar 29 14:07 archive_status -``` - -Copies of the unarchived WAL files are saved to a temporary location: - -```text --bash-4.1$ mkdir /tmp/unarchived_pg96_wals --bash-4.1$ pwd -/opt/PostgreSQL/9.6/data/pg_xlog -bash-4.1$ cp -p 000000010000000000000004 /tmp/unarchived_pg96_wals -bash-4.1$ cp -p 000000010000000000000005 /tmp/unarchived_pg96_wals -bash-4.1$ ls -l /tmp/unarchived_pg96_wals -total 32768 --rw------- 1 postgres postgres 16777216 Mar 29 14:07 000000010000000000000004 --rw------- 1 postgres postgres 16777216 Mar 29 13:50 000000010000000000000005 -``` - -On the remote host, a directory is created to which the PostgreSQL database cluster is to be restored. This restore path is named `/opt/restore_pg96` and is owned by user account `postgres`. - -```text -[user@localhost ~]$ su root -Password: -[root@localhost user]# cd /opt -[root@localhost opt]# mkdir restore_pg96 -[root@localhost opt]# chown postgres restore_pg96 -[root@localhost opt]# chgrp postgres restore_pg96 -[root@localhost opt]# chmod 700 restore_pg96 -[root@localhost opt]# ls -l -total 16 -drwxr-xr-x 4 root daemon 4096 Mar 29 12:10 PostgresPlus -drwxr-xr-x 3 root daemon 4096 Mar 29 12:25 PostgreSQL -drwx------ 2 postgres postgres 4096 Mar 29 14:15 restore_pg96 -drwxr-xr-x. 2 root root 4096 Nov 22 2013 rh -``` - -In the BART configuration file, the remote user and remote host IP address, `postgres@192.168.2.24`, have been set with the `remote_host` parameter. If not given in the BART configuration file, this information must then be specified by the `--remote-host` option when giving the `RESTORE` subcommand (for example, `bart RESTORE --remote-host postgres@192.168.2.24 …`). - -```text -[HR] - -host = 192.168.2.24 -port = 5432 -user = postgres -cluster_owner = postgres -backup_name = hr_%year-%month-%dayT%hour:%minute -remote_host = postgres@192.168.2.24 -copy_wals_during_restore = enabled -description = "Human Resources" -``` - -Use the `SHOW-BACKUPS` subcommand to identify the backup to use with the `RESTORE` subcommand. - -```text -SERVER NAME BACKUP ID BACKUP NAME BACKUP PARENT -BACKUP TIME -BACKUP SIZE WAL(s) SIZE WAL FILES STATUS -acctg 1490809695281 acctg_2017-03-29T13:48 none -2017-03-29 13:48:17 EDT -6.10 MB 32.00 MB 2 active -hr 1490809824946 hr_2017-03-29T13:50 none -2017-03-29 13:50:26 EDT -2.59 MB 32.00 MB 2 active -mktg 1490809751193 mktg_2017-03-29T13:49 none -2017-03-29 13:49:14 EDT -6.13 MB 64.00 MB 4 active -``` - -The `-t` option with the `SHOW-BACKUPS` subcommand displays additional backup information: - -```text --bash-4.1$ bart SHOW-BACKUPS -s hr -i 1490809824946 -t -SERVER NAME : hr -BACKUP ID : 1490809824946 -BACKUP NAME : hr_2017-03-29T13:50 -BACKUP PARENT : none -BACKUP STATUS : active -BACKUP TIME : 2017-03-29 13:50:26 EDT -BACKUP SIZE : 2.59 MB -WAL(S) SIZE : 32.00 MB -NO. OF WALS : 2 -FIRST WAL FILE : 000000010000000000000002 -CREATION TIME : 2017-03-29 13:50:31 EDT -LAST WAL FILE : 000000010000000000000003 -CREATION TIME : 2017-03-29 14:07:35 EDT -``` - -A recovery is made using timeline `1` to `2017-03-29 14:01:00`. - -```text --bash-4.1$ bart RESTORE -s hr -i hr_2017-03-29T13:50 -p -/opt/restore_pg96 -t 1 -g '2017-03-29 14:01:00' -INFO: restoring backup 'hr_2017-03-29T13:50' of server 'hr' -INFO: base backup restored -INFO: copying WAL file(s) to -postgres@192.168.2.24:/opt/restore_pg96/archived_wals -INFO: writing recovery settings to postgresql.auto.conf file -INFO: archiving is disabled -INFO: permissions set on $PGDATA -INFO: restore completed successfully -``` - -The following example shows the restored backup files in the restore path directory, `/opt/restore_pg96`: - -```text --bash-4.1$ pwd -/opt/restore_pg96 --bash-4.1$ ls -l -total 128 -drwxr-xr-x 2 postgres postgres 4096 Mar 29 14:27 archived_wals --rw------- 1 postgres postgres 206 Mar 29 13:50 backup_label -drwx------ 5 postgres postgres 4096 Mar 29 12:25 base -drwx------ 2 postgres postgres 4096 Mar 29 14:27 global -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_clog -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_commit_ts -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_dynshmem --rw------- 1 postgres postgres 4212 Mar 29 13:18 pg_hba.conf --rw------- 1 postgres postgres 1636 Mar 29 12:25 pg_ident.conf -drwxr-xr-x 2 postgres postgres 4096 Mar 29 13:45 pg_log -drwx------ 4 postgres postgres 4096 Mar 29 12:25 pg_logical -drwx------ 4 postgres postgres 4096 Mar 29 12:25 pg_multixact -drwx------ 2 postgres postgres 4096 Mar 29 13:43 pg_notify -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_replslot -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_serial -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_snapshots -drwx------ 2 postgres postgres 4096 Mar 29 13:43 pg_stat -drwx------ 2 postgres postgres 4096 Mar 29 13:50 pg_stat_tmp -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_subtrans -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_tblspc -drwx------ 2 postgres postgres 4096 Mar 29 12:25 pg_twophase --rw------- 1 postgres postgres 4 Mar 29 12:25 PG_VERSION -drwx------ 3 postgres postgres 4096 Mar 29 14:27 pg_xlog --rw------- 1 postgres postgres 169 Mar 29 13:24 postgresql.auto.conf --rw-r--r-- 1 postgres postgres 21458 Mar 29 14:27 postgresql.conf --rw-r--r-- 1 postgres postgres 118 Mar 29 14:27 postgresql.auto.conf -``` - -Copy the saved, unarchived WAL files to the restore path `pg_xlog` subdirectory (`/opt/restore_pg96/pg_xlog`): - -```text --bash-4.1$ pwd -/opt/restore_pg96/pg_xlog --bash-4.1$ ls -l -total 16388 --rw------- 1 postgres postgres 16777216 Mar 29 13:50 -000000010000000000000002 -drwx------ 2 postgres postgres 4096 Mar 29 14:27 archive_status --bash-4.1$ ls -l /tmp/unarchived_pg96_wals -total 32768 --rw------- 1 postgres postgres 16777216 Mar 29 14:07 -000000010000000000000004 --rw------- 1 postgres postgres 16777216 Mar 29 13:50 -000000010000000000000005 --bash-4.1$ cp -p /tmp/unarchived_pg96_wals/* . --bash-4.1$ ls -l -total 49156 --rw------- 1 postgres postgres 16777216 Mar 29 13:50 -000000010000000000000002 --rw------- 1 postgres postgres 16777216 Mar 29 14:07 -000000010000000000000004 --rw------- 1 postgres postgres 16777216 Mar 29 13:50 -000000010000000000000005 -drwx------ 2 postgres postgres 4096 Mar 29 14:27 archive_status -``` - -Inspect the `/opt/restore_pg96/postgresql.auto.conf` file to verify that it contains the correct recovery settings: - -```text -restore_command = 'cp archived_wals/%f %p' -recovery_target_time = '2017-03-29 14:01:00' -recovery_target_timeline = 1 -``` - -Note that the command restores from the `archived_wals` subdirectory of `/opt/restore_pg96` since the `copy_wals_during_restore` parameter in the BART configuration file is set to `enabled` for database server `hr`. - -Start the database server to initiate the point-in-time recovery operation: - -```text -[user@localhost ~]$ su postgres -Password: -bash-4.1$ cd /opt/restore_pg96 -bash-4.1$ /opt/PostgreSQL/9.6/bin/pg_ctl start -D /opt/restore_pg96 -l -/opt/restore_pg96/pg_log/logfile -server starting -``` - -Inspect the database server log file to ensure the operation did not result in any errors: - -```text -2017-03-29 14:33:23 EDT LOG: database system was interrupted; last known -up at 2017-03-29 13:50:25 EDT -2017-03-29 14:33:23 EDT LOG: starting point-in-time recovery to -2017-03-29 14:01:00-04 -2017-03-29 14:33:23 EDT LOG: restored log file -"000000010000000000000002" from archive -2017-03-29 14:33:23 EDT LOG: redo starts at 0/2000098 -2017-03-29 14:33:23 EDT LOG: consistent recovery state reached at -0/20000C0 -2017-03-29 14:33:23 EDT LOG: restored log file -"000000010000000000000003" from archive -2017-03-29 14:33:23 EDT LOG: recovery stopping before commit of -transaction 1762, time 2017-03-29 14:02:28.100072-04 -2017-03-29 14:33:23 EDT LOG: redo done at 0/303F390 -2017-03-29 14:33:23 EDT LOG: last completed transaction was at log time -2017-03-29 14:00:43.351333-04 -cp: cannot stat `archived_wals/00000002.history': No such file or -directory -2017-03-29 14:33:23 EDT LOG: selected new timeline ID: 2 -cp: cannot stat `archived_wals/00000001.history': No such file or -directory -2017-03-29 14:33:23 EDT LOG: archive recovery complete -2017-03-29 14:33:23 EDT LOG: MultiXact member wraparound protections are -now enabled -2017-03-29 14:33:23 EDT LOG: database system is ready to accept -connections -2017-03-29 14:33:23 EDT LOG: autovacuum launcher started -``` - -The tables that exist in the recovered database cluster are: - -```text -postgres=# \dt - List of relations -Schema | Name | Type | Owner ---------+----------------+-------+---------- -public | hr_rmt_t1_1356 | table | postgres -public | hr_rmt_t1_1358 | table | postgres -public | hr_rmt_t1_1400 | table | postgres -(3 rows) -``` - -Since recovery was up to and including 2017-03-29 14:01:00, the following tables created after 14:01 are not present: - -```text -public | hr_rmt_t1_1402 | table | postgres -public | hr_rmt_t1_1404 | table | postgres -public | hr_rmt_t1_1406 | table | postgres -``` - -The BART `RESTORE` operation stops WAL archiving by adding an `archive_mode = off` parameter at the very end of the `postgresql.conf` file. This last parameter in the file overrides any other previous setting of the same parameter in the file. Delete the last setting and restart the database server to start WAL archiving. - -```text -# Add settings for extensions here -archive_mode = off -``` diff --git a/product_docs/docs/bart/2.5/bart_ref/images/EDB_logo.png b/product_docs/docs/bart/2.5/bart_ref/images/EDB_logo.png deleted file mode 100644 index f4a93cf57f5..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/images/EDB_logo.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:07423b012a855204780fe5a2a5a1e33607304a5c3020ae4acbf3d575691dedd6 -size 12136 diff --git a/product_docs/docs/bart/2.5/bart_ref/images/edb.png b/product_docs/docs/bart/2.5/bart_ref/images/edb.png deleted file mode 100644 index 3e8d3c76655..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/images/edb.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:df8233799fa8616e3762286196fbaf567f3ef45830c65bfcb42214e86a5d69fc -size 12049 diff --git a/product_docs/docs/bart/2.5/bart_ref/images/edb_logo.svg b/product_docs/docs/bart/2.5/bart_ref/images/edb_logo.svg deleted file mode 100644 index f24d1dfefee..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/images/edb_logo.svg +++ /dev/null @@ -1,19 +0,0 @@ - - - edb-logo-disc-dark - - - - \ No newline at end of file diff --git a/product_docs/docs/bart/2.5/bart_ref/images/image2.png b/product_docs/docs/bart/2.5/bart_ref/images/image2.png deleted file mode 100644 index edc64a0ff46..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/images/image2.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:50824c247a9be22f3c0e10a02d4ed308dce6ce9a86adfd87bb439a00d8c121c1 -size 92905 diff --git a/product_docs/docs/bart/2.5/bart_ref/index.mdx b/product_docs/docs/bart/2.5/bart_ref/index.mdx deleted file mode 100644 index 5a9651b6874..00000000000 --- a/product_docs/docs/bart/2.5/bart_ref/index.mdx +++ /dev/null @@ -1,47 +0,0 @@ ---- -navTitle: Reference Guide -title: "EDB Postgres Backup and Recovery Reference Guide" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.1/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.1/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.2/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.2/conclusion.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.2/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.4/conclusion.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.4/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.4/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.3/conclusion.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.3/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.3/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.5/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.5/conclusion.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.5/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.7/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.7/conclusion.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/reference/reference-guide/2.5.7/index.html" ---- - -This guide acts as a quick reference for BART subcommands and provides comprehensive examples of the following BART operations: - -- Performing a full backup of database servers -- Performing a point-in-time recovery (PITR) on a remote PostgreSQL database server -- Restoring an incremental backup -- Restoring a database cluster with tablespaces -- Evaluating, marking, and deleting backups and incremental backups -- Configuring and operating local and remote database servers - -For detailed information about BART subcommands and operations, see the EDB Backup and Recovery User Guide available at the [EDB website](/bart/latest/bart_user/). - -The document is organized as follows: - -- See [Subcommands](01_bart_subcommands_examples/#using_bart_subcommands) to view BART subcommand examples. -- See [Examples](02_additional_examples/#examples) to view BART operations examples. -- See [Sample BART System](03_sample_bart_system_with_local_and_remote_database_servers/#a_sample_bart_system_with_local_and_remote_database_servers) to view examples of both local and remote database server configuration and operation. - -
- -bart_subcommands_examples additional_examples sample_bart_system_with_local_and_remote_database_servers conclusion - -
diff --git a/product_docs/docs/bart/2.5/bart_user/01_introduction.mdx b/product_docs/docs/bart/2.5/bart_user/01_introduction.mdx deleted file mode 100644 index f84d3920eb2..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/01_introduction.mdx +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: "Introduction" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/introduction.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/introduction.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/introduction.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/introduction.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/introduction.html" ---- - -The EDB Backup and Recovery Tool (BART) is an administrative utility that provides simplified backup and recovery management for multiple local or remote EDB Advanced Server and PostgreSQL database servers. - -BART provides the following features: - -- Support for complete, hot, physical backups of multiple Advanced Servers and PostgreSQL database servers -- Support for two types of backups – full base backups and block-level incremental backups -- Backup and recovery management of database servers on local or remote hosts -- A single, centralized catalog for backup data -- Retention policy support for defining and managing how long backups should be kept -- The capability to store the backup data in compressed format -- Verified backup data with checksums -- Backup information displayed in an easy-to-read format -- A simplified point-in-time recovery process - -This guide provides the following information about using BART: - -- an [overview](02_overview/#overview) of the BART components and concepts. -- [backup and recovery management process](03_using_bart/#using_bart). -- [using tablespaces](04_using_tablespaces/#using_tablespaces). - -For information about installing BART, see the *EDB Backup and Recovery Installation and Upgrade Guide*; for examples of BART operations and subcommand usage, see the *EDB Backup and Recovery Reference Guide*. These guides are available at the [EDB website](/bart/latest/bart_inst/). - - - -## Conventions Used in this Guide - -The following is a list of conventions used throughout this document. - -- Much of the information in this document applies interchangeably to the PostgreSQL and EDB Advanced Server database systems. The term *Advanced Server* is used to refer to EDB Advanced Server. The term *Postgres* is used to generically refer to both PostgreSQL and Advanced Server. When a distinction needs to be made between these two database systems, the specific names, PostgreSQL or Advanced Server are used. - -- The installation directory of the PostgreSQL or Advanced Server products is referred to as `POSTGRES_INSTALL_HOME`: - - - For PostgreSQL Linux installations, this defaults to `/opt/PostgreSQL/` for version 10 and earlier. For later versions, the installation directory is `/var/lib/pgsql/`. - - For Advanced Server Linux installations performed using the interactive installer for version 10 and earlier, this defaults to `/opt/PostgresPlus/AS` or `/opt/edb/as`. For Advanced Server Linux installations performed with an RPM package, this defaults to `/usr/ppas-` or `/usr/edb/as`. For Advanced Server Linux installations performed with an RPM package for version 11 or later, this defaults to `/usr/edb/as`. - -## Restrictions on pg_basebackup - -BART takes full backups using the `pg_basebackup` utility program under the following conditions: - -- The backup is taken on a standby server. -- The `--with-pg_basebackup` option is specified with the `BACKUP` subcommand (see [Backup](03_using_bart/03_basic_bart_subcommand_usage/03_backup/#backup)). -- The number of thread count in effect is 1, and the `with-pg_basebackup` option is not specified with the `BACKUP` subcommand. -- Database servers can only be backed up using `pg_basebackup` utility program of the same or later version than the database server version. - -In the global section of the BART configuration file, the `pg_basebackup_path` parameter specifies the complete directory path to the `pg_basebackup` program. For information about the `pg_basebackup_path` parameter and the `thread_count`, see the *EDB Backup and Recovery Installation and Upgrade Guide* available at the [EDB website](/bart/latest/bart_inst/). - -For information about `pg_basebackup`, see the [PostgreSQL Core Documentation](https://postgresql.org/docs/current/static/app-pgbasebackup.html). diff --git a/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/01_incremental_backup_limitations_and_requirements.mdx b/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/01_incremental_backup_limitations_and_requirements.mdx deleted file mode 100644 index 678f6651fb0..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/01_incremental_backup_limitations_and_requirements.mdx +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: "Incremental Backup Limitations and Requirements" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/incremental_backup_limitations_and_requirements.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/incremental_backup_limitations_and_requirements.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/incremental_backup_limitations_and_requirements.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/incremental_backup_limitations_and_requirements.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/incremental_backup_limitations_and_requirements.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/incremental_backup_limitations_and_requirements.html" ---- - - - -The following limitations apply to incremental backup: - -- If you have restored a full or incremental backup, you must take a full backup before enabling incremental backup. -- If a standby node has been promoted to the role of a primary node, you must take a full backup before enabling incremental backup on the cluster. -- On a standby database server, you cannot take an incremental backup. - -You must meet the following requirements before implementing incremental backup: - -- You must create or select an operating system account to be used as the BART user account. - -- You must create or select the replication database user, which must be a superuser. - -- In the BART configuration file: - - - You must set the `cluster_owner` parameter to the Linux operating system user account that owns the database cluster directory from which incremental backups are to be taken. - - You must enable the `allow_incremental_backups` parameter. - -- A passwordless SSH/SCP connection must be established between the BART user account on the BART host and the `cluster_owner` user account on the database server. - - It must be noted that a passwordless SSH/SCP connection must be established even if BART and the database server are running on the same host and the BART user account and the `cluster_owner` user account are the same account. - -- In addition to the BART host (where the BART backup catalog resides), the BART package must also be installed on every remote database server on which incremental backups are to be restored. To restore an incremental backup, the `bart` program must be executable on the remote host by the remote user (the remote user is specified by the `remote_host` parameter in the BART configuration file or by the `-r` option when using the `RESTORE` subcommand to restore the incremental backup). - -- When [restoring incremental backups on a remote database server](05_restoring_an_incremental_backup/#restoring-an-incremental-backup-on-a-remote-host), a passwordless SSH/SCP connection must be established from the BART user account on the BART host to the remote user on the remote host (the remote user is specified by the `remote_host` parameter in the BART configuration file or by the `-r` option when using the `RESTORE` subcommand to restore the incremental backup). - -- Compression of archived WAL files in the BART backup catalog is not permitted for database servers on which incremental backups are to be taken. The `wal_compression` setting in the BART configuration file must be disabled for those database servers. - -- The incremental backup must be on the same timeline as the parent backup. The timeline changes after each recovery operation so an incremental backup cannot use a parent backup from an earlier timeline. - -For information about configuring these requirements, see the EDB Backup and Recovery Installation and Upgrade Guide available at the [EDB website](/bart/latest/bart_inst/). - -The following section provides an overview of the basic incremental backup concepts. diff --git a/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/02_concept_overview.mdx b/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/02_concept_overview.mdx deleted file mode 100644 index 6b3ad593da9..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/02_concept_overview.mdx +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: "Concept Overview" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/concept_overview.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/concept_overview.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/concept_overview.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/concept_overview.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/concept_overview.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/concept_overview.html" ---- - - - -Using incremental backups involves the following sequence of steps: - -1. Configure BART, and enable and initiate archiving of WAL files to the `archive_path` in the same manner as done for full backups. - - The default `archive_path` is the BART backup catalog (`//archived_wals`). Using the `` parameter in the server section of the BART configuration file, you can specify the location where WAL files will be archived. - - For more information about the `archive_path` parameter and configuring BART, see the EDB Backup and Recovery Installation and Upgrade Guide available at the [EDB website](/bart/latest/bart_inst/). - -2. Take an initial full backup with the `BACKUP` subcommand. This full backup establishes the parent of the first incremental backup. - -3. Scan all WAL files produced by database servers on which incremental backups are to be taken. These WAL files are scanned once they have been archived to the `archive_path`. - - Each scanned WAL file results in a modified block map (MBM) file that records the location of modified blocks obtained from the corresponding WAL file. The BART WAL scanner program `bart-scanner` performs this process. - -4. Take incremental backups using the `BACKUP` subcommand with the `--parent` option to specify the backup identifier or name of a previous, full backup or an incremental backup. Any previous backup may be chosen as the parent as long as all backups belong to the same timeline. - -5. The incremental backup process identifies which WAL files may contain changes from when the parent backup was taken to the starting point of the incremental backup. The corresponding MBM files are used to locate and copy the modified blocks to the incremental backup directory along with other database cluster directories and files. Instead of backing up all, full relation files, only the modified blocks are copied and saved. In addition, the relevant MBM files are condensed into one consolidated block map (CBM) file that is stored with the incremental backup. - - Multiple block copier threads can be used to copy the modified blocks to the incremental backup directory. See the *EDB Backup and Recovery Installation and Upgrade Guide* available at the [EDB website](/bart/latest/bart_inst/) for information about setting the `thread_count` parameter in the BART configuration file. See [Backup](../../03_using_bart/03_basic_bart_subcommand_usage/03_backup/#backup) for information about using the `--thread-count` option with the `BACKUP` subcommand. - -6. Invoke the restore process for an incremental backup using the `RESTORE` subcommand in the same manner as restoring a full backup. The `-i` option specifies the backup identifier or name of the incremental backup to restore. The restore process begins by going back through the chain of past, parent incremental backups until the initial full backup starting the chain is identified. This full backup provides the initial set of directories and files to be restored to the location specified with the `-p` option. Each subsequent incremental backup in the chain is then restored. Restoration of an incremental backup uses its CBM file to restore the modified blocks from the incremental backup. - -The following sections provide some additional information on these procedures. diff --git a/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/03_wal_scanning_preparation_for_an_incremental_backup.mdx b/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/03_wal_scanning_preparation_for_an_incremental_backup.mdx deleted file mode 100644 index cbadd8e1de6..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/03_wal_scanning_preparation_for_an_incremental_backup.mdx +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: "WAL Scanning – Preparation for an Incremental Backup" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/wal_scanning_preparation_for_an_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/wal_scanning_preparation_for_an_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/wal_scanning_preparation_for_an_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/wal_scanning_preparation_for_an_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/wal_scanning_preparation_for_an_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/wal_scanning_preparation_for_an_incremental_backup.html" ---- - - - -The WAL scanner program (`bart-scanner`) scans the WAL files created from the time of the parent backup up to the start of the incremental backup to determine which blocks have modified since the parent backup, and records the information in a file called the *modified block map (MBM) file*. One MBM file is created for each WAL file. - -The MBM file is stored in the directory where archived_wals will be stored, as specified in the `archive_path` parameter in the `bart.cfg` file. If the `archive_path` is not specified, the default `archived_wals` directory is: - -`//` - -Where: - -`` is the BART backup catalog parent directory specified in the global section of the BART configuration file. - -`` is the lowercase conversion of the database server name specified in the server section of the BART configuration file. - -The following code snippet is the content of the archive path showing the MBM files created for the WAL files. (The user name and group name of the files have been removed from the example to list the WAL files and MBM files in a more comparable manner): - -```text -[root@localhost archived_wals]# pwd -/opt/backup/acctg/archived_wals -[root@localhost archived_wals]# ls -l -total 131104 --rw------- 1 ... ... 16777216 Oct 12 09:38 000000010000000100000078 --rw------- 1 ... ... 16777216 Oct 12 09:38 000000010000000100000079 --rw------- 1 ... ... 16777216 Oct 12 09:38 00000001000000010000007A --rw------- 1 ... ... 16777216 Oct 12 09:35 00000001000000010000007B --rw------- 1 ... ... 16777216 Oct 12 09:38 00000001000000010000007C --rw------- 1 ... ... 16777216 Oct 12 09:39 00000001000000010000007D --rw------- 1 ... ... 16777216 Oct 12 09:42 00000001000000010000007E --rw------- 1 ... ... 16777216 Oct 12 09:47 00000001000000010000007F --rw-rw-r-- 1 ... ... 161 Oct 12 09:49 0000000100000001780000280000000179000000.mbm --rw-rw-r-- 1 ... ... 684 Oct 12 09:49 000000010000000179000028000000017A000000.mbm --rw-rw-r-- 1 ... ... 161 Oct 12 09:49 00000001000000017A000028000000017B000000.mbm --rw-rw-r-- 1 ... ... 161 Oct 12 09:49 00000001000000017B000028000000017C000000.mbm --rw-rw-r-- 1 ... ...1524 Oct 12 09:49 00000001000000017C000028000000017D000000.mbm --rw-rw-r-- 1 ... ... 161 Oct 12 09:49 00000001000000017D000028000000017E000000.mbm --rw-rw-r-- 1 ... ... 161 Oct 12 09:49 00000001000000017E000028000000017F000000.mbm --rw-rw-r-- 1 ... ... 161 Oct 12 09:49 00000001000000017F0000280000000180000000.mbm -``` - -MBM files have the suffix, `.mbm`. - -In preparation for any incremental backup, the WAL files should be scanned as soon as they are copied to the `archive_path`. Thus, the WAL scanner should be running as soon as the WAL files from the database cluster are archived to the `archive_path`. If the `archive_path` contains WAL files that have not yet been scanned, starting the WAL scanner begins scanning these files. If WAL file fails to be scanned (resulting in a missing MBM file), you can use the WAL scanner to specify an individual WAL file. - -Under certain conditions such as when the Network File System (NFS) is used to copy WAL files to the `archive_path`, the WAL files may have been missed by the WAL scanner program for scanning and creation of MBM files. Use the `scan_interval` parameter in the BART configuration file to initiate force scanning of WAL files in the `archive_path` to ensure MBM files are generated. See the *EDB Backup and Recovery Installation and Upgrade Guide* available at the [EDB website](/bart/latest/bart_inst/) for more information about the `scan_interval` parameter. - -See [Running the BART WAL Scanner](../../03_using_bart/04_running_the_bart_wal_scanner/#running_the_bart_wal_scanner) for information about using the WAL scanner. diff --git a/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/04_performing_an_incremental_backup.mdx b/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/04_performing_an_incremental_backup.mdx deleted file mode 100644 index db889388658..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/04_performing_an_incremental_backup.mdx +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: "Performing an Incremental Backup" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/performing_an_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/performing_an_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/performing_an_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/performing_an_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/performing_an_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/performing_an_incremental_backup.html" ---- - - - -The WAL files produced at the time of the parent backup up to the start of the incremental backup contain information about which blocks were modified during that time interval. That information is consolidated into an MBM file for each WAL file by the WAL scanner. - -The MBM files for the relevant WAL files are read, and the information is used to copy the modified blocks from the database cluster to the `archived_wals` directory as specified in the `archive_path` parameter in the `bart.cfg` file. When compared to a full backup, the number and sizes of relation files can be significantly less for an incremental backup. - -For comparison, the following is an abbreviated list of the files copied to the archived `base` subdirectory of a full backup for one database: - -```text -[root@localhost 14845]# pwd -/opt/backup/acctg/1476301238969/base/base/14845 -[root@localhost 14845]# ls -112 13182_vm 14740 16467 16615 2608_vm 2655 2699 2995 ... -113 13184 14742 16471 174 2609 2656 2701 2995_vm ... -1247 13186 14745 16473 175 2609_fsm 2657 2702 2996 ... -1247_fsm 13187 14747 16474 2187 2609_vm 2658 2703 2998 ... -1247_vm 13187_fsm 14748 16476 2328 2610 2659 2704 2998_vm ... -1249 13187_vm 14749 16477 2328_fsm 2610_fsm 2660 2753 2999 ... -1249_fsm 13189 14752 16479 2328_vm 2610_vm 2661 2753_fsm 2999_vm ... -1249_vm 13191 14754 16488 2336 2611 2662 2753_vm 3079 ... -1255 13192 14755 16490 2336_vm 2611_vm 2663 2754 3079_fsm ... - . - . - . -13182_fsm 14739 16465 16603 2608_fsm 2654 2696 2893_vm 3501_vm ... -``` - -In contrast, the following is the content of the archived `base` subdirectory of the same database from a subsequent incremental backup: - -```text -[root@localhost 14845]# pwd -/opt/backup/acctg/1476301835391/base/base/14845 -[root@localhost 14845]# ls -1247 1249 1259 16384 17006 2608 2610 2658 2663 2678 ... -1247_fsm 1249_fsm 1259_fsm 16387 17009 2608_fsm 2610_fsm 2659 2673 2679 ... -1247_vm 1249_vm 1259_vm 16389 17011 2608_vm 2610_vm 2662 2674 2703 ... -``` - -The information from the MBM files are consolidated into one file called a *consolidated block map* (CBM) file. During the restore operation for the incremental backup, the CBM file is used to identify the modified blocks to be restored for that backup. In addition, the incremental backup also stores other required subdirectories and files from the database cluster as is done for full backups. - -Before taking an incremental backup, an initial full backup must be taken with the `BACKUP` subcommand. This full backup establishes the parent of the first incremental backup. - -The syntax for taking a full backup is: - -```text -bart BACKUP –s { | all } [ -F { p | t } ] - [ -z ] [ –c ] - [ --backup-name ] - [ --thread-count ] - [ { --with-pg_basebackup | --no-pg_basebackup } ] -``` - -The syntax for taking an incremental backup is: - -```text -bart BACKUP –s { | all } [ -F p] - [ --parent { | } ] - [ --backup-name ] - [ --thread-count ] - [ --check ] -``` - -You must specify the following before taking an incremental backup: - -- `-Fp` option for plain text format as incremental backup can only be taken in the plain text format. -- `--check` option to verify if the required MBM files are present in the `archived_wals` directory. The `--parent` option must be specified when the `--check` option is used. - -See [BACKUP](../../03_using_bart/03_basic_bart_subcommand_usage/03_backup/#backup) for more information about using the `BACKUP` subcommand. diff --git a/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/05_restoring_an_incremental_backup.mdx b/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/05_restoring_an_incremental_backup.mdx deleted file mode 100644 index 853841c077b..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/05_restoring_an_incremental_backup.mdx +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: "Restoring an Incremental Backup" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/restoring_an_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/restoring_an_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/restoring_an_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/restoring_an_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/restoring_an_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/restoring_an_incremental_backup.html" ---- - - - -Restoring an incremental backup may require additional steps depending upon the host on which the incremental backup is to be restored: - -- [Restoring an Incremental Backup on a BART Host](#restoring-an-incremental-backup-on-a-bart-host) - This section outlines restoring an incremental backup onto the same host where BART has been installed. -- [Restoring an Incremental Backup on a Remote Host](#restoring-an-incremental-backup-on-a-remote-host) - This section outlines restoring an incremental backup onto a remote host where BART has not been installed. - - - -## Restoring an Incremental Backup on a BART Host - -Specify a backup identifier or name, and include the `-i` option when invoking the `RESTORE` subcommand to restore an incremental backup. All `RESTORE` options may be used in the same manner as when restoring a full backup. See [RESTORE](../../03_using_bart/03_basic_bart_subcommand_usage/08_restore/#restore) command for more details. - -First, all files from the full backup from the beginning of the backup chain are restored. For each incremental backup, the CBM file is used to identify and restore blocks from the incremental backup. If there are new relations or databases identified in the CBM file, then relevant relation files are copied. If consolidated block map information is found indicating the drop of a relation or a database, then the relevant files are removed from the restore directory. Similarly, if there is any indication of a table truncation, then the related files are truncated. - -Also note that you can use the `-w` option of the `RESTORE` subcommand to specify a multiple number of parallel worker processes to stream the modified blocks to the restore host. - - - -## Restoring an Incremental Backup on a Remote Host - -Ensure the `bart` program is available on the remote host when restoring an incremental backup on a remote host; the invocation of the `RESTORE` subcommand for an incremental backup results in the execution of the `bart` program on the remote host to restore the modified blocks to their proper location. - -To restore an incremental backup onto a remote host where BART has not been installed, perform the following steps: - -**Step 1:** Install `BART` on the remote host to which an incremental backup is to be restored. - -No editing is needed in the `bart.cfg` file installed on the remote host. - -**Step 2:** Determine the Linux operating system user account on the remote host to be used as the remote user. This user is specified by the `remote_host` parameter in the BART configuration file or by the `-r` option when using the `RESTORE` subcommand to restore the incremental backup. The remote user must be the owner of the directory where the incremental backup is to be restored on the remote host. By default, the user account is `enterprisedb` for Advanced Server or `postgres` for PostgreSQL. - -**Step 3:** Ensure a passwordless SSH/SCP connection is established from the BART user on the BART host to the remote user on the remote host. For information about creating a passwordless SSH/SCP connection, see the *EDB Backup and Recovery Installation and Upgrade Guide*, available at the [EDB website](/bart/latest/bart_inst/). - -When restoring an incremental backup, specify the backup identifier or name of the incremental backup that will be restored. See the [RESTORE](../../03_using_bart/03_basic_bart_subcommand_usage/08_restore/#restore) documentation for more details. To view an example of restoring an incremental backup, see the *EDB Backup and Recovery Reference Guide* available at the [EDB website](/bart/latest/bart_ref/). diff --git a/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/index.mdx b/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/index.mdx deleted file mode 100644 index b8d9a7325f2..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/02_overview/01_block-level_incremental_backup/index.mdx +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: "Block-Level Incremental Backup" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/block-level_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/block-level_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/block-level_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/block-level_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/block-level_incremental_backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/block-level_incremental_backup.html" ---- - - - -This section describes the basic concepts of a block-level incremental backup (referred to as an incremental backup). An incremental backup is a unique functionality of BART. - -An incremental backup provides a number of advantages when compared to using a full backup: - -- The amount of time required to produce an incremental backup is generally less than a full backup, as modified relation blocks are saved instead of all full relation files of the database cluster. -- An incremental backup uses less disk space than a full backup. - -Generally, all BART features (such as retention policy management) apply to incremental backups and full backups. See [Managing Incremental Backups](../../03_using_bart/02_managing_backups_using_a_retention_policy/05_managing_incremental_backups/#managing_incremental_backups) for more information. - -
- -incremental_backup_limitations_and_requirements concept_overview wal_scanning_preparation_for_an_incremental_backup performing_an_incremental_backup restoring_an_incremental_backup - -
diff --git a/product_docs/docs/bart/2.5/bart_user/02_overview/02_creating_a_backup_chain.mdx b/product_docs/docs/bart/2.5/bart_user/02_overview/02_creating_a_backup_chain.mdx deleted file mode 100644 index 0e5f2d76f15..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/02_overview/02_creating_a_backup_chain.mdx +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: "Creating a Backup Chain" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/creating_a_backup_chain.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/creating_a_backup_chain.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/creating_a_backup_chain.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/creating_a_backup_chain.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/creating_a_backup_chain.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/creating_a_backup_chain.html" ---- - - - -A *backup chain* is the set of backups consisting of a full backup and all of its successive incremental backups. Tracing back on the parent backups of all incremental backups in the chain eventually leads back to that single, full backup. - -It is possible to have a *multi-forked* backup chain, which is two or more successive lines of incremental backups, all of which begin with the same, full backup. Thus, within the chain there is a backup that serves as the parent of more than one incremental backup. - -Since restoration of an incremental backup is dependent upon first restoring the full backup, then all successive incremental backups up to, and including the incremental backup specified by the `RESTORE` subcommand, it is crucial to note the following: - -- Deletion or corruption of the full backup destroys the entire backup chain. It is not possible to restore any of the incremental backups that were part of that chain. -- Deletion or corruption of an incremental backup within the chain results in the inability to restore any incremental backup that was added to that successive line of backups following the deleted or corrupted backup. The full backup and incremental backups prior to the deleted or corrupted backup can still be restored. - -The actions of retention policy management are applied to the full backup and all of its successive incremental backups within the chain in an identical manner as if they were one backup. Thus, use of retention policy management does not result in the breakup of a backup chain. - -See the *EDB Backup and Recovery Reference Guide*, available at the [EDB website](/bart/latest/bart_ref/) for examples of creating a backup chain and restoring an incremental backup. diff --git a/product_docs/docs/bart/2.5/bart_user/02_overview/index.mdx b/product_docs/docs/bart/2.5/bart_user/02_overview/index.mdx deleted file mode 100644 index 25152551d94..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/02_overview/index.mdx +++ /dev/null @@ -1,102 +0,0 @@ ---- -title: "Overview" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/overview.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/overview.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/overview.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/overview.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/overview.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/overview.html" ---- - - - -BART provides a simplified interface for the continuous archiving and point-in-time recovery method provided with Postgres database servers. This consists of the following processes: - -- Capturing a complete image of a database cluster as a full base backup or referred to simply as a *full backup*. -- Capturing a modified image of a database cluster called a *block-level incremental backup* or referred as *incremental backup*, which is similar to a full backup, but contains the modified blocks of the relation files that have been changed since a previous backup. -- Archiving the `Write-Ahead Log segments` (WAL files), which continuously record changes to be made to the database files. -- Performing *Point-In-Time Recovery* (PITR) to a specified transaction ID or timestamp with respect to a timeline using a full backup along with successive, [block-level incremental backups](01_block-level_incremental_backup/#block-level_incremental_backup) that reside in the same backup chain, and the WAL files. - -Detailed information regarding WAL files and point-in-time recovery is documented in the [PostgreSQL Core Documentation](https://www.postgresql.org/docs/current/static/continuous-archiving.html). - -The general term *backup* refers to both full backups and incremental backups. - -When taking a full backup of a standby server, BART uses the PostgreSQL `pg_basebackup` utility program. However, it must be noted that for standby servers, you can only take a full backup, but cannot take an incremental or parallel backups. For information about standby servers, see the [PostgreSQL Documentation](https://www.postgresql.org/docs/current/static/high-availability.html). - -BART uses a centralized backup catalog, a single configuration file, and a command line interface controlling the necessary operations to simplify the management process. Reasonable defaults are automatically used for various backup and restore options. BART also performs the necessary recovery file configuration required for point-in-time recovery using its command line interface. - -BART also provides the following features to enhance backup management: - -- Automation of the WAL archiving command configuration. -- Usage of retention policies to evaluate, categorize, and delete obsolete backups. -- Compression of WAL files to conserve disk space. -- Customizable naming of backups to ease their usage. -- Easy access to comprehensive information about each backup. - -The key components of a BART installation are: - -- **BART Host.** The host system on which BART is installed. BART operations are invoked from this host system. The database server backups and archived WAL files are stored on this host as well. -- **BART User Account.** Linux operating system user account you choose to run BART. The BART user account owns the BART backup catalog directory. -- **BART Configuration File.** File in editable text format containing the configuration information that BART uses. -- **BART Backup Catalog.** File system directory structure containing all of the backups for the database servers that BART manages. It is also the default `archive_path` to store archived WAL files. -- **BART Backupinfo File.** File in text format containing information for a BART backup. A `backupinfo` file resides in each backup subdirectory within the BART backup catalog. -- **BART Command Line Utility Program.** Single, executable file named `bart`, which is used to manage all BART operations. -- **BART WAL Scanner Program.** Single, executable file named `bart-scanner`, which is used to scan WAL files to locate and record the modified blocks for incremental backups. - -Other concepts and terms referred to in this document include the following: - -- **Postgres Database Cluster.** Also commonly called the *data directory*, this is the file system directory where all of the data files related to a particular Postgres database server instance are stored. (Each specific running instance is identified by its host and port number when connecting to a database.) The database cluster is identified by the `–D` option when it is created, started, stopped, etc. by the `Postgres initdb` and `pg_ctl` commands. A full backup is a copy of a database cluster. - - The terms database cluster and database server are used somewhat interchangeably throughout this document, though a single database server can run multiple database clusters. - -- **Postgres User Account.** Linux operating system user account that runs the Advanced Server or PostgreSQL database server and owns the database cluster directory. - - - By default, the database user account is `enterprisedb` when Advanced Server is installed to support compatibility with Oracle databases. - - - By default, the database user account is `postgres` when Advanced Server is installed in PostgreSQL compatible mode. For a PostgreSQL database server, the default database user account is also `postgres`. - - The BART configuration parameter `cluster_owner` must be set to the database user account for each database server. - -- **Replication Database User.** For each database server that BART manages, a database superuser must be selected to act as the replication database user. This database user is used to connect to the database server when backups are taken. The database superusers created with an initial Postgres database server installation (`enterprisedb` or `postgres`) may be used for this purpose. The BART configuration parameter `user` must be set to this replication database user for each database server. - -- **Secure Shell (SSH)/Secure Copy (SCP).** Linux utility programs used to log into hosts (SSH) and copy files (SCP) between hosts. A valid user account must be specified that exists on the target host and in fact is the user account under which the SSH or SCP operations occur. - -For information on how all of these components are configured and used with BART, see the EDB Backup and Recovery Installation and Upgrade Guide available at the [EDB website](/bart/latest/bart_inst/). - -**Supported BART Operations** - -The following tables are not a conclusive list of the scenarios supported by BART, but instead provides an overview of some of the most common scenarios in both `pg_basebackup` (thread count=1) as well as parallel backup mode (thread count greater than 1). - -| | -Fp-xlog-method=fetch | -Fp-xlog-method=stream | -Ft-xlog-method=fetch | -Ft-xlog-method=stream | -| -------------------------------------------- | --------------------- | ---------------------- | --------------------- | ---------------------- | -| `Primary Database Server/Full backup` | Supported | Supported | Supported | Supported | -| `Primary Database Server/Incremental backup` | Supported | Supported | Not Supported | Not Supported | -| `Standby Database Server/Full backup` | Supported | Supported | Supported | Supported | -| `Standby Database Server/Incremental backup` | Not Supported | Not Supported | Not Supported | Not Supported | - -Backup - -| | Wal compression by BART | WAL scanner | -| -------------------------------------------- | ----------------------- | ----------- | -| `Primary Database Server/Full backup` | Supported | N/A | -| `Primary Database Server/Incremental backup` | Not Supported | N/A | -| `Standby Database Server/Full backup` | Supported | N/A | -| `Standby Database Server/Incremental backup` | Not Supported | N/A | - -Wal Archiving - -| | Wal compression = enabled | Wal compression = disabled | -| ------------------ | ------------------------- | -------------------------- | -| `Restore` | Supported | Supported | -| `Parallel restore` | Supported | Supported | - -Restore - -
- -block-level_incremental_backup creating_a_backup_chain - -
diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/01_bart_management_overview/01_performing_a_restore_operation.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/01_bart_management_overview/01_performing_a_restore_operation.mdx deleted file mode 100644 index 612b9060af8..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/01_bart_management_overview/01_performing_a_restore_operation.mdx +++ /dev/null @@ -1,62 +0,0 @@ ---- -title: "Performing a Restore Operation" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/performing_a_restore_operation.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/performing_a_restore_operation.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/performing_a_restore_operation.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/performing_a_restore_operation.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/performing_a_restore_operation.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/performing_a_restore_operation.html" ---- - - - -The following steps describe the process of restoring a backup: - -**Step 1:** Use your system-specific command to shut down the database server. - -**Step 2:** Inspect the `pg_wal` subdirectory (inspect the `pg_xlog` subdirectory if you are using server version 9.6) of the data directory and save any WAL files that have not yet been archived to the `archive_path`. If there are files that have not been archived, save them to a temporary location. - -**Step 3:** If you want to restore to current data directory, it is recommended to make a copy of the current data directory and then delete all files and subdirectories under the data directory if you have enough extra space. If there is not enough space, then make a copy of `pg_wal` directory (or `pg_xlog` if you are using server version 9.6) until the server is successfully restored. - -If you want to restore to a new, empty directory, create the directory on which you want to restore the backed up database cluster. Ensure the data directory can be written to by the BART user account or by the user account specified by the `remote_host` configuration parameter, or by the `--remote-host` option of the `RESTORE` subcommand (if these are to be used). - -**Step 4:** Perform the same process for tablespaces as described in Step 3. The `tablespace_path` parameter in the BART configuration file must contain the tablespace directory paths to which the tablespace data files are to be restored. See the *EDB Backup and Recovery Installation and Upgrade Guide* available at the [EDB website](/bart/latest/bart_inst/) for more information about this parameter. - -**Step 5:** Identify the backup to use for the restore operation and obtain the backup ID or backup name. - -To use the latest backup, omit the `-i` option; the `RESTORE` subcommand uses that backup by default. The backups can be listed with the `SHOW-BACKUPS` subcommand. - -**Step 6:** Run the BART `RESTORE` subcommand. - -- Minimal recovery settings will be saved in the `postgresql.auto.conf` file and archive recovery will proceed only until consistency is reached, with no restoration of files from the archive. See [Restore](../03_basic_bart_subcommand_usage/08_restore/#restore) for detailed information about `Restore` subcommand. - -- If the `-c` option is specified or if the `copy_wals_during_restore` BART configuration parameter is enabled for this database server, then the following actions occur: - - - In addition to restoring the database cluster to the directory specified by the `-p restore_path` option, the archived WAL files of the backup are copied from the BART backup catalog to the subdirectory `restore_path/archived_wals`. - - If recovery settings are saved in the `postgresql.auto.conf` file, the command string set in the `restore_command` parameter retrieves the WAL files from this `archived_wals` subdirectory relative to the `restore_path` parent directory as: `restore_command = cp archived_wals/%f %p` - -You must ensure that valid options are specified when using the `RESTORE` subcommand. BART will not generate an error message if invalid option values or invalid option combinations are provided. BART will accept the invalid options and pass them to the `postgresql.auto.conf` file, which will then be processed by the database server when it is restarted. - -**Step 7:** Copy any saved WAL files from Step 2 to the `restore_path/pg_xlog` subdirectory. - -**Step 8:** Inspect the restored directories and data files of the restored database cluster in directory `restore_path`. - -All files and directories must be owned by the user account that you intend to use to start the database server. Recursively change the user and group ownership of the `restore_path` directory, its files, and its subdirectories if necessary. There must only be directory access privileges for the user account that will start the database server. No other groups or users can have access to the directory. - -**Step 9:** The `postgresql.auto.conf` file should be configured to recover only until the cluster reaches consistency. In either case, the settings may be modified as desired. - -**Step 10:** Disable WAL archiving at this point. The BART `RESTORE` subcommand adds `archive_mode = off` to the end of the `postgresql.conf` file. - -- If you want to restart the database server with WAL archiving enabled, ensure that this additional parameter is deleted. -- The original `archive_mode` parameter still resides in the `postgresql.conf` file in its initial location with its last setting. - -**Step 11:** Start the database server to initiate recovery. After completion, check the database server log file to ensure the recovery was successful. - -If the backup is restored to a different location than where the original database cluster resided, operations dependent upon the database cluster location may fail if supporting service scripts are not updated to reflect the location where the backup has been restored. For information about the use and modification of service scripts, see the EDB Advanced Server Installation Guide available at the [EDB website](/epas/latest/). - -See [Restore](../03_basic_bart_subcommand_usage/08_restore/#restore) for more information about using the BART `Restore` subcommand. - -An example of a restore operation is documented in the EDB Backup and Recovery Reference Guide available at the [EDB website](/bart/latest/bart_ref/). diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/01_bart_management_overview/02_point_in_time_recovery_operation.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/01_bart_management_overview/02_point_in_time_recovery_operation.mdx deleted file mode 100644 index 1b95019441f..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/01_bart_management_overview/02_point_in_time_recovery_operation.mdx +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: "Point-In-Time Recovery Operation" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/point_in_time_recovery_operation.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/point_in_time_recovery_operation.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/point_in_time_recovery_operation.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/point_in_time_recovery_operation.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/point_in_time_recovery_operation.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/point_in_time_recovery_operation.html" ---- - - - -The following steps outline how to perform a point-in-time recovery operation for a database cluster: - -1. Use your system-specific command to shut down the database server. - -2. If you want to: - a. restore the database cluster and tablespace files to new, empty directories, create the new directories with the appropriate directory ownership and permissions. - b. reuse the existing database cluster directories, delete all the files and subdirectories in the existing directories. We strongly recommend that you make a copy of this data before deleting it. Be sure to save any recent WAL files in the `pg_wal` subdirectory ( `pg_xlog` subdirectory if you are using server version 9.6) that have not been archived to `archive_path`. - -3. Run the BART `SHOW-BACKUPS -s ` subcommand to list the backup IDs and backup names of the backups for the database server. You will need to provide the appropriate backup ID or backup name with the BART `RESTORE` subcommand, unless you intend to restore the latest backup in which case the `-i` option of the `RESTORE` subcommand for specifying the backup ID or backup name may be omitted. - -4. Run the BART `RESTORE` subcommand with the appropriate options. - - - The backup is restored to the directory specified by the `-p restore_path` option. - - - In addition, if the `RESTORE` subcommand `-c` option is specified or if the enabled setting of the `copy_wals_during_restore` BART configuration parameter is applicable to the database server, then the required archived WAL files from the `archive_path` are copied to the `restore_path/archived_wals` subdirectory. - - - Ensure the `restore_path` directory and all subdirectories and files in the `restore_path` are owned by the proper Postgres user account (for example, `enterprisedb` or `postgres`). Also ensure that only the Postgres user account has access permission to the `restore_path` directory. - - Use the `chown` command to make the appropriate adjustments to file permissions; for example, the following command changes the ownership of `restore_path` to `enterprisedb`: - - `chown -R enterprisedb:enterprisedb restore_path` - - The following command restricts access to `restore_path`: - - `chmod 700 restore_path` - -5. Copy any saved WAL files from Step 2 that were not archived to the BART backup catalog to the `restore_path/pg_wal` subdirectory (`pg_xlog` subdirectory if you are using server version 9.6). - -6. Identify the timeline ID you wish to use to perform the restore operation. - - The available timeline IDs can be identified by the first non-zero digit of the WAL file names reading from left to right. - -7. Verify that the `postgresql.auto.conf` file created in the directory specified with the `RESTORE` subcommand’s `-p ` option was generated with the correct recovery parameter settings. - - If the `RESTORE` subcommand `-c` option is specified or if the enabled setting of the `copy_wals_during_restore` BART configuration parameter is applicable to the database server, then the `restore_command` parameter retrieves the archived WAL files from the `/archived_wals` subdirectory that was created by the `RESTORE` subcommand, otherwise the `restore_command` retrieves the archived WAL files from the BART backup catalog. - -8. The BART `RESTORE` subcommand disables WAL archiving in the restored database cluster. If you want to immediately enable WAL archiving, modify the `postgresql.conf` file by deleting the `archive_mode = off` parameter that BART appends to the end of the file. - -9. Start the database server, which will then perform the point-in-time recovery operation if recovery settings are saved in the `postgresql.auto.conf` file. - -For a detailed description of the `RESTORE` subcommand, see [Basic BART Subcommand Usage](../03_basic_bart_subcommand_usage/#basic_bart_subcommand_usage). An example of a Point-in-Time Recovery operation is documented in the *EDB Backup and Recovery Reference Guide* available at the [EDB website](/bart/latest/bart_ref/). See [Restore](../03_basic_bart_subcommand_usage/08_restore/#restore) for more information about using the `Restore` subcommand. diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/01_bart_management_overview/index.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/01_bart_management_overview/index.mdx deleted file mode 100644 index b1e5f9ab078..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/01_bart_management_overview/index.mdx +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: "BART Management Overview" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/bart_management_overview.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/bart_management_overview.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/bart_management_overview.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/bart_management_overview.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/bart_management_overview.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/bart_management_overview.html" ---- - - - -After configuring BART, you can begin the backup and recovery management process. The following steps will help you get started: - -1. Run the `CHECK-CONFIG` subcommand without the `-s` option. When the `CHECK-CONFIG` subcommand is used without specifying the `-s` option, it checks the parameters in the global section of the BART configuration file. -2. Run the `INIT` subcommand (if you have not already done so) to finish creation of the BART backup catalog, which results in the complete directory structure to which backups and WAL files are saved. This step must be done before restarting the database servers with enabled WAL archiving, otherwise the copy operation in the `archive_command` parameter of the `postgresql.conf` file or the `postgresql.auto.conf` file fails due to the absence of the target archive directory. When the directory structure is complete, the `archived_wals` subdirectory should exist for each database server. -3. Start the Postgres database servers with archiving enabled. Verify that the WAL files are appearing in the `archive_path`. The archiving frequency is dependent upon other `postgresql.conf` configuration parameters. Check the Postgres database server log files to ensure there are no archiving errors. Archiving should be operational before taking a backup in order to ensure that the WAL files that may be created during the backup process are archived. -4. Start the WAL scanner if you intend to take incremental backups. Since the WAL scanner processes the WAL files copied to the `archive path`, it is advantageous to commence the WAL scanning as soon as the WAL files begin to appear in the `archive_path` in order to keep the scanning in pace with the WAL archiving. -5. Run the BART `CHECK-CONFIG` subcommand for each database server with the `-s` option specifying the server name. This ensures the database server is properly configured for taking backups. -6. Create a full backup for each database server. The full backup establishes the starting point of when point-in-time recovery can begin and also establishes the initial parent backup for any incremental backups to be taken. - -There are now a number of other BART management processes you may perform: - -- Execute the `BACKUP` subcommand to create additional full backups or incremental backups. -- Use the `VERIFY-CHKSUM` subcommand to verify the checksum of the full backups. -- Display database server information with the `SHOW-SERVERS` subcommand. -- Display backup information with the `SHOW-BACKUPS` subcommand. -- Compress the archived WAL files in the `archive_path` by enabling WAL compression in the BART configuration file and then invoking the `MANAGE` subcommand. -- Determine and set the retention policy for backups in the BART configuration file. -- Establish the procedure for using the `MANAGE` subcommand to enforce the retention policy for backups. This may include using `cron` jobs to schedule the `MANAGE` subcommand. - -
- -performing_a_restore_operation point_in_time_recovery_operation - -
diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/01_overview_managing_backups_using_a_retention_policy.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/01_overview_managing_backups_using_a_retention_policy.mdx deleted file mode 100644 index 793594cf506..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/01_overview_managing_backups_using_a_retention_policy.mdx +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: "Overview - Managing Backups Using a Retention Policy" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/overview_managing_backups_using_a_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/overview_managing_backups_using_a_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/overview_managing_backups_using_a_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/overview_managing_backups_using_a_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/overview_managing_backups_using_a_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/overview_managing_backups_using_a_retention_policy.html" ---- - - - -The BART retention policy results in the categorization of each backup in one of three statuses – *active*, *obsolete*, and *keep*. - -- **Active.** The backup satisfies the retention policy applicable to its server. Such backups would be considered necessary to ensure the recovery safety for the server and thus should be retained. -- **Obsolete.** The backup does not satisfy the retention policy applicable to its server. The backup is no longer considered necessary for the recovery safety of the server and thus can be deleted. -- **Keep.** The backup is to be retained regardless of the retention policy applicable to its server. The backup is considered vital to the recovery safety for the server and thus should not be deleted for an indefinite period of time. - -There are two types of retention policies - redundancy retention policy and recovery window retention policy. - -- **Redundancy Retention Policy** - The [redundancy retention policy](03_setting_the_retention_policy/#redundancy-retention-policy) relies on a specified, maximum number of most recent backups to retain for a given server. When the number of backups exceeds that maximum number, the oldest backups are considered obsolete (except for backups marked as keep). -- **Recovery Window Retention Policy** - The [recovery window retention policy](03_setting_the_retention_policy/#recovery-window-retention-policy) relies on a time frame (the recovery window) for when a backup should be considered active. The boundaries defining the recovery window are the current date/time (the ending boundary of the recovery window) and the date/time going back in the past for a specified length of time (the starting boundary of the recovery window). - - If the date/time the backup was taken is within the recovery window (that is, the backup date/time is on or after the starting date/time of the recovery window), then the backup is considered active, otherwise it is considered obsolete (except for backups marked as keep). - - Thus, for the recovery window retention policy, the recovery window time frame dynamically shifts, so the end of the recovery window is always the current date/time when the `MANAGE` subcommand is run. As you run the `MANAGE` subcommand at future points in time, the starting boundary of the recovery window moves forward in time. At some future point, the date/time of when a backup was taken will be earlier than the starting boundary of the recovery window. This is when an active backup’s status will be considered obsolete. - - You can see the starting boundary of the recovery window at any point in time by running the `SHOW-SERVERS` subcommand. The `RETENTION POLICY` field of the `SHOW-SERVERS` subcommand displays the starting boundary of the recovery window. diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/02_marking_the_backup_status.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/02_marking_the_backup_status.mdx deleted file mode 100644 index bb71f7e9268..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/02_marking_the_backup_status.mdx +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: "Marking the Backup Status" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/marking_the_backup_status.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/marking_the_backup_status.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/marking_the_backup_status.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/marking_the_backup_status.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/marking_the_backup_status.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/marking_the_backup_status.html" ---- - - - -When a backup is initially created with the `BACKUP` subcommand, it is always recorded with active status. Use the `MANAGE` subcommand to evaluate if the backup status should be changed to obsolete in accordance with the retention policy. You can review the current status of your backups with the `SHOW-BACKUPS` subcommand. - -Active backups are evaluated and also marked (that is, internally recorded by BART) as obsolete only when the `MANAGE` subcommand is invoked either with no options or with only the `-s` option. - -Once a backup has been marked as obsolete, you cannot change it back to active unless you perform the following steps: - -- Use the `MANAGE` subcommand with the `-c` option along with the backup identifier or name with the `-i` option. To keep this particular backup indefinitely, use `-c keep`, otherwise use `-c nokeep`. -- If you use the `-c nokeep` option, the backup status is changed back to active. When the `MANAGE` subcommand is used the next time, the backup is re-evaluated to determine if its status needs to be changed back to obsolete based on the current retention policy in the BART configuration file. - -After setting the `retention_policy` parameter and running the `MANAGE` subcommand if you change the `retention_policy` parameter, the current, marked status of the backups are probably inconsistent with the new `retention_policy` setting. To modify the backup status to be consistent with the new `retention_policy` setting, you need to run the `MANAGE` subcommand with: - -- the `-c nokeep` option to change the obsolete status to active status if there are backups currently marked as obsolete that would no longer be considered obsolete under a new retention policy. You can also specify the `-i all` option to change all backups back to active status, including those currently marked as keep. -- no options or with only the `-s` option to reset the marked status based on the new `retention_policy` setting in the BART configuration file. - -See [MANAGE](../03_basic_bart_subcommand_usage/07_manage/#manage) for usage information for the `MANAGE` subcommand. diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/03_setting_the_retention_policy.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/03_setting_the_retention_policy.mdx deleted file mode 100644 index 961c636df50..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/03_setting_the_retention_policy.mdx +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: "Setting the Retention Policy" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/setting_the_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/setting_the_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/setting_the_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/setting_the_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/setting_the_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/setting_the_retention_policy.html" ---- - - - -The retention policy is determined by the `retention_policy` parameter in the BART configuration file. It can be applied globally to all servers, but each server can override the global retention policy with its own. For information about creating a global retention policy and an individual database server retention policy, see the EDB Backup and Recovery Installation and Upgrade Guide available at the [EDB website](/bart/latest/bart_inst/). - -There are two types of retention policies - redundancy retention policy and the recovery window retention policy as described in the following sections. - - - -## Redundancy Retention Policy - -To use the redundancy retention policy, set `retention_policy = max_number BACKUPS` where `max_number` is a positive integer designating the maximum number of most recent backups. - -**Additional Restrictions:** - -- The keyword `BACKUPS` must always be specified in plural form (for example, `1 BACKUPS`). -- BART will accept a maximum integer value of 2,147,483,647 for `max_number`; however, you should use a realistic, practical value based on your system environment. - -The redundancy retention policy is the default type of retention policy if all keywords `BACKUPS`, `DAYS`, `WEEKS`, and `MONTHS` following the `max_number` integer are omitted as shown by the following example: - -`retention_policy = 3` - -In the following example, the redundancy retention policy setting considers the three most recent backups as the active backups. Any older backups, except those marked as `keep`, are considered obsolete: - -```text -[ACCTG] -host = 127.0.0.1 -port = 5444 -user = enterprisedb -archive_command = 'cp %p %a/%f' -retention_policy = 3 BACKUPS -description = "Accounting" -``` - -The `SHOW-SERVERS` subcommand displays the `3 Backups` redundancy retention policy in the `RETENTION POLICY` field: - -```bash --bash-4.1$ bart SHOW-SERVERS -s acctg -SERVER NAME : acctg -HOST NAME : 127.0.0.1 -USER NAME : enterprisedb -PORT : 5444 -REMOTE HOST : -RETENTION POLICY : 3 Backups -DISK UTILIZATION : 627.04 MB -NUMBER OF ARCHIVES : 25 -ARCHIVE PATH : /opt/backup/acctg/archived_wals -ARCHIVE COMMAND : cp %p /opt/backup/acctg/archived_wals/%f -XLOG METHOD : fetch -WAL COMPRESSION : disabled -TABLESPACE PATH(s) : -DESCRIPTION : "Accounting" -``` - - - -## Recovery Window Retention Policy - -To use the recovery window retention policy, set the `retention_policy` parameter to the desired length of time for the recovery window in one of the following ways: - -- Set to `max_number DAYS` to define the start date/time recovery window boundary as the number of days specified by `max_number` going back in time from the current date/time. -- Set to `max_number WEEKS` to define the start date/time recovery window boundary as the number of weeks specified by `max_number` going back in time from the current date/time. -- Set to `max_number MONTHS` to define the start date/time recovery window boundary as the number of months specified by `max_number` going back in time from the current date/time. - -**Additional Restrictions:** - -- The keywords `DAYS`, `WEEKS`, and `MONTHS` must always be specified in plural form (for example, `1 DAYS`, `1 WEEKS`, or `1 MONTHS`). -- BART will accept a maximum integer value of `2,147,483,647` for `max_number`, however, a realistic, practical value based on your system environment must always be used. - -A backup is considered active if the date/time of the backup is equal to or greater than the start of the recovery window date/time. - -You can view the actual, calculated recovery window by: - -- Invoking the `MANAGE` subcommand in debug mode, along with the `-n` option. -- Using the `SHOW-SERVERS` subcommand. diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/04_managing_the_backups_based_on_the_retention_policy.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/04_managing_the_backups_based_on_the_retention_policy.mdx deleted file mode 100644 index e541313c7f1..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/04_managing_the_backups_based_on_the_retention_policy.mdx +++ /dev/null @@ -1,152 +0,0 @@ ---- -title: "Managing the Backups Based on the Retention Policy" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/managing_the_backups_based_on_the_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/managing_the_backups_based_on_the_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/managing_the_backups_based_on_the_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/managing_the_backups_based_on_the_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/managing_the_backups_based_on_the_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/managing_the_backups_based_on_the_retention_policy.html" ---- - - - -The [MANAGE](../03_basic_bart_subcommand_usage/07_manage/#manage) subcommand is used to evaluate and categorize backups according to the retention policy set in the BART configuration file. When a backup is first created with the `BACKUP` subcommand, it is `active`. You can use the `MANAGE` subcommand to change the status of an active backup to `obsolete`. Obsolete backups can then be deleted. - -This section covers following aspects of backup management: - -- The rules for [deleting backups](#deletions_permitted_under_retention_policy) depending upon the backup status and the subcommand used. -- The process to retain a backup indefinitely by [marking it as keep](#marking-backups-for-indefinite-keep-status). This section also provides information about resetting backups status (that are marked as `obsolete` and `keep`) back to active status. -- The general process for [evaluating, marking, and then deleting obsolete backups](#evaluating-marking-and-deleting-obsolete-backups). - - - -## Deletions Permitted Under a Retention Policy - -This section describes how and under what conditions backups may be deleted under a retention policy. - -You must use the `MANAGE` subcommand to delete obsolete backups. Use the `DELETE` subcommand only for special administrative purposes. - -The deletion behavior of the `MANAGE` subcommand and the `DELETE` subcommand are based on different aspects of the retention policy. - -- The `MANAGE` subcommand deletion relies solely upon how a backup status is currently marked (that is, internally recorded by BART). The current setting of the `retention_policy` parameter in the BART configuration file is ignored. -- The `DELETE` subcommand relies solely upon the current setting of the `retention_policy` parameter in the BART configuration file. The current active, obsolete, or keep status of a backup is ignored. - -The specific deletion rules for the `MANAGE` and `DELETE` subcommands are as follows: - -- `MANAGE` subcommand: The `MANAGE` subcommand with the `-d` option can only delete backups marked as obsolete. This deletion occurs regardless of the current `retention_policy` setting in the BART configuration file. The deletion of backups relies on the last occasion when the backups have been marked. -- `DELETE` subcommand: - - - Under a redundancy retention policy currently set with the `retention_policy` parameter in the BART configuration file, any backup regardless of its marked status, can be deleted with the `DELETE` subcommand when the backup identifier or name is specified with the `-i` option and if the current total number of backups for the specified database server is greater than the maximum number of redundancy backups currently specified with the `retention_policy` parameter. - - If the total number of backups is less than or equal to the specified, maximum number of redundancy backups, then no additional backups can be deleted using `DELETE` with the `-i backup` option. - - - Under a recovery window retention policy currently set with the `retention_policy` parameter in the BART configuration file, any backup regardless of its marked status, can be deleted with the `DELETE` subcommand when the backup identifier or name is specified with the `-i` option, and if the backup date/time is not within the recovery window currently specified with the `retention_policy` parameter. If the backup date/time is within the recovery window, then it cannot be deleted using `DELETE` with the `-i backup` option. - - - Invoking the `DELETE` subcommand with the `-i all` option results in the deletion of all backups regardless of the retention policy and regardless of whether the status is marked as active, obsolete, or keep. - -The following table summarizes the deletion rules of backups according to their marked status. An entry of `Yes` indicates the backup may be deleted under the specified circumstances. An entry of `No` indicates that the backup may not be deleted. - - -- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
OperationRedundancy Retention PolicyRecovery Window Retention Policy
ActiveObsoleteKeepActiveObsoleteKeep
MANAGE –dNoYesNoNoYesNo
DELETE –i *backup* -

Yes

-

(see Note 1)

-
-

Yes

-

(see Note 1)

-
-

Yes

-

(see Note 1_)

-
-

Yes

-

(see Note 2

-
-

Yes

(see Note 2 -
-

Yes

(see Note 2) -
DELETE –i allYesYesYesYesYesYes
- - - -!!! Note - Redundancy Retention Policy (Note 1) : Deletion occurs only if the total number of backups for the specified database server is greater than the specified, maximum number of redundancy backups currently set with the `redundancy_policy` parameter in the BART configuration file. - - - -!!! Note - Recovery Window Retention Policy (Note 2): Deletion occurs only if the backup is not within the recovery window currently set with the `redundancy_policy` parameter in the BART configuration file. - - - -## Marking Backups for Indefinite Keep Status - -There may be certain backups that you wish to keep for an indefinite period of time and do not wish to delete based upon the retention policy applied to the database server. Such backups can be marked as `keep` to exclude them from being marked as obsolete. Use the `MANAGE` subcommand with the `-c keep` option to retain such backups indefinitely. - - - -## Evaluating, Marking, and Deleting Obsolete Backups - -When the `MANAGE` subcommand is invoked, BART evaluates active backups: - -- If you include the `-s` option when invoking the `MANAGE` subcommand, BART evaluates backups for the database server. -- If you include the `-s all` option when invoking the `MANAGE` subcommand, BART evaluates backups for all database servers. -- If the `-s` option is omitted, the command evaluates the current number of backups for the database server based on the redundancy retention policy or the current date/time for a recovery window retention policy. - -!!! Note - The status of backups currently marked as `obsolete` or `keep` is not changed. To re-evaluate such backups and then classify them, their status must first be reset to `active` with the `MANAGE -c nokeep` option. See [Marking the Backup Status](02_marking_the_backup_status/#marking_the_backup_status) for more information. - -See the *EDB Backup and Recovery Reference Guide* available at the [EDB website](/bart/latest/bart_ref/) to review examples of how to evaluate, mark, and delete backups using a redundancy retention policy and recovery window retention policy, as well as examples of `MANAGE` subcommand. diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/05_managing_incremental_backups.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/05_managing_incremental_backups.mdx deleted file mode 100644 index dbf88d34704..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/05_managing_incremental_backups.mdx +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: "Managing Incremental Backups" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/managing_incremental_backups.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/managing_incremental_backups.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/managing_incremental_backups.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/managing_incremental_backups.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/managing_incremental_backups.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/managing_incremental_backups.html" ---- - - - -The following section summarizes how retention policy management affects incremental backups. - -- The retention policy rules are applied to full backups. - - A redundancy retention policy uses the number of full backups to determine if a backup is obsolete. Incremental backups are excluded from the comparison count against the `retention_policy` setting for the maximum number of backups. - - A recovery window retention policy uses the backup date/time of any full backups to determine if a backup is obsolete. The backup date/time of any successive incremental backups in the chain are ignored when comparing with the recovery window. -- The retention status of all incremental backups in a chain is set to the same status applied to the full backup of the chain. -- The actions applied by the `MANAGE` and `DELETE` subcommands on a full backup are applied to all incremental backups in the chain in the same manner. -- Thus, a backup chain (that is, the full backup and all its successive incremental backups) are treated by retention policy management as if they are all one, single backup. - - The status setting applied to the full backup is also applied to all incremental backups in its chain. - - If a full backup is marked as obsolete and then deleted according to the retention policy, all incremental backups in the chain are also marked obsolete and then deleted as well. - -The following are some specific points regarding the `MANAGE` and `DELETE` subcommands on incremental backups. - -- `MANAGE` subcommand: - - When the `MANAGE` subcommand is invoked, the status applied to the full backup is also applied to all successive incremental backups in the chain. - - The `MANAGE` subcommand with the `-c { keep | nokeep}` option cannot specify the backup identifier or backup name of an incremental backup with `-i` backup option. The `-i` backup option can only specify the backup identifier or backup name of a full backup. - - You can also use the `-i` all option to take a backup of all backups. When the `MANAGE` subcommand with the `-c { keep | nokeep }` option is applied to a full backup, the same status change is made to all incremental backups in the chain. -- `DELETE` subcommand: - - The `DELETE` subcommand with the `-s server -i` backup option specifies the backup identifier or backup name of an incremental backup in which case that incremental backup along with all its successive incremental backups are deleted, thus shortening that backup chain. - -## Using a Redundancy Retention Policy with Incremental Backups - -When a [redundancy retention policy](03_setting_the_retention_policy/#redundancy-retention-policy) is used and the `MANAGE` subcommand is invoked, the status of the oldest `active` full backup is changed to `obsolete` if the number of full backups exceeds the maximum number specified by the `retention_policy` parameter in the BART configuration file. - -!!! Note - When a full backup is changed from `active` to `obsolete`, all successive incremental backups in the chain of the full backup are also changed from `active` to `obsolete`. - -When determining the number of backups that exceeds the number specified by the `retention_policy` parameter, only full backups are counted for the comparison. Incremental backups are not included in the count for the comparison against the `retention_policy` parameter setting. - -See the *EDB Backup and Recovery Reference Guide* available at the [EDB website](/bart/latest/bart_ref/) for examples demonstrating use of the `MANAGE` and `DELETE` subcommands when a redundancy retention policy is in effect. - -## Using a Recovery Window Retention Policy with Incremental Backups - -If the `MANAGE` command is invoked when BART is configured to use a [recovery window retention policy](03_setting_the_retention_policy/#recovery-window-retention-policy), the status of `active` full backups are changed to `obsolete` if the date/time of the full backup is outside of the recovery window. - -!!! Note - If a full backup is changed from `active` to `obsolete`, all successive incremental backups in the chain of the full backup are also changed from `active` to `obsolete`. - -The status of an incremental backup is changed to `obsolete` regardless of whether or not the date/time of when the incremental backup was taken still lies within the recovery window. - -See the *EDB Backup and Recovery Reference Guide* available at the [EDB website](/bart/latest/bart_ref/) for examples demonstrating use of the `MANAGE` and `DELETE` subcommands when a recovery window retention policy is in effect. diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/index.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/index.mdx deleted file mode 100644 index 1a488924f4d..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/02_managing_backups_using_a_retention_policy/index.mdx +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: "Managing Backups Using a Retention Policy" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/managing_backups_using_a_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/managing_backups_using_a_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/managing_backups_using_a_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/managing_backups_using_a_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/managing_backups_using_a_retention_policy.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/managing_backups_using_a_retention_policy.html" ---- - - - -Over the course of time when using BART, the number of backups can grow significantly. This ultimately leads to a large consumption of disk space unless an administrator periodically performs the process of deleting the oldest backups that are no longer needed. This process of determining when a backup is old enough to be deleted and then actually deleting such backups can be done and automated with the following basic steps: - -1. Determine and set a retention policy in the BART configuration file. A *retention policy* is a rule that determines when a backup is considered obsolete. The retention policy can be applied globally to all servers, but each server can override the global retention policy with its own. - -2. Use the `MANAGE` subcommand to categorize and manage backups according to the retention policy. - -3. Create a cron job to periodically run the `MANAGE` subcommand to evaluate the backups and then list and/or delete the obsolete backups. - - Retention policy management applies differently to incremental backups than to full backups. See [Managing Incremental Backups](05_managing_incremental_backups/#managing_incremental_backups) for information about how retention policy management is applied to each backup type. - - The following sections describe how retention policy management generally applies to backups, and its specific usage and effect on full backups. - -
- -overview_managing_backups_using_a_retention_policy marking_the_backup_status setting_the_retention_policy managing_the_backups_based_on_the_retention_policy managing_incremental_backups - -
diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/01_check_config.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/01_check_config.mdx deleted file mode 100644 index bf2ec93ec9b..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/01_check_config.mdx +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: "CHECK-CONFIG" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/check_config.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/check_config.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/check_config.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/check_config.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/check_config.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/check_config.html" ---- - - - -The `CHECK-CONFIG` subcommand checks the parameter settings in the BART configuration file as well as the database server configuration for which the `-s` option is specified. - -**Syntax:** - -`bart CHECK-CONFIG [ –s server_name ]` - -The following table describes the option. - -| Options | Description | -| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-s ` or `--server ` | `server_name` is the name of the database server to be checked for proper configuration. If the option is omitted, the settings of the global section of the BART configuration file are checked. | - -- When the `-s` option is omitted, the global section \[BART] parameters including `bart_host`, `backup_path`, and `pg_basebackup_path` are checked. -- When the `-s` option is specified, the server section parameters are checked. In addition, certain database server `postgresql.conf` parameters are also checked, which include the following: - - The `cluster_owner` parameter must be set to the user account owning the database cluster directory. - - A passwordless SSH/SCP connection must be set between the BART user and the user account specified by the `cluster_owner` parameter. - - A database superuser must be specified by the BART `user` parameter. - - The `pg_hba.conf` file must contain a replication entry for the database superuser specified by the BART `user` parameter. - - The `archive_mode` parameter in the `postgresql.conf` file must be enabled. - - The `archive_command` parameter in the `postgresql.auto.conf` or the `postgresql.conf` file must be set. - - The `allow_incremental_backups` parameter in the BART configuration file must be enabled for database servers for which incremental backups are to be taken. - - Archiving of WAL files to the `archive_path` must be in process. - - The WAL scanner program must be running. - -The `CHECK-CONFIG` subcommand displays an error message if the required configuration is not properly set. diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/02_init.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/02_init.mdx deleted file mode 100644 index e67bad4c021..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/02_init.mdx +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: "INIT" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/init.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/init.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/init.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/init.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/init.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/init.html" ---- - - - -The `INIT` subcommand is used to create the BART backup catalog directory, rebuild the BART `backupinfo` file, and set the `archive_command` in the PostgreSQL server based on the `archive_command` setting in the `bart.cfg` file. - -!!! Note - If the `archive_mode` configuration parameter is set to `off`, then the `-o` option must be used to set the Postgres `archive_command` using the BART `archive_command` parameter in the BART configuration file even if the `archive_command` is not currently set in `postgresql.conf` nor in `postgresql.auto.conf` file. - -**Syntax:** - -```text -bart INIT [ –s { | all } ] [ -o ] - [ -r [ -i { | | all } ] ] - [--no-configure] -``` - -All subcommand options are generally specified in lowercase. The following table describes the command options: - -| Options | Description | -| ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-s { \| all }`

`--server { \| all }` | `server_name` is the name of the database server to which the `INIT` actions are to be applied. If `all` is specified or if the option is omitted, the actions are applied to all servers. | -| `-o`

`--override` | Overrides the existing, active Postgres `archive_command` configuration parameter setting in the `postgresql.conf` file or the `postgresql.auto.conf` file using the BART `archive_command` parameter in the BART configuration file. The `INIT` generated archive command string is written to the `postgresql.auto.conf` file. | -| `-r`

`--rebuild` | Rebuilds the backupinfo file (a text file named `backupinfo`) located in each backup subdirectory. This option is only intended for recovering from a situation where the backupinfo file has become corrupt.
If the backup was initially created with a user-defined backup name, and then the `INIT -r` option is invoked to rebuild that `backupinfo` file, the user-defined backup name is no longer available. Thus, future references to the backup must use the backup identifier. | -| `-i { \| \| all }`

`--backupid { \| \| all }` | `` is an integer, backup identifier and `` is the user-defined alphanumeric name for the backup. If `all` is specified or if the option is omitted, the backupinfo files of all backups for the database servers specified by the `-s` option are recreated. The `-i` option can only be used with the `-r` option. | -| `--no-configure` | Prevents the `archive_command` from being set in the PostgreSQL server. | - -**Archive Command Setting** - -After the `archive_command` is set, you need to either restart the PostgreSQL server or reload the configuration file in the PostgreSQL server based on the following conditions. - -- If the `archive_mode` is set to `off` and `archive_command` is not set in the PostgreSQL server, the `archive_command` is set based on the `archive_command` setting in the `bart.cfg` and also sets the `archive_mode` to `on`. In this case, you need to restart the PostgreSQL server using `pg_ctl restart` -- If the `archive_mode` is set to `on` and `archive_command` is not set in the PostgreSQL server, the `archive_command` is set based on the `archive_command` setting in the `bart.cfg`. In this case, you need to reload the configuration in the PostgreSQL server using `pg_reload_conf()` or `pg_ctl reload`. -- If the `archive_mode` is set to `off` and `archive_command` is already set in the PostgreSQL server, the `archive_mode` is set to on. In this case, you need to restart the PostgreSQL server using `pg_ctl restart` -- If the `archive_mode` is set to `on` and `archive_command` is already set in the PostgreSQL server, then the `archive_command` is not set unless `-o` option is specified. diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/03_backup.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/03_backup.mdx deleted file mode 100644 index 656ee799fcd..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/03_backup.mdx +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: "BACKUP" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/backup.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/backup.html" ---- - - - -The `BACKUP` subcommand is used to create a full backup or an incremental backup. - -**Syntax for full backup:** - -```text -bart BACKUP –s { | all } [ -F { p | t } ] - [ -z ] [ –c ] - [ --backup-name ] - [ --thread-count ] - [ { --with-pg_basebackup | --no-pg_basebackup } ] -``` - -!!! Note - While taking a backup, if a file (for example, database server log file) exceeding 1 GB size is stored in the `$PGDATA` directory, the backup will fail. To avoid such backup failure, you need to store large files (exceeding 1 GB) outside the `$PGDATA` directory. - -**Syntax for incremental Backup:** - -```text -bart BACKUP –s { | all } [ -F p] - [ --parent { | } ] - [ --backup-name ] - [ --thread-count ] - [ --check ] -``` - -!!! Note - To take an [incremental backup](../../02_overview/01_block-level_incremental_backup/#block-level_incremental_backup), you must take a full backup first followed by incremental backup. - -**Please Note:** - -- While a `BACKUP` subcommand is in progress, no other subcommands must be invoked. Any subcommands invoked while a backup is in progress will skip and ignore the backups. - -- For full backup, the target default format is a tar file, whereas for incremental backup, only plain format must be specified. - -- The backup is saved in the `//` directory, where `` is the value assigned to the `` parameter in the BART configuration file, `` is the lowercase name of the database server as listed in the configuration file, and `` is a backup identifier assigned by BART to the particular backup. - -- MD5 checksums of the full backup and any user-defined tablespaces are saved as well for tar backups. - -- Before performing the backup, BART checks to ensure if there is enough disk space to completely store the backup in the BART backup catalog. - -- In the `postgresql.conf` file, ensure the `wal_keep_segments` configuration parameter is set to a sufficiently large value. A low setting of the `wal_keep_segments` configuration parameter may result in the deletion of some WAL files before the BART `BACKUP` subcommand saves them to the `archive_path`. For information about the `wal_keep_segments` parameter, see the [PostgreSQL Core Documentation](https://www.postgresql.org/docs/current/static/runtime-config-replication.html). - -- In the BART configuration file, setting `xlog_method=stream` will instruct the server to stream the transaction log in parallel with creation of the backup for a specific database server; otherwise the transaction log files are collected upon completion of the backup. See the *EDB Backup and Recovery Installation and Upgrade Guide* available at the [EDB website](/bart/latest/bart_inst/) for details about database server setting. - - !!! Note - If the transaction log streaming method is used, the `-Fp` option for a plain text backup format must be specified with the `BACKUP` subcommand. - -- When you use BART to take a backup of PostgreSQL server, multiple backups can be taken simultaneously and if a backup is interrupted, the backup mode is terminated automatically without the need to run `pg_stop_backup()` command manually to terminate the backup. - -**Options** - -Along with the `BACKUP` subcommand, specify the following option: - -| Options | Description | -| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-s { server_name \| all }`
`--server { server_name \| all }` | `server_name` is the database server name to be backed up as specified in the BART configuration file. If `all` is specified, all servers are backed up. This option is mandatory.
If `all` is specified, and a connection to a database server listed in the BART configuration file cannot be opened, the backup for that database server is skipped, but the backup operation continues for the other database servers. | - -Specify the following options as required. If you do not specify any of the following options, the backup is created using default settings. - -| Options | Description | -| -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-F { p \| t }`
`--format { p \| t }` | Specify this option to provide the backup file format. Use `p` for plain text or `t` for tar. If the option is omitted, the default is tar format.
For taking incremental backups, the option `-Fp` must be specified. | -| `-z`
`--gzip` | This is applicable only for full backup. Specify this option to use gzip compression on the tar file output using the default compression level. This option is applicable only for the tar format. | -| `-c `
`--compress-level ` | This is applicable only for full backup. Specify this option to use the gzip compression level on the tar file output. `compression_level` is a digit from 1 through 9, with 9 being the best compression. This option is applicable only for the tar format. | -| `--parent { backup_id \| backup_name }` | Specify this option to take an incremental backup. `` is the backup identifier of a parent backup. `` is the user-defined alphanumeric name of a parent backup.
The parent is a backup taken prior to the incremental backup. The parent backup can be either a full backup or an incremental backup.
The option `–Fp` must be specified since an incremental backup can only be taken in plain text format.
An incremental backup cannot be taken on a standby database server. See [Block-Level Incremental Backup](../../02_overview/01_block-level_incremental_backup/#block-level_incremental_backup) for additional information on incremental backups. | -| `--backup-name ` | Specify this option to assign a user-defined, alphanumeric friendly name to the backup. The maximum permitted length of backup name is 49 characters.
The backup name may include the following variables to be substituted by the timestamp values when the backup is taken: 1) `%year` – 4-digit year, 2) `%month` – 2-digit month, 3) `%day` – 2-digit day, 4) `%hour` 2-digit hour, 5) `%minute` – 2-digit minute, and 6) `%second` – 2-digit second.
To include the percent sign (`%`) as a character in the backup name, specify `%%` in the alphanumeric string.
If the backup name contains space characters (i.e. more than one word) or when referenced with the option `-i` by other subcommands (such as `restore`), enclose the string in single quotes or double quotes. See [backup name examples](#backup_name_examples).
If the `--backup-name` option is not specified, and the `backup_name` parameter is not set for this database server in the BART configuration file, then the backup can only be referenced in other BART subcommands by the BART assigned backup identifier. | -| `--thread-count ` | Use this option to use the number of worker threads to run in parallel to copy blocks for a backup.
If the option `--thread-count` is omitted, then the `thread_count` parameter in the BART configuration file applicable to this database server is used.
If the option `--thread-count` is not enabled for this database server, then the `thread_count` setting in the global section of the BART configuration file is used.
If the option `--thread-count` is not set in the global section as well, the default number of threads is 1.
If parallel backup is run with N number of worker threads, then it will initiate N+ 1 concurrent connections with the server.
Thread count will not be effective if backup is taken on a standby server.
For more information about the `--thread-count` parameter, see the EDB Backup and Recovery Installation and Upgrade Guide available at the [EDB website](/bart/latest/bart_inst/) | -| `--with-pg_basebackup` | This is applicable only for full backup. Specify this option to use `pg_basebackup` to take a full backup. The number of thread counts in effect is ignored as given by the `thread_count` parameter in the BART configuration file.
When taking a full backup, if the thread count in effect is greater than `1`, then the `pg_basebackup` utility is not used to take the full backup (parallel worker threads are used) unless the option `--with-pg_basebackup` is specified with the `BACKUP` subcommand. | -| `--no-pg_basebackup` | This is applicable only for full backup. Specify this option if you do not want `pg_basebackup` to be used to take a full backup.
When taking a full backup, if the thread count in effect is only `1`, then the `pg_basebackup` utility is used to take the full backup unless the option `--no-pg_basebackup` is specified with the `BACKUP` subcommand. | -| `--check` | This is applicable only for incremental backup. Specify this option to verify if the required MBM files are present in the `archived_wals` directory as specified in the `archive_path` parameter in the `bart.cfg` file before taking an incremental backup. The option `--parent` must be specified when the option `--check` is used. An actual incremental backup is not taken when the option `--check` is specified. | - - - -**Backup Name Examples** - -The following examples demonstrate using the `--backup-name` clause: - -```text -./bart backup -s ppas12 -Ft --backup-name "YEAR = %year -MONTH = %month DAY = %day" -./bart backup -s ppas12 -Ft --backup-name "YEAR = %year -MONTH = %month DAY = %day %%" -./bart show-backups -s ppas12 -i "test backup" -``` - -**Error messages** - -The following table lists the error messages that may be encountered when using the `BACKUP` subcommand: - -| error message | Cause | -| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `edb@localhost bin]$ ./bart backup -s mktg -Ft`

`WARNING: xlog_method is empty, defaulting to global policy`

`ERROR: backup failed for server 'mktg'`

`free disk space is not enough to backup the server 'mktg'`

`space available 13.35 GB, approximately required 14.65 GB` | Insufficient free disk space. | -| `ERROR: backup failed for server 'mktg'`

`command failed with exit code 1`

`pg_basebackup: could not get transaction log end position from server: ERROR: requested WAL segment 00000001000000D50000006B has already been removed` | The wal_keep_segments configuration parameter is not set to a sufficiently large value in the postgresql.conf file. | -| `ERROR: backup failed for server 'mktg'`

`connection to the server failed: could not connect to server: Connection refused`

`Is the server running on host "172.16.114.132" and accepting`

`TCP/IP connections on port 5444?` | A connection to a database server listed in the BART configuration file fails. As a result the backup for that database server is skipped, but the backup operation continues for other database servers | diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/04_show_servers.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/04_show_servers.mdx deleted file mode 100644 index 3e990547ab8..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/04_show_servers.mdx +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: "SHOW-SERVERS" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/show_servers.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/show_servers.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/show_servers.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/show_servers.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/show_servers.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/show_servers.html" ---- - - - -The `SHOW-SERVERS` subcommand displays the information for the managed database servers listed in the BART configuration file. - -**Syntax:** - -`bart SHOW-SERVERS [ –s { | all } ]` - -The following table describes the command options. - -| Options | Description | -| ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-s { \| all }`
`--server { \| all }` | `` is the name of the database server whose BART configuration information is to be displayed. If `all` is specified or if the option is omitted, information for all database servers is displayed. | diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/05_show_backups.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/05_show_backups.mdx deleted file mode 100644 index 4e2ff1449d4..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/05_show_backups.mdx +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: "SHOW-BACKUPS" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/show_backups.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/show_backups.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/show_backups.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/show_backups.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/show_backups.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/show_backups.html" ---- - -The `SHOW-BACKUPS` subcommand displays the backup information for the managed database servers. - -**Syntax:** - -```text -bart SHOW-BACKUPS [ –s { | all } ] - [ -i { | | all } ] - [ -t ] -``` - -The following table describes the command options: - -| Options | Description | -| ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-s { \| all }`
`--server { \| all }` | `` is the name of the database server whose backup information is to be displayed.
If `all` is specified or if the option is omitted, the backup information for all database servers is displayed with the exception as described by the following note:
If `SHOW-BACKUPS` is invoked while the BART `BACKUP` subcommand is in progress, backups affected by the backup process are shown in progress status in the displayed backup information. | -| `-i { \| \| all }`
`--backupid { \| \| all }` | `` is a backup identifier and `` is the user-defined alphanumeric name for the backup.
If `all` is specified or if the option is omitted, all backup information for the relevant database server is displayed. | -| `-t`
`--toggle` | Displays more backup information in a list format. If the option is omitted, the default is a tabular format. | diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/06_verify_chksum.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/06_verify_chksum.mdx deleted file mode 100644 index f9c46c7e33f..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/06_verify_chksum.mdx +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: "VERIFY-CHKSUM" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/verify_chksum.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/verify_chksum.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/verify_chksum.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/verify_chksum.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/verify_chksum.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/verify_chksum.html" ---- - - - -The `VERIFY-CHKSUM` subcommand verifies the MD5 checksums of the full backups and any user-defined tablespaces for the specified database server or for all database servers. The checksum is verified by comparing the current checksum of the backup against the checksum when the backup was taken. - -!!! Note - The `VERIFY-CHKSUM` subcommand is only used for tar format backups. It is not applicable to plain format backups. - -**Syntax:** - -```text -bart VERIFY-CHKSUM - [ -s { | all } ] - [ -i { | | all } ] -``` - -The following table describes the command options: - -| Options | Description | -| ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-s { \| all }`

`--server { \| all }` | `` is the name of the database server whose tar backup checksums are to be verified. If `all` is specified or if the `-s` option is omitted, the checksums are verified for all database servers. | -| `-i { \| \| all }`

`--backupid { \| \| all }` | `` is the backup identifier of a tar format full backup whose checksum is to be verified along with any user-defined tablespaces.
`` is the user-defined alphanumeric name for the full backup.
If `all` is specified or if the `-i` option is omitted, the checksums of all tar backups for the relevant database server are verified. | diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/07_manage.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/07_manage.mdx deleted file mode 100644 index 3db85c87d33..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/07_manage.mdx +++ /dev/null @@ -1,67 +0,0 @@ ---- -title: "MANAGE" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/manage.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/manage.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/manage.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/manage.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/manage.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/manage.html" ---- - - - -The `MANAGE` subcommand can be invoked to: - -- Evaluate backups, mark their status, and delete obsolete backups based on the `retention_policy` parameter in the BART configuration file (See [Managing Backups Using a Retention Policy](../02_managing_backups_using_a_retention_policy/#managing_backups_using_a_retention_policy) for information about retention policy management). - -- Compress the archived WAL files based on the `wal_compression` parameter in the BART configuration file (See the *EDB Backup and Recovery Installation and Upgrade Guide* available at the [EDB website](/bart/latest/bart_inst/) for information about setting this parameter). - - **Syntax:** - - ```text - bart MANAGE [ –s { | all} ] - [ -l ] [ -d ] - [ -c { keep | nokeep } - -i { | | all } ] - [ -n ] - ``` - -The following summarizes the actions performed when the `MANAGE` subcommand is invoked: - -- When the `MANAGE` subcommand is invoked with no options or with only the `-s ` or `-s all` option, the following actions are performed: - - For the server specified by the `-s` option, or for all servers (if `-s all` is specified or the `-s` option is omitted), active backups are marked as `obsolete` in accordance with the retention policy. - - All backups that were marked `obsolete` or `keep` prior to invoking the `MANAGE` subcommand remain marked with the same prior status. - - If WAL compression is enabled for the database server, then any uncompressed, archived WAL files in the BART backup catalog of the database server are compressed with gzip. -- When the `MANAGE` subcommand is invoked with any other option besides the `-s` option, the following actions are performed: - - For the server specified by the `-s` option, or for all servers, the action performed is determined by the other specified options (that is, `-l` to list obsolete backups, `-d` to delete obsolete backups, `-c` to keep or to return backups to `active` status, or `-n` to perform a dry run of any action). - - No marking of `active` backups to `obsolete` status is performed regardless of the retention policy. - - All backups that were marked `obsolete` or `keep` prior to invoking the `MANAGE` subcommand remain marked with the same prior status unless the `-c` option (without the `-n` option) is specified to change the backup status of the particular backup or all backups referenced with the `-i` option. - - No compression is applied to any uncompressed, archived WAL file in the BART backup catalog regardless of whether or not WAL compression is enabled. - -The following are additional considerations when using WAL compression: - -- Compression of archived WAL files is not permitted for database servers on which incremental backups are to be taken. -- The gzip compression program must be installed on the BART host and be accessible in the `PATH` of the BART user account. -- When the `RESTORE` subcommand is invoked, if the `-c` option is specified or if the `copy_wals_during_restore` BART configuration parameter is enabled for the database server, then the following actions occur: - - - If compressed, archived WAL files are stored in the BART backup catalog and the location to which the WAL files are to be restored is on a remote host relative to the BART host: - - - the archived WAL files are transmitted across the network to the remote host in compressed format only if the gzip compression program is accessible in the `PATH` of the remote user account that is used to log into the remote host when performing the `RESTORE` operation. - - This remote user is specified with either the `remote_host` parameter in the BART configuration file or the `RESTORE -r` option (see [RESTORE](08_restore/#restore)). - - Transmission of compressed WAL files results in less network traffic. After the compressed WAL files are transmitted across the network, the `RESTORE` subcommand uncompresses the files for the point-in-time recovery operation. - - If the gzip program is not accessible on the remote host in the manner described in the previous bullet point, then the compressed, archived WAL files are first uncompressed while on the BART host, then transmitted across the network to the remote host in uncompressed format. -- When the `RESTORE` subcommand is invoked without the `-c` option and the `copy_wals_during_restore` BART configuration parameter is disabled for the database server, then any compressed, archived WAL files needed for the `RESTORE` operation are uncompressed in the BART backup catalog. The uncompressed WAL files can then be saved to the remote host by the `restore_command` in the `postgresql.auto.conf` file when the database server archive recovery begins. - -The following table describes the command options: - -| Options | Description | -| ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `s { \| all }`
`--server { \| all }` | `` is the name of the database server to which the actions are to be applied. If `all` is specified or if the `-s` option is omitted, the actions are applied to all database servers. | -| `-l`
`--list-obsolete` | Lists the backups marked as obsolete. | -| `-d`
`--delete-obsolete` | Delete the backups marked as `obsolete`. This action physically deletes the backup along with its archived WAL files and any MBM files for incremental backups. | -| `-c { keep \| nokeep }`

`--change-status { keep \| nokeep }` | Specify `keep` to change the status of a backup to `keep` to retain it indefinitely.
Specify `nokeep` to change the status of any backup back to active status. The backup can then be re-evaluated and possibly be marked to `obsolete` according to the retention policy by subsequent usage of the `MANAGE` subcommand.
The `–i` option must be included when using the `-c` option. | -| `-i { \| \| all }`

`--backupid { \| \| all }` | `` is a backup identifier and `` is the user-defined alphanumeric name for the backup.
If `all` is specified, then actions are applied to all backups.
The `–c` option must be included when using the `-i` option. | -| `-n`
`--dry-run` | Performs the test run and displays the results prior to actually implementing the actions as if the operation was performed, however, no changes are actually made.
If `-n` is specified with the `-d` option, it displays which backups would be deleted, but does not actually delete the backups.
If `-n` is specified with the `-c` option, it displays the keep or nokeep action, but does not actually change the backup from its current status.
If `-n` is specified alone with no other options, or with only the `-s` option, it displays which active backups would be marked as obsolete, but does not actually change the backup status. In addition, no compression is performed on uncompressed, archived WAL files even if WAL compression is enabled for the database server. | diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/08_restore.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/08_restore.mdx deleted file mode 100644 index efee311d16d..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/08_restore.mdx +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: "RESTORE" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/restore.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/restore.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/restore.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/restore.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/restore.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/restore.html" ---- - - - -The `RESTORE` subcommand restores a backup and its archived WAL files for the designated database server to the specified directory location. If the appropriate `RESTORE` options are specified, all recovery settings will be saved in the `postgresql.auto.conf` file. - -**Syntax:** - -```text -bart RESTORE –s -p - [ –i { | } ] - [ -r ] - [ -w ] - [ -t ] - [ { -x | -g } ] - [ -c ] -``` - -For information about using a continuous archive backup for recovery, see the [PostgreSQL Core Documentation](https://www.postgresql.org/docs/13/static/continuous-archiving.html). This reference material provides detailed information about the underlying point-in-time recovery process and the meaning and usage of the restore options that are generated into the `postgresql.auto.conf` file by BART. - -**Please note**: - -- For special requirements when restoring an incremental backup to a remote database server, see [Restoring an Incremental Backup on a Remote Host](../../02_overview/01_block-level_incremental_backup/05_restoring_an_incremental_backup/#restoring_an_incremental_backup_on_a_remote_host). -- Check to ensure that the host where the backup is to be restored contains enough disk space for the backup and its archived WAL files. The `RESTORE` subcommand may result in an error while copying files if there is not enough disk space available. -- See [Performing a Restore Operation](../01_bart_management_overview/01_performing_a_restore_operation/#performing_a_restore_operation) to view steps on how to perform a restore operation and see [Point-In-Time Recovery Operation](../01_bart_management_overview/02_point_in_time_recovery_operation/#point_in_time_recovery_operation) to view steps on how to perform a point-in-time recovery operation. -- If the backup is restored to a different database cluster directory than where the original database cluster resided, certain operations dependent upon the database cluster location may fail. This happens if their supporting service scripts are not updated to reflect the new directory location of restored backup. For information about the usage and modification of service scripts, see the *EDB Advanced Server Installation Guide* available at the [EDB website](/epas/latest/). - -The following table describes the command options: - -| Options | Description | -| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-s `
`--server ` | `` is the name of the database server to be restored. | -| `-p `
`--restore-path ` | `` is the directory path where the backup of the database server is to be restored. The directory must be empty and have the proper ownership and privileges assigned to it. | -| `-i { \| }`

`--backupid { \| }` | `` is the backup identifier of the backup to be used for the restoration and `` is the user-defined alphanumeric name for the backup.
If the option is omitted, the default is to use the latest backup. | -| `-r or --remote-host ` | `` is the user account on the remote database server host that accepts a passwordless SSH/SCP login connection and is the owner of the directory where the backup is to be restored and `` is the IP address of the remote host to which the backup is to be restored. This option must be specified if the `` parameter for this database server is not set in the BART configuration file.
If the BART user account is not the same as the operating system account owning the `` directory given with the `-p` option, use the `` BART configuration parameter or the `RESTORE` subcommand `-r` option to specify the `` directory owner even when restoring to a directory on the same host as the BART host.
See the *EDB Backup and Recovery Installation and Upgrade Guide* available at the [EDB website](/bart/latest/bart_inst/) for information about the `` parameter. | -| `-w `
`--workers ` | `` is the specification of the number of worker processes to run in parallel to stream the modified blocks of an incremental backup to the restore location.
For example, if 4 worker processes are specified, 4 receiver processes on the restore host and 4 streamer processes on the BART host are used. The output of each streamer process is connected to the input of a receiver process. When the receiver gets to the point where it needs a modified block file, it obtains those modified blocks from its input. With this method, the modified block files are never written to the restore host disk. If the `-w` option is omitted, the default is `1` \| worker process. | -| `-t `
`--target-tli ` | `` is the integer identifier of the timeline to be used for replaying the archived WAL files for point-in-time recovery. | -| `-x `
`--target-xid ` | `` is the integer identifier of the transaction ID that determines the transaction up to and including, which point-in-time recovery encompasses. Include either the `-x ` or the `--target-xid ` option if point-in-time recovery is desired. | -| `-g `

`--target-timestamp ` | `` is the timestamp that determines the point in time up to and including, which point-in-time recovery encompasses. Include either the `--target-timestamp ` or the `-g ` option if point-in-time recovery is desired. | -| `-c`
`--copy-wals` | Specify this option to copy archived WAL files from the BART backup catalog to `/archived_wals` directory.
If recovery settings are saved in the `postgresql.auto.conf` file for point-in-time recovery, the `restore_command` retrieves the WAL files from `/archived_wals` for the database server archive recovery.
If the `-c` option is omitted and the `copy_wals_during_restore` parameter in the BART configuration file is not enabled in a manner applicable to this database server, the `restore_command` in the `postgresql.auto.conf` file is generated by default to retrieve the archived WAL files directly from the BART backup catalog. See the *EDB Backup and Recovery Installation and Upgrade Guide* available at the [EDB website](/bart/latest/bart_inst/) for information about the `copy_wals_during_restore` parameter. | \ No newline at end of file diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/09_delete.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/09_delete.mdx deleted file mode 100644 index 0cbc5e48e0b..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/09_delete.mdx +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: "DELETE" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/delete.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/delete.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/delete.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/delete.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/delete.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/delete.html" ---- - - - -The `DELETE` subcommand removes the subdirectory and data files from the BART backup catalog for the specified backups along with its archived WAL files. - -**Syntax:** - -```text -bart DELETE –s - -i { all | - [']{ | },... }['] - } - [ -n ] -``` - -!!! Note - While invoking the `DELETE` subcommand, you must specify a specific database server. - -For database servers under a retention policy, there are conditions where certain backups may not be deleted. See [Deletions Permitted Under a Retention Policy](../02_managing_backups_using_a_retention_policy/04_managing_the_backups_based_on_the_retention_policy/#deletions_permitted_under_retention_policy) for information about permitted backup deletions. - -The following table describes the command options: - -| Options | Description | -| -------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-s `

`--server ` | `` is the name of the database server whose backups are to be deleted. | -| `-i { all \| [']{ \| },... }['] }`

`--backupid { all \| [']{ \| },... }['] }` | `` is the backup identifier of the backup to be deleted and `` is the user-defined alphanumeric name for the backup.
Multiple backup identifiers and backup names may be specified in a comma-separated list. The list must be enclosed within single quotes if there is any white space appearing before or after each comma.
If `all` is specified, all of the backups and their archived WAL files for the specified database server are deleted. | -| `-n`
`--dry-run` | Displays the results as if the deletions were done, however, no physical removal of the files are actually performed. In other words, a test run is performed so that you can see the potential results prior to actually initiating the action.
After the deletion, the BART backup catalog for the database server no longer contains the corresponding directory for the deleted backup ID. The `archived_wals` subdirectory no longer contains the WAL files of the backup. | diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/index.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/index.mdx deleted file mode 100644 index bf161ff1cb2..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/03_basic_bart_subcommand_usage/index.mdx +++ /dev/null @@ -1,55 +0,0 @@ ---- -title: "Basic BART Subcommand Usage" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/basic_bart_subcommand_usage.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/basic_bart_subcommand_usage.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/basic_bart_subcommand_usage.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/basic_bart_subcommand_usage.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/basic_bart_subcommand_usage.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/basic_bart_subcommand_usage.html" ---- - - - -This section briefly describes the BART subcommands and options. You can invoke the `bart` program (located in the `/bin` directory) with the desired options and subcommands to manage your BART installation. - -To view examples of BART subcommands, see the *EDB Backup and Recovery Reference Guide* available at the [EDB website](/bart/latest/bart_ref/). - -**Syntax for invoking BART**: - - `bart [ general_option ]... [ subcommand ] [subcommand_option ]...` - -- When invoking a subcommand, the subcommand name is not case-sensitive (that is, the subcommand can be specified in uppercase, lowercase, or mixed case). -- Each subcommand has a number of its own applicable options that are specified following the subcommand. All options are available in both single-character and multi-character forms. -- Keywords are case-sensitive; options are generally specified in lowercase unless specified otherwise in this section. -- When invoking BART, the current user must be the BART user account (operating system user account used to run the BART command line program). For example, enterprisedb or postgres can be selected as the BART user account when the managed database servers are Advanced Server or PostgreSQL respectively. -- The chosen operating system user account must own the BART backup catalog directory, be able to run the `bart` program and the `bart scanner` program, and have a passwordless SSH/SCP connection established between database servers managed by BART. - -You can specify one or more of the following general options: - -| Options | Description | -| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-h` or `--help` | Displays general syntax and information on BART usage. All subcommands support a help option (`-h`, `--help`). If the help option is specified, information is displayed regarding that particular subcommand. The subcommand, itself, is not executed. | -| `-v` or `--version` | Displays the BART version information. | -| `-d` or `--debug` | Displays debugging output while executing BART subcommands. | -| `-c `or `--config-path ` | Specifies `config_file_path` as the full directory path to a BART configuration file. Use this option if you do not want to use the default BART configuration file `/etc/bart.cfg`. | - -**Troubleshooting: Setting Path Environment Variable** - -If execution of BART subcommands fails with the following error message, then you need to set the `LD_LIBRARY_PATH` to include the `libpq` library directory: - - `./bart: symbol lookup error: ./bart: undefined symbol: PQping` - -**Workaround:** Set the `LD_LIBRARY_PATH` environment variable for the BART user account to include the directory containing the `libpq` library. This directory is `POSTGRES_INSTALL_HOME/lib`. - -It is suggested that the `PATH` and the `LD_LIBRARY_PATH` environment variable settings be placed in the BART user account’s profile. See the *EDB Backup and Recovery Installation and Upgrade Guide* available at the [EDB website](/bart/latest/bart_inst/) for details. - -In the following sections, the `help` option is omitted from the syntax diagrams for the purpose of providing readability for the subcommand options. - -
- -check_config init backup show_servers show_backups verify_chksum manage restore delete - -
diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/04_running_the_bart_wal_scanner.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/04_running_the_bart_wal_scanner.mdx deleted file mode 100644 index 0dc25187e97..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/04_running_the_bart_wal_scanner.mdx +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: "Running the BART WAL Scanner" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/running_the_bart_wal_scanner.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/running_the_bart_wal_scanner.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/running_the_bart_wal_scanner.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/running_the_bart_wal_scanner.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/running_the_bart_wal_scanner.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/running_the_bart_wal_scanner.html" ---- - - - -Use the BART WAL scanner to invoke the `bart-scanner` program located in the `BART_HOME/bin` directory. When invoking the WAL scanner, the current user must be the BART user account. - -**Syntax:** - -```text -bart-scanner - [ -d ] - [ -c ] - { –h | - -v | - --daemon | - -p | - | - RELOAD | - STOP -``` - -!!! Note - For clarity, the syntax diagram shows only the single-character option form (for example, `-d`), but the multi-character option form (for example, `--debug`) is supported as well. - -The WAL scanner processes each WAL file to find and record modified blocks in a corresponding modified block map (MBM) file. The default approach is that the WAL scanner gets notified whenever a new WAL file is added to the `archived_wals` directory specified in the `archive_path` parameter of the configuration file. It then scans the WAL file and produces the MBM file. - -The default approach does not work in some cases; for example when the WAL files are shipped to the `archive_path` using the Network File System (NFS) and also in case of some specific platforms. This results in the WAL files being copied to the `archived_wals` directory, but the WAL scanner does not scan them (as WAL scanner is not aware of WAL file) and produce the MBM files. This results in the failure of an incremental backup. This can be avoided by using the timer-based WAL scanning approach, which is done by using the `scan_interval` parameter in the BART configuration file. The value for `scan_interval` is the number of seconds after which the WAL scanner will initiate force scanning of the new WAL files. See the *EDB Backup and Recovery Installation and Upgrade Guide* available at the [EDB website](/bart/latest/bart_inst/) for more information about `scan_interval` parameter. - -When the `bart-scanner` program is invoked, it forks a separate process for each database server enabled with the `allow_incremental_backups` parameter. - -The WAL scanner processes can run in either the foreground or background depending upon usage of the `--daemon` option. Use the `--daemon` option to run the WAL scanner process in the background so that all output messages can be viewed in the BART log file. If the `--daemon` option is omitted, the WAL scanner process runs in the foreground and all output messages can be viewed from the terminal running the program as well as in the BART log file. - -See the *EDB Backup and Recovery Installation and Upgrade Guide* available at the [EDB website](/bart/latest/bart_inst/) for additional information about WAL scanning, `allow_incremental_backups`, and `logfile` parameters. - -!!! Note - The BART user account’s `LD_LIBRARY_PATH` environment variable may need to be set to include the directory containing the `libpq` library if invocation of the WAL scanner program fails. See [Basic BART Subcommand Usage](03_basic_bart_subcommand_usage/#basic_bart_subcommand_usage) for information about setting the `LD_LIBRARY_PATH` environment variable. - -The following table describes the scanner options: - -| Options | Description | -| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `-h` `--help` | Displays general syntax and information on WAL scanner usage. | -| `-v` `--version` | Displays the WAL scanner version information. | -| `-d` `--debug` | Displays debugging output while executing the WAL scanner with any of its options. | -| `-c ` `--config-path ` | Use this option to specify the `config_file_path` of a BART configuration file if you do not want to use the default BART configuration file path `BART_HOME/etc/bart.cfg`. | -| `--daemon` | Runs the WAL scanner as a background process. | -| `-p ` `--print ` | Use this option to specify the full directory path to an MBM file whose content is to be printed. The directory specified in the `archive_path` parameter in the `bart.cfg` file contains the MBM files. | -| `` | Specify the full directory path to a WAL file to be scanned. The directory specified in the `archive_path` parameter in the `bart.cfg` file contains the WAL files. Use this option if a WAL file in the archive path is missing its MBM file. This option is to be used for assisting the EnterpriseDB support team for debugging problems that may have been encountered. | -| `RELOAD` | Reloads the BART configuration file. The keyword `RELOAD` is not case-sensitive. The `RELOAD` option is useful if you make changes to the configuration file after the WAL scanner has been started. It will reload the configuration file and adjust the WAL scanners accordingly. For example, if a server section allowing incremental backups is removed from the BART configuration file, then the process attached to that server will stop. Similarly, if a server allowing incremental backups is added, a new WAL scanner process will be launched to scan the WAL files of that server. | -| `STOP` | Stops the WAL scanner. The keyword `STOP` is not case-sensitive. | diff --git a/product_docs/docs/bart/2.5/bart_user/03_using_bart/index.mdx b/product_docs/docs/bart/2.5/bart_user/03_using_bart/index.mdx deleted file mode 100644 index 3c36e23542d..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/03_using_bart/index.mdx +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: "Using BART" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/using_bart.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/using_bart.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/using_bart.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/using_bart.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/using_bart.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/using_bart.html" ---- - - - -After installing and configuring the BART host and the database servers, you can start using BART. - -This section describes how to perform backup and recovery management operations using BART. Review the sections that follow before proceeding with any BART operation. - -
- -bart_management_overview managing_backups_using_a_retention_policy basic_bart_subcommand_usage running_the_bart_wal_scanner - -
diff --git a/product_docs/docs/bart/2.5/bart_user/04_using_tablespaces.mdx b/product_docs/docs/bart/2.5/bart_user/04_using_tablespaces.mdx deleted file mode 100644 index bab53f47fab..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/04_using_tablespaces.mdx +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: "Using Tablespaces" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/using_tablespaces.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/using_tablespaces.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/using_tablespaces.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/using_tablespaces.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/using_tablespaces.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/using_tablespaces.html" ---- - - - -If the database cluster contains user-defined tablespaces (that is, tablespaces created with the `CREATE TABLESPACE` command): - -- You can take full backups with the `BACKUP` subcommand in either tar (`-Ft`) or plain text (`-Fp`) backup file format. -- You must take incremental backups in the plain text (`-Fp`) backup file format. -- You can take full backups using the transaction log streaming method (xlog_method = stream in the BART configuration file) `--with-pg_basebackup` and the `BACKUP` subcommand in either tar (`-Ft`) or plain text (`-Fp`) backup file format. - -!!! Note - If the particular database cluster you plan to back up contains tablespaces created by the `CREATE TABLESPACE` command, then you must set the `tablespace_path` parameter in the BART configuration file before you perform a BART `RESTORE` operation. - -The `tablespace_path` parameter specifies the directory paths to which you want the tablespaces to be restored. It takes the following format: - - `OID_1=tablespace_path_1;OID_2=tablespace_path_2 ...` - -Where `OID_1`, `OID_2`, … are the Object Identifiers of the tablespaces. You can find the OIDs of the tablespaces and their corresponding soft links to the directories by listing the contents of the `POSTGRES_INSTALL_HOME/data/pg_tblspc` subdirectory as shown in the following example: - -```text -[root@localhost pg_tblspc ]# pwd -/opt/PostgresPlus/9.6AS/data/pg_tblspc -[root@localhost pg_tblspc]# ls -l -total 0 -lrwxrwxrwx 1 enterprisedb enterprisedb 17 Aug 22 16:38 16644 -> /mnt/tablespace_1 -lrwxrwxrwx 1 enterprisedb enterprisedb 17 Aug 22 16:38 16645 -> /mnt/tablespace_2 -``` - -The OIDs are `16644` and `16645` to directories `/mnt/tablespace_1` and `/mnt/tablespace_2`, respectively. - -If you later wish to restore the tablespaces to the same locations as indicated in the preceding example, the BART configuration file must contain the following entry: - -```text -[ACCTG] -host = 127.0.0.1 -port = 5444 -user = enterprisedb -cluster_owner = enterprisedb -tablespace_path = 16644=/mnt/tablespace_1;16645=/mnt/tablespace_2 -description = "Accounting" -``` - -If you later wish to restore the tablespaces to different locations, specify the new directory locations in the `tablespace_path` parameter. - -In either case, the directories specified in the `tablespace_path` parameter must exist and be empty at the time you perform the `BART RESTORE` operation. - -If the database server is running on a remote host (in other words you are also using the `remote_host` configuration parameter or will specify the `--remote-host` option with the `RESTORE` subcommand), the specified tablespace directories must exist on the specified remote host. - -To view example of backing up and restoring a database cluster on a remote host containing tablespaces, see the *EDB Backup and Recovery Reference Guide* available at the [EDB website](/bart/latest/bart_ref/). - -The directories must be owned by the user account with which you intend to start the database server (typically the Postgres user account) with no access by other users or groups as is required for the directory path to which the main full backup is to be restored. - -To view a sample BART managed backup and recovery system consisting of both local and remote database servers, see the *EDB Backup and Recovery Reference Guide* available at the [EDB website](/bart/latest/bart_ref/). diff --git a/product_docs/docs/bart/2.5/bart_user/images/EDB_logo.png b/product_docs/docs/bart/2.5/bart_user/images/EDB_logo.png deleted file mode 100644 index f4a93cf57f5..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/images/EDB_logo.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:07423b012a855204780fe5a2a5a1e33607304a5c3020ae4acbf3d575691dedd6 -size 12136 diff --git a/product_docs/docs/bart/2.5/bart_user/images/copy_1.png b/product_docs/docs/bart/2.5/bart_user/images/copy_1.png deleted file mode 100644 index e08d97827fb..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/images/copy_1.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:c2b13e1623222f77bce5a2d1be4027a9032c878b05bed7ba1a0873be45257d8c -size 10470 diff --git a/product_docs/docs/bart/2.5/bart_user/images/edb.png b/product_docs/docs/bart/2.5/bart_user/images/edb.png deleted file mode 100644 index 3e8d3c76655..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/images/edb.png +++ /dev/null @@ -1,3 +0,0 @@ -version https://git-lfs.github.com/spec/v1 -oid sha256:df8233799fa8616e3762286196fbaf567f3ef45830c65bfcb42214e86a5d69fc -size 12049 diff --git a/product_docs/docs/bart/2.5/bart_user/images/edb_logo.svg b/product_docs/docs/bart/2.5/bart_user/images/edb_logo.svg deleted file mode 100644 index f24d1dfefee..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/images/edb_logo.svg +++ /dev/null @@ -1,19 +0,0 @@ - - - edb-logo-disc-dark - - - - \ No newline at end of file diff --git a/product_docs/docs/bart/2.5/bart_user/index.mdx b/product_docs/docs/bart/2.5/bart_user/index.mdx deleted file mode 100644 index 097dffd6a4f..00000000000 --- a/product_docs/docs/bart/2.5/bart_user/index.mdx +++ /dev/null @@ -1,38 +0,0 @@ ---- -navTitle: Backup and Recovery Guide -title: "EDB Postgres Backup and Recovery User Guide" - -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/whats_new.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.1/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/conclusion.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/introduction.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/whats_new.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.2/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/introduction.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/conclusion.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.4/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/conclusion.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/introduction.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/whats_new.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.3/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/index.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/conclusion.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/introduction.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.5/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/introduction.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/genindex.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/conclusion.html" - - "/edb-docs/d/edb-backup-and-recovery-tool/user-guides/backup-recovery-guide/2.5.7/index.html" ---- - -
- -introduction overview using_bart using_tablespaces conclusion - -
diff --git a/product_docs/docs/bart/2.5/index.mdx b/product_docs/docs/bart/2.5/index.mdx deleted file mode 100644 index 0837f420698..00000000000 --- a/product_docs/docs/bart/2.5/index.mdx +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: Backup and Recovery Tool -directoryDefaults: - description: "EDB Backup and Recovery Tool Version 2.5.9 Documentation and release notes. A tool to manage and configure PostgreSQL backups and disaster recovery." -navigation: - - "#Getting Started" - - bart_inst - - bart_qs_7 - - bart_qs_8 - - "#Guides" - - bart_user - - bart_ref -legacyRedirectsGenerated: - # This list is generated by a script. If you need add entries, use the `legacyRedirects` key. - - "/edb-docs/p/edb-backup-and-recovery-tool/2.5.1" - - "/edb-docs/p/edb-backup-and-recovery-tool/2.5.2" - - "/edb-docs/p/edb-backup-and-recovery-tool/2.5.4" - - "/edb-docs/p/edb-backup-and-recovery-tool/2.5.3" - - "/edb-docs/p/edb-backup-and-recovery-tool/2.5.5" - - "/edb-docs/p/edb-backup-and-recovery-tool/2.5.7" ---- - - - - diff --git a/static/_redirects b/static/_redirects index af895ab18b1..b3137350b96 100644 --- a/static/_redirects +++ b/static/_redirects @@ -40,6 +40,7 @@ /docs/bart/2.5.5/* /docs/bart/2.5/:splat 301 /docs/bart/2.5.7/* /docs/bart/2.5/:splat 301 /docs/bart/2.5.9/* /docs/bart/2.5/:splat 301 +/docs/bart/2.5/* /docs/bart/2.6/:splat 301 /docs/bart/2.6.1/* /docs/bart/2.6/:splat 301 /docs/bart/2.6.2/* /docs/bart/2.6/:splat 301