Bug 1044526 - Typoes in current (RHEL 6.5) Storage Admin Guide
Summary: Typoes in current (RHEL 6.5) Storage Admin Guide
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Linux 6
Classification: Red Hat
Component: doc-Storage_Admin_Guide
Version: 6.5
Hardware: Unspecified
OS: Unspecified
medium
low
Target Milestone: rc
: ---
Assignee: Jacquelynn East
QA Contact: ecs-bugs
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2013-12-18 13:46 UTC by Robert P. J. Day
Modified: 2015-07-26 22:11 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2014-10-16 23:44:42 UTC
Target Upstream Version:


Attachments (Terms of Use)

Description Robert P. J. Day 2013-12-18 13:46:26 UTC
At least the first part of the Guide:

* Section 1.1: "It is now possible [to] encrypt ..."

* Section 2.2.1.11: The /srv/ directory: While this section suggests that FTP or web server goes under /srv/, the default httpd install still appears to use /var/www/html for served content. That might be worth noting to avoid confusion.

* Section 2.2.1.13: Might be worth mentioning /usr/lib64/ as well. Also, on a stock RHEL 6.5 install like mine, there is no /usr/kerberos/ directory, and that section stresses that "At a minimum" such a directory should exist. Might want to back off on that claim just for that one directory.

 Possibly more later ...

Comment 1 Robert P. J. Day 2013-12-19 12:46:09 UTC
Additional pedantry -- if you spell it "shareable", you should probably spell it "unshareable" for consistency.

Comment 2 Robert P. J. Day 2013-12-20 12:54:50 UTC
Section 2.1: The sentence, "Variable files, such as documents, can be changed at any time; static files, such as binaries, do not change without an action from the system administrator."

  From my reading of the FHS, that's not quite what "variable" means. I believe the descriptor "variable" is meant to refer to system files that change constantly with no user intervention as the system runs -- things like log and lock files and so on; files that represent a perpetually-changing state of the system in normal operation.

  I don't think that "documents" is really a good example of variable files -- I would use, as I said, log and lock files.

http://www.pathname.com/fhs/pub/fhs-2.3.html#THEFILESYSTEM

Comment 3 Robert P. J. Day 2013-12-20 13:29:00 UTC
Section 2.2.1.3: "(such as with a USB [drive?])"

Table 2.1: Can't believe you don't list the serial port there, I think you need to add it (ttyS0).

Section 2.2.1.7: "Zip disks"? Really? :-)

Comment 4 Robert P. J. Day 2013-12-20 15:50:46 UTC
Section 9.1.1, NFS "Required Services", refers to the "process" rpc.nfsd. While there is an *executable* /usr/sbin/rpc.nfsd, that list in the Guide seems to suggest that it's listing *processes* that one can see actually running, such as, say, rpc.mountd and so on. As far as I know, you will not *see* a running process with the name "rpc.nfsd", so that might be clarified.

Comment 5 Robert P. J. Day 2013-12-24 14:50:16 UTC
Continuing on, Section 9.7.2, "The exportfs command", a couple oddities. First, under the "-r" option explanation, I believe the filename /etc/lib/nfs/xtab should be /var/lib/nfs/xtab, no?

Also, while that section refers to the exported filesystems being written to /var/lib/nfs/xtab, on my RHEL (OK, CentOS) 6.5 system, that file is empty while the exported filesystem is actually listed in /var/lib/nfs/etab.There is no mention of the .../etab file in that section, perhaps there should be.

Oh, and in the final Section 9.7.2.1, I think there should be quotes, as in:

RPCNFSDARGS="-N 4"

Aren't those quotes necessary there?

Comment 6 Robert P. J. Day 2013-12-24 15:30:55 UTC
Section 9.7.3.1, "systmes" -> "systems"

Section 9.10 References: Not sure there's much value in that O'Reilly book on NFS and NIS anymore, it's 12 years old.

  I think we're done here.

Comment 7 Robert P. J. Day 2013-12-28 12:38:22 UTC
It seems that the entire Section 9.7,2 is out of date as it refers numerous times to the file /var/lib/nfs/xtab, when in fact the correct file is .../etab. If you go back several years in Bugzilla here:

https://bugzilla.redhat.com/show_bug.cgi?id=262861

it would appear that the xtab file is simply not used anymore.

Comment 10 Jacquelynn East 2014-05-04 22:24:33 UTC
Robert:

> Section 2.2.1.3: "(such as with a USB [drive?])"
This does not need to change. It is talking about the connection, it can be any USB device, the USB refers to how the computer is reading it, the same with the CD, the CD is how the computer reads the information.

(In reply to Robert P. J. Day from comment #5)
> Oh, and in the final Section 9.7.2.1, I think there should be quotes, as in:
> 
> RPCNFSDARGS="-N 4"
> 
> Aren't those quotes necessary there?

Why there should be quotes? Are they required for the command to work?

Comment 11 Jacquelynn East 2014-05-30 01:21:03 UTC
Sorry forgot to add a need info.

Comment 12 Robert P. J. Day 2014-06-23 11:57:01 UTC
Possibly not, I'm just so used to seeing quotes that maybe I just assumed they were necessary. So just ignore that last point, thanks.

Comment 17 Jacquelynn East 2014-10-16 23:44:42 UTC
This change is now available in the Red Hat Enterprise Linux 6.6 documentation
at https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/.


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