Troubleshooting
In any complex environment, you occasionally run into problems. This section includes tips for
isolating and resolving the most common errors that you may encounter.
This section refers to the Apache HTTPD binary as apache, which is what it is named
on Debian systems. However, in most other distributions, the binary is named httpd.
On different systems, you may need to substitute httpd for apache when it appears by itself, although
not for commands such as apachectl.
Configuration Errors
You may occasionally run into configuration errors or script problems that prevent Apache from
starting or that prevent specific files from being accessible. Most of these problems can be isolated
and resolved using two Apache-provided tools: the apachectl program and the system error log.
When encountering a problem, first use the apachectl program with the configtest parameter
to test the configuration. In fact, it??™s a good idea to develop the habit of running this every time you
make a configuration change:
NOTE
662
Running Servers Part V
# apachectl configtest
Syntax OK
# apachectl graceful
/usr/sbin/apachectl graceful: httpd gracefully restarted
In the event of a syntax error, apachectl indicates where the error occurs and also does its
best to give a hint about the nature of the problem.
Pages:
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223