Skip to content
logo
Percona Server for MongoDB 6.0
Upgrade from 5.0 to 6.0
Initializing search
    percona/psmdb-docs
    percona/psmdb-docs
    • Home
    • Percona Server for MongoDB feature comparison
      • System requirements
      • Install Percona Server for MongoDB on Debian and Ubuntu
      • Install Percona Server for MongoDB on Red Hat Enterprise Linux and derivatives
      • Install Percona Server for MongoDB from binary tarball
      • Run Percona Server for MongoDB in a Docker container
        • Percona Memory Engine
        • Hot Backup
        • $backupCursor and $backupCursorExtend aggregation stages
        • Authentication overview
        • Enable SCRAM authentication
        • Set up LDAP authentication with SASL
        • Set up x.509 authentication and LDAP authorization
        • Setting up Kerberos authentication
        • AWS IAM authentication
        • Setting up AWS IAM authentication
        • LDAP authorization
        • Set up LDAP authentication and authorization using NativeLDAP
        • Data at rest encryption
        • HashiCorp Vault integration
        • Using the Key Management Interoperability Protocol (KMIP)
        • Local key management using a keyfile
        • Migrate from key file encryption to HashiCorp Vault encryption
      • Auditing
      • Profiling rate limit
      • Log redaction
      • Additional text search algorithm - ngram
      • Tune parameters
        • Upgrade from 5.0 to 6.0
        • Upgrade Percona Server for MongoDB
      • Uninstall Percona Server for MongoDB
      • Release notes index
      • Percona Server for MongoDB 6.0.5-4 (2023-03-29)
      • Percona Server for MongoDB 6.0.4-3 (2023-01-30)
      • Percona Server for MongoDB 6.0.3-2 (2022-12-07)
      • Percona Server for MongoDB 6.0.2-1 (2022-10-31)
    • Glossary
    • Copyright and licensing information
    • Trademark policy

    Upgrading from Percona Server for MongoDB 5.0 to 6.0¶

    To upgrade Percona Server for MongoDB to version 6.0, you must be running version 5.0. Upgrades from earlier versions are not supported.

    Before upgrading your production Percona Server for MongoDB deployments, test all your applications in a testing environment to make sure they are compatible with the new version. For more information, see Compatibility Changes in MongoDB 6.0

    We recommend to upgrade Percona Server for MongoDB from official Percona repositories using percona-release repository management tool and the corresponding package manager for your system.

    This document describes this method for the in-place upgrade (where your existing data and configuration files are preserved).

    Warning

    Perform a full backup of your data and configuration files before upgrading.

    1. Stop the mongod service:

      $ sudo systemctl stop mongod
      
    2. Enable Percona repository for Percona Server for MongoDB 6.0:

      $ sudo percona-release enable psmdb-60
      
    3. Update the local cache:

      $ sudo apt update
      
    4. Install Percona Server for MongoDB 6.0 packages:

      $ sudo apt install percona-server-mongodb
      
    5. Start the mongod instance:

      $ sudo systemctl start mongod
      

    For more information, see Installing Percona Server for MongoDB on Debian and Ubuntu.

    1. Stop the mongod service:

      $ sudo systemctl stop mongod
      
    2. Enable Percona repository for Percona Server for MongoDB 6.0:

      $ sudo percona-release enable psmdb-60
      
    3. Install Percona Server for MongoDB 6.0 packages:

      $ sudo yum install percona-server-mongodb
      
    4. Start the mongod instance:

      $ sudo systemctl start mongod
      

    After the upgrade, Percona Server for MongoDB is started with the feature set of 5.0 version. Assuming that your applications are compatible with the new version, enable 6.0 version features. Run the following command against the admin database:

    > db.adminCommand( { setFeatureCompatibilityVersion: "6.0" } )
    

    See also

    MongoDB Documentation:

    • Upgrade a Standalone
    • Upgrade a Replica Set
    • Upgrade a Sharded Cluster

    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: January 2, 2023
    Created: December 7, 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.