Bug 1476929

Summary: [RHHI] Configuring Fencing for hosts
Product: [Red Hat Storage] Red Hat Gluster Storage Reporter: Dave <dfitzpat>
Component: doc-Maintaining_RHHIAssignee: Laura Bailey <lbailey>
Status: CLOSED CURRENTRELEASE QA Contact: RamaKasturi <knarra>
Severity: medium Docs Contact:
Priority: unspecified    
Version: rhgs-3.2CC: annair, asriram, bturner, dfitzpat, knarra, lbailey, lbopf, lsurette, rbalakri, rhs-bugs, sabose, sankarshan, sasundar, srevivo, storage-doc, storage-qa-internal, ykaul
Target Milestone: ---   
Target Release: ---   
Hardware: x86_64   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2018-01-03 10:56:25 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: Docs RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:
Bug Depends On:    
Bug Blocks: 1491680    

Description Dave 2017-07-31 20:53:41 UTC
Description of problem:
Following: https://access.redhat.com/documentation/en-us/red_hat_hyperconverged_infrastructure/1.0/html-single/maintaining_red_hat_hyperconverged_infrastructure/#configure_high_availability_using_fencing_policies

Need a 2.2 section with instructions on how to configure each hosts after enabling fencing  in the cluster's tab.

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


How reproducible:
Deploy RHHI and enable fencing. There's no specifics on how to configure the hosts for fencing after 2.1.

Actual results:
Does not include complete steps to configure fencing

Expected results:
Fencing configured

Additional info:
Link to doc: https://access.redhat.com/documentation/en-us/red_hat_hyperconverged_infrastructure/1.0/html-single/maintaining_red_hat_hyperconverged_infrastructure/#configure_high_availability_using_fencing_policies

Comment 1 Dave 2017-07-31 21:23:33 UTC
I think we should include the process like we do in the other sections and then link to the full DOC for further info:

https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html-single/administration_guide/#Setting_fencing_parameters_on_a_host

Here is an example of what I think section 2.2 should look like:

Use the Hosts resource tab, tree mode, or the search function to find and select the host in the results list.
Click Edit to open the Edit Host window.
Click the Power Management tab.

Figure 7.2. Power Management Settings
Select the Enable Power Management check box to enable the fields.
Select the Kdump integration check box to prevent the host from fencing while performing a kernel crash dump.
IMPORTANT
When you enable Kdump integration on an existing host, the host must be reinstalled for kdump to be configured. See Section 7.5.12, “Reinstalling Hosts”.
Optionally, select the Disable policy control of power management check box if you do not want your host's power management to be controlled by the Scheduling Policyof the host's cluster.
Click the plus (+) button to add a new power management device. The Edit fence agent window opens.

Figure 7.3. Edit fence agent
Enter the Address, User Name, and Password of the power management device.
Select the power management device Type from the drop-down list.
NOTE
For more information on how to set up a custom power management device, see https://access.redhat.com/articles/1238743.
Enter the SSH Port number used by the power management device to communicate with the host.
Enter the Slot number used to identify the blade of the power management device.
Enter the Options for the power management device. Use a comma-separated list of 'key=value' entries.
Select the Secure check box to enable the power management device to connect securely to the host.
Click the Test button to ensure the settings are correct. Test Succeeded, Host Status is: on will display upon successful verification.
WARNING
Power management parameters (userid, password, options, etc) are tested by Red Hat Virtualization Manager only during setup and manually after that. If you choose to ignore alerts about incorrect parameters, or if the parameters are changed on the power management hardware without the corresponding change in Red Hat Virtualization Manager, fencing is likely to fail when most needed.
Click OK to close the Edit fence agent window.
In the Power Management tab, optionally expand the Advanced Parameters and use the up and down buttons to specify the order in which the Manager will search the host's cluster and dc (datacenter) for a fencing proxy.
Click OK.
You are returned to the list of hosts. Note that the exclamation mark next to the host's name has now disappeared, signifying that power management has been successfully configured.
####

ex.
Address: rhs-srv-05-mm.gdev.lab.eng.rdu2.redhat.com
User Name: root
Password: calvin
Type: drac7
Port: [blank]
Slot: [blank]
Options: [blank]

Comment 2 Lucy Bopf 2017-08-01 12:15:09 UTC
Thanks for reporting, Dave.

This content is actually managed by the Gluster team, so I'm moving this bug over to their queue for review.

Comment 4 Lucy Bopf 2017-08-02 00:05:28 UTC
Moving this again to the correct product queue to enable review.

Comment 12 Dave 2017-11-08 13:28:51 UTC
Looks good to me.

Thanks,
Dave

Comment 13 RamaKasturi 2017-11-08 14:27:39 UTC
Hi Laura,

  I see that in section 2.2 there is a link to 'Reinstalling Hosts' and that link does not have information to deploy HostedEngine on the hosts while reinstalling which is a crucial step.

Thanks
kasturi

Comment 15 RamaKasturi 2017-11-09 12:42:47 UTC
Laura, i think for now we can ask them to follow steps from i to v in the Important Note under 9.3 section.

Comment 17 RamaKasturi 2017-11-10 10:54:45 UTC
Laura, sure. Let us add it as another section then which says 'reinstalling hosts'

Comment 19 RamaKasturi 2017-11-15 07:35:39 UTC
Hi Laura,

   The doc content in the links provided in comment 18 looks good to me. But when i click on the link 'Reinstalling Hosts' it says 404 error not found. Does this get fixed automatically when the docs are live ?

Thanks
kasturi

Comment 21 RamaKasturi 2017-11-15 11:27:09 UTC
Cool, Thanks laura.

Verified in the links provided in comment 18 and as suggested by laura changed the link to access.qa.redhat.com and the link works fine.