From 7e2d8db1937f2e55f2a098d0263f232530fde9df Mon Sep 17 00:00:00 2001 From: Anastasia Alexandrova Date: Wed, 24 Apr 2024 18:32:04 +0300 Subject: [PATCH] Described installing PSMDB pro from tarballs (#852) modified: docs/install/install-pro.md --- docs/install/install-pro.md | 128 +++++++++++++++++++++++++++++------- docs/install/tarball.md | 10 +-- 2 files changed, 108 insertions(+), 30 deletions(-) diff --git a/docs/install/install-pro.md b/docs/install/install-pro.md index 1ec86b7a..f0289e8d 100644 --- 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} \ No newline at end of file diff --git a/docs/install/tarball.md b/docs/install/tarball.md index e236c6ec..aa0b192e 100644 --- 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 ```