diff --git a/source/upgrading/index.rst b/source/upgrading/index.rst index eb368a29b6c..dc9e9041bd4 100644 --- a/source/upgrading/index.rst +++ b/source/upgrading/index.rst @@ -31,12 +31,13 @@ release. Please read through all sections carefully before starting. .. note:: For information on the API changes and issues fixed in this release, please see the Release Notes section of the documentation - Contents: .. toctree:: :maxdepth: 1 + upgrade/mysql + upgrade/valid_source upgrade/upgrade-4.15 upgrade/upgrade-4.14 upgrade/upgrade-4.13 @@ -55,4 +56,3 @@ Contents: .. upgrade/upgrade-4.0 .. upgrade/upgrade-3.0.x .. upgrade/upgrade-2.2.14 - upgrade/valid_source diff --git a/source/upgrading/upgrade/mysql.rst b/source/upgrading/upgrade/mysql.rst new file mode 100644 index 00000000000..c29f45e31dd --- /dev/null +++ b/source/upgrading/upgrade/mysql.rst @@ -0,0 +1,36 @@ +.. Licensed to the Apache Software Foundation (ASF) under one + or more contributor license agreements. See the NOTICE file + distributed with this work for additional information# + regarding copyright ownership. The ASF licenses this file + to you under the Apache License, Version 2.0 (the + "License"); you may not use this file except in compliance + with the License. You may obtain a copy of the License at + http://www.apache.org/licenses/LICENSE-2.0 + Unless required by applicable law or agreed to in writing, + software distributed under the License is distributed on an + "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY + KIND, either express or implied. See the License for the + specific language governing permissions and limitations + under the License. + +MySQL upgrade problems +====================== + +Users who may upgrade their MySQL server after upgrading to Apache +CloudStack 4.15 or later, may need to run the following SQL query to +fix an issue with "cloud.nics" table's column type which may lead to +exception seen in the management server logs. Users who have already +upgraded their MySQL server prior to upgrading to Apache CloudStack +4.15 may not need this as this query runs as part of the 4.14.x to +4.15.0.0 database upgrade path. + +.. note:: + The issue has not been seen in cases where the database was upgraded while on CloudStack version 4.14. + + .. parsed-literal:: +ALTER TABLE nics MODIFY COLUMN update_time timestamp DEFAULT CURRENT_TIMESTAMP; + +The issue is known to affect the following MySQL server versions: + + - 5.7.34 or later + - 8+