Skip to content

Commit b7348d0

Browse files
fix alignments
1 parent 275e1cb commit b7348d0

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+
.. parsed-literal::
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+
.. parsed-literal::
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+
.. parsed-literal::
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+
.. parsed-literal::
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+
.. parsed-literal::
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+
.. parsed-literal::
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)