Troubleshooting installation

How to troubleshoot an unsuccessful installation of WebSphere Process Server.

Why and when to perform this task

Use this topic to diagnose possible problems when the installation is unsuccessful. The installer program records the following indicators of success at the end of the primary log file, which can be found in install_root/logs/wbi/log.txt on Linux and UNIX platforms or install_root\logs\wbi\log.txt on Windows platforms: If the result is INSTCONFPARTIALSUCCESS or INSTCONFFAILED, continue analyzing the problem by following these steps:

Steps for this task

  1. The installation process might display error messages.

    See the following topic for an explanation: Error messages: installation and profile creation and augmentation. If the message corresponds to any of those described, correct the problem, clean up any installed portions, and try to reinstall.

    For details on uninstalling any installed portions before reinstalling, refer to Preparing for reinstallation after a failed uninstallation.

  2. Determine if the installation of WebSphere Application Server Network Deployment was successful. If the installation of WebSphere Process Server was not successful, first check install_root/logs/log.txt on Linux and UNIX platforms or install_root\logs\log.txt on Windows platforms for errors to determine if the installation of WebSphere Application Network Deployment was successful. If the installation of WebSphere Application Server Network Deployment failed, refer to the installation troubleshooting information for WebSphere Application Server Network Deployment, at the WebSphere Application Server Network Deployment, version 6.0, Information Center and use the information found there to correct the problems before attempting to reinstall WebSphere Process Server. If the installation of WebSphere Application Server Network Deployment succeeded and the installation of WebSphere Process Server failed, use the troubleshooting information below to correct the problems.
  3. Check the WebSphere Process Server installation log files for errors after installing.

    Refer to Log files for the names, locations, and descriptions of the various log files that are created. Check the log files in this sequence:

    Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms:
    1. install_root/logs/wbi
    2. %tmp% if no files are found in install_root/logs/wbi
    3. install_root/logs/wasprofile/wasprofile_create_ profile_name.log or install_root/logs/wasprofile/wasprofile_augment_ profile_name.log. If you performed a Complete installation, which creates a stand-alone server named default, the value for profile_name will be default.
    4. Any additional log or trace files generated by installation actions. Look in install_root/logs/wbi for trace files generated during the installation (or uninstallation) process. Look in profile_root/logs for those generated by profile creation or augmentation, where profile_root represents the installation location of the WebSphere Process Server profile (by default, install_root/profiles/profile_name on Linux and UNIX platforms). These files are primarily intended for use by IBM technical support.
    Icon indicating Windows platforms On Windows platforms:
    1. install_root\logs\wbi
    2. %tmp% if no files are found in install_root\logs\wbi
    3. install_root\logs\wasprofile\wasprofile_create_ profile_name.log or install_root\logs\wasprofile\wasprofile_augment_ profile_name.log. If you performed a Complete installation, which creates a stand-alone server named default, the value for profile_name will be default.
    4. Any additional log files generated by installation actions. Look in install_root\logs\wbi for trace files generated during the installation (or uninstallation) process. Look in profile_root\logs for those generated by profile creation or augmentation, where profile_root represents the installation location of the WebSphere Process Server profile (by default, install_root\profiles\profile_name on Windows platforms). These files are primarily intended for use by IBM technical support.
  4. If there is no information in the installation logs, use the -log parameter with a response file.
    Certain events can prevent the InstallShield for Multiplatforms (ISMP) from starting the Installation Wizard. Such an event is not enough disk space to launch the Installation Wizard, for example. If your installation fails and there is no information in the installation logs, use the -log parameter with a response file to record entries for events that cause the ISMP program to fail to start the Installation Wizard. This will work with any one of the following response files:
    • responsefile.wps.txt
    • responsefile.pcaw.standAloneProfile.txt
    • responsefile.pcaw.dmgrProfile.txt
    • responsefile.pcaw.managedProfile.txt

    For more information about response files, refer to Installing the product silently.

    You will need to copy a response file from WebSphere Process Server CD 1 to your system’s hard drive to use it. The syntax of the install command for logging such events is as in the following examples (your paths to the response file and the log file, and the actual name of the response file might differ):

    Icon indicating AIX platforms On AIX platforms:
    install -options "/usr/IBM/WebSphere/silentFiles/myresponsefile.txt" 
            -silent -log # !/usr/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    Icon indicating HP-UX platforms Icon indicating Solaris platforms On HP-UX and Solaris platforms:
    install -options "/opt/IBM/WebSphere/silentFiles/myresponsefile.txt" 
            -silent -log # !/opt/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    Icon indicating Linux platforms Icon indicating 6.0.1 content only On Linux platforms:
    install -options "/opt/ibm/WebSphere/silentFiles/myresponsefile.txt" 
            -silent -log # !/opt/ibm/WebSphere/myOptionFiles/log.txt  @ALL
    Icon indicating Linux platforms Icon indicating 6.0.0 content only On Linux platforms:
    install -options "/opt/IBM/WebSphere/silentFiles/myresponsefile.txt" 
            -silent -log # !/opt/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    Icon indicating Windows platforms On Windows platforms:
    install.exe -options 
                "C:\Program Files\IBM\WebSphere\silentFiles\myresponsefile.txt" 
                -silent -log # 
                !C:\Program Files\IBM\WebSphere\silentFiles\log.txt  @ALL
  5. Determine whether the installation problem is caused by a configuration script that failed.

    The install_root/logs/wbi/instconfig.log file on Linux and UNIX platforms or install_root\logs\wbi\instconfig.log file on Windows platforms indicates configuration problems that can prevent the product from working correctly. Search on the string action failed to find the name of the configuration script that failed.

  6. Verify that no files exist in the install_root/classes directory.

    IBM Support sometimes queues work for customers and provides test or debugging fixes. A common location for the fixes is in the install_root/classes directory.

    By default, the install_root/classes directory is picked up first in the WebSphere Process Server class path to let it override other classes.

    Putting a fix in the directory lets you verify that the fix does indeed solve your problem. After verifying that the fix solves the problem, you should delete the fix from the install_root/classes directory to return the system to a working state.

    If you do not remove such fixes from the install_root/classes directory, you can experience errors.

  7. Uninstall the product, clean up any log files or other artifacts that are left behind, and reinstall after turning on tracing if the error logs do not contain enough information to determine the cause of the problem.
    • Report the stdout and stderr logs to the console window, by adding the -is:javaconsole parameter to the install command:
      • Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms:
        install -is:javaconsole
        Capture the stream to a file with the following commands:
        install -is:javaconsole > captureFileName.txt 2>&1
      • Icon indicating Windows platforms On Windows platforms:
        install.exe -is:javaconsole
        Capture the stream to a file with the following commands:
        install.exe -is:javaconsole > drive:\captureFileName.txt
    • Capture additional information to a log of your choice with the -is:log file_name option.
    • Turn on additional installation logging by passing the -W Setup.product.install.logAllEvents="true" parameter to the install command:
      • Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms:
        install -W Setup.product.install.logAllEvents="true"
      • Icon indicating Windows platforms On Windows platforms:
        install.exe -W Setup.product.install.logAllEvents="true"
  8. If you have successfully created a process server profile, use the First steps console or the command-line method to start the process server.
    Start the First steps console for a particular node (where profile_root represents the installation location of the WebSphere Process Server profile (by default, install_root/profiles/profile_name on Linux and UNIX platforms and install_root\profiles\profile_name on Windows platforms):
    • Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms: profile_root/firststeps/wbi/firststeps.sh
    • Icon indicating Windows platforms On Windows platforms: profile_root\firststeps\wbi\firststeps.bat
    Start the server from the command line:
    1. Change directories to the profile_root/bin directory in the profile.
    2. Start the server process.
      • Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms: ./startServer.sh server_name
      • Icon indicating Windows platforms On Windows platforms: startServer.bat server_name
  9. Verify that the server starts and loads properly by looking for a running Java process and the Open for e-business message in the SystemOut.log and SystemErr.log files.

    If no Java process exists or if the message does not appear, examine the same logs for any miscellaneous errors. Correct any errors and retry.

    You can find the SystemOut.log and SystemErr.log files in the following platform-specific directories:
    • Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms: profile_root/profiles/logs/server_name
    • Icon indicating Windows platforms On Windows platforms: profile_root\profiles\logs\server_name
  10. Use the First steps console or the command-line method to stop the process server server_name, if it is running, and to start the deployment manager if one exists.
    To stop server_name from the command line:
    • Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms: profile_root/bin/stopServer.sh server_name
    • Icon indicating Windows platforms On Windows platforms: profile_root\bin\stopServer.bat server_name
    If you enable security, specify the -user and the -password parameters of the command.
    To start the deployment manager from the command line:
    • Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms: profile_root/bin/startManager.sh
    • Icon indicating Windows platforms On Windows platforms: profile_root\bin\startManager.bat
  11. Verify that the server starts and loads properly by looking for a running Java process and the Server dmgr open for e-business message in the profile_root/logs/server_name/SystemOut.log file.
    Icon indicating Linux platforms Icon indicating UNIX platforms On Linux and UNIX platforms: Open a command window and issue the top command to see a display of running processes. If the top command is not available on your system, use the ps command:
    ps -ef | grep java

    Icon indicating Windows platforms On Windows platforms: Press Ctrl+Alt+Delete and type T to open the Task Manager. Click the Processes tab and the Image Name column header to sort by image name. Look for processes named java.exe.

    If no Java process exists or if the message does not appear, examine the same logs for any miscellaneous errors. Correct any errors and try again to start the deployment manager.

What to do next

For current information available from IBM Support on known problems and their resolution, see the IBM WebSphere Process Server support page.

IBM Support has documents that can save you time gathering the information that you need to resolve a problem. Before opening a PMR, see the IBM WebSphere Process Server support page.


Terms of use |

Last updated: Thu Apr 27 15:07:55 2006

(c) Copyright IBM Corporation 2006.
This information center is powered by Eclipse technology (http://www.eclipse.org)