🗃️Database Upgrade

When upgrading to a newer version of GlowKey, your existing database must be migrated properly to avoid losing any data. This process is simple and usually only needs to be done once.


⚙️ Step 1: Select the Correct Options

When prompted with the Legacy Database Data Restoration window, you’ll see multiple choices. For a clean and automatic migration, make sure you select the top three options:

  • 🔘 Restore previous database data into the new database

  • ☑️ Delete the old database after a successful restore

  • ☑️ Delete the backup after a successful restore

These choices will:

  • Safely move your old data to the new system.

  • Clean up the old database files.

  • Remove the temporary backup once the transfer is confirmed to be successful.

Click Confirm to proceed.


🔄 Step 2: Automatic Backup & Restore

After confirming, the system will begin the upgrade process:

  • It will back up your legacy database.

  • Then, it will inject that data into the new format.

  • Once complete, it will remove the old data and backup files automatically.

You won’t need to manually move anything—GlowKey handles it all.


✅ Final Step: Launch Module Setup

Once the upgrade finishes, you will see the Module Setup screen. This means you’re fully upgraded and ready to use the latest version. You're done!


🛠️ Troubleshooting

❗ Error: Port Already in Use

If you see the message:

Failed to create backup of legacy database: Another mongod instance is already running on port 13037...” This means another database instance is still running in the background.

🛠️ Fix:

  • Restart your PC.

  • Close Mongod in Task Manager.

  • Make sure you’ve updated Glowie to version 2.0.0 or higher. This will clear any lingering MongoDB processes and allow the restoration to continue.


🚫 Error: Database Server Failed to Start

If you see this message:

Failed to run database server on port 12219...

🛠️ Fix:

  • Restart Computer.

  • Close Mongod in Task Manager.

  • If the issue persists, please open a support ticket so our team can help you directly.

Last updated