🗃️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