Skip to content

Commit 3d38bb1

Browse files
fix alignments
1 parent 275e1cb commit 3d38bb1

File tree

1 file changed

+33
-32
lines changed

1 file changed

+33
-32
lines changed

source/upgrading/upgrade/upgrade_notes.rst

Lines changed: 33 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -132,59 +132,60 @@ If you are running MySQL 8.0 and would like to upgrade to MySQL 8.4,
132132
you may follow the standard MySQL upgrade process to migrate safely to version 8.4,
133133
and then update the authentication method for the root and CloudStack (cloud) users with
134134
caching_sha2_password plugin using the below steps as the mysql_native_password plugin
135-
is deprecated as of MySQL 8.0.34, and disabled by default in MySQL 8.4.
135+
is deprecated as of MySQL 8.0.34, and disabled by default in MySQL 8.4. For more details,
136+
refer to MySQL documentation here: https://dev.mysql.com/doc/refman/8.4/en/caching-sha2-pluggable-authentication.html
136137

137-
* Stop MySQL server if already running
138+
#. Stop MySQL server if already running
138139

139-
.. code-block:: bash
140+
.. code-block:: bash
140141
141-
sudo systemctl stop mysqld
142+
sudo systemctl stop mysqld
142143
143-
* Start MySQL server in safe mode without auth
144+
#. Start MySQL server in safe mode without auth
144145

145-
.. code-block:: bash
146+
.. code-block:: bash
146147
147-
sudo mysqld --skip-grant-tables --skip-networking &
148+
sudo mysqld --skip-grant-tables --skip-networking &
148149
149-
* Login to MySQL without password
150+
#. Login to MySQL without password
150151

151-
.. code-block:: bash
152+
.. code-block:: bash
152153
153-
mysql -u root
154+
mysql -u root
154155
155-
* Reset passwords for root and CloudStack (cloud) user
156+
#. Reset passwords for root and CloudStack (cloud) users.
156157

157-
.. code-block:: bash
158+
.. code-block:: mysql
158159
159-
ALTER USER 'root'@'localhost' IDENTIFIED WITH caching_sha2_password BY 'ROOT_PASSWORD';
160-
ALTER USER 'root'@'%' IDENTIFIED WITH caching_sha2_password BY 'ROOT_PASSWORD';
161-
ALTER USER 'cloud'@'localhost' IDENTIFIED WITH caching_sha2_password BY 'CLOUD_PASSWORD';
162-
ALTER USER 'cloud'@'%' IDENTIFIED WITH caching_sha2_password BY 'CLOUD_PASSWORD';
163-
FLUSH PRIVILEGES;
160+
ALTER USER 'root'@'localhost' IDENTIFIED WITH caching_sha2_password BY 'ROOT_PASSWORD';
161+
ALTER USER 'root'@'%' IDENTIFIED WITH caching_sha2_password BY 'ROOT_PASSWORD';
162+
ALTER USER 'cloud'@'localhost' IDENTIFIED WITH caching_sha2_password BY 'CLOUD_PASSWORD';
163+
ALTER USER 'cloud'@'%' IDENTIFIED WITH caching_sha2_password BY 'CLOUD_PASSWORD';
164+
FLUSH PRIVILEGES;
164165
165-
Note: Please ensure that the password used for the cloud database user matches the value
166-
configured in /etc/cloudstack/management/db.properties. If the password in db.properties
167-
is encrypted, you can retrieve it using:
166+
Note: Please ensure that the password used for the cloud database user matches the value
167+
configured in /etc/cloudstack/management/db.properties. If the password in db.properties
168+
is encrypted, you can retrieve it using:
168169

169-
.. code-block:: bash
170+
.. code-block:: bash
170171
171-
java -classpath /usr/share/cloudstack-common/lib/cloudstack-utils.jar \
172-
com.cloud.utils.crypt.EncryptionCLI -d \
173-
-i "$(grep -oP 'db.cloud.password=ENC\(\K[^\)]+(?=\))' /etc/cloudstack/management/db.properties)" \
174-
-p "$(cat /etc/cloudstack/management/key)"
172+
java -classpath /usr/share/cloudstack-common/lib/cloudstack-utils.jar \
173+
com.cloud.utils.crypt.EncryptionCLI -d \
174+
-i "$(grep -oP 'db.cloud.password=ENC\(\K[^\)]+(?=\))' /etc/cloudstack/management/db.properties)" \
175+
-p "$(cat /etc/cloudstack/management/key)"
175176
176-
* Remove deprecated authentication plugin 'mysql_native_password' from the MySQL configuration. Either comment or remove the below line from /etc/my.cnf
177+
#. Remove deprecated authentication plugin 'mysql_native_password' from the MySQL configuration. Either comment or remove the below line from /etc/my.cnf
177178

178-
.. code-block:: bash
179+
.. parsed-literal::
179180
180-
default_authentication_plugin=mysql_native_password
181+
default_authentication_plugin=mysql_native_password
181182
182-
* Restart MySQL server
183+
#. Restart MySQL server
183184

184-
.. code-block:: bash
185+
.. code-block:: bash
185186
186-
killall mysqld
187-
systemctl start mysqld
187+
killall mysqld
188+
systemctl start mysqld
188189
189190
MySQL 8.4 sql mode change
190191
-------------------------

0 commit comments

Comments
 (0)