Described installing PSMDB pro from tarballs (#852)

modified: docs/install/install-pro.md
percona · Apr 24, 2024 · 7e2d8db · 7e2d8db
1 parent b3da2f5
commit 7e2d8db
Show file tree

Hide file tree

Showing 2 changed files with 108 additions and 30 deletions.
diff --git a/docs/install/install-pro.md b/docs/install/install-pro.md
@@ -1,30 +1,43 @@
 # Install Percona Server for MongoDB Pro
 
-This document provides guidelines how to install Percona Server for MongoDB Pro from Percona repositories. [Learn more about Percona Server for MongoDB Pro](../psmdb-pro.md).
+This document provides guidelines how to install Percona Server for MongoDB Pro from Percona repositories and from binary tarballs. [Learn more about Percona Server for MongoDB Pro](../psmdb-pro.md).
 
-## Procedure {.power-number}
+If you already run Percona Server for MongoDB and wish to upgrade to Percona Server for MongoDB Pro, see the [upgrade guide](update-pro.md).
 
-1. Request the access to the Pro builds repository from Percona Support. You will receive the client ID and the access token.
+## Before you start
 
-2. Configure the repository
+Request the access to the pro repository from Percona Support. You will receive the client ID and the access token.
 
-    === ":material-debian: On Debian and Ubuntu"
+## Install from Percona repository
 
-        1. Create the `/etc/apt/sources.list.d/psmdb-pro.list` configuration file with the following contents
+=== ":material-debian: Debian and Ubuntu"
 
-            ```ini title="/etc/apt/sources.list.d/psmdb-pro.list"
-            deb http://repo.percona.com/private/[CLIENTID]-[TOKEN]/psmdb-70-pro/apt/ OPERATING_SYSTEM main
-            ```
+    1. Configure the repository. Create the `/etc/apt/sources.list.d/psmdb-pro.list` configuration file with the following contents:
 
-        2. Update the local cache
+        ```ini title="/etc/apt/sources.list.d/psmdb-pro.list"
+        deb http://repo.percona.com/private/[CLIENTID]-[TOKEN]/psmdb-70-pro/apt/ OPERATING_SYSTEM main
+        ```
+
+    2. Update the local cache
+
+        ```{.bash .data-prompt="$"}
+        $ sudo apt update
+        ```
+
+    3. Install Percona Server for MongoDB Pro packages
 
-            ```{.bash .data-prompt="$"}
-            $ sudo apt update
-            ```
+        ```{.bash .data-prompt="$"}
+        $ sudo apt install -y percona-server-mongodb-pro
+        ```
 
-    === ":material-redhat: On RHEL and derivatives"
+    4. Start the server
+
+        ```{.bash .data-prompt="$"}
+        $ sudo systemctl start mongod
+        ```
+=== ":material-redhat: RHEL and derivatives"
 
-        Create the `/etc/yum.repos.d/psmdb-pro.repo` configuration file with the following contents
+    1. Configure the repository. Create the `/etc/yum.repos.d/psmdb-pro.repo` configuration file with the following contents:
 
         ```ini title="/etc/yum.repos.d/psmdb-pro.repo"
         [psmdb-7.0-pro]
@@ -34,22 +47,87 @@ This document provides guidelines how to install Percona Server for MongoDB Pro
         gpgkey = https://repo.percona.com/yum/PERCONA-PACKAGING-KEY
         ```
 
-3. Install Percona Server for MongoDB Pro packages
-
-    === ":material-debian: On Debian and Ubuntu"
+    2. Install Percona Server for MongoDB Pro packages
 
         ```{.bash .data-prompt="$"}
-        $ sudo apt install -y percona-server-mongodb-pro
+        $ sudo yum install -y percona-server-mongodb-pro
         ```
-
-    === ":material-redhat: On RHEL and derivatives"
+        
+    3. Start the server
 
         ```{.bash .data-prompt="$"}
-        $ sudo yum install -y percona-server-mongodb-pro
+        $ sudo systemctl start mongod
         ```
 
-4. Start the server
+## Install from binary tarballs
+
+Binary tarballs are available for the following operating systems:
+
+Starting with version 7.0.7-4:
+
+* Ubuntu 22.04 (Jammy Jellyfish)
+* Red Hat Enterprise Linux 9
+* Debian 12 (bookworm)
+
+Starting with version 7.0.8-5
+
+* Red Hat Enterprise Linux 8
+
+### Preconditions
+
+The following packages are required for the installation.
 
-    ```{.bash .data-prompt="$"}
-    $ sudo systemctl start mongod
+=== ":material-debian: On Debian and Ubuntu"
+
+     * `libcurl4`
+
+     * `libsasl2-modules`
+
+     * `libsasl2-modules-gssapi-mit`
+
+
+=== ":material-redhat: On RHEL and derivatives"
+
+     * `libcurl`
+
+     * `cyrus-sasl-gssapi`
+
+     * `cyrus-sasl-plain`
+
+### Procedure
+
+The steps below describe the installation on Ubuntu 22.04.
+
+1. Download the tarballs from the pro repository 
+
+    ```{.bash data-prompt="$"}
+    $ wget https://repo.percona.com/private/ID-TOKEN/psmdb-70-pro/tarballs/percona-server-mongodb-pro-{{release}}-x86_64.jammy.tar.gz\
+    $ wget https://repo.percona.com/private/ID-TOKEN/psmdb-70-pro/tarballs/percona-mongodb-mongosh-{{mongosh}}-x86_64.tar.gz
+    ```
+2. Extract the tarballs
+
+    ```{.bash data-prompt='$'} 
+    $ tar -xf percona-server-mongodb-{{release}}-x86_64.jammy.tar.gz
+    $ tar -xf percona-mongodb-mongosh-{{mongosh}}-x86_64.tar.gz
+    ```
+
+3. Add the location of the binaries to the `PATH` variable:
+
+    ```{.bash data-prompt="$"}
+    $ export PATH=~/percona-server-mongodb-pro-{{release}}-x86_64.jammy/bin/:~/percona-mongodb-mongosh-{{mongosh}}/bin/:$PATH
+    ```
+
+
+4. Create the default data directory:
+
+    ```{.bash data-prompt="$"}
+    $ mkdir -p /data/db
     ```
+
+
+5. Make sure that you have read and write permissions for the data
+directory and run `mongod`.
+
+## Next steps
+
+[Connect to MongoDB :material-arrow-right:](../connect.md){.md-button}
diff --git a/docs/install/tarball.md b/docs/install/tarball.md
@@ -40,21 +40,21 @@ The steps below describe the installation on Debian 10 (“buster”).
 1. Fetch and the binary tarballs:
 
     ```{.bash data-prompt="$"}
-    $ wget https://www.percona.com/downloads/percona-server-mongodb-7.0/percona-server-mongodb-7.0.2-1/binary/tarball/percona-server-mongodb-7.0.2-1-x86_64.glibc2.17.tar.gz\
-    $ wget https://www.percona.com/downloads/percona-server-mongodb-7.0/percona-server-mongodb-7.0.2-1/binary/tarball/percona-mongodb-mongosh-2.0.0-x86_64.tar.gz
+    $ wget https://www.percona.com/downloads/percona-server-mongodb-7.0/percona-server-mongodb-{{release}}/binary/tarball/percona-server-mongodb-{{release}}-x86_64.glibc2.17.tar.gz\
+    $ wget https://www.percona.com/downloads/percona-server-mongodb-7.0/percona-server-mongodb-{{release}}/binary/tarball/percona-mongodb-mongosh-{{mongosh}}-x86_64.tar.gz
     ```
 2. Extract the tarballs
 
     ```{.bash data-prompt='$'} 
-    $ tar -xf percona-server-mongodb-7.0.2-1-x86_64.glibc2.17.tar.gz
-    $ tar -xf percona-mongodb-mongosh-2.0.0-x86_64.tar.gz
+    $ tar -xf percona-server-mongodb-{{release}}-x86_64.glibc2.17.tar.gz
+    $ tar -xf percona-mongodb-mongosh-{{release}}-x86_64.tar.gz
     ```
 
 
 3. Add the location of the binaries to the `PATH` variable:
 
     ```{.bash data-prompt="$"}
-    $ export PATH=~/percona-server-mongodb-7.0.2-1/bin/:~/percona-mongodb-mongosh-2.0.0/bin/:$PATH
+    $ export PATH=~/percona-server-mongodb-{{release}}/bin/:~/percona-mongodb-mongosh-{{mongosh}}/bin/:$PATH
     ```