Bug 1194290

Summary: [Docs] [User] Settings and operations guide needs updating regarding database operations when creating new region
Product: Red Hat CloudForms Management Engine Reporter: Johan Swensson <jswensso>
Component: DocumentationAssignee: Suyog Sainkar <ssainkar>
Status: CLOSED CURRENTRELEASE QA Contact: Thom Carlin <tcarlin>
Severity: medium Docs Contact:
Priority: medium    
Version: 5.3.0CC: adahms, jhardy, mfeifer, obarenbo, tcarlin, xlecauch
Target Milestone: GA   
Target Release: 5.4.2   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2016-02-11 00:54:29 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:
Deadline: 2015-03-10   
Attachments:
Description Flags
Appliance screenshot none

Description Johan Swensson 2015-02-19 13:39:06 UTC
Created attachment 993616 [details]
Appliance screenshot

https://access.redhat.com/documentation/en-US/Red_Hat_CloudForms/3.1/html/Management_Engine_5.3_Settings_and_Operations_Guide/sect-Database_Operations.html#sect-Database_Regions_and_Replication

5.4.2.2. Creating a Region

This section of the documentation describes the process of creating a new region.
It seems some things have been moved around in the appliance since this was written.

Attaching screen shot to visualize how it looks now.

Comment 2 Andrew Dahms 2015-02-20 04:59:20 UTC
Assigning to Brian for review.

Comment 5 Thom Carlin 2015-04-22 16:58:47 UTC
Step 5: No Enter was needed - the menu reappeared by itself
Step 8 and Step 9 should be swapped
Step 10: Was not needed
Received errors between Steps 11 and 12 regarding postgreSQL
Received errors after Step 13

Comment 6 Andrew Dahms 2015-04-27 04:13:33 UTC
Re-assigning to Suyog to follow up on the feedback from comment #5.

Suyog - let me know if you have any questions.

Comment 8 Thom Carlin 2015-05-22 12:59:33 UTC
Is the sentence " After creating a region, upload a valid license file to the VMDB." necessary?

Step 5: No Enter was needed - the menu reappeared by itself
Step 7: For 5.4.0.2: "There is no database configured yet, please choose Configure Database instead".  Steps 7 through 10 should be redone to reflect this

Comment 11 Thom Carlin 2015-06-12 11:05:43 UTC
In current spin:
I had some initial confusion between Configure Database for the first time,for subsequent times, whether or not the encryption key has been created, and whether or not the database disk needs to be partitioned.

We may want to add verbiage to differentiate between the different cases (and point to appropriate documentation).

Comment 12 Marianne Feifer 2015-06-12 18:48:14 UTC
I agree with Tom.  The instructions are technically correct, but not useful without some context.

These directions are how to create a region on a CFME Appliance that already has a database.  Not really what you want to do usually, but if you want to do this...and there may be situations where you do, then this is how you would do it.

In most cases, the region is created when you are creating your CFME Environment - essentially on first appliance for the region.  The first Region's Appliance will need security key created and region number - this will all be prompted for when you select Configure Database. The next Region in the environment will need to FETCH the key from the first regional database appliance.  Again, prompted for once you select Configure Database. This is probably covered in the installation guides.  Might be a good idea to point to those and qualify what this set of instructions is for.

Comment 17 Andrew Dahms 2016-02-11 00:54:29 UTC
This content is now live on the Customer Portal.

Closing.