Merge pull request #2598 from EnterpriseDB/release/2022-04-29

Release: 2022-04-29
EnterpriseDB · Apr 29, 2022 · cbb2bd6 · cbb2bd6
2 parents c4ead9d + f06c951
commit cbb2bd6
Show file tree

Hide file tree

Showing 175 changed files with 4,317 additions and 4,951 deletions.
diff --git a/...s/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx b/...s/migration_toolkit/55/02_supported_operating_systems_and_database_versions.mdx
@@ -11,11 +11,11 @@ You can use the following database product versions with Migration Toolkit:
 
 -   PostgreSQL versions 10, 11, 12, 13, and 14
 -   EDB Postgres Advanced Server versions 10, 11, 12, 13, and 14
--   Oracle 10g Release 2
--   Oracle 11g Release 2
--   Oracle 12c Release 1
--   Oracle 18c Release 1
--   Oracle 19c Release 1
+-   Oracle 10g
+-   Oracle 11g
+-   Oracle 12c
+-   Oracle 18c
+-   Oracle 19c
 -   SQL Server 2008
 -   SQL Server 2012
 -   SQL Server 2014

diff --git a/product_docs/docs/pem/8/considerations.mdx b/product_docs/docs/pem/8/considerations.mdx
@@ -0,0 +1,13 @@
+---
+title: "Deployment considerations"
+---
+
+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/index.mdx b/product_docs/docs/pem/8/index.mdx
@@ -4,25 +4,53 @@ directoryDefaults:
   description: "EDB Postgres Enterprise Manager (PEM) Version 8 Documentation and release notes. PostgreSQL GUI tool for monitoring and performance optimization."
 navigation:
   - pem_rel_notes
-  - "#Getting Started"
-  - pem_inst_guide_linux
-  - pem_inst_guide_windows
+  - supported_platforms
+  - "#Planning"
+  - pem_architecture
+  - considerations
+  - "#Installing"
+  - installing_pem_server
+  - installing_pem_agent
   - pem_upgrade
-  - 04_troubleshooting
-  - pem_pgbouncer
-  - "#Guides"
-  - pem_admin
-  - pem_agent
-  - pem_bart
-  - pem_ent_feat
-  - pem_ha_setup
-  - pem_security_best_practices
-  - pem_sqlprofiler
+  - Uninstalling
+  - "#Administering"
+  - registering_database_server
+  - registering_agent
+  - managing_pem_server
+  - managing_database_server
+  - managing_pem_agent
+  - managing_certificates
+  - managing_configuration_settings
+  - "#Using"
+  - pem_web_interface
+  - monitoring_performance
+  - monitoring_barman
+  - managing_bart
+  - monitoring_BDR_nodes
+  - monitoring_failover_manager
+  - monitoring_xdb_replication_cluster
+  - tuning_performance
+  - profiling_workloads
+  - reports
+  - "#Developing"
+  - pem_query_tool
+  - pem_schema_diff_tool
+  - pem_erd_tool
+  - "#Troubleshooting"
+  - troubleshooting_agent
+  - troubleshooting_server
   - "#Online Help"
   - pem_online_help
 legacyRedirectsGenerated:
   # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
   - "/edb-docs/p/edb-postgres-enterprise-manager/8.0"
+redirects:
+- /pem/latest/pem_admin
+- /pem/latest/pem_agent
+- /pem/latest/pem_ent_feat
+- /pem/latest/em_ha_setup
+- /pem/latest/pem_security_best_practices/
+- /pem/latest/pem_admin/01_overview/02_installing_pem_overview/
 ---
 
 Welcome to Postgres Enterprise Manager. PEM consists of components that provide the management and analytical functionality for your EDB Postgres Advanced Server or PostgreSQL database. PEM is based on the Open Source pgAdmin 4 project.

diff --git a/product_docs/docs/pem/8/installing_pem_agent/index.mdx b/product_docs/docs/pem/8/installing_pem_agent/index.mdx
@@ -0,0 +1,19 @@
+---
+navTitle: "Installing the PEM agent"
+title: "Installing Postgres Enterprise Manager agent"
+# This is new created file
+# Line 15 onwards need review/edits
+---
+
+The PEM Agent that is installed with the PEM server is capable of monitoring multiple servers that reside on the same host, or on remote hosts. Please note that the PEM functionality on servers monitored by a remote Agent may be limited. For detailed information about remote monitoring functionality see the [PEM agent privileges](/pem/latest/pem_online_help/02_toc_pem_agent/05_pem_agent_privileges/).
+
+For detailed information about installing a standalone PEM Agent on monitored hosts, see
+
+-   [Installing on Linux](installing_on_linux)
+-   [Installing on Windows](installing_pem_agent_on_windows)
+
+For detailed information about registering, managing and troubleshooting the agent, see
+
+-   [Registering a PEM Agent](../registering_agent/)
+-   [Managing a PEM agent](../managing_pem_agent/) 
+-   [Troubleshooting for PEM agent](../troubleshooting_agent/)
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
@@ -0,0 +1,23 @@
+---
+title: "Installing a PEM agent using the EDB repository"
+navTitle: "On Linux"
+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/installing_pem_server_on_linux.html"
+# This whole section is moved from pem_inst_guide_linux/04_installing_postgres_enterprise_manager and the navtitle is added.
+redirects:
+- /pem/8/pem_inst_guide_linux/04_installing_postgres_enterprise_manager/08_installing_pem_agent_using_edb_repository/
+
+navigation:
+
+- x86
+- ppc64le
+---
+
+The native packages installs the PEM agent on Linux. You need to register the agent installed with native packages, for more details see [Registering a agent]().
+
+For platform-specific install instructions, see:
+
+- [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
@@ -0,0 +1,14 @@
+---
+title: "IBM Power (ppc64le)"
+navigation:
+
+- pem_agent_rhel8_ppcle
+- pem_agent_sles12_ppcle
+- pem_agent_sles15_ppcle
+---
+
+- For Linux on IBM Power (ppc64le), see:
+  - [RHEL 8](pem_agent_rhel8_ppcle)
+
+  - [SLES 15](pem_agent_sles15_ppcle)
+  - [SLES 12](pem_agent_sles12_ppcle)
diff --git a/...b_repository/07_pem_agent_rhel8_ppcle.mdx → ...n_linux/ppc64le/pem_agent_rhel8_ppcle.mdx b/...b_repository/07_pem_agent_rhel8_ppcle.mdx → ...n_linux/ppc64le/pem_agent_rhel8_ppcle.mdx
@@ -1,5 +1,5 @@
 ---
-title: "RHEL 8 on IBM Power (ppc64le)"
+title: "RHEL 8"
 ---
 
 
@@ -61,6 +61,6 @@ sudo su -
    dnf -y install edb-pem-agent
    ```
 
-After installing the PEM Agent, you must register the agent. For more detailed information see [Registering a PEM Agent](09_registering_a_pem_agent/#registering-a-pem-agent).
+After installing the PEM Agent, you must register the agent. For more detailed information see [Registering an agent](../../../registering_agent).
 
 
diff --git a/..._repository/10_pem_agent_sles12_ppcle.mdx → ..._linux/ppc64le/pem_agent_sles12_ppcle.mdx b/..._repository/10_pem_agent_sles12_ppcle.mdx → ..._linux/ppc64le/pem_agent_sles12_ppcle.mdx
@@ -1,5 +1,5 @@
 ---
-title: "SLES 12 on IBM Power (ppc64le)"
+title: "SLES 12"
 ---
 
 There are three steps to completing an installation:
@@ -51,4 +51,4 @@ zypper addrepo https://download.opensuse.org/repositories/Apache:/Modules/SLE_12
 zypper -n install edb-pem-agent
 ```
 
-After installing the PEM Agent, you must register the agent. For more detailed information see [Registering a PEM Agent](09_registering_a_pem_agent/#registering-a-pem-agent).
+After installing the PEM Agent, you must register the agent. For more detailed information see [Registering an agent](../../../registering_agent).
diff --git a/..._repository/09_pem_agent_sles15_ppcle.mdx → ..._linux/ppc64le/pem_agent_sles15_ppcle.mdx b/..._repository/09_pem_agent_sles15_ppcle.mdx → ..._linux/ppc64le/pem_agent_sles15_ppcle.mdx
@@ -1,5 +1,5 @@
 ---
-title: "SLES 15 on IBM Power (ppc64le)"
+title: "SLES 15"
 ---
 
 There are two steps to completing an installation:
@@ -47,4 +47,4 @@ zypper refresh
 zypper -n install edb-pem-agent
 ```
 
-After installing the PEM Agent, you must register the agent. For more detailed information see [Registering a PEM Agent](09_registering_a_pem_agent/#registering-a-pem-agent).
+After installing the PEM Agent, you must register the agent. For more detailed information see [Registering an agent](../../../registering_agent).
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
@@ -0,0 +1,24 @@
+---
+title: "x86"
+navigation:
+
+- pem_agent_rhel8_x86
+- pem_agent_other_linux8_x86
+- pem_agent_rhel7_x86
+- pem_agent_centos7_x86
+- pem_agent_sles15_x86
+- pem_agent_sles12_x86
+- pem_agent_ubuntu20_deb10_x86
+- pem_agent_ubuntu18_deb9_x86
+---
+
+For Linux x86-64 (amd64) see:
+  - [RHEL 8/OL 8](pem_agent_rhel8_x86)
+
+  - [Rocky Linux 8/AlmaLinux 8](pem_agent_other_linux8_x86)
+  - [RHEL 7/OL 7](pem_agent_rhel7_x86)
+  - [CentOS 7](pem_agent_centos7_x86)
+  - [SLES 15](pem_agent_sles15_x86)
+  - [SLES 12](pem_agent_sles12_x86)
+  - [Ubuntu 20.04/Debian 10](pem_agent_ubuntu20_deb10_x86)
+  - [Ubuntu 18.04/Debian 9](pem_agent_ubuntu18_deb9_x86)
diff --git a/..._repository/02a_pem_agent_centos7_x86.mdx → ...ng_on_linux/x86/pem_agent_centos7_x86.mdx b/..._repository/02a_pem_agent_centos7_x86.mdx → ...ng_on_linux/x86/pem_agent_centos7_x86.mdx
@@ -1,8 +1,8 @@
 ---
-title: "CentOS 7 on x86_64"
+title: "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 [PEM Agent User Guide](https://www.enterprisedb.com/docs/pem/latest/pem_agent/).
+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).
 
 On a CentOS system, you can use the `yum` package manager to install a PEM Agent; the installation tool you use will be dependent on the version of the host operating system. Before installing the agent, you must ensure that your system contains the required prerequisite software listed below.
 
@@ -38,11 +38,11 @@ To request credentials for the repository, contact [EDB](https://www.enterprised
 
 When the installation is complete, you can review a list of the installed packages and dependencies.
 
-![](../../images/pem_rpm_installation_agent.png)
+![](../../../images/pem_rpm_installation_agent.png)
 
 When you install an RPM package that is signed by a source that is not recognized by your system, yum may ask for your permission to import the key to your local server. If prompted, and you are satisfied that the packages come from a trustworthy source, enter `y`, and press `Return` to continue.
 
 During the installation, yum may encounter a dependency that it cannot resolve. If it does, it will provide a list of the required dependencies that you must manually resolve.
 
-After installing PEM Agent using `yum`, you need to register the PEM Agent. For detailed information see [Registering a PEM Agent](09_registering_a_pem_agent/#registering-a-pem-agent).
+After installing PEM Agent using `yum`, you need to register the PEM Agent. For detailed information see [Registering an agent](../../../registering_agent).
 
diff --git a/...sitory/01a_pem_agent_other_linux8_x86.mdx → ..._linux/x86/pem_agent_other_linux8_x86.mdx b/...sitory/01a_pem_agent_other_linux8_x86.mdx → ..._linux/x86/pem_agent_other_linux8_x86.mdx
@@ -1,8 +1,8 @@
 ---
-title: "Rocky Linux 8/AlmaLinux 8 on x86_64"
+title: "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 the [PEM Agent User Guide](https://www.enterprisedb.com/docs/pem/latest/pem_agent/).
+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).
 
 On a Rocky Linux or AlmaLinux system, you can use the `dnf` command to install a PEM Agent; the installation tool you use will be dependent on the version of the host operating system. Before installing the agent, you must ensure that your system contains the required prerequisite software listed below.
 
@@ -44,10 +44,10 @@ To request credentials for the repository, contact [EDB](https://www.enterprised
 
 When the installation is complete, you can review a list of the installed packages and dependencies.
 
-![](../../images/pem_rpm_installation_agent.png)
+![](../../../images/pem_rpm_installation_agent.png)
 
 When you install an RPM package that is signed by a source that is not recognized by your system, yum may ask for your permission to import the key to your local server. If prompted, and you are satisfied that the packages come from a trustworthy source, enter `y`, and press `Return` to continue.
 
 During the installation, yum may encounter a dependency that it cannot resolve. If it does, it will provide a list of the required dependencies that you must manually resolve.
 
-After installing PEM Agent using `dnf`, you need to register the PEM Agent. For detailed information see [Registering a PEM Agent](09_registering_a_pem_agent/#registering-a-pem-agent).
+After installing PEM Agent using `dnf`, you need to register the PEM Agent. For detailed information see [Registering an agent](../../../registering_agent).
diff --git a/...edb_repository/02_pem_agent_rhel7_x86.mdx → ...ling_on_linux/x86/pem_agent_rhel7_x86.mdx b/...edb_repository/02_pem_agent_rhel7_x86.mdx → ...ling_on_linux/x86/pem_agent_rhel7_x86.mdx
@@ -1,8 +1,8 @@
 ---
-title: "RHEL 7/OL 7 on x86_64 on x86_64"
+title: "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 the [PEM Agent User Guide](https://www.enterprisedb.com/docs/pem/latest/pem_agent/).
+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).
 
 On a RHEL or OL system, you can use the `yum` package manager to install a PEM Agent; the installation tool you use will be dependent on the version of the host operating system. Before installing the agent, you must ensure that your system contains the required prerequisite software listed below.
 
@@ -46,11 +46,11 @@ To request credentials for the repository, contact [EDB](https://www.enterprised
 
 When the installation is complete, you can review a list of the installed packages and dependencies.
 
-![](../../images/pem_rpm_installation_agent.png)
+![](../../../images/pem_rpm_installation_agent.png)
 
 When you install an RPM package that is signed by a source that is not recognized by your system, yum may ask for your permission to import the key to your local server. If prompted, and you are satisfied that the packages come from a trustworthy source, enter `y`, and press `Return` to continue.
 
 During the installation, yum may encounter a dependency that it cannot resolve. If it does, it will provide a list of the required dependencies that you must manually resolve.
 
-After installing PEM Agent using `yum`, you need to register the PEM Agent. For detailed information see [Registering a PEM Agent](09_registering_a_pem_agent/#registering-a-pem-agent).
+After installing PEM Agent using `yum`, you need to register the PEM Agent. For detailed information see [Registering an agent](../../../registering_agent).
 
diff --git a/...edb_repository/01_pem_agent_rhel8_x86.mdx → ...ling_on_linux/x86/pem_agent_rhel8_x86.mdx b/...edb_repository/01_pem_agent_rhel8_x86.mdx → ...ling_on_linux/x86/pem_agent_rhel8_x86.mdx
@@ -1,8 +1,8 @@
 ---
-title: "RHEL 8/OL 8 on x86_64"
+title: "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 the [PEM Agent User Guide](https://www.enterprisedb.com/docs/pem/latest/pem_agent/).
+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).
 
 On a RHEL or OL system, you can use the `dnf` command to install a PEM Agent; the installation tool you use will be dependent on the version of the host operating system. Before installing the agent, you must ensure that your system contains the required prerequisite software listed below.
 
@@ -47,10 +47,10 @@ To request credentials for the repository, contact [EDB](https://www.enterprised
 
 When the installation is complete, you can review a list of the installed packages and dependencies.
 
-![](../../images/pem_rpm_installation_agent.png)
+![](../../../images/pem_rpm_installation_agent.png)
 
 When you install an RPM package that is signed by a source that is not recognized by your system, yum may ask for your permission to import the key to your local server. If prompted, and you are satisfied that the packages come from a trustworthy source, enter `y`, and press `Return` to continue.
 
 During the installation, yum may encounter a dependency that it cannot resolve. If it does, it will provide a list of the required dependencies that you must manually resolve.
 
-After installing PEM Agent using `dnf`, you need to register the PEM Agent. For detailed information see [Registering a PEM Agent](09_registering_a_pem_agent/#registering-a-pem-agent).
+After installing PEM Agent using `dnf`, you need to register the PEM Agent. For detailed information see [Registering an agent](../../../registering_agent).
diff --git a/...db_repository/04_pem_agent_sles12_x86.mdx → ...ing_on_linux/x86/pem_agent_sles12_x86.mdx b/...db_repository/04_pem_agent_sles12_x86.mdx → ...ing_on_linux/x86/pem_agent_sles12_x86.mdx
@@ -1,5 +1,5 @@
 ---
-title: "SLES 12 on x86_64"
+title: "SLES 12"
 ---
 
 There are two steps to completing an installation:
@@ -47,5 +47,5 @@ zypper refresh
 zypper -n install edb-pem-agent
 ```
 
-After installing the PEM Agent, you must register the agent. For more detailed information see [Registering a PEM Agent](09_registering_a_pem_agent/#registering-a-pem-agent).
+After installing the PEM Agent, you must register the agent. For more detailed information see [Registering an agent](../../../registering_agent).
 
diff --git a/...db_repository/03_pem_agent_sles15_x86.mdx → ...ing_on_linux/x86/pem_agent_sles15_x86.mdx b/...db_repository/03_pem_agent_sles15_x86.mdx → ...ing_on_linux/x86/pem_agent_sles15_x86.mdx
@@ -1,5 +1,5 @@
 ---
-title: "SLES 15 on x86_64"
+title: "SLES 15"
 ---
 
 There are two steps to completing an installation:
@@ -47,5 +47,5 @@ zypper refresh
 zypper -n install edb-pem-agent
 ```
 
-After installing the PEM Agent, you must register the agent. For more detailed information see [Registering a PEM Agent](09_registering_a_pem_agent/#registering-a-pem-agent).
+After installing the PEM Agent, you must register the agent. For more detailed information see [Registering an agent](../../../registering_agent).
 
diff --git a/...sitory/06_pem_agent_ubuntu18_deb9_x86.mdx → ...linux/x86/pem_agent_ubuntu18_deb9_x86.mdx b/...sitory/06_pem_agent_ubuntu18_deb9_x86.mdx → ...linux/x86/pem_agent_ubuntu18_deb9_x86.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Ubuntu 18.04/Debian 9 on x86_64"
+title: "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) .
@@ -45,5 +45,5 @@ Where `username:password` is to be replaced by the credentials provided by EDB.
     apt-get install edb-pem-agent
     ```
 
-After installing PEM Agent using `apt-get`, you need to register the PEM Agent. For more detailed information see [Registering a PEM Agent](09_registering_a_pem_agent/#registering-a-pem-agent).
+After installing PEM Agent using `apt-get`, you need to register the PEM Agent. For more detailed information see [Registering an agent](../../../registering_agent).
 
diff --git a/...tory/05_pem_agent_ubuntu20_deb108_x86.mdx → ...inux/x86/pem_agent_ubuntu20_deb10_x86.mdx b/...tory/05_pem_agent_ubuntu20_deb108_x86.mdx → ...inux/x86/pem_agent_ubuntu20_deb10_x86.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Ubuntu 20.04/Debian 10 on x86_64"
+title: "Ubuntu 20.04/Debian 10"
 ---
 
 
@@ -52,5 +52,5 @@ The following steps will walk you through using the EDB apt repository to instal
     apt-get install edb-pem-agent
     ```
 
-After installing PEM Agent using `apt-get`, you need to register the PEM Agent. For more detailed information see [Registering a PEM Agent](09_registering_a_pem_agent/#registering-a-pem-agent).
+After installing PEM Agent using `apt-get`, you need to register the PEM Agent. For more detailed information see [Registering an agent](../../../registering_agent).