Troubleshooting; Log Files; General Problems - Red Hat NETWORK SATELLITE 5.3.0 Installation Manual

Chapter 7.

Troubleshooting

This chapter provides tips for determining the cause of and resolving the most common errors
associated with RHN Satellite. If you need additional help, contact Red Hat Network support at
rhn.redhat.com/help/contact.pxt. Log in using your Satellite-entitled account to see your full list of
options.
In addition, you may package configuration information and logs from the Satellite and send them to
Red Hat for further diagnosis. Refer to

7.1. Log Files

Virtually every troubleshooting step should start with a look at the associated log file or files. These
provide invaluable information about the activity that has taken place on the device or within the
application that can be used to monitor performance and ensure proper configuration. See
"Log Files"
for the paths to all relevant log files:
Component/Task
Apache Web server
RHN Satellite
RHN Satellite Installation
Program
Database installation - Embedded
Database
Database population
RHN Satellite Synchronization
Tool
Monitoring infrastructure
Monitoring notifications
RHN DB Control - Embedded
Database
RHN Task Engine (taskomatic)
yum
XML-RPC transactions
Table 7.1. Log Files

7.2. General Problems

To begin troubleshooting general problems, examine the log file or files related to the component
exhibiting failures. A useful exercise is to issue the tail -f command for all log files and then run
yum list on Red Hat Enterprise Linux 5 (or up2date --list on earlier Red Hat Enterprise Linux
versions). You should then examine all new log entries for potential clues.
A common issue is full disk space. An almost sure sign of this is the appearance of halted writing in
the log files. If logging stopped during a write, such as mid-word, you likely have filled disks. To confirm
this, run this command and check the percentages in the Use% column:
Section 7.7, "Satellite Debugging by Red Hat"
Log File Location
/var/log/httpd/ directory
/var/log/rhn/ directory
/var/log/rhn_satellite_install.log
/var/log/rhn/rhn-database-installation.log
/var/log/rhn/populate_db.log
/var/log/rhn/rhn_server_satellite.log
/var/lib/nocpulse/ directory
/var/log/notification/ directory
/var/log/rhn/rhn_database.log
/var/log/messages
/var/log/yum.log
/var/log/rhn/rhn_server_xmlrpc.log
https://
for instructions.
Table 7.1,
51