1.0 Introduction
2.0 Supported software and specifications
3.0 Changes from the previous release
4.0 Known problems
4.1 Updating online documentation with translated versions
4.2 Struts documentation updates
4.3 Changes in instructions for the Hospital scenario
4.4 WSDL errors after importing a Web services file from 4.0.x
4.5 Using WebSphere Studio Version 5.1 with Version 5.0 workspace
4.6 Ignore the Embedded Messaging Client only has been installed message
4.7 Changing default selections when using Update Manager
4.8 Migration Guide updates
4.9 Ignore the "Uninstalling Rational ClearCase LT" section in the Installation Guide
4.10 Canceling the installation program may take a while before the cancel takes affect
4.11 Updates to the WebSphere Application Server - Express Installation guide
4.12 Broken link to install.html
4.13 No support for a silent install from CD
4.14 Responsefile included with build for silent install
4.15 Update to the installation guide - modifying your installation
4.16 No error indicating problem with disk space when performing a silent install
4.17 Security feature not available for Agent Controller on AIX
4.18 Version 5.0.2 entry in Add/Remove programs window dissapears if you install Version 5.0
This readme file pertains to the online documentation provided with WebSphere Studio.
Viewing a Show Me
A Show Me is a short movie that provides a visual walkthrough of the task topic that you have open in the online help system. The actions shown in the demo map directly to the steps written in the task. This provides you with another way to learn the steps of a complex task.
Not all tasks have a Show Me associated with them. If a task topic has a Show Me, you will see a link under the title of the topic.
Click the Show Me link to start the demonstration. A new window will open and the Show Me will begin playing automatically. There are controls at the bottom of the window that let you control the Show Me playback. This way you can replay sections as needed.
When you are finished viewing the Show Me, just close the window to return to the topic in the online help system.
Except for some key pieces (the Getting Started, Install and Migration Guides, and others), only the English version of the online documentation are 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 or Help > Software Updates > Update Manager in the Workbench.
Getting Started Guide Struts sample
In the Getting Started Guide under "Loading the Struts Trade Sample," 4.0 should be changed to 5.0 and 8080 should be changed to 7080 in the following bullet item: Created a server project named Trade Server, which runs in the WebSphere version 4.0 test environment and listens on TCP/IP port number 8080.
When you create the patient or insurance Web service, a warning may pop up that says that the Web service is not WS-I compliant. This warning can be ignored.
(This is a migration item.) If you have imported a Web services file from 4.0.x, you may receive the following error messages:
Error The part 'result' has an invalid value 'anyElement' defined for its type. Type declarations must refer to valid values defined in a schema.
Error The part 'return' has an invalid value 'findPatientResult' defined for its element. Element declarations must refer to valid values defined in a schema.
Error The part 'response' has an invalid value 'findPatientResponse' defined for its element. Element declarations must refer to valid values defined in a schema.The workaround is:
- Delete the WSDL files.
- Regenerate your Web services by rerunning the Web Services wizard.
When WebSphere Studio Version 5.1 is started for the first time using an existing WebSphere Studio Version 5.0 workspace a dialog box appears showing you one way to migrate from Version 5.0 to Version 5.1. Click OK to migrate the Version 5.0 workspace to Version 5.1, or click Cancel to stop WebSphere Studio from starting.
When the workspace is migrated to Version 5.1, you can still use the workspace with Version 5.0 as the metadata of the new project features of Version 5.1 are ignored and can be read by Version 5.0. You cannot make any changes in Version 5.0 to the projects in the workspace that would effect the metadata or overwrite the metadata of the new project feature of Version 5.1 projects.
For more information about the new project features in Version 5.1, refer to the WebSphere Studio Migration Guide.
Even though the messaging and queuing support was not installed, you may receive the "Embedded Messaging Client only has been installed" message upon starting the server. This message refers to the build-in client code for the MQ Simulator for Java Developers and not the messaging and queuing support code. The message can be safely ignored.
When using Update Manager to apply service, you may be prompted with an Optional Features dialog asking if you would like to update optional features. Do not modify the default selections. If you attempt to service a feature that is not already installed on your system, you will receive error messages.
- The second sentence in the second paragraph of the "WebSphere Studio Workbench in Version 5, Version 5.0.1, and Version 5.1" section, should say: "There are some differences between WSWB 2.1.1 and WSWB 2.0.3 or WSWB 2.0.2."
- All references in the guide to Struts 1.1 RC1 should say Struts 1.1.
Since the Rational ClearCase LT is not available in this product, you can safely ignore the "Uninstalling Rational ClearCase LT" section in the Installation Guide.
If during the installation of the product you press Cancel, the installation program may continue for a while before the cancel takes affect.
The following are updates to the WebSphere Application Server - Express installation guide:
- In the WebSphere Application Server - Express Installation Guide the section titled "Verifying Your Agent Controller Installation" tells you to look in the /opt/IBM/WebSphere/Express/racInstallLog.txt file for the install completion status. It is normal for this file to be empty. It does not contain an install completion status. If you restart Linux then you will need to restart the Agent Controller either using the entry on the Program menu or by running the /opt/IBMRAC/bin/RAStart.sh script.
- When running the uninstall of WebSphere Application Server - Express the feature panel that is displayed has several additional features shown than are displayed during the installation. These additional features show up as subfeatures of the Studio Site Developer feature. If you want to select or deselect the Studio Site Developer feature make sure that all subfeatures are selected or deselected. If you only want to select or deselect the Language Pack feature, then make sure you select or deselect both occurrences of Language Pack.
- In order to run the SetConfig utility of the IBM Agent Controller you must have java in your execution path
- On Linux if you run the setupLinux install program from a command window and the current working directory of the command window is /mnt/cdrom and you are installing from the CD, then when the installation asks you for the second installation CD you will not be able to eject the first CD from the drive. This happens because the command window working directory is pointing to the CD so the CD drive appears to be in use. To avoid this make sure that you do not have the working directory of a command window set to /mnt/cdrom. This means that instead of using the command ./setupLinux to start the install, you use the full path to the CD, /mnt/cdrom/setupLinux.
- If you install WebSphere Application Server - Express 5.0.2 on a machine where you already have a copy of WebSphere Application Server - Express 5.0, the IBM Agent Controller will be updated to the 5.0.2 version and will be configured to point to the 5.0.2 Express server. If you subsequently want to remove WebSphere Application Server - Express 5.0.2 and restore your 5.0 environment, you will need to reinstall the 5.0 Application Server or Studio Site Developer component in order to restore the 5.0 version of IBM Agent Controller. Either of these 5.0 features also installs IBM Agent Controller for 5.0.
- On Linux, AIX, Solaris, and HP-UX if you run this command "/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary" you may get errors reported regarding mqver not found and wempsservice not found. You can ignore these error messages.
In 'Related Information', the install.html link is broken. However, this link is unnecessary since it refers to itself.
WebSphere Application Server - Express does not support a silent install from a CD.
A sample responsefile is included with Express in: \util\responsefile.txt. You can use and edit this file.
If you type '-silent' on the command line and the '-silent' is commented out of the responsefile, the installation runs silently. It does not show the InstallShield dialog, which is shown when there is no '-silent' on the command line and the '-silent' is uncommented in the responsefile.
You should use the responsefile solely for the control of the installation process. There should not be '-silent' at the command line.
If you install WebSphere Studio, and then start the installation program again to install (or re-install) various componenent, and select to cancel the installation before it finishes, you may receive the following error:
"Errors occured during the installation - User cancelled installation".
When you attempt to uninstall the product, you may receve the following error:
"A suitable JVM could not be found. Please run the program again using the option -is:javahome <JAVA HOME DIR>.
To work around this, you must run the installation program again, then uninstall the product.
If you are performing a silent installation of WebSphere Studio and you do not have enough disk space to install the product, you will not receive an error message when the installation fails. To work around this, ensure you have enough disk space before you start the installation. The amount of disk space required is listed in the Installation guide.
The log in security feature for Agent Controller is not available if you install Agent Controller on AIX.
If you install Version 5.0.2 of WebSphere Studio, and then install Version 5.0 (to a different directory), you will not see the entry for WebSphere Studio in the Add/Remove programs list.
To uninstall the product, you must run the uninstaller.exe manually from the file system or command line.
Return to the main readme file
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.