Bug 1153667

Created attachment 947606 [details]
Draft of Proposed updates to Appendix

Draft of proposed updates to the Appendix section on GFS2 PCP Performance Analysis.

Paul:

I've been making updates to the PCP section in the GFS2 manual for RHEL 7, based on the attached file (I did visual line-by-line compare, so I may have missed some things but I'll go through this again.). I have two small questions, however:

- At the end of section A.2, you note "For more information on how to set up and configure PCP on your system, refer to the links in Section A.9. References. " But there is no section A.9. There is a section B.9 called "References" but the references don't seem to be about PCP. Here is that section:

https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Global_File_System_2/ap-references-gfs2.html

Is that the section you meant?  Which of those links discusses PCP?

- Towards the end of section A.6 there is this note:

Note: PCP comes with a default set of metrics which it will log on the host when pmlogger is enabled, the none of the GFS2 metrics are logged by the default logging configuration.

I'm not sure what "the none of the" was meant to be here.

Other than that the updated appendix (at this point) is here -- but as I say, I'll go through this again to be sure I caught all the additions.

https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Global_File_System_2/gfs2_pcp.html

Hi Steven,

I have read through the doc-draft and it's looking good, there doesn't appear to be any of the updates missed that I can see. To answer your questions it seems that in both of the cases issues have made it past my proof reading.

"... refer to the links in Section A.9. References", this was originally part of an earlier draft which did include some PCP references which I decided to removed. In the doc-draft linked you have already omitted this error.

With regards to the note towards the end of section A.6, I suggest the following change so that things make more sense:

"Note: PCP comes with a default set of metrics it will log on the host when pmlogger is enabled. However no logging of GFS2 metrics occur with this default configuration."

I have also discovered two small issues in sections A.4 and A.5 (again these are my own). Where it is mentioned to use the "-n" flag for connecting to remote hosts it is incorrect, this should be changed to use the "-h" flag for both instances.

I have made the changes indicated in Comment 4.