Update MongoDB for Unifi Network Application 8

I was trying to update MongoDB from 3.6 to 4.4 since the Unifi network app supports it now, and it’ll get rid of those pesky GPG errors from APT.

Make sure you have a backup before starting, especially of /usr/lib/unifi/data/db.

Upgrade Steps

You will need to iterate though each major version of MongoDB, e.g. 3.6 -> 4.0 -> 4.2 -> 4.4.

  1. Edit the APT repo

     nano /etc/apt/sources.list.d/mongodb-org-3.6.list
    

    Comment out the old one and add the new version, you will probably have to use [allow-insecure=yes] since the certificate has expired and APT doesn’t like that.

     #deb [signed-by=/usr/share/keyrings/mongodb-org-server-3.6-archive-keyring.gpg] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/3.6 multiverse
    
     deb [allow-insecure=yes] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/4.0 multiverse
    

    Remember you will need to iterate though every version, so you will need to change the 4.0 to 4.2, then 4.4, after each upgrade.

  2. Update APT

     apt update
     apt upgrade
     # You will need this for the next step too:
     apt install mongodb-org-shell
    
  3. Start mongod with the Unifi database

     screen mongod --dbpath /usr/lib/unifi/data/db
    

    Then detach the screen session so it runs in the background: Ctrl+A, then D

  4. Upgrade the Mongo database

    Open a mongo shell, (using mongo shell) and follow the official upgrade guide.

    For example, I did this for version 4.0:

     db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
    
     db.adminCommand( { setFeatureCompatibilityVersion: "4.0" } ) 
    
     db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
    
  5. Stop mongod from earlier

     screen -r
    

    Then type Ctrl+C, to stop it.

  6. Restart from the beginning for the next version, until you get to your desired version.

Final Steps

  1. Fix up the APT repo for version 4.4

    This will get rid of those GPG/verification errors.

     wget -qO- https://www.mongodb.org/static/pgp/server-4.4.asc \
     | gpg --dearmor -o /etc/apt/trusted.gpg.d/mongodb-org-server-4.4-archive-keyring.gpg
    
     echo "deb [arch=amd64,arm64 signed-by=/etc/apt/trusted.gpg.d/mongodb-org-server-4.4-archive-keyring.gpg] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/4.4 multiverse" \
     | tee /etc/apt/sources.list.d/mongodb-org-4.4.list
    
     rm /etc/apt/sources.list.d/mongodb-org-3.6.list
    
  2. Fix permissions (optional)

    If Unifi isn’t starting, and you are getting permission denied errors in the mongo logs (tail -f /var/log/unifi/mongod.log), you may need to chown back to the unifi user.

    For example:

     chown -R unifi:unifi /usr/lib/unifi/data/db
    

Thanks for reading!
Steve.


This site doesn't use any Google services, read more here.
If I helped you please buy me a croissant or sponsor me on GitHub.

© Stephen Horvath 2023