diff --git a/docs/install/install-pro.md b/docs/install/install-pro.md index 6cf69b59..4d020a65 100644 --- 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 - ``` \ No newline at end of file +5. Make sure that you have read and write permissions for the data +directory and run `mongod`. \ No newline at end of file diff --git a/docs/install/tarball.md b/docs/install/tarball.md index dc886d74..c018d5cc 100644 --- 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 index 3c503c8d..be0b6640 100644 --- a/variables.yml +++ b/variables.yml @@ -3,4 +3,5 @@ release: '6.0.13-10' version: '6.0' +mongosh: '2.2.1'