README: IBM Express Runtime, Version 2.1.1



This document applies to version 2, release 1, modification 1 of IBM Express Runtime (product number 5724-J10).

Copyright International Business Machines Corporation 2003, 2005. All rights reserved.
US Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

What's new in Express Runtime Version 2.1 and Version 2.1.1 ?
Express Runtime system requirements
Known development issues
Installing Express Runtime on a SUSE LINUX Enterprise Server 9.0 Computer
Erroneous "wrong volume" message when exiting launch pad
Linux shortcuts on Application menu
Double-byte word wrapping in deployment wizard
Period in directory name
Migrating wrappers to Express Runtime 2.1.1
Some Mozilla browsers do not display the GUI correctly
Known documentation issues
Some languages must use browsers configured to use the UTF-8 codepage
Displaying the InfoCenter in simplified Chinese requires "zh_cn" language preference
Appendix. Notices
Trademarks

What's new in Express Runtime Version 2.1 and Version 2.1.1 ?

New features and functions in Express Runtime 2.1.1:

New features and functions in Express Runtime 2.1.0:

Express Runtime system requirements

This topic lists the hardware and software prerequisites for installing and using Express Runtime.

Operating system support

The following tables show which specific operating systems are supported for each basic platform type:

Windows(R)

Operating System Development or Deployment Deployable as Target OS?
Windows XP Professional SP(TM) 2
both No
Note: Informix Dynamic Server is the only Express Runtime middleware that supports Windows XP Professional SP 2.
Windows 2000 Server SP 4 both Yes
Windows 2000 Advanced Server SP 4 both Yes
Windows 2000 Professional SP 3 both Yes
Windows Server 2003, Standard Edition SP 1 both Yes
Windows Server 2003, Enterprise Edition SP 1 both Yes

Linux(R) (Intel(R) Pentium(R) or equivalent platforms only)

Operating System Development or Deployment Deployable as Target OS?
Red Flag Advanced Server 4.1 deployment only Yes
Red Hat Enterprise Linux 3.0 WS/AS/ES both Yes
Red Hat Enterprise Linux 4.0 WS/AS/ES deployment only Yes
SUSE LINUX Enterprise Server 8.0
deployment only Yes
Note: Informix Dynamic Server is not supported on SUSE LINUX Enterprise Server 8.0
SUSE LINUX Enterprise Server 9.0 both Yes

Linux (IBM POWER5(TM) processor-based technology systems only)

Operating System Development or Deployment Deployable as Target OS?
Linux on POWER(TM)
(using  
SUSE LINUX
Enterprise Server 9.0  
Red Hat Enterprise
Linux AS 3.0
Red Hat Enterprise
Linux AS 4.0
Note: Informix Dynamic Server is not supported on Linux on POWER.
deployment only Yes
AIX 5.3
neither Yes

OS/400(R)

Operating System Development or Deployment Deployable as Target OS?
V5R2 neither Yes

i5/OS(TM)1

Operating System Development or Deployment Deployable as Target OS?
V5R3 and V5R3M5 neither Yes

Windows development requirements

Linux development requirements

Windows deployment server requirements

Linux deployment server requirements

Linux on IBM POWER deployment server requirements

Windows deployment target requirements

Linux deployment target requirements

Linux on IBM POWER deployment target requirements

AIX deployment target requirements

i5/OS and OS/400 deployment target requirements

Middleware requirements

Informix Dynamic Server - Express TC3E for Windows and Informix Dynamic Server UC3E for Linux

For Windows computers, verify that your computer meets the minimum requirements:

For Linux platforms, the following prerequisite RPM packages are required:

For Linux platforms, the following are require to use optional graphical tools:

Note: * = the build number is irrelevant.

If Informix Dynamic Server is to be used on Windows platforms, the drive where Informix Dynamic Server is to be installed must be formatted as NTFS.

WebSphere Application Server - Express 6.0.2

The hardware and software requirements are provided in the WebSphere Application Server - Express InfoCenter:

http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp

IBM HTTP Server

The hardware and software requirements are provided in the WebSphere Application Server - Express InfoCenter:

http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp

Rational Web Developer 6.0

The hardware and software requirements are provided in the Rational Web Developer InfoCenter:

http://www.ibm.com/software/awdtools/developer/web/sysreq/

Note: for Linux platforms, Rational Web Developer requires that Mozilla 1.4 be installed before it can be run.

Express Runtime console

The hardware and software requirements are provided in the Express Runtime console InfoCenter:

http://publib.boulder.ibm.com/infocenter/iru21inf/index.jsp

Known development issues

The development issues known at the time the product was shipped are:

Refer to the support section of the Express Runtime Web site (http://www.ibm.com/software/webservers/expressruntime/) for more information about other issues, or contact your IBM Support Center representative.

Installing Express Runtime on a SUSE LINUX Enterprise Server 9.0 Computer

When attempting to install IBM Express Runtime on SUSE LINUX Enterprise Server 9.0, if the options on the Middleware Selection Panel are greyed out and the installation program reports that it cannot locate the required resources to proceed with the installation, the CD or DVD drive is not properly mounted. To correct this situation please perform the following steps:

  1. Cancel the installation program.
  2. Close any open file browser windows.
  3. Close any open Express Runtime Launchpad windows.
  4. Open a terminal window and execute the command mkdir /mnt/cdrom.
  5. From the terminal window execute the command mount /dev/cdrom mnt/cdrom.
  6. From the terminal window type ls /mnt/cdrom to ensure your the drive is properly mounted and you can access the files.
  7. Open a new file browser window and open the location /mnt/cdrom.
  8. Click on launchpad.sh or LinuxSetup to re-start the installation program.

Erroneous "wrong volume" message when exiting launch pad

When exiting the Express Runtime launch pad on Windows platforms, you might see the following error message: "The wrong volume is in the drive. Please insert volume ER211MP-Main1 into drive <x:>". Ignore this message: it does not affect program operation in any way. Close the message window by clicking Continue twice.

Linux shortcuts on Application menu

On the Linux platform, the Express Runtime menu shortcuts might also be displayed under the application menu.

Double-byte word wrapping in deployment wizard

In the deployment wizard, double-byte words may wrap in the middle of the word. If you encounter this behavior, open your double-byte translated application and solution files, locate the translated strings for the following elements, and insert a space in locations where it is acceptable to wrap your sentences.

Period in directory name

Do not install IBM HTTP Server in a directory that contains a "." in the name.

Migrating wrappers to Express Runtime 2.1.1

This section describes how to migrate applications and solutions created using Integrated Runtime, Version 1.1 to Express Runtime, Version 2.1.1. This information is not necessary for migrating Express Runtime wrappers from version 2.1 to version 2.1.1.

  1. Move project and deployment package files.
    1. If you are moving your projects to another physical system, you can export the projects to a removable media, using File > Export > File system. You do not have to include the bin folder, but include the .classpath and .project files.
    2. Import your Integrated Runtime 1.1 projects to your Express Runtime 2.1.1 developer workspace using File > Import > Existing project into workspace. This makes the necessary updates to your wrappers, adding new XML tags and updating classpath information. The import wizard does not physically move or copy the imported files. If you prefer to have your imported project's files physically reside under the target workspace folder, ensure that the project to be imported is placed there prior to the import.
    3. If you are migrating an application that was included with Integrated Runtime v1.1, copy the application's deployment package from the Integrated Runtime v1.1 installation directory to the Express Runtime v2.1.1 installation directory.
      1. Locate the deployment package .jar file in the Integrated Runtime v1.1 installation directory (<INSTALLATION_DIRECTORY>/Runtime/SolutionEnabler/com/ibm/jsdt/webserver/tree). The deployment package filename contains the application ID and an abbreviation of the platform it is intended for (for example, "win" = Windows, "lnx" = Linux).
      2. Copy the application's deployment package to the Express Runtime v2.1.1 installation directory (<INSTALLATION_DIRECTORY>/Runtime21/SolutionEnabler/com/ibm/jsdt/webserver/tree).
      3. Rename the copy of the deployment package in the Express Runtime v2.1.1 installation directory, changing the ".en.jar" suffix to " .xx.jar."
  2. Update wrapper files.
    1. For each project you want to migrate, open the solution or application wrapper in the appropriate wrapper editor.
    2. Review the new updates generated by the import to ensure the correct values have been used and to add information to the optional attributes. The new attributes as listed below in the schema changes section.
    3. Optionally remove deprecated tags using the Source tab in the wrapper editor to edit the XML. The deprecated tags are listed in the Problems view in the developer. The wrapper does work in Express Runtime 2.1.1 if you leave the deprecated tags.
  3. Generate the solution.

Schema changes from Version 2.1

Detailed information about the XML schema is located in the InfoCenter under Express Runtime 2.1.1 > Reference > XML Schemas.

Application wrappers

Deprecated elements:

Solution wrappers

New elements:

Some Mozilla browsers do not display the GUI correctly

Eclipse 3.0.1 and Rational Web Developer 6.0 requires the SWT plug-in version 3.1.0.4 in order to support Mozilla 1.7. This plug-in is packaged as 3.0.2 for eclipse 3.0.x-based products. Eclipse 3.0.1 does not support all Linux browsers by default. Complete the following steps:

  1. Set the MOZILLA_FIVE_HOME environment variable to the locations of the Mozilla browser you are using. Do this by adding the following to the eclipse_start.sh script: "export MOZILLA_FIVE_HOME=/usr/lib/path_to_mozilla". eclipse_start.sh is located in the in the opt/IBM/Runtime21/SolutionEnabler directory.
  2. Run update manager by clicking Help > Software Updates > Find and Install and select the SWT 3.0.2 plugin.
  3. Restart Eclipse to see the Express Runtime Welcome page display correctly.

Known documentation issues

This section contains information about known documentation issues at the time the product was shipped.

Refer to the support section of the Express Runtime Web site (http://www.ibm.com/software/webservers/expressruntime/) for more information about other issues, or contact your IBM Support Center representative.

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:

Displaying the InfoCenter in simplified Chinese requires "zh_cn" language preference

If you are viewing the InfoCenter, set the browser language preference to "zh_cn" instead of "zh" to ensure the document displays in simplified Chinese. You can set this by clicking Tools > Internet Options on the Internet Explorer menu and selecting Languages.

Appendix. Notices

This information was developed for products and services offered in the U.S.A.

IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY  10504-1785
U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106-0032, Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

IBM Corporation
Software Interoperability Coordinator, Department 49XA
3605 Highway 52 N
Rochester, MN 55901
U.S.A.

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs.

Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:

If you are viewing this information softcopy, the photographs and color illustrations may not appear.

Trademarks

The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:

DB2
IBM
Informix
i5/OS
OS/400
WebSphere

Intel, Intel Inside (logos), MMX(TM), and Pentium are trademarks of Intel Corporation in the United States, other countries, or both.

Microsoft(R), Windows, Windows NT(R), and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

UNIX(R) is a registered trademark of The Open Group in the United States and other countries.

Other company, product, or service names may be trademarks or service marks of others.


1.
The OS/400 operating system is known as the i5/OS operating system beginning with V5R3.