Described installing PSMDB pro from tarballs (#822)

* Described installing PSMDB pro from tarballs modified: docs/install/install-pro.md * Update docs/install/tarball.md Co-authored-by: Sandra Romanchenko <53295797+sandraromanchenko@users.noreply.github.com> --------- Co-authored-by: Sandra Romanchenko <53295797+sandraromanchenko@users.noreply.github.com>
percona · Feb 20, 2024 · c1c9ecf · c1c9ecf
1 parent cc226cb
commit c1c9ecf
Show file tree

Hide file tree

Showing 3 changed files with 98 additions and 30 deletions.
diff --git a/docs/install/install-pro.md b/docs/install/install-pro.md
@@ -1,30 +1,42 @@
 # Install Pro packages of Percona Server for MongoDB
 
-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
+## Preconditions
 
-1. Request the access to the pro repository from Percona Support. You will receive the client ID and the access token.
+Request the access to the pro repository from Percona Support. You will receive the client ID and the access token.
 
-2. Configure the repository
+## Install from Percona repository
 
- === "On Debian and Ubuntu"
+=== "On Debian and Ubuntu"
 
-   1. Create the `/etc/apt/sources.list.d/psmdb-pro.list` configuration file with the following contents
+ 1. Configure the repository. Create the `/etc/apt/sources.list.d/psmdb-pro.list` configuration file with the following contents:
 
-  ```ini title="/etc/apt/sources.list.d/psmdb-pro.list"
-  deb http://repo.percona.com/private/[CLIENTID]-[TOKEN]/psmdb-60-pro/apt/ OPERATING_SYSTEM main
-  ```
+  ```ini title="/etc/apt/sources.list.d/psmdb-pro.list"
+  deb http://repo.percona.com/private/[CLIENTID]-[TOKEN]/psmdb-60-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 install -y percona-server-mongodb-pro
+  ```
 
-   2. Update the local cache
+ 4. Start the server
 
-   ```{.bash .data-prompt="$"}
-   $ sudo apt update
-   ```
+  ```{.bash .data-prompt="$"}
+  $ sudo systemctl start mongod
+  ```
 
- === "On RHEL and derivatives"
+=== "On 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-6.0-pro]
@@ -34,22 +46,77 @@ 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
-
- === "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
   ```
 
- === "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 starting with version 6.0.13-10 for the following operating systems:
+
+* Ubuntu 22.04 (Jammy Jellyfish)
+* Red Hat Enterprise Linux 9
+
+### Preconditions
+
+The following packages are required for the installation.
+
+=== "On Debian and Ubuntu"
+
+ * `libcurl4`
+
+  * `libsasl2-modules`
+
+  * `libsasl2-modules-gssapi-mit`
+
+
+=== "On Red hat Enterprise Linux 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-60-pro/tarballs/percona-server-mongodb-pro-{{release}}-x86_64.jammy.tar.gz\
+ $ wget https://repo.percona.com/private/ID-TOKEN/psmdb-60-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
+ ```
+
 
- ```{.bash .data-prompt="$"}
- $ sudo systemct start mongod
- ```
+5. Make sure that you have read and write permissions for the data
+directory and run `mongod`.
diff --git a/docs/install/tarball.md b/docs/install/tarball.md
@@ -39,21 +39,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-6.0/percona-server-mongodb-6.0.2-1/binary/tarball/percona-server-mongodb-6.0.2-1-x86_64.glibc2.17.tar.gz\
- $ wget https://www.percona.com/downloads/percona-server-mongodb-6.0/percona-server-mongodb-6.0.2-1/binary/tarball/percona-mongodb-mongosh-1.6.0-x86_64.tar.gz
+ $ wget https://www.percona.com/downloads/percona-server-mongodb-6.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-6.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-6.0.2-1-x86_64.glibc2.17.tar.gz
- $ tar -xf percona-mongodb-mongosh-1.6.0-x86_64.tar.gz
+ $ tar -xf percona-server-mongodb-{{release}}-x86_64.glibc2.17.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-6.0.2-1/bin/:~/percona-mongodb-mongosh-1.6.0/bin/:$PATH
+ $ export PATH=~/percona-server-mongodb-{{release}}/bin/:~/percona-mongodb-mongosh-{{mongosh}}/bin/:$PATH
  ```
 
 

diff --git a/variables.yml b/variables.yml
@@ -3,4 +3,5 @@
 
 release: '6.0.13-10'
 version: '6.0'
+mongosh: '2.2.1'