Skip to content

Commit 0cbf0c0

Browse files
Timezone requirements for 4.14+ (#112)
* Create _timezone.rst * Update upgrade-4.13.rst * Update upgrade-4.13.rst * Update upgrade-4.12.rst * Update upgrade-4.11.rst * Update upgrade-4.10.rst * Update upgrade-4.9.rst * Update upgrade-4.8.rst * Update upgrade-4.7.rst * Update upgrade-4.6.rst * Update upgrade-4.5.rst * Update upgrade-4.4.rst * Update upgrade-4.3.rst * Update upgrade-4.2.rst * Update _timezone.rst
1 parent 231036d commit 0cbf0c0

File tree

13 files changed

+70
-0
lines changed

13 files changed

+70
-0
lines changed
Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
.. Licensed to the Apache Software Foundation (ASF) under one
2+
or more contributor license agreements. See the NOTICE file
3+
distributed with this work for additional information#
4+
regarding copyright ownership. The ASF licenses this file
5+
to you under the Apache License, Version 2.0 (the
6+
"License"); you may not use this file except in compliance
7+
with the License. You may obtain a copy of the License at
8+
http://www.apache.org/licenses/LICENSE-2.0
9+
Unless required by applicable law or agreed to in writing,
10+
software distributed under the License is distributed on an
11+
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
12+
KIND, either express or implied. See the License for the
13+
specific language governing permissions and limitations
14+
under the License.
15+
16+
.. sub-section included in upgrade notes.
17+
18+
Time zone requirements
19+
######################
20+
21+
As of CloudStack 4.14, you must explicitly configure time zone either in the MySQL server or JDBC driver (db.properties).
22+
In previous CloudStack versions, UTC time zone was assumed by default (all event's have UTC time stamps), so
23+
the same UTC time zone should now be explicitly configured.
24+
25+
You can do this by editing the /etc/cloudstack/management/db.properties file and adding "serverTimezone=UTC"
26+
to the "db.cloud.url.params=" and "db.usage.url.params=" lines. Example lines, from a clean 4.14 installation, are given below:
27+
28+
.. parsed-literal::
29+
30+
db.cloud.url.params=prepStmtCacheSize=517&cachePrepStmts=true&sessionVariables=sql_mode='STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION'&serverTimezone=UTC
31+
db.usage.url.params=serverTimezone=UTC
32+

source/upgrading/upgrade/upgrade-4.10.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -114,6 +114,8 @@ Backup current database
114114
Management Server
115115
-----------------
116116
117+
.. include:: _timezone.rst
118+
117119
Ubuntu
118120
######
119121

source/upgrading/upgrade/upgrade-4.11.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -110,6 +110,8 @@ Backup current database
110110
Management Server
111111
-----------------
112112
113+
.. include:: _timezone.rst
114+
113115
Ubuntu
114116
######
115117

source/upgrading/upgrade/upgrade-4.12.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -108,6 +108,8 @@ Backup current database
108108
Management Server
109109
-----------------
110110
111+
.. include:: _timezone.rst
112+
111113
Ubuntu
112114
######
113115

source/upgrading/upgrade/upgrade-4.13.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -109,6 +109,8 @@ Backup current database
109109
Management Server
110110
-----------------
111111
112+
.. include:: _timezone.rst
113+
112114
Ubuntu
113115
######
114116

source/upgrading/upgrade/upgrade-4.2.rst

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -96,6 +96,8 @@ Management Server Ubuntu
9696
If you are using Ubuntu, follow this procedure to upgrade your packages. If
9797
not, skip to step :ref:`rhel42`.
9898
99+
.. include:: _timezone.rst
100+
99101
.. note::
100102
**Community Packages:** This section assumes you're using the community
101103
supplied packages for CloudStack. If you've created your own packages and
@@ -164,6 +166,8 @@ Management Server CentOS/RHEL
164166
If you are using CentOS or RHEL, follow this procedure to upgrade your
165167
packages. If not, skip to hypervisors section :ref:`upg_hyp_42`.
166168

169+
.. include:: _timezone.rst
170+
167171
.. note::
168172
**Community Packages:** This section assumes you're using the community
169173
supplied packages for CloudStack. If you've created your own packages and

source/upgrading/upgrade/upgrade-4.3.rst

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -100,6 +100,8 @@ Management Server on Ubuntu
100100
If you are using Ubuntu, follow this procedure to upgrade your packages. If
101101
not, skip to step :ref:`rhel43`.
102102
103+
.. include:: _timezone.rst
104+
103105
.. note::
104106
**Community Packages:** This section assumes you're using the community
105107
supplied packages for CloudStack. If you've created your own packages and
@@ -169,6 +171,8 @@ Management Server on CentOS/RHEL
169171
If you are using CentOS or RHEL, follow this procedure to upgrade your
170172
packages. If not, skip to hypervisors section :ref:`upg_hyp_43`.
171173

174+
.. include:: _timezone.rst
175+
172176
.. note::
173177
**Community Packages:** This section assumes you're using the community
174178
supplied packages for CloudStack. If you've created your own packages and

source/upgrading/upgrade/upgrade-4.4.rst

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -100,6 +100,8 @@ Management Server on Ubuntu
100100
If you are using Ubuntu, follow this procedure to upgrade your packages. If
101101
not, skip to step :ref:`rhel44`.
102102
103+
.. include:: _timezone.rst
104+
103105
.. note::
104106
**Community Packages:** This section assumes you're using the community
105107
supplied packages for CloudStack. If you've created your own packages and
@@ -169,6 +171,8 @@ Management Server on CentOS/RHEL
169171
If you are using CentOS or RHEL, follow this procedure to upgrade your
170172
packages. If not, skip to hypervisors section :ref:`upg_hyp_44`.
171173

174+
.. include:: _timezone.rst
175+
172176
.. note::
173177
**Community Packages:** This section assumes you're using the community
174178
supplied packages for CloudStack. If you've created your own packages and

source/upgrading/upgrade/upgrade-4.5.rst

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -109,6 +109,8 @@ Management Server on Ubuntu
109109
If you are using Ubuntu, follow this procedure to upgrade your packages. If
110110
not, skip to step :ref:`rhel45`.
111111
112+
.. include:: _timezone.rst
113+
112114
.. note::
113115
**Community Packages:** This section assumes you're using the community
114116
supplied packages for CloudStack. If you've created your own packages and
@@ -181,6 +183,8 @@ Management Server on CentOS/RHEL
181183
If you are using CentOS or RHEL, follow this procedure to upgrade your
182184
packages. If not, skip to hypervisors section :ref:`upg_hyp_45`.
183185

186+
.. include:: _timezone.rst
187+
184188
.. note::
185189
**Community Packages:** This section assumes you're using the community
186190
supplied packages for CloudStack. If you've created your own packages and

source/upgrading/upgrade/upgrade-4.6.rst

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,8 @@ Management Server on Ubuntu
9898
If you are using Ubuntu, follow this procedure to upgrade your packages. If
9999
not, skip to step :ref:`rhel46`.
100100
101+
.. include:: _timezone.rst
102+
101103
.. note::
102104
**Community Packages:** This section assumes you're using the community
103105
supplied packages for CloudStack. If you've created your own packages and
@@ -167,6 +169,8 @@ Management Server on CentOS/RHEL
167169
If you are using CentOS or RHEL, follow this procedure to upgrade your
168170
packages. If not, skip to hypervisors section :ref:`upg_hyp_46`.
169171

172+
.. include:: _timezone.rst
173+
170174
.. note::
171175
**Community Packages:** This section assumes you're using the community
172176
supplied packages for CloudStack. If you've created your own packages and

0 commit comments

Comments
 (0)