Documentation - release notes


1.0 Supported software and specifications
2.0 Limitations
   2.1 National language limitations
3.0 Known problems
   3.1 Update to Exploring the RDB to XML mapping editor tutorial
   3.2 Network installation may fail if the machine goes into standby mode
   3.3 Updates to the WebSphere Application Server - Express Installation Guide
   3.4 Minimum free temporary disk space for the install
   3.5 Coexistance with Site Developer from WAS-Express 5.0.2
   3.6 Location of the setupLinux executable
   3.7 Starting the application server as a non-root user
   3.8 Error reported after canceling an install
   3.9 Port conflicts when running multiple servers

1.0 Supported software and specifications

The tooling around the JavaServer Faces technology, such as the Faces components in the Palette view, is considered to be Beta level function. The documentation that refers to this function is also supported at the Beta level.
Because the JavaServer Faces features are in Beta state, they should not be used for production applications. IBM does not assure forward migration, compatibility, or support of JavaServer Page files that use these JavaServer Faces features.

2.0 Limitations

2.1 National language limitations

The following are National language limitations:

  1. Voice narration only available in English in Web Development Tour
  2. Except for some key pieces only the English version of the online documentation is provided with the product. More translated documentation will be available via Update Manager. To download these updates when they are available, select Help > Software Updates > New Updates in the Workbench.

3.0 Known problems

3.1 Update to Exploring the RDB to XML mapping editor tutorial

In Part 4, step 1b of the "Exploring the RDB to XML mapping editor" tutorial, the first sentence should be "On Linux, you will need to run source setup in a command shell in order to initialize the environment."

3.2 Network installation may fail if the machine goes into standby mode

If you machines goes into standby mode during an installation from a network installation image, the installation may fail.

3.3 Updates to the WebSphere Application Server - Express Installation Guide

3.4 Minimum free temporary disk space for the install

The Installation Guide indicates that you should have 200 megabytes of free space on your disk that is used for temporary space. This is insufficient in some cases. The minimum temporary free space recommended is 300 megabytes.

3.5 Coexistance with Site Developer from WAS-Express 5.0.2

If you install the Site Developer feature of WebSphere Application Server - Express 5.1 on a system where you already have installed the Site Developer feature of Express 5.0.2 then there is a conflict in the naming of the /usr/bin/wasexpress51 symbolic link. The 5.0.2 release used the same name that the 5.1 release is using. To allow coexistance the 5.1 installation program renames the existing 5.0.2 link to /usr/bin/wasexpress502. Note that only the link itself is renamed. No other 5.0.2 files are affected.

3.6 Location of the setupLinux executable

The Installation Guide references the setupLinux executable several times. Note that this program is in the setup directory on the installation CD disk 1 and not in the root directory as implied by the documentation.

3.7 Starting the application server as a non-root user

On Linux if you initially start the application server while logged in as root, several directories are created with the owner root and with file permissions 755 which means that only root has authority to write to the directories. If you then subsequently log in as non-root and try to start the application server, it will fail to start because it can not write to the root created directories. To resolve this situation you can go to the directory you have installed WebSphere Appplication Server - Express and then to the AppServer directory. Change the file permissions of the logs, temp, wstemp, and tranlog directories and all files in the directory to 777. You can use a command similar to "chmod -R 777 temp" to do this. You will then be able to start the application server as non-root.

3.8 Error reported after canceling an install

If you select to install the optional Language Pack feature and then Cancel the install shortly afterwards while files are being copied, subsequent installs will show some anomalies. On a subsequent install the Language Pack feature will show an (installed) status on the Feature panel even though the files that make up the language pack are not installed. You can select to reinstall the Language Pack feature and the proper files will be copied to your disk. In this situation at the end of the install you may receive a message stating that "One or more errors occurred during replacement of files". You can safely ignore this error message.

3.9 Port conflicts when running multiple servers

WebSphere Application Server - Express 5.1 can be installed on a system where you have a previous version of the server. If you want to run both servers at the same time, then the servers will need to be configured such that their ports do not conflict. You can use the Administrative Console to reconfigure the ports.

Return to the main readme file