Skip to content
logo
Percona Distribution for MongoDB 4.4
Install Percona Distribution for MongoDB
Initializing search
    percona/distmongo-docs
    percona/distmongo-docs
    • Home
      • Release notes index
      • Percona Distribution for MongoDB 4.4.25 (2023-10-16)
      • Percona Distribution for MongoDB 4.4.24 (2023-09-11)
      • Percona Distribution for MongoDB 4.4.23 (2023-08-14)
      • Percona Distribution for MongoDB 4.4.22 (2023-06-06)
      • Percona Distribution for MongoDB 4.4.21 (2023-05-09)
      • Percona Distribution for MongoDB 4.4.19 (2023-03-20)
      • Percona Distribution for MongoDB 4.4.18 (2022-12-19)
      • Percona Distribution for MongoDB 4.4.17 (2022-11-10)
      • Percona Distribution for MongoDB 4.4.16 (2022-08-30)
      • Percona Distribution for MongoDB 4.4.15 (2022-07-19)
      • Percona Distribution for MongoDB 4.4.14 (2022-05-25)
      • Percona Distribution for MongoDB 4.4.13 (2022-03-23)
      • Percona Distribution for MongoDB 4.4.12 (2022-02-07)
      • Percona Distribution for MongoDB 4.4.10 (2021-11-10)
      • Percona Distribution for MongoDB 4.4.9 (2021-10-07)
      • Percona Distribution for MongoDB 4.4.8 (2021-08-16)
      • Percona Distribution for MongoDB 4.4.6 (2021-06-01)
      • Percona Distribution for MongoDB 4.4.5 (2021-04-19)
      • Percona Distribution for MongoDB 4.4.4 (2021-02-25)
      • Percona Distribution for MongoDB 4.4.3 (2021-01-28)
      • Percona Distribution for MongoDB 4.4.2 (2020-12-01)
      • Percona Distribution for MongoDB 4.4.1 Update (2020-10-09)
      • Percona Distribution for MongoDB 4.4.1 (2020-09-24)
      • Percona Distribution for MongoDB 4.4.0 (2020-08-26)
      • Install Percona Distribution for MongoDB
        • Uninstall Percona Distribution for MongoDB
      • Repository overview
      • Minor upgrade of Percona Distribution for MongoDB
      • Copyright and licensing
      • Trademark policy

    • Uninstall Percona Distribution for MongoDB

    Install Percona Distribution for MongoDB¶

    We recommend to install Percona Distribution for MongoDB from Percona repositories using the package manager of your operating system. Find the list of supported Linux distributions on the Percona Software and Platform Lifecycle page.

    Alternatively, you can download Percona Distribution for MongoDB from Percona website and install it manually from binary tarballs.

    Choose how you wish to install Percona Distribution for MongoDB:

    Run the following commands as root or by using the sudo command.

    1. Install percona-release

      Install the percona-release repository management tool to subscribe to Percona repositories:

      • Install curl
      $ sudo apt update
      $ sudo apt install curl
      
      • Download the percona-release package
      $ curl -O https://repo.percona.com/apt/percona-release_latest.generic_all.deb
      
      • Install the package and dependancies
      $ sudo apt install gnupg2 lsb-release ./percona-release_latest.generic_all.deb
      
      • Refresh the local cache
      $ supo apt update
      
    2. Enable the repository

      Percona provides two repositories for Percona Distribution for MongoDB. To enable a repo, we recommend using the setup command:

      $ sudo percona-release setup pdmdb-4.4
      
    3. Install Percona Distribution for MongoDB packages

      $ sudo apt install percona-server-mongodb percona-backup-mongodb
      

    Run the following commands as root or by using the sudo command.

    1. Install percona-release

      Install the percona-release repository management tool to subscribe to Percona repositories:

      $ sudo yum install -y https://repo.percona.com/yum/percona-release-latest.noarch.rpm
      
    2. Enable the repository

      Percona provides two repositories for Percona Distribution for MongoDB. To enable a repo, we recommend using the setup command:

      $ sudo percona-release setup pdmdb-4.4
      
    3. Install Percona Distribution for MongoDB packages

      $ sudo yum install percona-server-mongodb percona-backup-mongodb
      

    You can find binary tarballs on the Percona software downloads page

    1. Select Generic Linux from the dropdown.

    2. Download binary tarballs. Replace the <version> variable with the desired version:

      $ wget https://downloads.percona.com/downloads/percona-distribution-mongodb-4.4/percona-distribution-mongodb-<version>/binary/tarball/percona-backup-mongodb-<version>-x86_64.tar.gz
      $ wget https://downloads.percona.com/downloads/percona-distribution-mongodb-4.4/percona-distribution-mongodb-<version>/binary/tarball/percona-server-mongodb-<version>-x86_64.glibc2.17.tar.gz
      
    3. Extract the tarballs

      $ tar -xf percona-backup-mongodb-<version>-x86_64.tar.gz
      $ tar -xf percona-server-mongodb-<version>-x86_64.glibc2.17.tar.gz
      
    4. Export the location of the binaries to the PATH variable

      For example, if you’ve extracted the tarballs to your home directory, the commands would be the following:

      $ export PATH=~/percona-backup-mongodb-<version>/:~/percona-server-mongodb-<version>/:$PATH
      
    5. Create the default data directory for Percona Server for MongoDB:

      $ sudo mkdir -p /data/db
      
    6. Check that you have read and write permissions for the data directory and run mongod.

    Deploy and run Percona Distribution for MongoDB on Kubernetes with Percona Operator for MongoDB. See Quickstart guides for the installation instructions on your favorite Kubernetes flavor.

    To set up monitoring of your Percona Distribution for MongoDB in PMM, see Set up PMM to monitor MongoDB

    Uninstall Percona Distribution for MongoDB¶

    To uninstall Percona Distribution for MongoDB, remove the packages using the package manager of your operation system. Optionally, disable Percona repository.

    See also

    • Uninstall Percona Server for MongoDB

    • Uninstall Percona Backup for MongoDB

    Contact Us

    For free technical help, visit the Percona Community Forum.

    To report bugs or submit feature requests, open a JIRA ticket.

    For paid support and managed or consulting services , contact Percona Sales.


    Last update: April 3, 2023
    Created: December 9, 2022
    Percona LLC and/or its affiliates, © 2023
    Made with Material for MkDocs

    Cookie consent

    We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better. Read more about Percona Cookie Policy.