@@ -196,6 +196,31 @@ TABLE="core_url_rewrite"
196196mysql " $DATABASE " -e " TRUNCATE TABLE $TABLE "
197197```
198198
199+ ## Changing the Authentication Plugin for a MySQL User
200+
201+ Some MySQL features and upgrades require that users use a supported authentication plugin.
202+ For example, newer MySQL versions no longer support ` mysql_native_password ` by default.
203+
204+ To change the authentication plugin for an existing user to the recommended ` caching_sha2_password ` plugin, first log in to MySQL:
205+
206+ ``` bash
207+ mysql
208+ ```
209+
210+ Then run the following command, replacing ` <username> ` , ` <host> ` and ` <password> ` with your own values:
211+
212+ ``` mysql
213+ ALTER USER ' <username>' @' <host>' IDENTIFIED WITH caching_sha2_password BY ' <password>' ;
214+ ```
215+
216+ For example, to update a custom user for all hosts:
217+
218+ ``` mysql
219+ ALTER USER ' someuser' @' %' IDENTIFIED WITH caching_sha2_password BY ' new_secure_password' ;
220+ ```
221+
222+ After changing the plugin, update your ` .my.cnf ` (or any other configuration files) to reflect the new password.
223+
199224## Changing Your Password
200225
201226How you change the database password depends on what version of MySQL you are running on your Hypernode.
@@ -289,3 +314,21 @@ hypernode-systemctl settings mysql_version 8.0
289314```
290315
291316You can then check with ` livelog ` when the process has finished and your MySQL version has been upgraded.
317+
318+ ### Upgrading to MySQL 8.4
319+
320+ ** Please note that once you have upgraded the MySQL version on your Hypernode, you won't be able to downgrade it.**
321+
322+ Upgrading to MySQL 8.4 is only supported from MySQL 8.0.
323+ If you are not yet on MySQL 8.0, first follow the steps above to upgrade to 8.0.
324+
325+ Before upgrading, ensure all MySQL users are using supported authentication plugins (for example ` caching_sha2_password ` ).
326+ See [ Changing the Authentication Plugin for a MySQL User] ( #changing-the-authentication-plugin-for-a-mysql-user ) for details.
327+
328+ Once ready, run the following command:
329+
330+ ``` bash
331+ hypernode-systemctl settings mysql_version --value 8.4
332+ ```
333+
334+ Use the ` livelog ` command to monitor the progress of the update job.
0 commit comments