Bug 1375276

Summary: OSP-d backup documentation incorrectly uses discoverd instead of inspector
Product: Red Hat OpenStack Reporter: Leif Madsen <lmadsen>
Component: documentationAssignee: RHOS Documentation Team <rhos-docs>
Status: CLOSED CURRENTRELEASE QA Contact: RHOS Documentation Team <rhos-docs>
Severity: low Docs Contact:
Priority: unspecified    
Version: 8.0 (Liberty)CC: dmacpher, srevivo
Target Milestone: ---Keywords: Documentation
Target Release: 10.0 (Newton)   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2018-03-19 07:46:58 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 Leif Madsen 2016-09-12 15:15:32 UTC 
Description of problem:

Backup documentation for OSP-d 8 incorrectly stops the ironic-discoverd service instead of ironic-inspector.

Director Installation and Usage > Chapter 9. Scaling the Overcloud (section 9.4.1)

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

OSP 8 and 9

How reproducible:

N/A

Actual results:

2. Perform a backup of the Undercloud databases:

$ mkdir /home/stack/backup
$ sudo mysqldump --all-databases --quick --single-transaction | gzip > /home/stack/backup/dump_db_undercloud.sql.gz
$ sudo systemctl stop openstack-ironic-api.service openstack-ironic-conductor.service openstack-ironic-discoverd.service openstack-ironic-discoverd-dnsmasq.service
$ sudo cp /var/lib/ironic-discoverd/inspector.sqlite /home/stack/backup
$ sudo systemctl start openstack-ironic-api.service openstack-ironic-conductor.service openstack-ironic-discoverd.service openstack-ironic-discoverd-dnsmasq.service

Expected results:

$ mkdir /home/stack/backup
$ sudo mysqldump --all-databases --quick --single-transaction | gzip > /home/stack/backup/dump_db_undercloud.sql.gz
$ sudo systemctl stop openstack-ironic-api.service openstack-ironic-conductor.service openstack-ironic-inspector.service openstack-ironic-inspector-dnsmasq.service
$ sudo cp /var/lib/ironic-inspector/inspector.sqlite /home/stack/backup
$ sudo systemctl start openstack-ironic-api.service openstack-ironic-conductor.service openstack-ironic-inspector.service openstack-ironic-inspector-dnsmasq.service

Additional info:

Just to reiterate, this is an issue on both OSP8 and OSP9 documentation. It is correct for OSP7 (as OSP8 is when the service names changed).
Comment 2 Leif Madsen 2016-12-01 22:30:33 UTC 
Just wanted to ping on this since it's been sitting here for a bit, and would be a relatively simple documentation change. If there is a spot for me to submit a please, I'm happy to do that as well. Thanks!
Comment 3 Dan Macpherson 2018-03-19 07:46:58 UTC 
This appears to have been fixed a while back:

https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/8/html/back_up_and_restore_red_hat_openstack_platform/back_up_and_restore_the_undercloud#back_up_the_undercloud

Closing this BZ but if further changes are required, please let us know.