If the log files are not generating enough information to identify the cause of a problem, you can run the Access Gateway Service in debug mode. You should not be running in debug mode except when you are trying to isolate a problem because of the following side effects:
Debug mode causes the size of the log files to grow quickly. They can grow large enough to consume all available disk space and crash the system. When running in debug mode, you need to carefully monitor available disk space and the size of the log files.
Debug mode opens additional ports. Anyone who has local access to the Access Gateway machine can see the information displayed in the following local URLs:
http://127.0.0.1:8181/server-status http://127.0.0.1:8181/server-info
Debug mode causes load and response times to slow.
Debug mode enables core dumps, enables X-Mag headers in LAN traces, and increases log levels by enabling all options in the DebugSettings.conf file located in the following directory:
Linux: /var/opt/novell/tomcat5/webaps/agm/WEB-INF/config/apache2
Windows: \Program Files\Novell\apache\conf
This section describes the following tasks:
Use the following commands to start debug mode:
/etc/init.d/novell-apache2 stop /etc/init.d/novell-apache2 start debug
Use the following steps to enable debug mode:
Create a tmp directory at the root of C:
Stop Apache:
Click > > .
Right-click the Apache 2.2 service, then select .
Start Apache:
Right-click the service, then click .
In the box, specify
-D allowServerDebug
Click .
Examine the Apache error log file or copy it so you can send it to Novell Technical Support:
Linux: /var/log/novell-apache2
Windows: \Program Files\Novell\apache\logs
View the information at the local URLs or copy the pages to send to Novell Support:
http://127.0.0.1:8181/server-status
This page displays debug information about caching, SSL, workers, and proxy information.
http://127.0.0.1:8181/server-info
This page displays module and configuration information.
If a crash occurred, examine the core dump file or copy it so you can send it to Novell Technical Support.
Linux: /var/cache/novell-apache2
Windows: C:\tmp directory that you created
Use the following commands to disable debug mode:
/etc/init.d/novell-apache2 stop /etc/init.d/novell-apache2 start nodebug
Use the following steps to disable debug mode:
Click > > .
Right-click the Apache 2.2 service, then select .
Right-click the service, then click .
In the Start parameters box, remove
-D allowServerDebug
Click .