Install Pro packages of Percona Server for MongoDB¶
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.
If you already run Percona Server for MongoDB and wish to upgrade to Percona Server for MongoDB Pro, see the upgrade guide.
Get the access token to the Pro repository¶
As a Percona Customer, you have the access to the ServiceNow portal. To request the access token, do the following:
- In ServiceNow, click My Account and select Entitlements.
- Select your entitlement.
-
If you are entitled for Pro builds, you will see the Token Management widget. Click the Get Percona Builds Token button.
If you don’t see the widget, contact Percona Support.
-
Click Request Token button in the Request a Percona Pro Builds Token dialog window.
- A token will be generated for you. You will also see the Customer ID. Copy both the Customer ID and the token as you will use them to configure the Pro repository and install the software.
Install from Percona repository¶
-
Install
percona-release
repository management tool. Fetchpercona-release
packages from Percona web:$ wget https://repo.percona.com/apt/percona-release_latest.$(lsb_release -sc)_all.deb
-
Install the downloaded package with dpkg:
$ sudo dpkg -i percona-release_latest.$(lsb_release -sc)_all.deb
-
Update the local cache
$ sudo apt update
-
Enable the repository. Choose your preferable method:
Run the following command and pass your credentials to the Pro repository:
$ sudo percona-release enable psmdb-60-pro release --user_name=<Your Customer ID> --repo_token=<Your PRO repository token>
-
Create the
/root/.percona-private-repos.config
configuration file with the following content:/root/.percona-private-repos.config[psmdb-60-pro] USER_NAME=<Your Customer ID> REPO_TOKEN=<Your PRO repository token>
-
Enable the repository
$ sudo percona-release enable psmdb-60-pro release
-
-
Install Percona Server for MongoDB Pro packages:
$ sudo apt install -y percona-server-mongodb-pro
-
Start the server
$ sudo systemctl start mongod
-
Install
percona-release
using the following command:$ sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
-
Enable the repository. Choose your preferable method:
Run the following command and pass your credentials to the Pro repository:
$ sudo percona-release enable psmdb-60-pro release --user_name=<Your Customer ID> --repo_token=<Your PRO repository token>
-
Create the
/root/.percona-private-repos.config
configuration file with the following content:/root/.percona-private-repos.config[psmdb-60-pro] USER_NAME=<Your Customer ID> REPO_TOKEN=<Your PRO repository token>
-
Enable the repository
$ sudo percona-release enable psmdb-60-pro release
-
-
Install Percona Server for MongoDB Pro packages:
$ sudo yum install -y percona-server-mongodb-pro
-
Start the server
$ sudo systemctl start mongod
Install from binary tarballs¶
Binary tarballs are available for the following operating systems:
Starting with version 6.0.13-10:
- Ubuntu 22.04 (Jammy Jellyfish)
- Red Hat Enterprise Linux 9
Starting with 6.0.14-11:
- Red Hat Enterprise Linux 8
Preconditions¶
The following packages are required for the installation.
-
libcurl4
-
libsasl2-modules
-
libsasl2-modules-gssapi-mit
-
libcurl
-
cyrus-sasl-gssapi
-
cyrus-sasl-plain
Procedure¶
The steps below describe the installation on Ubuntu 22.04.
-
Download the tarballs from the pro repository
2. Extract the tarballs$ wget https://repo.percona.com/private/ID-TOKEN/psmdb-60-pro/tarballs/percona-server-mongodb-6.0.24-19/percona-server-mongodb-pro-6.0.24-19-x86_64.jammy.tar.gz \ $ wget https://repo.percona.com/private/ID-TOKEN/psmdb-60-pro/tarballs/percona-mongodb-mongosh-2.5.0/percona-mongodb-mongosh-2.5.0-x86_64.tar.gz
$ tar -xf percona-server-mongodb-6.0.24-19-x86_64.jammy.tar.gz $ tar -xf percona-mongodb-mongosh-2.5.0-x86_64.tar.gz
-
Add the location of the binaries to the
PATH
variable:$ export PATH=~/percona-server-mongodb-pro-6.0.24-19-x86_64.jammy/bin/:~/percona-mongodb-mongosh-2.5.0/bin/:$PATH
-
Create the default data directory:
$ mkdir -p /data/db
-
Make sure that you have read and write permissions for the data directory and run
mongod
.
Next steps¶
Run Percona Server for MongoDB Pro in Docker¶
You can run Percona Server for MongoDB Pro in Docker using the official image available in a private registry on Docker Hub.
We gather Telemetry data to understand the use of the software and improve our products.x
To access this image, you must authenticate in DockerHub. For this you must have a valid Percona Server for MongoDB Pro subscription.
Authenticate in Docker Hub¶
- Contact your Percona Representative to get authentication credentials for Docker Hub. You will receive a username and an access token.
-
Authenticate in Docker Hub:
$ docker login --username <Username>
When prompted for a password, enter your access token.
Run Percona Server for MongoDB Pro¶
To run Percona Server for MongoDB Pro in Docker, use the following command:
$ docker run -d --name psmdb-pro -p 27017:27017 --restart always percona/percona-server-mongodb-pro:<TAG>
The command does the following:
-
The
docker run
command instructs thedocker
daemon to run a container from an image. -
The
-d
option starts the container in detached mode (that is, in the background). -
The
--name
option assigns a custom name for the container that you can use to reference the container within a Docker network. In this case:psmdb-pro
. -
The
-p
option binds the container’s port27017
to TCP port27017
on all host network interfaces. This makes the container accessible externally. -
The
--restart
option defines the container’s restart policy. Setting it toalways
ensures that the Docker daemon will start the container on startup and restart it if the container exits. -
percona/percona-server-mongodb-pro
is the name of the image to derive the container from. -
<TAG>
is the tag specifying the version you need. For example,6.0.24-19
. Docker automatically identifies the architecture (x86_64 or ARM64) and pulls the respective image. See the full list of tags.
Access the container shell¶
Run the following command to start the bash session and run commands inside the container:
$ docker exec -it <container-name>
where <container-name>
is the name of your database container.
For example, to connect to Percona Server for MongoDB, run:
$ mongosh