Bug 1588404

Summary:	[RFE] Add instructions on how to rename database appliances to the HA documentation
Product:	Red Hat CloudForms Management Engine	Reporter:	Felix Dewaleyne <fdewaley>
Component:	Documentation	Assignee:	Dayle Parker <dayleparker>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Chris Budzilowicz <cbudzilo>
Severity:	low	Docs Contact:
Priority:	high
Version:	5.9.0	CC:	adahms, cbudzilo, cpelland, fdewaley, hhudgeon, mfeifer, ncarboni, obarenbo, sbulage
Target Milestone:	GA	Keywords:	FutureFeature
Target Release:	5.9.5
Hardware:	All
OS:	All
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2019-03-11 01:21:27 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	Documentation	Target Upstream Version:
Embargoed:
Bug Depends On:
Bug Blocks:	1595269

Description Felix Dewaleyne 2018-06-07 08:49:03 UTC

Document URL: https://access.redhat.com/documentation/en-us/red_hat_cloudforms/4.6/html/high_availability_guide/

Section Number and Name: n/a

Describe the issue: the document does not include the steps to rename appliances, especially the database appliances

Suggestions for improvement: 

the following steps were shared with the customer and he decided to close the case :

follow the steps of https://access.redhat.com/documentation/en-us/red_hat_cloudforms/4.6/html/high_availability_guide/database_failover#failover_monitor. Basically what you'll have to do to rename your appliances is 

 0 - make sure which is the active database and which is the standby
 1 - stop all monitor on all the non-db appliances in appliance_console
 2 - reset the standby by deleting the database
 3 - stop all evmserverd on the non-db appliances
 4 - do the renaming of the db appliance & restart the appliance 
 5 - on all appliances change the database to the right hostname in vmdb/config/database.yml
 6 - restart the appliances

note : if you use a non-dedicated database appliances also stop evmserverd there before renaming it and reconfigure the database.yml before restarting.

at that point you should have all appliances able to connect to the db. after that you will have to set up again HA from https://access.redhat.com/documentation/en-us/red_hat_cloudforms/4.6/html/high_availability_guide/installation#configuring_primary_db (part 2.3).

Additional information: 

I haven't had tried to create a HA setup to confirm those steps cause no issues and it would benefit us to cover that type of change.

Comment 2 Dayle Parker 2018-11-27 08:55:21 UTC

WIP in https://github.com/ManageIQ/manageiq_docs/pull/1023

Need to get all the technical details & commands still for this to be complete.

Comment 15 Dayle Parker 2019-03-11 01:21:27 UTC

This new content (and some other general edits) has been included in the latest version (4.7) of the CloudForms docs:

https://access.redhat.com/documentation/en-us/red_hat_cloudforms/4.7/html-single/high_availability_guide/?lb_target=production#renaming-ha