IBM Express Runtime application development toolkit README

To install the IBM Express Runtime application development toolkit, see the IBM Express Runtime application development toolkit InfoCenter, which is accessible from the LaunchPad. By default, you find the launchpad programs on the first CD or DVD in the installation media.
ProgramCommand
Linux LaunchPadIRUT_LinuxLaunchpad
Linux InstallationIRUT_LinuxSetup
Linux on POWER(TM) LaunchPadIRUT_LinuxPPCLaunchpad
Linux on POWER(TM) InstallationIRUT_LinuxPPCSetup
Windows LaunchPadIRUT_WindowsLaunchpad.exe
Windows InstallationIRUT_WindowsSetup.exe

See the license directory in your installation path for product license and third-party license and notice files.

Table of Contents

Known development issues
    Log on with administrator authority
    IBM Installation Agent required for deploying middleware to remote computers
    Linux shortcuts on Applications menu
    Deployment wizard cannot connect to a Linux target computer
    Redeployment of WebSphere Application Server - Express fails
    Location of Eclipse .log file

Documentation issues
    Supported Web browser required for documentation
    Some languages must use browsers configured to use the UTF-8 codepage
    Supported platforms for Linux listed incorrectly
    IBM Express Runtime information Web site

Messages
    IRU00129
    IRU03026
    IRU10950


Known development issues

Log on with administrator authority

To install IBM Express Runtime application development toolkit, you must be logged on to the target computer as a user with administrator authority. The installation fails if you are not logged on as an administrator, and there might not be any error messages logged to IRU_Install.log indicating the problem. If the installation fails and no information is available in the log file, exit the installation, log in as a user with administrator authority, and try the installation again.

IBM Installation Agent required for deploying middleware to remote computers

If you are using Express Runtime to install middleware directly to a computer that is remote to yours, you must first install the IBM Installation Agent on that computer.

With the exception of the localhost, all the target computers that you deploy a solution to must have the IBM Installation Agent installed and running in order for the solution to be successfully deployed.

More information regarding the IBM Installation Agent, including installation directions, is in the IBM Installation Agent InfoCenter.

Linux shortcuts on Applications menu

On the Linux platform, the Express Runtime menu shortcuts might also appear under the Applications menu.

Deployment wizard cannot connect to a Linux target computer

The /etc/hosts file in a Linux distribution must be configured properly to enable RMI. If the Linux target computer is not properly configured, you will encounter the following Java exception when the deployment wizard attempts to connect.

Java.lang.NullPointerException
     at sun.rmi.transport.tcp.TCPConnection.getOutputStream(TCPConnection.java:83)
     at sun.rmi.transport.tcp.TCPChannel.createConnection(TCPChannel.java:206)
     at sun.rmi.transport.tcp.TCPChannel.newConnection(TCPChannel.java:188)

To configure the Linux target computer, modify the /etc/hosts file on the target computer as follows:
  1. Open the /etc/hosts file in an editor.
    There should be an entry for the loop back address, similar to 127.0.0.2 localhost.localdomain localhost.
  2. Check to see if the actual hostname of the computer is included in this entry. An entry containing the actual hostname might look similar to 127.0.0.1 testmachine.ibm.com testmachine localhost. localdomain localhost, where testmachine.ibm.com testmachine is the hostname. If the actual hostname is included, remove both the fully-qualified and short name versions of the hostname from the entry. In the example noted, you would remove testmachine.ibm.com testmachine.
  3. If the actual IP address and hostname of the target computer are not included in the hosts file, add them. For example, 9.42.76.1000 testmachine100.ibm.com testmachine100.
  4. Restart the network.

Redeployment of WebSphere Application Server - Express fails
After uninstalling WebSphere Application Server - Express, you must remove the AppServer directory from the target computer before attempting to redeploy WebSphere Application Server - Express.

Location of Eclipse .log file

The Eclipse .log file is stored in workspace\.metadata\.log, where workspace is the location where all a user's files and projects are stored.

Documentation issues

Supported Web browser required for documentation
A Web browser is required to view the documentation for this product. If no Web browser is available, the online documentation is not accessible.

Some languages must use browsers configured to use the UTF-8 codepage
Browsers must be configured to use the UTF-8 codepage to view the program help files and InfoCenter in the following languages:

Supported platforms for Linux listed incorrectly

The following platforms are not supported in Express Runtime, Version 2.1:

SUSE LINUX Enterprise Server 8.0 is supported for deployment only.

IBM Express Runtime information Web site

For more information about IBM Express Runtime products, see http://www.ibm.com/partnerworld/isv/go/expressruntime.

Messages

The following messages are new or have been modified since the release of the Express Runtime 2.1 InfoCenter.

IRU00129: The user {0} must possess the special authorities *ALLOBJ, *SAVSYS, *JOBCTL, *SERVICE, *SPLCTL, *SECADM, *AUDIT, *IOSYSCFG to perform this task.

Explanation: The user attempted a task for which he does not have sufficient authority.
User Response: Update the user profile to include the special authorities noted in the message.

IRU03026: The target computer cannot find the deployment package {0}.

Explanation: The deployment wizard cannot find the specified file or there is not enough space on the target computer for the installation JAR file. This file is necessary for the software installation.
User Response: Free up some disk space on the target computer. Restart the deployment wizard on the staging server and IBM Installation Agent on the target computer, and then start the installation again. If the problem persists, print the log file and contact your solution provider.

IRU10950: The uninstallation of the {0} plug-in failed. Run {1} to uninstall the plug-in.

Explanation: The uninstallation of an Express Runtime console plug-in failed. Failure might be caused by any number of problems, including network problems, a corrupted installation registry, an incorrect user ID or password, or other reasons.
User Response: Manually run the uninstallation program that is listed in the message.

(C) Copyright IBM Corporation 2003, 2005
IBM Legal: http://www.ibm.com/legal/us/