Troubleshooting SRA

This section describes how to capture information that Portal Server support personnel need to troubleshoot problems in your deployment.

Debugging the Gateway

To turn debugging on or off, you set the level of debugging or set it to off. The following steps describe what to do.

To Use Debugging

Steps

1. Log in as root to the Gateway machine and edit the following files:

   • gateway-install-root/SUNWam/config/AMConfig-instance-name.properties

   • platform.conf-default or platform.conf-gateway-instance-name-provided-during-install file

2. Set the debug level to FINEST.

   com.iplanet.services.debug.level=FINEST

   The debug levels are:

   • FINEST - Only serious errors are logged in the debug file. Rewriter usually stops functioning when such errors occur.

   • WARNING - All debug messages are logged.

   • OFF - No debug messages are logged.

3. Set the log level in the platform.conf-default or platform.conf-gateway-instance-name-provided-during-install.

   The log levels are:

   • WARNING

   • INFO

   • SEVERE

   • FINE

   • FINEST

4. Restart the Gateway from a terminal window:

   ./psadmin start-sra-instance -u admin-user -p passwordfile -N default -t gateway

SRA Log Files

Examine the following log files for errors.

Gateway:

/var/opt/SUNWportal/debug/srapGateway_gateway-hostname_gateway-profile-name

NetFile:

/var/opt/SUNWporta/debug/srapNetFile

Netlet:

/var/opt/SUNWporta/debug/srapNetlet_gateway-hostname_gateway-profile-name