๐Ÿ—ƒ๏ธ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