Novell ACCESS MANAGER 3.1 SP2 - ACCESS GATEWAY GUIDE 2010 Manual page 9

7.12 Using Curl to Download Large Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
7.13 Linux Access Gateway Crashes When Change is Applied to the Server . . . . . . . . . . . . . . . 241
8 Troubleshooting the Access Gateway Service
8.1 Useful Troubleshooting Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
8.1.1 Apache Logging Options for the Gateway Service . . . . . . . . . . . . . . . . . . . . . . . . . 244
8.1.2 The Access Gateway Service Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
8.2 Verifying That All Services Are Running . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
8.2.1 Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
8.2.2 Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
8.3 Enabling Debug Mode and Core Dumps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
8.3.1 Starting Apache in Debug Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
8.3.2 Examining the Debug Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
8.3.3 Disabling Debug Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
8.4 Useful Troubleshooting Tools for the Access Gateway Service. . . . . . . . . . . . . . . . . . . . . . . 252
8.4.1 Tools for the Windows Access Gateway Service . . . . . . . . . . . . . . . . . . . . . . . . . . 252
8.4.2 Tools for the Linux Access Gateway Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
8.5 A Few Performance Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
8.6 Solving Apache Restart Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
8.6.1 Removing Any Advanced Configuration Settings . . . . . . . . . . . . . . . . . . . . . . . . . . 254
8.6.2 Viewing the Logged Apache Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
8.6.3 Viewing the Errors as Apache Generates Them . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
8.6.4 The ActiveMQ Module Fails to Start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
8.7 Understanding the Authentication Process of the Access Gateway Service . . . . . . . . . . . . . 257
243
Contents 9