Reading the Installation Log
The QXtend installation log, named QXTEND-InstallLog-<TimeStamp>.log, resides in the configured directory that was chosen when running the installer. The log file captures all of the standard output from the JVM during the install. If you are running the GUI installer, the information displayed in the Detailed Messages tab is the same as the information in the log file.
If an error occurred, you can read the log file during or after the install. If the pause occurred during installation (see
Process Control), you can look at the file without exiting the installer. In some cases, you can fix the problem and rerun the routine that failed.
If the installation process completed with a non-fatal error, you can identify the error by looking in the
repository.xml file (see
Checking repository.xml). To find the problem, look for the component that owns the failed routine. Then search the log file for the beginning of that component by finding the name followed by the instance in square brackets. For example:
QXtend Inbound Servlet [default]
=============================================
The failed routine has a corresponding ant task. Look for an ant task with a name that is similar to that of the failed routine. For example:
add-tomcat-users:
[copy] Copying 1 file to /qad/tomcat-164-8110/conf
[xslt] Processing /qad/tomcat-164-8110/conf/tomcat-users.xml.bak
to /qad/tomcat-164-8110/conf/tomcat-users.xml
[xslt] Loading stylesheet
/tmp/656641.tmp/resources/Transformations/tomcat-users.xsl
If the routine is successful, you see a message similar to the following:
BUILD SUCCESSFUL
Total time: 1 second
Trying to override old definition of datatype resources
If the routine is unsuccessful, you see a message similar to the following:
BUILD FAILED
java.net.ConnectException: Connection refused
The failure message includes a Java stack trace of the error. Since stack traces are sometimes hard to understand, QAD provides Helpful Hints when the installer pauses for an error.
Reading the steps around the error can provide clues regarding its cause.