IBM WebSphere Studio Application Developer for Windows Version 5.1.1 - Readme

Welcome to the integrated suite of WebSphere Studio tools, powered by Eclipse technology release 2.1.2. To view the latest version of this readme file, go to this Web address: www3.software.ibm.com/ibmdl/pub/software/websphere/studiotools/html/511/wsad/readme.html

Table of contents

1.0 Hardware requirements
2.0 Supported software
3.0 Version 5.1.1 release notes
4.0 About Eclipse
5.0 Where to find more information
6.0 Creating and installing from the installation image

1.0 Hardware requirements

See the Installation Guide for the hardware requirements for installing WebSphere Studio Application Developer.

2.0 Supported software

For details of software and specifications that are supported by a particular tool in WebSphere Studio, refer to the online help.

Notes:

1. Other SCM repositories can be integrated with WebSphere Studio Application Developer through software configuration management (SCM) team adapters. If you want to work with another SCM provider, SCM team adapters for commercial SCM products are provided by the vendors of those products. To find a list of SCM products and team adapters provided by IBM Business Partners, go to www.ibm.com/software/ad/studioappdev/partners/scm.html. From this list, you can access the SCM product vendors' Web sites to download the SCM team adapter of your choice. IBM does not endorse or warrant these team adapters. For support, or further information, please contact the SCM product vendor directly. 

3.0 Version 5.1.1 release notes

Release notes cover release-specific information (such as problems and limitations) that did not become available until after the product documentation was finalized.

• General
• Documentation updates
• Web tools
• EJB tools
• Web services tools
• Relational database tools
• Testing and deployment tools
• Profiling and logging tools
• Agent Controller
• Team programming with Rational ClearCase
• Debuggers
• UML visualization and editing for J2EE
• Page Designer
• JavaServer Faces tooling (beta)

For information about known problems and workarounds in the Eclipse base, refer to the readme_eclipse.html file located in the ws_install_dir\eclipse\readme directory (where ws_install_dir is your WebSphere Studio installation directory). This information is available in English only.

For information about what has changed since the previous release, refer to the product overview, which can be accessed from the main menu (Select Help > Help Contents, then select the Product overview book).  Details about the new functionality described in the Product overview section can be found in the online help.

4.0 About Eclipse

Eclipse is an open-source project that creates royalty-free technology and a universal platform for tools integration. Eclipse-based tools give developers freedom of choice in a multi-language, multi-platform, multi-vendor environment. Eclipse delivers a framework for developing plug-ins that makes it easier to create, integrate, and use software tools, saving time and money. By collaborating and sharing core integration technology, tool producers can concentrate on their areas of expertise and the creation of new development technology. The Eclipse platform is written in the Java language and comes with extensive toolkits and examples for construction plug-ins. It has already been deployed on a range of operating system environments including Linux, MAC OS X, QNX, and Windows based systems. Full details of the Eclipse community and white papers documenting the design of the Eclipse platform are available at www.eclipse.org.

Toolkits and complementary middleware from IBM integrate with the WebSphere Studio environment, allowing you to quickly and easily add new functionality targeted at specific development needs. Plug-in tools from other vendors, also built using the open Eclipse platform, integrate with the WebSphere Studio environment to provide additional value.

5.0 Where to find more information

• Installation, migration, and coexistence
  • For information about installing WebSphere Studio Application Developer, see the Installation Guide. 
  • For information about migrating applications to WebSphere Studio Application Developer or upgrading from previous releases, see the Migration Guide. 
  • For information about using WebSphere Studio Application Developer together with VisualAge for Java, see the coexistence paper listed at www.ibm.com/websphere/developer/zones/studio/transition.html 
  • Updates to information about installation, migration, and coexistence will be posted at www.ibm.com/websphere/developer/zones/studio/transition.html 
• For general information about the product, refer to the "Product overview" section of the online help.
• Product news, updates, and fixes
  • The product home page for WebSphere Studio Application Developer is www.ibm.com/software/ad/studioappdev. For FAQs, lists of known problems and fixes, and other support information, click the Support link at that site.
• Technical articles and sample code
  • The WebSphere Developer Domain Web site at  www.ibm.com/websphere/developer offers technical articles, "how to" information, tutorials, samples, and previews of new technology.
• Updates to documentation
  • Both the product home page and WebSphere Developer Domain have Library sections that provide updates to scenario documents and other documentation.

6.0 Creating and installing from the installation image

Prerequisites:

• Your environment variable TEMP or TMP must point to a valid temporary directory with at least 130 MB free. This is in addition to the space required to install the product.
• You must have approximately 2 GB of disk space to store the full set of downloadable images plus another 2 GB of disk space to unpack the images.

There are 20 downloadable parts for WebSphere Studio Application Developer. You must download the first 11 at a minimum; the rest are optional. Refer to the list below for details about what each archive contains:

• Part 1 - REQUIRED. Contains core installation files.
• Part 2 - REQUIRED. Contains core installation files.
• Part 3 - REQUIRED. Contains core installation files.
• Part 4 - REQUIRED. Contains core installation files.
• Part 5 - REQUIRED. Contains core installation files.
• Part 6 - REQUIRED. Contains core installation files.
• Part 7 - REQUIRED. Contains core installation files.
• Part 8 - REQUIRED. Contains core installation files.
• Part 9 - REQUIRED. Contains core installation files.
• Part 10 - REQUIRED. Contains core installation files.
• Part 11 - REQUIRED. Contains core installation files.
• Part 12 - OPTIONAL. Contains the WebSphere Application Server V5.1 Integrated Test Environment.
• Part 13 - OPTIONAL. Contains the WebSphere Application Server V5.0 Integrated Test Environment.
• Part 14 - OPTIONAL. Contains the WebSphere Application Server V4.0 Integrated Test Environment.
• Part 15 - OPTIONAL. Contains the WebSphere Application Server Express V5.1 Integrated Test Environment.
• Part 16 - OPTIONAL. Contains the WebSphere Application Server Express V5.0 Integrated Test Environment.
• Part 17 - OPTIONAL. Contains the Language Pack.
• Part 18 - OPTIONAL. Contains Agent Controller. Download this part if you intend to use Agent Controller for profiling and remote deployment.
• Part 19 - OPTIONAL. Contains the Rational ClearCase LT. Download this part if you intend to use ClearCase for your software configuration management (SCM) solution, and do not have Rational ClearCase (or Rational ClearCase LT) Version 4.2 or later.
• Part 20 - OPTIONAL. Contains the embedded messaging client and server. Important: If MQSeries is already installed, do not install this part because the messaging and queuing client and server are a subset of the functions of the MQSeries.

To download and create the installation image:

1. Download all the required parts and any optional parts to the same temporary directory.
2. Launch the wsextract.exe file that is located in this temporary directory. This starts the wizard that creates the installation image.
3. Follow the instructions in the wizard to specify where you want to create the image and which features you want to include.
4. After the image is created, if you want to install the product immediately, select Start the installation wizard now before you click Finish. Alternatively, you can run the installation program later by launching temp_dir\IBMWSAppDev-5.1.1\disk1\launchpad.exe, where temp_dir is the directory where you created the installation image.
5. Follow the instructions in the "Installing from the CD-ROM" section of the Installation Guide

Copyrights and notices

(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

IBM, ClearCase, Rational, VisualAge, and WebSphere are trademarks or registered trademarks of IBM Corporation in the United States and/or other countries. 

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

Microsoft and Windows are trademarks of Microsoft Corporation in the United States and/or other countries. 

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

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 OR CONDITIONS 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 notices.