Installation guide

Troubleshooting
104 Sun ONE Identity Server Policy Agents 2.1 • Web Policy Agents Guide • September 2004
The log is located by default at the Agent_Install_Dir directory. This is the best
source of debug information for resolving initialization and agent operation
issues. The log file directory is specified by the property:
com.sun.am.policy.am.logFile in the AMAgent.properties file located in
the directory:
Agent_Install_Dir\iis\config\_PathInstanceName
The property com.sun.am.policy.am.loglevels controls the verbosity of
the log information. Set the logging level for the specified logging categories.
The format of the values is:
ModuleName[:Level],ModuleName[:Level]]*
The currently used module names are AuthService, NamingService,
PolicyService, SessionService, PolicyEngine, ServiceEngine, Notification,
PolicyAgent, RemoteLog and all. If the level is omitted, then the logging
module will be created with the default logging level, which is the logging
level associated with the 'all' module.
The all module can be used to set the logging level for all modules. This will
also establish the default level for all subsequently created modules.The
meaning of the 'Level' value is described below:
0 = Disable logging from specified module
1 = Log error messages
2 = Log warning and error messages
3 = Log info, warning, and error messages
4 = Log debug, info, warning, and error messages
5 = Like level 4, but with even more debugging messages.
• Check that the agent can locate the AMAgent.properties configuration file.
The agent uses the registry key HKEY_LOCAL_MACHINE\Software\Sun
Microsystems\Identity Server IIS Agent
to locate the
AMAgent.properties file. The AMAgent.properties file is located at:
Agent_Install_Dir\iis\config\_PathInstanceName
• The agent uses the Application Event Log to log errors that occur before the
debug log file specified in AMAgent.properties is started.
a. From the Start menu, choose Programs > Administrative Tools > Event
Viewer.