HuskLegacy
/
HuskSync
forked from public-mirrors/HuskSync
1
0
Fork 0
Code Pull Requests Activity
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
master
dependabot/gradle/xyz.jpenilla.run-paper-2.3.1
dependabot/gradle/org.junit.jupiter-junit-jupiter-api-5.11.0
dependabot/gradle/com.google.guava-guava-33.3.0-jre
dependabot/gradle/org.junit.jupiter-junit-jupiter-params-5.11.0
dependabot/gradle/org.junit.jupiter-junit-jupiter-engine-5.11.0
feat/data-edit-commands
1.3
1.3.2
1.4
1.4-SNAPSHOT
1.4.1
2.0
2.0.1
2.0.2
2.1
2.1.1
2.1.2
2.2
2.2.1
2.2.2
2.2.3
2.2.4
2.2.5
2.2.6
2.2.7
2.2.8
3.0
3.0.1
3.0.2
3.1
3.1.1
3.1.2
3.2
3.2.1
3.3
3.3.1
3.3.2
3.3.3
3.4
3.5
3.5.1
3.5.2
3.5.3
3.6
3.6.1
3.6.2
3.6.3
3.6.4
3.6.5
3.6.6
3.6.7
3.6.8
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '29d8f2ecf4'
${ noResults }
HuskSync/docs/MPDB-Migration.md

1.9 KiB
Raw Blame History

This guide will walk you through how to migrate from MySQLPlayerDataBridge (MPDB) to HuskSync v3.x.

Warning: Please note that due to MPDB changes, HuskSync only supports migrating from MySQLPlayerDataBridge <= v4.9.2. Support for newer versions will be added in the future.

Requirements

  • Spigot servers with MySQLPlayerDataBridge still installed

Migration Instructions

1. Install HuskSync v3.x on all Spigot servers

  • Download, then install HuskSync on all your servers. Don't uninstall MySQLPlayerDataBridge yet.
  • Follow the setup instructions here.
  • Start your servers again when done.

2. Configure the migrator

  • With your servers back on and correctly configured to run HuskSync v3.x, ensure nobody is online.
  • Use the console on one of your Spigot servers to enter: husksync migrate help mpdb. If the MPDB migrator is not available, ensure MySQLPlayerDataBridge is still installed.
  • Adjust the migration setting as needed using the following command: husksync migrate set mpdb <setting> <value>.
  • Note that migration will be carried out from the database you specify with the settings in console to the database configured in config.yml.

3. Start the migrator

  • Run husksync migrate start mpdb to begin the migration process. This may take some time, depending on the amount of data you're migrating.

4. Uninstall MySQLPlayerDataBridge

  • HuskSync will display a message in console when data migration is complete.
  • Stop all your Spigot servers and remove the MySQLPlayerDataBridge jar from each of them.
  • Start your Spigot servers again.

5. Ensure the migration was successful

  • Verify that the migration was successful by logging in and using the /userdata list <username> command to see if the data was imported with the mpdb_migration saveCause.
  • You can delete the old tables in the database if you want. Be careful to make sure you delete the correct ones.