Skip to main content

Manual in-place upgrade of the ProfileUnity 6.8.x MongoDB 4.0.0 Instance

Steven Hajek
  • Created:
  • Updated:

This KB covers the process that can be used to manually upgrade the bundled MongoDB instance installed along with the ProfileUnity Console.

You can find automated upgraders in the console upgrade guide or in the hotfix list.

NOTES:

  • From ProfileUnity version 6.8.0 and newer, until 6.8.5, MongoDB is version 4.0.0. This means that you can only upgrade directly to a 4.0.x or a 4.2.x release, NOT directly to 4.4.x.  The latest direct upgrade version available at the time of writing is 4.2.17.  After upgrading to 4.2.x, you can then upgrade to 4.4.x.  *MongoDB 4.4.x supports only Server 2016 and higher OS versions!
  • You must know the prou_services password.
  • This process also works on an existing cluster and still allows for future cluster operations, like adding/removing nodes. It was tested with full downtime - upgrading all nodes in the cluster at the same time to 4.2.17 and then bringing it down and doing it again for 4.4.10.
  • If clustered, to find the PRIMARY node on which to run the setFeatureCompatibilityVersion command, first run the replicaSet status command: 
    "C:\Program Files\MongoDB\bin\mongo.exe" -u prou_services -p --authenticationDatabase admin --eval "printjson(rs.status())"

 

INSTRUCTIONS:

  1. Using the Database section of the Administration screen, take a backup of the database and download it now for safe keeping.
  2. Shutdown, take a snapshot of the ProfileUnity Console server(s) and boot it back up.
  3. Using Services.msc, in order, stop the Liquidware Labs ProfileUnity, FlexDisk and MongoDB services.
  4. Download and install MongoDB Community 4.2.17
    1. Select the Complete option
    2. Uncheck Install MongoD as a Service
    3. Uncheck Install MongoDB Compass
  5. Navigate to C:\Program Files\MongoDB, and from within there:
    1. Rename the bin folder to bin_4.0.0 to save a backup.
    2. Move the bin folder from C:\Program Files\MongoDB\Server\4.2 into C:\Program Files\MongoDB
  6. Using Services.msc, in order, start the MongoDB, Liquidware Labs ProfileUnity and FlexDisk services.
  7. From a cmd.exe prompt, run the following command and provide the prou_services password when prompted: (MUST BE RUN ON PRIMARY NODE IF CLUSTERED) 
    "C:\Program Files\MongoDB\bin\mongo.exe" -u prou_services -p --authenticationDatabase admin --eval "db.adminCommand( { setFeatureCompatibilityVersion: '4.2' } )"

*Make sure the output from the above command returns an "ok" before proceeding!
mceclip0.png

ProfileUnity is now running on MongoDB 4.2.x.

  • If you are doing this on a cluster, make sure all nodes are up and working prior to moving to the next version.

If you need to upgrade to 4.4.x, please continue below.

  1. Using Services.msc, in order, stop the Liquidware Labs ProfileUnity, FlexDisk and MongoDB services.
  2. Download and install MongoDB Community 4.4.10 (latest at time of writing)
    1. Select the Complete option
    2. Uncheck Install MongoD as a Service
    3. Uncheck Install MongoDB Compass
  3. Navigate to C:\Program Files\MongoDB, and from within there:
    1. Rename the bin folder to bin_4.2.17 to save a backup.
    2. Move the bin folder from C:\Program Files\MongoDB\Server\4.4 into C:\Program Files\MongoDB
  4. Using Services.msc, in order, start the MongoDB, Liquidware Labs ProfileUnity and FlexDisk services.
  5. From a cmd.exe prompt, run the following command and provide the prou_services password when prompted: (MUST BE RUN ON PRIMARY NODE IF CLUSTERED) 
    "C:\Program Files\MongoDB\bin\mongo.exe" -u prou_services -p --authenticationDatabase admin --eval "db.adminCommand( { setFeatureCompatibilityVersion: '4.4' } )"

*Make sure the output from the above command returns an "ok" before proceeding!

6. To go to Mongo 4.4.14 you can get MSI here:

Update: Download link for 4.4.14

https://fastdl.mongodb.org/windows/mongodb-windows-x86_64-4.4.14-signed.msi

The steps listed above 1-5 should be followed to go from 4.4.10 to 4.4.14 just changing the version as specific to the current version of Mongo going from and to (ie.  bin folder).

 

ProfileUnity is now running on MongoDB 4.4.x. 

 

Now proceed with old version cleanup.

  1. Navigate to "C:\Program Files\MongoDB" and delete the "Server" folder.
  2. In regedit.exe, browse to "HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall" and find+delete the Keys containing the "DisplayName" Value matching the 4.0.0 and 4.2.x MongoDB installations. 
    • For MongoDB 4.0.0, the Key name is "{4E74B290-E888-415D-9192-53D31CA828E3}".
    • For MongoDB 4.2.17, the Key name is "{F88BC1B0-3E51-4799-9DD2-5F844A052417}".

      mceclip4.png

 

Product: ProfileUnity-FlexApp

Product Version: 6.8.0-6.8.4

 

Related articles