Troubleshooting Installation Issues

Most of the issues that occur during installation are likely to be logged in one of the log files described in this section. You should review each log file to identify the source of the problem. The Apache or Tomcat errors are open source projects, so the errors logged in these types of log files should be documented. Use a Web search engine to search for the information specific to the error.


Reviewing Log Files Created During Installation

The following four log files are created during the Liberty IDP installation:

1. apache_install.log: This log file, located by default at C:\Program Files\Novell\apache_install.log, documents the various steps of the Apache installation. The key portion of this file is the "Installation operation completed successfully" message shown in the example below. any error messages in this file should be noted. Since Apache is an open source project, Web sites such as Google* are likely to reference many of the errors reported.

1: SelfStartService 2: 0
1: StartApacheMonitor 2: 0 
Action ended 10:35:15: InstallFinalize. Return value 1.
Action start 10:35:15: RemoveExistingProducts.
Action ended 10:35:15: RemoveExistingProducts. Return value 1.
Action ended 10:35:15: INSTALL. Return value 1.
=== Logging stopped: 4/2/2003  10:35:15 ===
MSI (s) (14:3C): Product: Apache HTTP Server 2.0.44 -- Installation operation completed successfully.

2. Apache_Tomcat_Installlog.txt:This log file, located by default at C:\Program Files\Novell\Tomcat\Apache_Tomcat_Installlog.txt, documents every instruction performed by the Tomcat installation, including the interface with Apache through mod_jk, the various Windows registry changes, and the setting up of the Tomcat webapps environment. The start of the file includes a counter of errors and warnings. Ideally, you should see all successes, as shown below. If you see any errors, you should scan the file for the specific errors reported. As with Apache, Tomcat is open source and many of the errors or warnings encountered are likely to be documented and referenced through Internet search engines.

Summary
-------

Installation: Successful.
1408 SUCCESSES
0 WARNINGS
0 NONFATAL ERRORS
0 FATAL ERRORS

3. Novell_iManager_1.5.1_InstallLog: This log file, located by default at C:\Program Files\Novell\Tomcat\webapps\eMFrame\WEB-INF\install\Novell_iManager_1.5.1_InstallLog, documents every instruction performed by the iManager installation, the various Windows registry changes, and the setting up of the Tomcat webapps environment for iManager. The start of the file includes a counter of errors and warnings. Ideally, you should see all successes, as shown in the previous log file above. If there are any errors, you should scan the file for the specific errors reported and take appropriate action (for example, if you did not have enough disk space to copy over class files, you would need to free the required space and try installing again).

4. Novell_Liberty_Identity_Provider_for_Novell_eDirectory_InstallLog.txt: This file, located by default at C:\Program Files\Novell\Tomcat\webapps\nidp\Novell_Liberty_Identity_Provider_for_Novell_eDirectory_InstallLog.txt, documents every instruction performed by the Liberty installation, including the various Windows registry changes, and the files and directories installed. As with the other log files described, the start of the file includes a counter of errors and warnings. Ideally, you want to see all successes. If there are any errors, you should scan the file for the specific errors reported and take appropriate action (for example, if you did not have enough disk space to copy over class files, you would need to free the required space and try installing again).