Installation guide

Note
If you have exhausted these troubleshooting steps or want to defer them to Red Hat Network
professionals, Red Hat recommends you take advantage of the strong support that comes with
Red Hat Satellite. T he most efficient way to do this is to aggregate your Satellite's configuration
parameters, log files, and database information and send this package directly to Red Hat.
Red Hat Network provides a command line tool explicitly for this purpose: T he Satellite
Diagnostic Info Gatherer, commonly known by its command satellite-debug. T o use this
tool, issue the command as root. You will see the pieces of information collected and the single
tarball created, like so:
# satellite-debug
Collecting and packaging relevant diagnostic information.
Warning: this may take som e tim e...
* copying configuration information
* copying logs
* querying RPM database (versioning of Red Hat Satellite, etc.)
* querying schema version and database character sets
* get diskspace available
* timestam ping
* creating tarball (m ay take some time): /tmp/satellite-debug.tar.bz2
* removing tem porary debug tree
Debug dum p created, stored in /tmp/satellite-debug.tar.bz2
Deliver the generated tarball to your Red Hat Network contact or support
channel.
Once finished, email the new file from the /tm p/ directory to your Red Hat representative for
immediate diagnosis.
Additionally, Red Hat provides a command line tool called the SoS Report, commonly known by
its command sosreport. T his tool collects your Proxy's configuration parameters, log files, and
database information and sends it directly to Red Hat.
To use this tool for Red Hat Satellite information, you must have the sos package installed. T ype
sosreport -o rhn as root on the Satellite server to create a report. For example:
[root@satserver ~]# sosreport -o rhn
sosreport (version 1.7)
This utility will collect some detailed information about the
hardware and setup of your Red Hat Enterprise Linux system .
The information is collected and an archive is packaged under
/tmp, which you can send to a support representative.
Red Hat will use this information for diagnostic purposes ONLY
and it will be considered confidential information.
This process may take a while to complete.
No changes will be made to your system .
Press ENTER to continue, or CTRL-C to quit.
You are then prompted for your first initial and last name, then a support case number.
It may take several minutes for the system to generate and archive the report to a compressed
file. Once finished, email the new file from the /tm p/ directory to your Red Hat representative for
immediate diagnosis.
Chapter 5. Troubleshooting
87