Bug 712400

Summary: Integrate "What are the debug options that can be enabled for RHEL6 clustering? " into docs
Product: Red Hat Enterprise Linux 6 Reporter: Allison Matlack <amatlack>
Component: doc-Cluster_AdministrationAssignee: Steven J. Levine <slevine>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: low Docs Contact:
Priority: low    
Version: 6.2CC: cfeist, lhh, pkennedy, slevine, ssaha
Target Milestone: rcKeywords: Documentation
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-06-21 20:51:38 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:

Description Allison Matlack 2011-06-10 13:22:15 UTC
Need to integrate kbase article "What are the debug options that can be enabled for RHEL6 clustering?" into official product docs.

Link to kbase article: https://access.redhat.com/kb/docs/DOC-53585

Comment 2 Steven J. Levine 2011-06-14 15:27:00 UTC
Logging options are currently defined in the annotated cluster schema (plus in the Conga section). The plans are to expand the logging section of the ccs command documentation, but the basic cluster.conf options are defined in that file.

Reassigning to me.

Comment 3 Steven J. Levine 2011-08-16 20:57:07 UTC
Moving to 6.3, as per the Version field.

Comment 6 Steven J. Levine 2011-08-24 17:37:01 UTC
The bug was originally filed as being Version 6.3, which is what I was referring to in Comment 3. I thought I had moved the flag to 6.2, but it looks as if what I did was remove the 6.2 flag and then check the 6.2 flag again instead of the 6.3 flag.

Comment 7 Steven J. Levine 2011-10-18 21:57:48 UTC
[Adding Chris Feist to the cc list since resolving this bug will involve adding some ccs documentation about logging.]

The debug options are mostly part of the logging options. These are my plans to expand the documentation regarding debug and logging:

- As noted, the logging options are defined specifically in the annotated cluster schema, and the Conga chapter includes a section on configuring logging with Conga. The debug option per se is noted as something you can set -- to enable debugging messages in the log file. There's not much more to document about it, I don't think.

- The ccs chapter currently does not mention logging at all. I will add a new section on configuring logging with ccs with the --setlogging, --addlogging, and --rmlogging options of the ccs command.

- The chapter on the cluster.conf file does not explicitly document configuring logging with the logging tag. I will add a small section about this, to parallel the section in the ccs chapter, including the sample section of cluster.conf that is currently in the kBase article..

- The kBase article includes a summary of enabling dlm debug logging. Configuration for dlm is, so far, not part of the Cluster Administration manual. It seems pretty internal -- something more for a developer than a system administrator. I will pursue whether we really want to document this in the Cluster Administration manual, but I think that at most we should just refer to the annotated schema for information about enabling dlm logging. Even there, that would involve documenting dlm in the first place and that's what I'm not certain about.