@@ -196,6 +196,29 @@ TABLE="core_url_rewrite"
196196mysql " $DATABASE " -e " TRUNCATE TABLE $TABLE "
197197```
198198
199+ ## Changing the Authentication Plugin for a Custom 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 CUSTOM 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+
199222## Changing Your Password
200223
201224How you change the database password depends on what version of MySQL you are running on your Hypernode.
@@ -289,3 +312,21 @@ hypernode-systemctl settings mysql_version 8.0
289312```
290313
291314You can then check with ` livelog ` when the process has finished and your MySQL version has been upgraded.
315+
316+ ### Upgrading to MySQL 8.4
317+
318+ ** Please note that once you have upgraded the MySQL version on your Hypernode, you won't be able to downgrade it.**
319+
320+ Upgrading to MySQL 8.4 is only supported from MySQL 8.0.\
321+ If you are not yet on MySQL 8.0, first follow the steps above to upgrade to 8.0.
322+
323+ Before upgrading, ensure all MySQL users are using supported authentication plugins (for example ` caching_sha2_password ` ).\
324+ See [ Changing the Authentication Plugin for a Custom MySQL User] ( #changing-the-authentication-plugin-for-a-custom-mysql-user ) for details.
325+
326+ Once ready, run the following command:
327+
328+ ``` bash
329+ hypernode-systemctl settings mysql_version --value 8.4
330+ ```
331+
332+ Use the ` livelog ` command to monitor the progress of the update job.
0 commit comments