This guide will walk you through how to upgrade from HuskSync v1.4.x to HuskSync v3.x. Data from HuskSync v2.x will automatically be imported into HuskSync v3.x.
- MySQL Database with HuskSync v1.4.x data
- Migration from SQLite is not supported, as HuskSync v2.x requires a MySQL database and does not support SQLite. Apologies for the inconvenience.
- If you're running v1.3.x or older, follow the update instructions to 1.4.x first before updating to 2.x.
- Switch off all servers and your proxy
- Delete the .jar file from your
~/plugins/ folders on your Spigot servers - Also delete the .jar file from your
~/plugins/ folders on your Proxy. HuskSync v3.x no longer requires a proxy plugin. - Delete (or make a copy and delete) all HuskSync config data folders (
~/plugins/HuskSync/). HuskSync v3.x has new config.yml, messages-xx-xx.yml and server.yml files.
- HuskSync v3.x must only be installed on your Spigot servers, not your proxy.
- Follow the setup instructions here.
- 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 legacy - Carefully read the migration configuration instructions. In most cases, you won't have to change the settings, but if you do need to adjust them, use
husksync migrate set legacy <setting> <value>. - Migration will be carried out from the database you specify with the settings in console to the database configured in
config.yml. If you're migrating from multiple clusters, ensure you run the migrator on the correct servers corresponding to the migrator.
- Run
husksync migrate start legacy to begin the migration process. This may take some time, depending on the amount of data you're migrating.
- HuskSync will notify in console when migration is complete. Verify that the migration went OK by logging in and using the
/userdata list <username> command to see if the data was imported with the legacy migration saveCause. - You can delete the old tables in the database if you want. Be careful to make sure you delete the right ones. By default the new table names are
husksync_users and husksync_user_data and the old ones were husksync_players and husksync_data, but you may have changed these.