If installation fails and you are unable to complete the installer, follow the installer error messages to correct problems with software dependencies. In addition, the installer creates four separate log files and places them in the installation folder. The generated log files are listed below:
AquaLogic_Interaction_Publisher_InstallLog.log
content_register.log
workflow_register.log
imageserver_register.log (This is created only for Image Service installations).
If you encounter problems after installation, review the <install_root>\ptcs\6.3\logs\service.log fileto help diagnose and correct the problem.
In addition, you can use the Publisher and Workflow diagnostic pages to troubleshoot your installation.
Two Publisher database configuration files are populated with information you entered in the Publisher installer. Later, these files may be modified if you must change a database configuration setting. The files database.content.properties and database.portal.properties areinstalled in the following directory:
<install_root>\ptcs\6.3\settings\config\
Similarly, there is a Workflow database configuration file that is populated with information that you entered in the Publisher installer. This file, application.conf, is installed in the following directory:
<install_root>\ptworkflow\6.3\settings\config
Reconfiguring Publisher
If the installation verification tool reports configuration errors, review the configuration decisions you recorded on the configuration worksheets provided in Installation Worksheet for AquaLogic Interaction Publisher 6.3 and re-run the installer.
Diagnosing Unexpected Results
This following table provides symptom-solution interpretations for unexpected results you might encounter when you install and deploy Publisher.
Table 7-1 Troubleshooting
Symptom
Possible Solution
When you start Publisher, the portlets time out and errors are displayed. These errors are most likely to occur when you start up the Publisher the first time after it is installed.
The Java Server Pages (.jsp pages) in your application server were not precompiled before you started Publisher for the first time.
Refresh the page to resolve the errors.
An error occurs when trying to publish content where the publish target is a drive mapped to a network shared folder.
Specify a UNC path instead of a mapped drive for the publish target. For more information, see KB article DA_130773, "Problem Publishing Content Server Content To a Mapped Drive."
The BEA AquaLogic Interaction Publisher Service does not start.
The BEA AquaLogic Interaction Publisher Service attempts to connect to port 1098, which may already be in use. To change the port:
Open <install_root>\ptcs\settings\config\container.conf with a text editor.
Change plumtree.container.jboss.jndi.rmi.port=1098 to indicate an unused port, for example 10098.
Restart the BEA AquaLogic Interaction Publisher Service.
Port conflict, port in use, BindException
Port numbers for HTTP and HTTPS are configured in <install_root>/ptcs/6.3/setttings/config/service.conf. Edit the http and https settings in service.conf to set the value to an available port. The service must be restarted to pick up changes made in the configuration file. Note that changes to a service port number require corresponding changes to any web service or remote server settings which may reference that port number.
Memory consumption, Out of Memory Errors
The maximum amount of memory, in megabytes, that the service JVM will be allowed to use is controlled by the wrapper.java.maxmemory property, configured in the file <install_root>/ptcs/6.3/settings/config/service.conf. For example, the following line shows a maximum memory setting of 1 GB:
wrapper.java.maxmemory=1024
The setting corresponds directly to the -Xmx parameter used by the java executable. The default value of this setting in the config file will be adequate for most configurations. For large production configurations, especially those in which the service is installed on a dedicated host machine, this value should be set as high as possible (e.g. 1024 or 1536) but should always remain below the amount of physical RAM on the host machine.
