Merge pull request #4502 from EnterpriseDB/docs/pem/normalize-upgrade…

…-language Revised upgrade language to be more consistent with other product
EnterpriseDB · Aug 2, 2023 · bfa180c · bfa180c
2 parents 179c0cf + d7ba623
commit bfa180c
Showing 1 changed file with 25 additions and 59 deletions.
diff --git a/...9/upgrading/upgrading_pem_installation/upgrading_pem_installation_linux_rpm.mdx b/...9/upgrading/upgrading_pem_installation/upgrading_pem_installation_linux_rpm.mdx
@@ -18,53 +18,35 @@ During an installation, the component installation detects an existing installat
 !!! Note
     If you already configured or are planning to configure any shell/batch script run by a Linux agent that's upgraded from any earlier version to version 7.11 or later, you must specify the user for the `batch_script_user` parameter in the `agent.cfg` file. We strongly recommended that you use a non-root user to run the scripts. Using the root user can result in compromising the data security and operating system security. However, if you want to restore the pemagent to its original settings using a root user to run the scripts, then you must set the `batch_script_user` parameter to `root`.
 
-## Upgrading a PEM server installation
-
-The commands to upgrade the PEM server are platform specific. 
-
-If you want to upgrade a PEM server that's 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, see [Creating an EDB repository on an isolated network](/pem/latest/installing/creating_pem_repository_in_isolated_network/).
-
-### On a CentOS, Rocky Linux, AlmaLinux, or RHEL host
-
-To use an RPM package to upgrade an existing RPM installation, you can use the `yum` package manager to upgrade the installed version of the PEM server on CentOS/RHEL 7.x or Rocky Linux/AlmaLinux/RHEL 8.x:
-
-```shell
-yum upgrade edb-pem
-```
 
-You can also use the `dnf` command on Rocky Linux/AlmaLinux/RHEL 8.x:
-
-```shell
-dnf upgrade edb-pem
-```
-
-!!! Note
-    If you're doing a fresh installation of the PEM server on CentOS or RHEL 7.x host, the installer installs the `edb-python3-mod_wsgi` package along with the installation. The package is a requirement of the operating system. If you're upgrading the PEM server on a CentOS or RHEL 7.x host, the`the edb-python3-mod_wsgi` packages replaces the `mod_wsgi package`  package to meet the requirements of the operating system.
-
-After upgrading the PEM server using yum or the `dnf` command, you must configure the PEM server. For details, see [Configuring the PEM server](#configuring-the-pem-server).
+## Upgrading a PEM server installation
 
-### On a Debian or Ubuntu host
+If you want 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, see [Creating an EDB repository
+on an isolated network](../../installing/creating_pem_repository_in_isolated_network/).
 
-You can use the `apt-get` package manager to upgrade the installed version of the PEM server on supported versions of Debian or Ubuntu:
+To upgrade a PEM server installation:
 
 ```shell
-apt-get upgrade edb-pem
+sudo <package-manager> upgrade edb-pem
 ```
 
-After upgrading the PEM server with `apt-get`, you need to configure the PEM server. For details, see [Configuring the PEM server](#configuring-the-pem-server).
+Where `<package-manager>` is the package manager used with your operating system:
 
-### On a SLES host
+  | Package manager |        Operating system          |
+  | --------------- | -------------------------------- |
+  | dnf             | RHEL 8/9 and derivatives         |
+  | yum             | RHEL 7 and derivatives, CentOS 7 |
+  | zypper          | SLES                             |
+  | apt-get         | Debian and Ubuntu                |
 
-You can use the zypper package manager to upgrade the installed version of the PEM Server on supported versions of a SLES host:
 
-```shell
-zypper update edb-pem
-```
+!!! Note
+    If you're doing a fresh installation of the PEM server on CentOS or RHEL 7.x host, the installer installs the `edb-python3-mod_wsgi` package along with the installation. The package is a requirement of the operating system. If you are upgrading the PEM server on CentOS or RHEL 7.x host, the `edb-python3-mod_wsgi` packages replaces the `mod_wsgi package`  package to meet the requirements of the operating system.
 
-After upgrading the PEM server using zypper, you need to configure the PEM server. For details, see [Configuring the PEM server](#configuring-the-pem-server).
+After upgrading the PEM server, you must configure the PEM server. For detailed information, see [Configuring the PEM server](#configuring-the-pem-server).
 
 !!! Note
-    If you upgrade the PEM backend database server and the PEM server, update the `PG_INSTALL_PATH` and `DB_UNIT_FILE` parameters to point to the new version in the `/usr/edb/pem/share/.install-config` file before you run the configure script.
+    If you upgrade the PEM backend database server and the PEM server, update the `PG_INSTALL_PATH` and `DB_UNIT_FILE` parameters pointing to the new version in the `/usr/edb/pem/share/.install-config` file before you run the configure script.
 
 ## Configuring the PEM server
 
@@ -97,34 +79,18 @@ The configure script uses the values from the old PEM server configuration file
 
 ## Upgrading a PEM agent installation
 
-The commands to upgrade the PEM agent are platform specific. 
-
-### On a CentOS or RHEL host
-
-For CentOS or RHEL 7.x or RHEL 8.x, use the following command:
-
-```shell
-yum upgrade edb-pem-agent
-```
-
-For Rocky Linux or AlmaLinux or RHEL 8.x, you can also use the following command:
+To upgrade a PEM agent:
 
 ```shell
-dnf upgrade edb-pem-agent
+sudo <package-manager> upgrade edb-pem-agent
 ```
 
-### On a Debian or Ubuntu host
+Where `<package-manager>` is the package manager used with your operating system:
 
-For Debian or Ubuntu, use the following command:
+  | Package manager |        Operating system          |
+  | --------------- | -------------------------------- |
+  | dnf             | RHEL 8/9 and derivatives         |
+  | yum             | RHEL 7 and derivatives, CentOS 7 |
+  | zypper          | SLES                             |
+  | apt-get         | Debian and Ubuntu                |
 
-```shell
-apt-get upgrade edb-pem-agent
-```
-
-### On a SLES host
-
-For SLES, use the following command:
-
-```shell
-zypper update edb-pem-agent
-```