Upgrade MongoDB to version 4.2

Version 5.x of Identity Panel can run with any version of MongoDB 3.6 or later. The following guide provides guidance on upgrading existing Windows installations of MongoDB community edition to the latest version to take advantage of improvements to performance and reliability.

NOTE: If you use Robo 3T and the application is older than version 1.3.1, go to Robomongo.org to download and install the latest version.  Previous versions can be removed via add/remove programs.

Upgrade to 4.2

1. Perform a backup of the existing MongoDB.  Utilize the script at Backing up a MongoDB instance if needed.
2. Go to the MongoDB download center
3. Select Version: 4.2.3, OS: Windows 64 bit, Package: MSI, and download
4. Stop the existing MongoDB service and either disable or delete it
   net stop MongoDB
sc delete MongoDB
   
   
5. Run the 4.2 MSI installer
   1. Choose Setup Type: Custom
   2. Accept the default location, or choose an alternate
   3. Under Service Configuration, choose settings appropriate to the environment being upgraded (**unless you have moved the existing data files, the data folder must not match the existing location): e.g.
      Service Name: MongoDB
      Data Directory: C:\Program Files\SoftwareIDM\IdentityPanelWeb\MongoDB\data\db.4.2
      Log Directory: C:\Program Files\SoftwareIDM\IdentityPanelWeb\MongoDB\log.4.2
   4. Deselect MongoDB compass as it runs as a web installer
6. If you have customized your mongodb.cfg file for IdentityPanel, edit C:\Program Files\MongoDB\4.0\bin\mongod.cfg and copy over any customized values.
7. Verify the new MongoDB service is running:
   
8. cd into the installation bin directory and run mongo.exe
   
9. View the current compatibility version and set it to 4.2 if needed
   db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
db.adminCommand( { setFeatureCompatibilityVersion: "4.2" } )
10. Exit the MongoDB shell quit()
11. Optional: If you would like to utilize the old data files path
    1. Stop the existing MongoDB service 
       net stop MongoDB
    2.  Copy the existing data files from the previous MongoDB instance to a new location.
    3.  Copy the new data files to the desired location.
    4. Modify your mongodb.cfg file for IdentityPanel, edit C:\Program Files\MongoDB\4.0\bin\mongod.cfg  e.g.
       Service Name: MongoDB
       Data Directory: C:\Program Files\SoftwareIDM\IdentityPanelWeb\MongoDB\data\db
       Log Directory: C:\Program Files\SoftwareIDM\IdentityPanelWeb\MongoDB\log
12. Perform a mongorestore to restore the data from the backup performed in Step 1.  Utilize the script at Backing up a MongoDB instance if needed.
13. Start the existing MongoDB service
    net start MongoDB
14. Optional: Uninstall any previous versions of MongoDB via add/remove programs.
15. Open Robo 3T or mongo.exe.
16. Choose the Connect button to setup a new connection to the database.
17. You should see a db instance named idp_<GUID> where you can see and view data elements for your existing Identity Panel.