1.0 Introduction
2.0 Known problems
2.1 Struts documentation updates
2.2 Page Designer Classic and embedded graphics tools are not available for Linux
2.3 Moving views when Motif is your window view system
2.4 Changes in instructions for the Hospital scenario
2.5 WSDL errors after importing a Web services file from 4.0.x
2.6 Using WebSphere Studio Version 5.1 with Version 5.0 workspace
2.7 Ignore the Embedded Messaging Client only has been installed message
2.8 Changing default selections when using Update Manager
2.9 Migration Guide updates
2.10 Alternate image text does not appear in documentation
2.11 Ignore the "Uninstalling Rational ClearCase LT" section in the Installation Guide
2.12 Canceling the installation program may take a while before the cancel takes affect
2.13 Command for uninstalling on Linux, AIX, Solaris, and HP-UX is incorrect
2.14 Updates to the WebSphere Application Server - Express Installation guide
2.15 Broken link to install.html
2.16 No support for a silent install from CD
2.17 Update to the installation guide - modifying your installation
2.18 Security feature not available for Agent Controller on AIX
This readme file pertains to the online documentation provided with WebSphere Studio.
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.
Page Designer Classic, along with the embedded graphics tools, WebArt Designer and AnimatedGif Designer, are not available in WebSphere Studio for Linux 5.0.x. Therefore, any inadvertant references to these tools in help files or F1 infopops should be disregarded.
If you are working with WebSphere Studio on Linux and your window view system is Motif, you must select a view with your middle mouse button in order to be able to move it around. Otherwise, if you have a two button mouse, you hold both buttons down when selecting a view if you want to move it.
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.
The alternate image text for documentation images does not appear when you are viewing the documentation on Linux.
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.
In the WebSphere Application Server - Express Installation Guide the instructions for uninstalling on Linux, AIX, Solaris, and HP-UX say to run the command: ./uninstall.sh. This command does not exist. The correct command to run is ./uninstaller.
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.
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.
The log in security feature for Agent Controller is not available if you install Agent Controller on AIX.
Return to the main readme file
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.