Skip to content

Commit ca80f54

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

File tree

1 file changed

+41
-0
lines changed

1 file changed

+41
-0
lines changed

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

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

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

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

Comments
 (0)