Skip to content

Commit fb86575

Browse files
add upgrade to 8.4 and auth section
1 parent dc512db commit fb86575

File tree

1 file changed

+43
-0
lines changed

1 file changed

+43
-0
lines changed

docs/hypernode-platform/mysql/how-to-use-mysql-on-hypernode.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -196,6 +196,31 @@ TABLE="core_url_rewrite"
196196
mysql "$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

201226
How 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

291316
You 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

Comments
 (0)