Bug 492961

(Talking with zeus, it appears I wasn't pinged on the Cobbler+Satellite documentation review, so I'm doing that now.  There are numerous errors we want to correct, but there are also various useful features in the Sat integrate we do not document indicated towards the bottom of this ...)

From my review of http://documentation-stage.bne.redhat.com/docs/en-US/Red_Hat_Network_Satellite/5.3.0/html/Reference_Guide/ch-cobbler.html

In the first section, "content channel management" is not something Cobbler does, per se, so I'd just replace that with "installation environment management".

"Automation of kickstart file creation using kickstart import" should say "cobbler import", though that's not the Satellite way to do it, so we should probably strike that line.

In 11.1.11, "the following lists the services and configuration files" implies that it lists all of the things it checks below, but the section below is not complete, so I'd say say "lists some of the services and configuration files"

In the 11.1.11 section, the setup process for configurating cobbler settings is done at Satellite install time, so the user will not need to set this things initially, and we should mention that (or not ask them to set it)

In 11.1.3, we don't list a complete DHCP file.  We probably should to show context -- a sample one that defines a range and an address section can be shown in about 10-15 lines.  What you have listed is not sufficient to DHCP a system.

In 11.1.13 list item 4, the path given is a Fedora path.  The path is "/tftpboot/pxelinux.0" on RHEL 4/5, though probably not for RHEL 6.  Should also add "cobbler makes sure this file is in the right place" or equivalent language there -- so the user doesn't try to put that file there themselves.  It might be simpler to say "Finally the DHCP server retrieves the bootloader, which is pxelinux.0" and not mention the path since cobbler takes care of that.

In 11.1.4 "change disable = yes line to disable = yes" should read in the last part "disable = no"

In 11.1.5.1, again we have a Fedora specific path.  The RHEL 4/5 path is "/var/lib/tftpboot"

In 11.1.5, under "For Cobbler" remove the section about 25150

In 11.1.5, change the "For Koan" text to "For Cobbler and Koan XMLRPC".  

In 11.1.6, cahnge "One all the prerequisites are met" to imply that there may still be some warnings/messages there that the user does not need to correct, i.e. "to your satisification" etc.   The user may not be able to make check 100% silent depending on their configuration and what they want to do.

Remove the sentence startwith with "First, ensure that" and remove the instruction to run cobbler sync.   (If it doesn't, it's a Satellite bug)

In general

Cobbler buildiso was not documented, which is very useful to customers who want to install bare metal in places where they can't PXE, and we should document it.

Cobbler replicate was not documented, though we mention it earlier in the documentation section

--netboot-enabled flags and how to reinstall an existing system (possibly using the Sat UI, or using cobbler on the command line) for PXE was not documented.

PXE menu behavior was not documented (about how you get a list of all the profiles to install if you haven't assigned a system to PXE boot to a specific profile)

The cobbler CLI for editing commands was not mentioned.

We have no pointers to http://cheetahtemplate.org or examples of where to find more information about templating, we should direct folks to the cobbler Wiki at least.

There isn't any documentation about what parts of cobbler "aren't" supported, not sure if we want to mention what those are or not.

"koan --replace-self" is not documented.

In the virtualization section, koan virtualization options to install guests via the CLI are not mentioned.