"IOException creating Runtime()" error when installing webui component
 Technote (troubleshooting)
 
Problem(Abstract)
During installation of a fix pack for WebSphere® Application Server v5.0 and v5.1 on the Microsoft® Windows® platform, update of the "webui" component by updateInstaller reports "IOException creating Runtime()" and Error 59.
 
Cause
This specific pattern of errors occurs as a result of a failure to start the launcher.exe process. This often happens because the launcher.exe file is not in the correct location.

The updateInstaller reports a failure to install a fix pack. The selective-install log file indicates that the failure occurred during the "webui" update, and indicates which log file to look in for further details about webui. The webui log file is quite large, and the errors are reported in the bottom portion of the file.

The errors are listed in the lines that follow this text:

Log: ExecCmd::launch

Both of the following error messages appear:

Error ( 2 ): IOException creating RunTime(): CreateProcess: <process_name>

Error 59 -- Execution of <class_name> returned an error message.

Result Code: 888

"Result Code 888" and "Error 2" might occur for a variety of reasons. However, when "Result Code 888" and "Error 2" also appear with "Error 59" on a Windows platform, the cause is most likely because the launcher.exe file has not been extracted to the correct location. If "Error 59" does not appear in this context, the "Error 2" and "Result Code 888" are likely to have been caused by a different problem.

Note: updateInstaller log files might be located in either of the following directories,

install_root/properties/version/log

or

install_root/logs/update.

 
Resolving the problem
In the webui log file, locate lines that resemble the following:

Log: ExecCmd::launch
Log: Launching:
Log:   0: [ "X:\IBM\AppServer\update\earLauncher\launcher.exe" ]

The path to the launcher.exe file might not be in this location, or it might lack appropriate execution permissions.

To correct this problem, move the launcher.exe file to the location listed in the error message and log file. Verify that the user installing the fix pack has execute permission for this file. If the launcher.exe program was lost or erased, download a new copy of the updateInstaller.

The launcher.exe program is included with the updateInstaller, located in the /earLauncher directory. It should not be moved from there.

For further information, refer to Technote #1137927, which lists the proper locations of updateInstaller files.
 
Related information
updateInstaller download page
 
 
Cross Reference information
Segment Product Component Platform Version Edition
Application Servers Runtimes for Java Technology Java SDK
 
 


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server > Install
Operating system(s): Windows
Software version: 5.1
Software edition:
Reference #: 1113969
IBM Group: Software Group
Modified date: Mar 25, 2005