Troubleshooting

This appendix provides information on troubleshooting the installation and configuration process. It includes the following topics:

Overview of Logs

This section provides the descriptions and locations of logs that you can use to troubleshoot the Pathways installation and Pathways in runtime. Individual log files are generated for each day's activity.

Installation Logs

Table A-1 Logs Used to Troubleshoot the Installation of Pathways
Log	Description	Default Location and Platform
AquaLogic_Pathways_InstallLog.log	Provides activity and error details for the installation of the main Pathways UI files.	install_dir\installlogs (Windows) install_dir/installlogs (UNIX)
AquaLogic_pathways_analytics_pathways_deployment.log	Provides activity and error details for the installation of the files required for integrating Pathways with Analytics.	install_dir\installlogs (Windows) install_dir/installlogs (UNIX)
AquaLogic_pathways_deployment.log	Provides activity and error details for the installation of the main Pathways UI files.	install_dir\installlogs (Windows) install_dir/installlogs (UNIX)
AquaLogic_pathways_portal_deployment.log	Provides activity and error details for the installation of the files required for integrating Pathways with the portal.	install_dir\installlogs (Windows) install_dir/installlogs (UNIX)
AquaLogic_rankengine_deployment.log	Provides activity and error details for the installation of the Rank Engine files.	install_dir\installlogs (Windows) install_dir/installlogs (UNIX)
AquaLogic_searchservice_deployment.log	Provides activity and error details for the installation of the files required for integrating Pathways with the Search Service.	install_dir\installlogs (Windows) install_dir/installlogs (UNIX)
AquaLogic_securityservice_deployment.log	Provides activity and error details for the installation of the files required for integrating Pathways with the Security and Directory Service.	install_dir\installlogs (Windows) install_dir/installlogs (UNIX)

Runtime Logs

Table A-2 Logs Used to Troubleshoot Pathways in Runtime
Log	Description	Default Location and Platform
wrapper.log	Provides additional activity and error details for the BEA AL Pathways service, including details for these user interfaces: Simple UI Enhanced UI Pathways Administration	install_dir\pathways\1.0\logs (Windows) install_dir/pathways/1.0/logs (UNIX)

Troubleshooting Common Installation Problems

The table in this section describes common installation and configuration problems and provides solutions to them.

Table A-3 Common Installation and Configuration Problems and Solutions
Problem Description and Details	Cause and Solution
Problem: The Submit a Document link does not appear on the Search page. Details: Users cannot submit documents and Web pages, because they cannot access the Submit page.	Cause: The settings in the Content Sources component for Pathways was either not configured or not correctly configured in Configuration Manager. Solution: Correctly configure the settings in the Content Sources component for Pathways in Configuration Manager.
Problem: Security and Directory Service is consuming too much CPU.	Solution: Reduce the number of calls made to the Security and Directory Service by increasing the expiration time of login tokens. To do so, change the setting for the wsserver.DefaultSessionDurationInMinutes node in serverconfig.xml as desired.

Using the Logging Utilities

When the Pathways portlets or the Pathways Administration UI display either an error or the Pathways diagnostic checks, one or more of the required services or Pathways itself may not be configured correctly. Use the AquaLogic Interaction Logging Utilities to help identify the specific issue by enabling Pathways and the required services as message senders within Logging Spy.