Merge pull request #2151 from EnterpriseDB/content/docs/pem/upgrade_g…

…uide_fix

Updated the PEM Upgrade guide

product_docs/docs/pem/8/index.mdx

@@ -1,14 +1,14 @@
 ---
 title: "Postgres Enterprise Manager"
 directoryDefaults:
-  description: "EDB Postgres Enterprise Manager Version 8 Documentation and release notes. PostgreSQL GUI tool for monitoring and performance optimization."
+  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_pgbouncer
-  - pem_upgrade
   - pem_inst_guide_windows
+  - pem_upgrade
+  - pem_pgbouncer
   - "#Guides"
   - pem_admin
   - pem_agent
@@ -24,6 +24,6 @@ legacyRedirectsGenerated:
   - "/edb-docs/p/edb-postgres-enterprise-manager/8.0"
 ---
 
-Welcome to Postgres Enterprise Manager (PEM). 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.
+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.
 
 PEM is a comprehensive database design and management system. PEM is designed to meet the needs of both novice and experienced Postgres users alike, providing a powerful graphical interface that simplifies the creation, maintenance, and use of database objects.

product_docs/docs/pem/8/pem_inst_guide_linux/04_installing_postgres_enterprise_manager/04_creating_pem_repository_in_isolated_network.mdx

@@ -5,7 +5,7 @@ legacyRedirectsGenerated:
   - "/edb-docs/d/edb-postgres-enterprise-manager/installation-getting-started/linux-installation-guide/8.0/creating_pem_repository_in_isolated_network.html"
 ---
 
-You can create a local repository to act as a host for the PEM RPM packages if the server on which you wish to upgrade PEM cannot directly access the EnterpriseDB repository. Please note that this is a high-level overview of the steps required; you may need to modify the process for your individual network. To create and use a local repository, you must:
+You can create a local repository to act as a host for the PEM RPM packages if the server on which you wish to upgrade PEM cannot directly access the EDB repository. Please note that this is a high-level overview of the steps required; you may need to modify the process for your individual network. To create and use a local repository, you must:
 
 1.  Use the following commands on a system with Internet access to download the dependencies for PEM:
 

product_docs/docs/pem/8/pem_inst_guide_linux/index.mdx

@@ -1,5 +1,5 @@
 ---
-title: "PEM Installation Guide on Linux"
+title: "Installation 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/whats_new.html"

product_docs/docs/pem/8/pem_inst_guide_windows/index.mdx

@@ -1,6 +1,5 @@
 ---
-navTitle: Windows Installation Guide
-title: "PEM Installation Guide on Windows"
+title: "Installation on Windows"
 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/windows-installation-guide/8.0/genindex.html"
@@ -15,10 +14,4 @@ This document provides step-by-step instructions to guide you through the instal
 
 Throughout this guide, the term `Postgres` refers to either a PostgreSQL or an Advanced Server installation, where either is appropriate.
 
-Language pack installers contain supported languages that may be used with EDB Postgres Advanced Server and EDB PostgreSQL database installers. The language pack installer allows you to install Perl, TCL/TK, and Python without installing supporting software from third party vendors. For more information about installing and using Language Pack, please see the `EDB Postgres Language Pack Guide`, available from the EDB Website.
-
-<div class="toctree" maxdepth="5">
-
-whats_new pem_hardware_software_requirements pem_architecture installing_postgres_enterprise_manager the_pem_web_interface uninstalling_pem_components conclusion
-
-</div>
+Language pack installers contain supported languages that may be used with EDB Postgres Advanced Server and EDB PostgreSQL database installers. The language pack installer allows you to install Perl, TCL/TK, and Python without installing supporting software from third party vendors. For more information about installing and using Language Pack, please see the [EDB Postgres Language Pack Guide](https://www.enterprisedb.com/docs/epas/latest/language_pack/).

product_docs/docs/pem/8/pem_pgbouncer/index.mdx

@@ -1,5 +1,5 @@
 ---
-navTitle: pgBouncer Configuration Guide
+navTitle: pgBouncer Configuration
 title: "EDB Postgres Enterprise Manager Configuring pgBouncer for Use with PEM Agents"
 legacyRedirectsGenerated:
   # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.

product_docs/docs/pem/8/pem_security_best_practices/index.mdx

@@ -1,6 +1,6 @@
 ---
 navTitle: Security Guide
-title: "PEM Security Guide"
+title: "Security Guide"
 legacyRedirectsGenerated:
   # This list is generated by a script. If you need add entries, use the `legacyRedirects` key.
   - "/edb-docs/d/edb-postgres-enterprise-manager/user-guides/pem-security-guide/8.0/index.html"

product_docs/docs/pem/8/pem_upgrade/01_upgrading_pem_installation/02_upgrading_pem_installation_linux_rpm.mdx

@@ -26,12 +26,14 @@ PEM is dependent on third-party components from the vendor repository, including
 To upgrade packages on a CentOS or RHEL 7.x host
 
 ```text
+yum update
 yum upgrade
 ```
 
 To upgrade packages on a CentOS or RHEL 8.x host
 
 ```text
+dnf update
 dnf upgrade
 ```
 
@@ -55,6 +57,7 @@ To upgrade packages on a Debian or Ubuntu host
 
 ```text
 apt-get update
+apt-get upgrade
 ```
 
 To upgrade Advanced Server libs:
@@ -77,6 +80,7 @@ To upgrade packages on a SLES host
 
 ```text
 zypper update
+zypper upgrade
 ```
 
 To upgrade Advanced Server libs:
@@ -95,7 +99,7 @@ Where `<X>` is the PostgreSQL or Advanced Server version whose `libs` package yo
 
 ## Upgrading a PEM Agent Native Package Installation
 
-You can use native packages to upgrade existing PEM Agents that were initially installed using native packages. The upgrade process does not update the PEM agent configuration file. After installing the new agent, you must manually copy the configuration file of the existing agent to the new installation location.
+You can use native packages to upgrade existing PEM Agents initially installed using native packages. The upgrade process does not update the PEM agent configuration file. After installing the new agent, you must manually copy the configuration file of the existing agent to the new installation location.
 
 ### Upgrading the PEM Agent on a CentOS or RHEL Host
 
@@ -133,7 +137,7 @@ zypper update edb-pem-agent
 
 If you initially used native packages to install your PEM server, you can use native packages to upgrade your PEM server. The commands to upgrade are platform-specific; please refer to your platform's section below.
 
-If you wish to upgrade a PEM server that is installed on a machine in an isolated network, you need to create a PEM repository on that machine before you upgrade the PEM server. For more information about creating a PEM repository on an isolated network, see [Creating a PEM Repository on an Isolated Network](03_creating_pem_repository_in_isolated_network/#creating_pem_repository_in_isolated_network).
+If you wish to upgrade a PEM server that is installed on a machine in an isolated network, you need to create a PEM repository on that machine before you upgrade the PEM server. For more information about creating a PEM repository on an isolated network, see [Creating a PEM Repository on an Isolated Network](../../pem_inst_guide_linux/04_installing_postgres_enterprise_manager/04_creating_pem_repository_in_isolated_network/).
 
 ### Upgrading a PEM Server on a CentOS or RHEL Host
 
@@ -154,7 +158,7 @@ dnf upgrade edb-pem
 !!! Note
     If you are doing a fresh installation of the PEM Server on CentOS or RHEL 7.x host, the installer will install the edb-python3-mod_wsgi package along with the installation as the package is a requirement of the operating system. If you are *upgrading* the PEM Server on CentOS or RHEL 7.x host, the mod_wsgi package will be replaced by the edb-python3-mod_wsgi package to meet the requirements of the operating system.
 
-After upgrading the PEM Server using `yum` or `dnf`, you must configure the PEM Server. For more detailed information see [Configuring the PEM Server on Linux Platforms](05_configuring_the_pem_server_on_linux_platforms/#configuring_the_pem_server_on_linux_platforms).
+After upgrading the PEM Server using `yum` or `dnf`, you must configure the PEM Server. For more detailed information see [Configuring the PEM Server](../01_upgrading_pem_installation/02_upgrading_pem_installation_linux_rpm/#configuring-the-pem-server).
 
 ### Upgrading the PEM Server on a Debian or Ubuntu Host
 
@@ -164,7 +168,7 @@ You can use the `apt-get` package manager to upgrade the installed version of th
 apt-get upgrade edb-pem
 ```
 
-After upgrading the PEM Server with `apt-get`, you need to configure the PEM Server. For more detailed information see [Configuring the PEM Server on Linux Platforms](05_configuring_the_pem_server_on_linux_platforms/#configuring_the_pem_server_on_linux_platforms).
+After upgrading the PEM Server with `apt-get`, you need to configure the PEM Server. For more detailed information see [Configuring the PEM Server](../01_upgrading_pem_installation/02_upgrading_pem_installation_linux_rpm/#configuring-the-pem-server).
 
 ### Upgrading the PEM Server on a SLES Host
 
@@ -174,74 +178,22 @@ You can use the `zypper` package manager to upgrade the installed version of the
 zypper update edb-pem
 ```
 
-After upgrading the PEM Server using `zypper`, you need to configure the PEM Server. For more detailed information see [Configuring the PEM Server on Linux platforms](05_configuring_the_pem_server_on_linux_platforms/#configuring_the_pem_server_on_linux_platforms).
+After upgrading the PEM Server using `zypper`, you need to configure the PEM Server. For more detailed information see [Configuring the PEM Server](../01_upgrading_pem_installation/02_upgrading_pem_installation_linux_rpm/#configuring-the-pem-server).
 
-## Upgrading a SQL Profiler Native Package Installation
 
-To upgrade a SQL Profiler installation that resides on a Linux host:
+## Configuring the PEM Server
 
-1.  Delete the existing SQL Profiler query set on each node by invoking the `uninstall-sql-profiler.sql` script. By default, on a Linux host the script resides in the `share/contrib` directory under your Advanced Server or PostgreSQL installation.
+After upgrading the PEM Server you can use the following command to configure the PEM Server:
 
-    You can use the following server-specific command:
-
-    For PostgreSQL:
-
-    ```text
-    /usr/pgsql-<x>/bin/psql -f /usr/pgsql-<x>/share/contrib/uninstall-sql-profiler.sql -d postgres -U postgres
-    ```
-
-    Where, `x` is the version of PostgreSQL and `-d` specifies the name of the maintenance database.
-
-    For Advanced Server:
-
-    ```text
-    /usr/edb/as<x>/bin/psql -f /usr/edb/as<x>/share/contrib/uninstall-sql-profiler.sql -d edb -U enterprisedb
-    ```
-
-    Where, `x` is the version of Advanced Server and `-d` specifies the name of the maintenance database.
-
-2.  Invoke the new SQL Profiler installer on each node you wish to profile.
-
-    For PostgreSQL:
-
-    ```text
-    yum upgrade postgresql<x>-sqlprofiler
-    ```
-
-    Where, `x` is the version of the PostgreSQL.
-
-    For Advanced Server:
-
-    ```text
-    yum upgrade edb-as<x>-server-sqlprofiler
-    ```
-
-    Where `x` is the version of Advanced Server.
-
-The installer will detect the existing `SQL Profiler` installation and upgrade with the latest version of SQL Profiler.
-
-Please see the following example of upgrading SQL Profiler for PostgreSQL:
-
-![Upgrading SQL Profiler](../../images/sqlprofiler_upgrade.png)
-
-3.  Then, run the `sql-profiler.sql` script file in the maintenance database.
-
-    For PostgreSQL:
-
-    ```text
-    /usr/pgsql-<x>/bin/psql -f /usr/pgsql-<x>/share/contrib/sql-profiler.sql -d postgres -U postgres
-    ```
-
-    Where, `x` is the version of PostgreSQL and `-d` specifies the name of the maintenance database.
-
-    For Advanced Server:
+```text
+/usr/edb/pem/bin/configure-pem-server.sh
+```
 
-    ```text
-    /usr/edb/as<x>/bin/psql -f /usr/edb/as<x>/share/contrib/sql-profiler.sql -d edb -U enterprisedb
-    ```
+The configure script uses the values from the old PEM Server configuration file while running the script.
 
-    Where, `x` is the version of Advanced Server and `-d` specifies the name of the maintenance database.
+After executing the PEM server configuration file, use your version-specific service control command to restart the `httpd` service.
 
-4.  Restart the PostgreSQL/Advanced Server to resume profiling the node from the PEM Client.
+For detailed information, please see the [Configuring the PEM Server on Linux Platforms](../../pem_inst_guide_linux/04_installing_postgres_enterprise_manager/05_configuring_the_pem_server_on_linux/).
 
-After updating the PEM components, you are ready to update the backend database.
+!!! Note
+    From PEM 7.11 and later, the configure script only requires a superuser password post the upgrade process.