Bug 1378144 - Documentation bug: upgrade guide for osp 9 says "This scenario upgrades from Red Hat OpenStack Platform 7 to Red Hat OpenStack Platform 8"
Summary: Documentation bug: upgrade guide for osp 9 says "This scenario upgrades from...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation
Version: 9.0 (Mitaka)
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
: 10.0 (Newton)
Assignee: Petr Kovar
QA Contact: RHOS Documentation Team
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-09-21 15:09 UTC by Andreas Karis
Modified: 2019-12-16 06:51 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-01-25 14:01:48 UTC
Target Upstream Version:


Attachments (Terms of Use)
8 to 9 search (118.37 KB, image/png)
2016-10-11 14:54 UTC, Andreas Karis
no flags Details
7 to 8 search (81.25 KB, image/png)
2016-10-11 14:55 UTC, Andreas Karis
no flags Details
6 to 7 search (95.55 KB, image/png)
2016-10-11 14:55 UTC, Andreas Karis
no flags Details

Description Andreas Karis 2016-09-21 15:09:11 UTC
Document URL: 
https://access.redhat.com/documentation/en/red-hat-openstack-platform/9/paged/upgrading-red-hat-openstack-platform/chapter-5-non-director-environments-upgrading-individual-openstack-services-live-compute-in-a-standard-environment

Section Number and Name: 
Chapter 5. Non-Director Environments: Upgrading Individual OpenStack Services (Live Compute) in a Standard Environment 

Describe the issue: 
"This scenario upgrades from Red Hat OpenStack Platform 7 to Red Hat OpenStack Platform 8 in environments that do not use the director. "

Suggestions for improvement: 
"This scenario upgrades from Red Hat OpenStack Platform 8 to Red Hat OpenStack Platform 9 in environments that do not use the director. "

Additional information: 
this is the upgrade guide for OSP 9

Comment 2 Andreas Karis 2016-09-21 15:21:58 UTC
actually, note that the whole page seems to still contain the upgrade procedure for osp 7 -> to osp 8 instead of the upgrade procedure from osp 8 to osp 9, e.g.

~~~
# subscription-manager repos --disable=rhel-7-server-openstack-7.0-rpms
# subscription-manager repos --enable=rhel-7-server-openstack-8-rpms
~~~

Comment 3 Andreas Karis 2016-09-23 14:47:43 UTC
Here is an upgrade procedure for a an upgrade from OSP 8 packstack to OSP 9 packstack - it contains a few adjustments compared to the documentation:

updated procedure from: https://access.redhat.com/documentation/en/red-hat-openstack-platform/9/paged/upgrading-red-hat-openstack-platform/chapter-5-non-director-environments-upgrading-individual-openstack-services-live-compute-in-a-standard-environment

on each node:
~~~
subscription-manager repos --disable=rhel-7-server-openstack-8-rpms
subscription-manager repos --enable=rhel-7-server-openstack-9-rpms
yum upgrade openstack-selinux -y
~~~

on the controller:
~~~
systemctl stop httpd
yum -d1 -y upgrade \*keystone\* && yum -y upgrade \*horizon\* \*openstack-dashboard\* && yum -d1 -y upgrade \*horizon\* \*python-django\*
keystone-manage token_flush
openstack-db --service keystone --update
systemctl start httpd

openstack-service stop swift
yum -d1 -y upgrade \*swift\*
openstack-service start swift

openstack-service stop glance
yum -d1 -y upgrade \*glance\*
openstack-db --service glance --update
openstack-service start glance

# fixes issues with heat and cinder
yum update python-osprofiler

openstack-service stop cinder
yum -d1 -y upgrade \*cinder\*
openstack-db --service cinder --update
openstack-service start cinder

openstack-service stop heat
yum -d1 -y upgrade \*heat\*
openstack-db --service heat --update
openstack-service start heat
~~~

on all nodes
~~~
openstack-service stop ceilometer
yum -d1 -y upgrade \*ceilometer\*
~~~
on the controller
~~~
ceilometer-dbsync
~~~
on all nodes
~~~
openstack-service start ceilometer
~~~

on all nodes
~~~
crudini --set /etc/nova/nova.conf upgrade_levels compute liberty
~~~
on all nodes
~~~
openstack-service stop nova
yum -d1 -y upgrade \*nova\*
~~~
on controller
~~~
openstack-db --service nova --update
~~~
on all nodes
~~~
crudini --del /etc/nova/nova.conf upgrade_levels compute
openstack-service start nova
~~~

on the controller
~~~
openstack-service stop neutron
yum -d1 -y upgrade \*neutron\*
openstack-db --service neutron --update
openstack-service start neutron
~~~

on compute nodes
~~~
yum upgrade -y
~~~

on controller
~~~
yum remove erlang-reltool
yum install erlang
yum upgrade -y
~~~

on controller
~~~
yum install vim -y
vim /etc/keystone/keystone.conf
# config_file = /usr/share/keystone/keystone-dist-paste.ini
systemctl restart httpd
~~~

change neutron section on computes to:
~~~
yum install vim -y
vim /etc/nova/nova.conf
[neutron]
url=http://10.10.181.112:9696
username=neutron
password=a1b39f9379644b2e
project_name=services
project_domain_name=Default
user_domain_name=Default
region_name=RegionOne
auth_url=http://10.10.181.112:5000/v3
ovs_bridge=br-int
#auth_strategy=keystone
auth_plugin=v3password
ovs_bridge=br-int
extension_sync_interval=600
timeout=30
default_tenant_id=default
[osapi_v21]
[oslo_concurrency]
[oslo_messaging_amqp]
[oslo_messaging_qpid]
[oslo_messaging_rabbit]
amqp_durable_queues=False
kombu_reconnect_delay=1.0
rabbit_host=10.10.181.112
rabbit_port=5672
rabbit_hosts=10.10.181.112:5672
rabbit_use_ssl=False
rabbit_userid=guest
rabbit_password=guest
rabbit_virtual_host=/
rabbit_ha_queues=False
heartbeat_timeout_threshold=0
heartbeat_rate=2
~~~

change neutron section on controller to:
~~~
vim /etc/nova/nova.conf
[neutron]
service_metadata_proxy=True
metadata_proxy_shared_secret =9278a8ce2eaf46cd
url=http://10.10.181.112:9696
username=neutron
password=a1b39f9379644b2e
project_name=services
project_domain_name=Default
user_domain_name=Default
region_name=RegionOne
auth_url=http://10.10.181.112:5000/v3
auth_plugin=v3password
ovs_bridge=br-int
extension_sync_interval=600
timeout=30
default_tenant_id=default
~~~

on all nodes
~~~
openstack-service restart nova
~~~

on all nodes
~~~
reboot
~~~

after the reboot, verify that services are up (may need to run openstack-service restart <service>
~~~
nova service-list
neutron agent-list
cinder service-list
~~~

Comment 4 Ivan Chavero 2016-09-28 22:11:48 UTC
This is not a bug in Packstack, it's a bug in the documentation.
Changing the bug to the proper component.

Comment 5 Andreas Karis 2016-10-11 14:48:41 UTC
It seems that this document was simply moved from 8 to 9. It's completely missing in OSP 8 documentation now, and the document in OSP 9 explains an upgrade from 7 to 8.

See attached screenshots.

Please move the aforementioned document under OSP 8 doc, where it belongs, and create an updated procedure for OSP 8 -> 9 upgrades.

Thanks,

Andreas

Comment 6 Andreas Karis 2016-10-11 14:54:49 UTC
Created attachment 1209184 [details]
8 to 9 search

Comment 7 Andreas Karis 2016-10-11 14:55:10 UTC
Created attachment 1209187 [details]
7 to 8 search

Comment 8 Andreas Karis 2016-10-11 14:55:30 UTC
Created attachment 1209188 [details]
6 to 7 search

Comment 9 Dr. David Alan Gilbert 2016-12-16 13:00:38 UTC
and the rhos-10 docs make the same mistake:
https://access.redhat.com/documentation/en/red-hat-openstack-platform/10/paged/upgrading-red-hat-openstack-platform/

says it's for upgrading 8->9 (although the contents look like they've been updated).


Note You need to log in before you can comment on or make changes to this bug.