Install Percona Server for MongoDB from binary tarball

You can find links to the binary tarballs under the Generic Linux menu item on the Percona website

There are the following tarballs available:

• percona-server-mongodb-6.0.27-21-x86_64.<operating-system>.tar.gz is the tarball for a supported operating system.

• percona-mongodb-mongosh-2.5.1-x86_64.tar.gz is the tarball for mongosh shell.

Note that tarballs are available only for the x86_64 architecture.

Tarball types

Type	Name	Description
Full	percona-server-mongodb-6.0.27-21-x86_64..tar.gz	Contains binaries and libraries
Minimal	percona-server-mongodb-6.0.27-21-x86_64.-minimal.tar.gz	Contains binaries and libraries without debug symbols
Checksum	percona-server-mongodb-6.0.27-21-x86_64.-minimal.tar.gz.sha256sum	Contains the MD5 checksum to verify the integrity of the files after the extraction

Preconditions

Install the following dependencies required to install Percona Server for MongoDB from tarballs.

RHEL and derivatives Ubuntu Debian

sudo yum install openldap cyrus-sasl-gssapi curl

Update the repositories and install the required packages:

sudo apt update
sudo apt install curl libsasl2-modules-gssapi-mit

Update the repositories and install the required packages:

sudo apt update
sudo apt install curl libsasl2-modules-gssapi-mit

Procedure

The following steps show how to install Percona Server for MongoDB from a tarball.

Red Hat and derivatives Debian and Ubuntu

The following steps describe how to install Percona Server for MongoDB on Oracle Linux 9.0. They use the tarball package built for this operating system.

If you are running a different operating system, you must download the tarball built for that OS version and replace its name and paths in the commands below.

1. Fetch the binary tarballs:

   curl -O https://downloads.percona.com/downloads/percona-server-mongodb-8.0/percona-server-mongodb-6.0.27-21/binary/tarball/percona-server-mongodb-6.0.27-21-x86_64.ol9.tar.gz
   curl -O https://downloads.percona.com/downloads/percona-server-mongodb-8.0/percona-server-mongodb-6.0.27-21/binary/tarball/percona-mongodb-mongosh-2.5.1-x86_64.tar.gz
   

2. Extract the tarballs

   tar -xf percona-server-mongodb-6.0.27-21-x86_64.ol9.tar.gz
   tar -xf percona-mongodb-mongosh-2.5.1-x86_64.tar.gz
   

3. Add the location of the binaries to the PATH variable:

   export PATH=~/percona-server-mongodb-6.0.27-21-x86_64.ol9/bin/:~/percona-mongodb-mongosh-2.5.1-x86_64/bin/:$PATH
   

4. Create the default data directory:

   sudo mkdir -p /data/db
   

5. The new TCMalloc requires Restartable Sequences (rseq) to implement per-CPU caches . To ensure that TCMalloc can use rseq, prevent glibc from registering an rseq structure. To do this, set the following environment variable:

```bash GLIBC_TUNABLES=glibc.pthread.rseq=0 export GLIBC_TUNABLES

1. Make sure that you have read and write permissions for the data directory and run mongod.

The following steps describe how to install Percona Server for MongoDB on Ubuntu 22.04 (Jammy Jellyfish). They use the tarball package built for this operating system.

If you are running a different operating system, you must download the tarball built for that OS version and replace its name and paths in the commands below.

1. Fetch the binary tarballs:

   curl -O https://downloads.percona.com/downloads/percona-server-mongodb-8.0/percona-server-mongodb-6.0.27-21/binary/tarball/percona-server-mongodb-6.0.27-21-x86_64.jammy.tar.gz
   curl -O https://downloads.percona.com/downloads/percona-server-mongodb-8.0/percona-server-mongodb-6.0.27-21/binary/tarball/percona-mongodb-mongosh-2.5.1-x86_64.tar.gz
   

2. Extract the tarballs

   tar -xf percona-server-mongodb-6.0.27-21-x86_64.jammy.tar.gz
   tar -xf percona-mongodb-mongosh-2.5.1-x86_64.tar.gz
   

3. Add the location of the binaries to the PATH variable:

   export PATH=~/percona-server-mongodb-6.0.27-21-x86_64.jammy/bin/:~/percona-mongodb-mongosh-2.5.1-x86_64/bin/:$PATH
   

4. Create the default data directory:

   mkdir -p /data/db
   

5. The new TCMalloc requires Restartable Sequences (rseq) to implement per-CPU caches . To ensure that TCMalloc can use rseq, prevent glibc from registering an rseq structure. To do this, set the following environment variable:

   GLIBC_TUNABLES=glibc.pthread.rseq=0
   export GLIBC_TUNABLES
   

6. Make sure that you have read and write permissions for the data directory and run mongod.

Next steps

Connect to MongoDB