Bug 1331749

Summary: OSP 8 upgrade documentation does not mention timezone requirement
Product: Red Hat OpenStack Reporter: Jon Jozwiak <jjozwiak>
Component: documentationAssignee: Dan Macpherson <dmacpher>
Status: CLOSED CURRENTRELEASE QA Contact: RHOS Documentation Team <rhos-docs>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 8.0 (Liberty)CC: dmacpher, jjozwiak, lbopf, srevivo
Target Milestone: ---Keywords: Documentation, ZStream
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-06-16 04:48:36 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Jon Jozwiak 2016-04-29 12:42:11 UTC 
Description of problem:
Section 6.10 of the documentation shows that now OSP 8 can set the time zone on servers in an environment file like shown below: 
parameter_defaults:
  TimeZone: 'Japan'

However, upgrade documentation in Chapter 10 makes no mention of the need to set this timezone parameter.  As a result, when you go through an upgrade, all of your servers will be changed to UTC by default (from EST which was the previous default).  


Version-Release number of selected component (if applicable):


How reproducible:
This will happen if you don't modify templates for timezone

Steps to Reproduce:
1. Follow upgrade documentation in chapter 10 of the director install guide
https://access.redhat.com/documentation/en/red-hat-openstack-platform/version-8/director-installation-and-usage/#chap-Upgrading_the_Environment

Actual results:
Timezone updates to UTC 

Expected results:
Timezone should not change on upgrade 

Additional info:
Adding a step to the upgrade documentation to modify your templates to add timezone configuration is required.
Comment 3 Dan Macpherson 2016-05-13 03:40:20 UTC 
Hi Jon,

I've included a note in the upgrade chapter:

https://access.redhat.com/documentation/en/red-hat-openstack-platform/8/director-installation-and-usage/chapter-10-upgrading-the-environment

"The default timezone for Red Hat OpenStack Platform 8 is now UTC. The previous default timezone was EST. If necessary, include an environment file to specify the timezone. For more information, see Section 6.10, “Configuring the Overcloud Time Zone”."

Was this along the lines of what you were after?
Comment 4 Dan Macpherson 2016-06-16 04:48:36 UTC 
No response in over a month. Closing this BZ as the changes are live on the portal. Feel free to reopen if further changes are required.