Bug 1194290 - [Docs] [User] Settings and operations guide needs updating regarding database operations when creating new region
Summary: [Docs] [User] Settings and operations guide needs updating regarding database...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Deadline: 2015-03-10
Product: Red Hat CloudForms Management Engine
Classification: Red Hat
Component: Documentation
Version: 5.3.0
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: GA
: 5.4.2
Assignee: Suyog Sainkar
QA Contact: Thom Carlin
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2015-02-19 13:39 UTC by Johan Swensson
Modified: 2016-02-11 00:54 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-02-11 00:54:29 UTC
Category: ---
Cloudforms Team: ---
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)
Appliance screenshot (18.40 KB, image/png)
2015-02-19 13:39 UTC, Johan Swensson
no flags Details

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.


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