Bug 1546371

Summary: [Docs] [director] Pre-Provisioned Nodes docs don't work with Ceph without missing steps
Product: Red Hat OpenStack Reporter: John Fulton <johfulto>
Component: documentationAssignee: Laura Marsh <lmarsh>
Status: CLOSED CURRENTRELEASE QA Contact: RHOS Documentation Team <rhos-docs>
Severity: unspecified Docs Contact:
Priority: medium    
Version: 15.0 (Stein)CC: amoralej, ccopello, cminkema, dcadzow, dmacpher, lars, lmarsh, mburns, srevivo
Target Milestone: zstreamKeywords: ZStream
Target Release: 14.0 (Rocky)   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard: docs-accepted
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of:
: 1729263 (view as bug list) Environment:
Last Closed: 2019-08-19 14:56:27 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:
Embargoed:
Bug Depends On:    
Bug Blocks: 1729263, 1729264    

Description John Fulton 2018-02-16 21:42:17 UTC
Please update "8.7. Creating the Overcloud with Pre-Provisioned Nodes" [1] of the document Director Installation and Usage (An end-to-end scenario on using Red Hat OpenStack Platform director to create an OpenStack cloud) to add a few steps missing when deploying Ceph in the overcloud or deploying an overcloud to use an external Ceph cluster. 

The document is missing something like the following: 

"""
When using ceph-ansible and Using Already Deployed Servers, it is necessary to run commands like the following from the undercloud before deployment:

export OVERCLOUD_HOSTS="192.168.1.8 192.168.1.42"
bash /usr/share/openstack-tripleo-heat-templates/deployed-server/scripts/enable-ssh-admin.sh
for h in $OVERCLOUD_HOSTS ; do
    ssh $h -l stack "sudo groupadd ceph -g 64045 ; sudo useradd ceph -u 64045 -g ceph"
done

In the example above, the OVERCLOUD_HOSTS variable should be set to the IPs of the overcloud hosts which will be Ceph clients (e.g. Nova, Cinder, Glance, Gnocchi, Manila, etc.). The enable-ssh-admin.sh script configures a user on the overcloud nodes that Ansible uses to configure Ceph clients. The for loop creates the Ceph user on the relevant overcloud hosts.
"""

The above is from the upstream documentation which was recently updated [2]. 

Without this change it's possible to run into what's described in bug 1536678 [3]. 

Also, the above steps include adding the Ceph user to the overcloud nodes. This step won't be necessary after BZ 1546233 is resolved. 


[1] https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/12/html/director_installation_and_usage/chap-configuring_basic_overcloud_requirements_on_pre_provisioned_nodes#sect-Creating_the_Overcloud_with_Pre_Provisioned_Nodes

[2] https://review.openstack.org/#/c/545460/

[3] https://bugzilla.redhat.com/show_bug.cgi?id=1536678

[4] https://bugzilla.redhat.com/show_bug.cgi?id=1546233

Comment 2 John Fulton 2018-02-16 21:48:26 UTC
*** Bug 1536678 has been marked as a duplicate of this bug. ***

Comment 3 John Fulton 2018-05-09 21:12:13 UTC
You may now modify the documentation to not require that the ceph user be created as the needed change for 1546233 has merged. I updated the suggested text below: 

"""
When using ceph-ansible and Using Already Deployed Servers, it is necessary to run commands like the following from the undercloud before deployment:

export OVERCLOUD_HOSTS="192.168.1.8 192.168.1.42"
bash /usr/share/openstack-tripleo-heat-templates/deployed-server/scripts/enable-ssh-admin.sh

In the example above, the OVERCLOUD_HOSTS variable should be set to the IPs of the overcloud hosts which will be Ceph clients (e.g. Nova, Cinder, Glance, Gnocchi, Manila, etc.). The enable-ssh-admin.sh script configures a user on the overcloud nodes that Ansible uses to configure Ceph clients.
"""

Comment 4 John Fulton 2018-11-14 14:41:53 UTC
*** Bug 1645134 has been marked as a duplicate of this bug. ***