The following lists some of the most commonly found error messages encountered when installing WebSphere Process Server.
If you do not see a problem that resembles yours, or if the information provided does not solve your problem, contact IBM WebSphere Process Server support for further assistance.
This message will appear if you are attempting to install additional features on top of an existing WebSphere Process Server installation by means of a silent incremental installation and the correct version of WebSphere Process Server was not detected on the system. Check to make sure that WebSphere Process Server is already installed in the location you specified in the silent installation response file and that the installed product version is greater than or equal to the version you are attempting to install. For example, if you are attempting to install WebSphere Process Server features from a WebSphere Process Server 6.0.2.0 installation CD, make sure WebSphere Process Server 6.0.2.0 (or later) is installed in the proper location.
Check that the node name, host name, and cell name contain a valid sequence of characters. Use the IBM defaults provided or make sure that your names do not use disallowed characters, as described below:
A node name or a cell name cannot have any spaces, and the following characters are not allowed: / \ * , : ; = + ? | < > & % ’ ". A host name cannot have any spaces, cannot start with any of the preceding characters, and cannot be surrounded by brackets ( [ ] ).
The remainder of this message says: The following files could not be found. list of files Please reenter the directory for the Location of the JDBC driver classpath files. For the given panel's database configuration, the Profile wizard will verify that the necessary jar files exist for the JDBC driver. If the Profile wizard can't verify that the files exist (each database type has a different set), it will present you with this message along with the list of files to help you find the correct directory to specify.
The Profile wizard will not augment an existing profile if it is currently running. You do not need to exit the Profile wizard; shut down the server and then continue with the Profile wizard.
The remainder of this message says: Wait until the current creation or deletion operation is complete before continuing. When a profile is being created, augmented, or deleted, a global lock is made on the Profile Registry. This lock prevents other changes (create/augment/delete) from occurring at the same time.
Solution: Run only one instance of any Profile wizard at a time. Wait until the other creation, augmentation, or deletion process is finished before continuing. If you determine that no other creation, augmentation, or deletion process is running, manually release the profileRegistry.xml lock, which might have been left over from the prior installation attempt. To release this lock, delete the file install_root/properties/profileRegistry.xml_LOCK.
The log file entry is: The Installation Wizard cannot install WebSphere Process Server. The installation response file for WebSphere Application Server Network Deployment, responsefile.nd.txt, was not found.
Possible solution: If the installation image was copied from one location to another (for example, from a product CD to your C:\ drive, on Windows) make sure you also copy the WAS directory (containing the file responsefile.nd.txt) and that it exists in the same root directory as the WBI directory for the installation image.
The log file entry is: Supported IBM JDK was not found. The IBM JDK shipped with this product must be located at <install_image_root>/JDK. Please correct this problem and try again.
Possible solution: If the installation image was copied from one location to another (for example, from a product CD to your C:\ drive, on Windows) make sure you also copy the JDK directory and that it exists in the same root directory as the WBI directory for the installation image. Then start the installation program again (WBI/install on Linux or UNIX operating systems or WBI\install.exe on Windows operating systems).
The log file entry is: A supported version of IBM WebSphere Application Server was not found. The installation files for the version of IBM WebSphere Application Server Network Deployment shipped with this product must be located at <install_image_root>/WAS. Please correct this problem and try again.
This error occurs if the version of WebSphere Application Server Network Deployment shipped with WebSphere Process Server is not detected in the installation image root directory, and either you are trying to install a new instance of WebSphere Application Server Network Deployment for use with WebSphere Process Server or the Installation wizard is attempting to upgrade your existing WebSphere Application Server installation to the supported level.
If the installation image was copied from one location to another (for example, from a product CD to your C:\ drive, on Windows) make sure you also copy the WAS directory and that it exists in the same root directory as the WBI directory for the installation image.
On Linux and UNIX platforms: The log file
entry is: There is insufficient free disk space on the system. /tmp
Required: 535 MB. Available: n MB. Please ensure there is enough free disk
space on all required filesystems and retry the operation.
A total of 535 MB of /tmp disk space is required on Linux and UNIX platforms when the WebSphere Process Server Installation Wizard silently installs WebSphere Application Server or WebSphere Application Server Network Deployment or needs to upgrade an existing installation of WebSphere Application Server or WebSphere Application Server Network Deployment to the supported level.
The log file entry is: A previous attempt to uninstall WebSphere Process Server failed for the following installation location: <install_root>. Follow the instructions on preparing for reinstallation after a failed uninstallation in the product information center to uninstall WebSphere Process Server and then reinstall the product before attempting to use it.
This error occurs in the Installation wizard if you attempt to add features or launch the Profile wizard for an installation of WebSphere Process Server that is no longer valid.
For more information, refer to the instructions for Preparing for reinstallation after a failed uninstallation.
The log file entry is: The selected installation of WebSphere Process Server is no longer valid since the underlying WebSphere Application Server product has been uninstalled. Please uninstall WebSphere Process Server from the following location: <install_root>. You must then reinstall WebSphere Process Server before attempting to use the product.
This error occurs in the Installation wizard if you attempt to add features or launch the Profile wizard for an installation of WebSphere Process Server that is no longer valid because the underlying WebSphere Application Server product is uninstalled.
When uninstalling WebSphere Process Server, this message will be logged if the Common Event Infrastructure application is in use by products other than the instance of WebSphere Process Server that you are uninstalling.
When uninstalling WebSphere Process Server, this message will be logged if the underlying WebSphere Application Server product is still in use by another product using the Common Event Infrastructure and therefore cannot be uninstalled.
If you get the message "A suitable JVM could not be found. Please run the program again using the option -is:javahome <JAVA HOME DIR>," it is because the JDK shipped with WebSphere Process Server could not be found. If the installation image was copied from one location to another (for example, from the product CD to your C:\ drive, on Windows) make sure you also copy the JDK directory and that it exists in the same root directory as the WBI directory for the installation image.
On Windows platforms: This is a profile creation
error. It can occur during installation or when using the Profile wizard.
Installation problem (Complete installation only)
The input line is too long.
The installation directory path must be no longer than 60 characters.
The node name field is available during a custom installation. The length of the default node name is usually short enough. Avoid using a node name that is longer than 10 characters if possible.
You can select your own profiles path, which could be C:\profiles, for example.
You can select your own profile name.
Verify from the install_root/logs/wbi/log.txt file that the ISMPConfigManagerLaunchAction is successful.
(date time), Install, com.ibm.ws.install.ni.ismp.actions.ISMPConfigManagerLaunchAction, msg1, INSTCONFSUCCESS: Post-installation configuration is successful. (date time), Install, com.ibm.ws.install.ni.ismp.actions.ISMPWSProfileLaunchAction, err, INSTCONFFAILED: Cannot complete required configuration actions after the installation. The configuration failed. The installation is not successful. Refer to C:\Program Files\IBM\WebSphere\ProcServer\logs\wasprofile\ wasprofile_create_default.log for more details. (date time), Install, com.ibm.ws.install.ni.ismp.actions.ISMPLogFileAction, msg1, Profile Creation is finished. (date time), Install, com.ibm.ws.install.ni.ismp.actions.ISMPLogSuccessMessageAction, msg1, INSTCONFFAILED
Profile wizard problem
The input line is too long.
The number of characters in the profile_root must be no more than 80 characters.
If your directory path is 80 characters or less and you still have a problem, edit the install_root\bin\setupCmdLine.bat file to make it use the Windows subst command. The subst command maps an entire path to a virtual drive. After editing the file, run the Profile wizard again. If changing the setupCmdLine.bat file does not fix the problem, you can install the WebSphere Process Server product using a shorter installation path, such as C:\WPS.
For a description of how to edit the setupCmdLine.bat file, see "The input line is too long" section in the topic Problems starting or using the wsadmin command in the WebSphere Application Server Network Deployment, version 6.0, information center.
On AIX platforms: You can allocate expansion space
for directories on AIX. If the Installation wizard does not have enough space,
InstallShield for MultiPlatforms (ISMP) issues a system call for more space
that increases the space allocation dynamically. The message you might see
when this occurs for the /usr directory is similar to the following
example:
NOTE: The following file systems will be expanded during the installation: /usr
On Linux and UNIX platforms: If the file
system is not dynamically expandable, an insufficient amount of disk space
results in a message that is similar to the following example:
The disk space is 33 Mbyte less than required. The installation cannot continue.
This error indicates that you deleted the installation root directory before using the uninstaller program to remove the product. Now you are attempting to reinstall into the same directory.
To correct the problem, you must remove registry entries that can prevent you from reinstalling the product into the original directory.
To "clean" your system in this way, refer to the instructions for Preparing for reinstallation after a failed uninstallation.
(Month day, year time), Install, com.ibm.ws.install.ni.ismp.actions.ISMPWarningDialogAction, wrn, Specify a different directory or perform a manual uninstall to remove all packages before reinstalling to the same directory.
Error writing file = There may not be enough temporary disk space. Try using -is:tempdir to use a temporary directory on a partition with more disk space.
This error can occur when you have not provided enough temp space to create a profile. Verify that you have a minimum of 40 MB of temp space available before creating a profile.
For more information about creating profiles, see Creating profiles.
This error occurs when you enter localhost as the value for the Host name field in the Profile wizard.
For information on valid host names, see the section on "Host name considerations" in Naming considerations for profiles, nodes, hosts, and cells.
(date, time), Plugin.Install, com.ibm.wizard.platform.linux.LinuxProductServiceImpl, wrn, The installer could not successfully add the product information into the RPM database. Installation will continue as this is not critical to the installation of the product.
rpm -q --all
If the command hangs, the problem is a corrupt RPM database.
On Linux and UNIX platforms: The ISMP Launch
Browser action throws the following exception on Linux and UNIX systems:
com.installshield.wizardx.actions.LaunchBrowserAction, err, java.io.IOException: konqueror: not found STACK_TRACE: 11 java.io.IOException: konqueror: not found at java.lang.UNIXProcess.forkAndExec(Native Method) at java.lang.UNIXProcess.<init>(UNIXProcess.java:72) at java.lang.Runtime.execInternal(Native Method) at java.lang.Runtime.exec(Runtime.java:602) at java.lang.Runtime.exec(Runtime.java:524) at java.lang.Runtime.exec(Runtime.java:490) at com.installshield.util.BrowserLauncher.openURL (BrowserLauncher.java:578) at com.installshield.wizardx.actions.LaunchBrowserAction.execute (LaunchBrowserAction .java:62) at com.installshield.wizard.RunnableWizardBeanContext.run RunnableWizardBeanContext. java:21)
This action searches for a Netscape, Mozilla, or Konqueror browser for displaying an HTML page or a Web site. In the case of the Web server plug-ins for WebSphere Application Server, the target page is the Plug-ins roadmap. Even though the ISMP Launch Browser action might find Mozilla or Netscape, the exception is thrown and a log entry occurs.
You can safely ignore this error.
Last updated: Tue 31 Oct 2006 09:53:28
(c) Copyright IBM Corporation 2005, 2006.
This information center is powered by Eclipse technology (http://www.eclipse.org)