Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Info

Summary

This article is a step-through guide for backing up and restoring your existing records in MongoDB before updating to the latest version. (Note:Visual examples can be enlarged for better viewing by clicking the images. The MongoDB Compass visual examples shown in this article will be based on the interface of version 1.45.0)

Backing up and Restoring using .bat files

  1. Download and unzip the GEOJobe-Products-MongoDB-Backup-Restore.zip file into a directory on the server.

  2. Extract Once this folder has been unzipped, extract the mongodb-database-tools-windows-x86_64-100.5.2.zip file (located inside of the unzipped GEOJobe-Products-MongoDB-Backup-Restore) to a designated folder. These include the This folder will contain the following mongo commands: mongoimport and mongoexport commands.

  3. You will need to add the extracted bin directory to your PATH environment variable in order to access the mongoimport and mongoexport files. An example path AND instructions for setting the environment variable are shown below:

    Code Block
    Example path:
    C:\Users\YourUser\Downloads\GEOJobe-Products-MongoDB-Backup-Restore\mongodb-database-tools-windows-x86_64-100.5.2\bin
    1. Open The your Windows Control Panel.

    2. In the ‘System and Security’ category, click ‘System’

      test.pngImage Added

    3. Click ‘Advanced “Advanced System Settings’Settings”. The ‘System Properties’ modal will display.Click ‘Environment Variables’

      image-20250107-155910.pngImage Added

    4. Once the modal for ‘System Properties’ appear, click ‘Environment Variables’ button (located in the Advanced tab of System Properties).

    5. In the ‘System Variables’ section, select the ‘Path’ variable and click the ‘Edit’ button. The ‘Edit Environment Variable' modal will display.Click

      image-20250108-165134.pngImage Added
    6. In the ‘Edit Environment Variable’ modal, click ‘New’ and add the filepath for of the location you placed the unzippedmongodb-database-tools-windows-x86_64-100.5.2.

    7. Click ‘Ok’ on each of the modals to confirm your changes.

  4. In Next, open the command prompt, navigate and do the following:

    1. Navigate to the filepath where the extracted Backup-Restore directory

    and run
    1. is located,

    2. Run the following command(s) to the respective GEO Jobe product(s) that you currently own:

      1. at-export.bat,

      2. bmo-export.bat,

      3. cmo-export.bat, and/or

      4. scheduler-export.bat

    for each product you own.
      1. Note:If you have previously created your JSON collection files from another server, copy them into the/bmocollections and /cmocollections directories respectively instead of running the export file.

  5. Verify that the collections JSON in the/atcollections, /bmocollections, and/or /cmocollections directories have JSON files.

  6. Install your new version of MongoDB version.

  7. Run the at-import.bat, bmo-import.bat,cmo-import.batand/or scheduler-import.batto restore the database collections respectively.

  8. Install the Admin Tools, BackupMyOrg, CleanMyOrg and/or Scheduler applications to their previous file locations (if needed).

This should be all you need to migrate your data. If you wish to migrate the data manually, see the steps below.

...

...

Manually Restoring BackupMyOrg Database and Application

  1. If MongoDB is not installed:

    1. Copy your collection JSONs from the backup to directories such as D:\bmocollections and D:\cmocollections.

      1. Note: Copy all collections, even if it’s not the one you are restoring. Updating MongoDB will clear all of your collections in the update process.

    2. Install the latest MongoDB Community on the new machine, be sure AND ensure to click the checkbox to download MongoDBCompass as well.After installation, open MongoDBCompass..

    3. Open MongoDB Compass once installation is complete.

  2. In MongoDB Compass, connect to the server where your GEO Jobe products are located in.

    1. Enter the server URI containing your GEO Products, such as mongodb://localhost:<port>/ .

    2. Click the ‘Save & Connect’ button, or the ‘Connect’ button (if the connection already exists).

      image-20250109-145327.pngImage Added

  3. Click on the Create Database button and type in‘Create Database’ button (upper right-corner of your connection’s home page) and type into modal:

    1. Database Name: BackupMyOrg

    2. Collection Name: BackupReports

    Image RemovedClick on
    1. image-20250109-154140.pngImage Added

  4. First, locate and select the newly created BackupMyOrg database (found in the left panel inside or Connections panel). In the expanded BackupMyOrg database, locate and select the BackupReports collection. Then, click the Add Data button; then the Import File button. Select ‘Add Data’ button and click ‘Import JSON or CSV file’ button. A pop-up modal will appear where you will locate and select the D:\bmocollections\BackupReports.json file. The input file type should be JSON.

    Image Removedimage-20250109-163815.pngImage Added

  1. On the left panel, next to the

...

  1. CleanMyOrg database, click the plus icon

...

  1. ➕ for the ‘Create a Collection’ modal to appear.

    Image Added

  2. On the

...

  1. ‘Create Collection’ Modal, enter the next collection name (listed below) and confirm by clicking the ‘Create Collection’ button.

    1. Collection Name: Config

...

  1. Navigate to the newly created collection found in the the left panel. Click ‘Add Data’ > 'Import JSON or CSV' buttons and select D:\bmocollections\Config.json

...

  1. as your file.

  2. Repeat Steps 5-7 again for the following Mongo Collections:

    1. Identities > D:\bmocollections\Identities.json

    2. RestoreReports > D:\bmocollections\RestoreReports.json

    3. ScheduledBackup > D:\bmocollections\ScheduledBackup.json

  3. Install the BackupMyOrg application and all of the existing Identitites’ backup locations to the same directory structure as the previous server, and install the service.

...

Manually Restoring CleanMyOrg Database and Application

  1. If MongoDB is not installed:

    1. Copy your collection JSONs from the backup to directories such as D:\bmocollections and D:\cmocollections.

      1. Note: Copy all collections, even if it’s not the one you are restoring. Updating MongoDB will clear all of your collections in the update process.

    2. Install the latest MongoDB Community on the new machine, be sure to click the checkbox to download MongoDBCompass as well.

    3. After installation, open MongoDBCompass.

  2. In MongoDB Compass, connect to the server where your GEO Jobe products are located in.

    1. Enter the server URI containing your GEO Products, such as mongodb://localhost:<port>/ .

    2. Click

    on the Create Database button and type in
    1. the ‘Save & Connect’ button, or the ‘Connect’ button (if the connection already exists).

      image-20250113-160240.pngImage Added

  3. Click on the ‘Create Database’ button (upper right-corner of your connection’s home page) and type into modal:

    Database Name: CleanMyOrg
    Collection Name: Config

    Image Removedimage-20250109-154140.pngImage Added

  4. Click on the Configcollection in the left panel. Then, click the Add Data ‘Add Data’ button; then the 'Import File JSON or CSV' button. Select the D:\cmocollections\Config.json file. The input file type should be JSON.

    Image Removedimage-20250113-155933.pngImage Added

  5. On the Connection pane (left-side panel), next to the CleanMyOrg database, click the plus icon to Create a Collection

    Image Removed

    ➕ for the ‘Create a Collection’ modal to appear.

    image-20250113-155143.pngImage Added

  6. On the Create Collection ‘Create Collection’ Menu, type in:
    Collection Name: IdentitiesRepeat Step 5 by clicking on the new collection on the left panel, then clicking Add Data > Import File '

  7. Navigate to the newly created collection found in the the left panel. Click ‘Add Data’ > 'Import JSON or CSV' buttons and select D:\cmocollections\Identitites.json

  8. Now, repeat Steps 5-7 and 8 again for the following all of the follow Collections following collections you have. Note: If you do not have a Collectioncollection, that is okay. It means you are not currently utilizing that collection and there is therefore nothing to restore. If you decide to use it in the future, CMO CleanMyOrg will generate the collection for you.

    1. AddressBook > D:\cmocollections\AddressBook.json

    2. ScanIssues > D:\cmocollections\ScanIssues.json

    3. ScanReports > D:\cmocollections\ScanReports.json

    4. ScheduledScans > D:\cmocollections\ScheduledScans.json

    5. WhitelistFolder > D:\cmocollections\WhitelistFolder.json

    6. WhitelistGroup > D:\cmocollections\WhitelistGroup.json

    7. WhitelistItem > D:\cmocollections\WhitelistItem.json

    8. WhitelistItemId > D:\cmocollections\WhitelistItemId.json

    9. WhitelistLayer > D:\cmocollections\WhitelistLayer.json

    10. WhitelistUser > D:\cmocollections\WhitelistUser.json

  9. Install the CleanMyOrg application and install the service.

...

Restoring Admin Tools Database and Applications

  1. If MongoDB is not installed:

    1. Copy your collection JSONs from the backup to directories such as D:\bmocollections and D:\cmocollections. atcollections.

      1. Note: Copy all collections, even if it’s not the one you are restoring. Updating MongoDB will clear all of your collections in the update process.

    2. Install the latest MongoDB Community on the new machine, be sure to click the checkbox to download MongoDBCompass as well.

    3. After installation, open MongoDBCompass.

  2. In MongoDB Compass, connect to the server where your GEO Jobe products are located in.

    1. Enter the server URI containing your GEO Products, such as mongodb://localhost:<port>/ .

    2. Click

    on the Create Database button and type in
    1. the ‘Save & Connect’ button, or the ‘Connect’ button (if the connection already exists).

      image-20250113-160156.pngImage Added

  3. Click on the ‘Create Database’ button (upper right-corner of your connection’s home page) and type into modal:

    1. Database Name: AdminTools2
      Collection Name: SavedFilters

    Image Removed
    1. image-20250109-154140.pngImage Added

  4. Click on the SavedFilters collection in the left panel. Then, click the Add Data ‘Add Data’ button; then the Import File ‘Import JSON or CSV file’ button. Select the D:\atcollections\SavedFilters.json file. The input file type should be in JSON format.

    Image Removedimage-20250113-160119.pngImage Added

  5. On the left panel, next to the AdminTools2 database, click the plus icon to ➕ for the 'Create a Collection

    Image Removed

    Collection’ modal to appear.

    Image Added

  6. On the Create Collection ‘Create Collection’ Menu, type inin…

    1. Collection Name: SavedFavoriteTools

  7. Repeat Step 5 by clicking on the new collection on Click the newly created collection in the left panel, then clicking Add Data > Import File click ‘Add Data’ > ‘Import JSON or CSV file’ button and select D:\atcollections\SavedFavoriteTools.json

  8. Use Repeat steps 5-7 and use the following Collections for import:

    1. SavedSettings > D:\atcollections\SavedSettings.json

    2. SavedThumbnailTemplates > D:\atcollections\SavedThumbnailTemplates.json

If you have any questions or are experiencing any issues while following the step-through, please reach out to our GEO Jobe Support Team at support@geo-jobe.com.