© Copyright International Business Machines Corporation 2000, 2007. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
The information in this readme file also applies to the IBM Rational Performance Tester Extension for SOA Quality. Both IBM Rational Tester for SOA Quality and the IBM Rational Performance Tester Extension for SOA Quality provide SOA testing capabilities.
The SOA testing capabilities automate the creation, execution, and analysis of functional, regression, and performance tests for Web services and SOA applications. The SOA testing capabilities support the HTTP, SSL, SOAP, and Java Messaging Service (JMS) protocols.
The latest version of this document is available at http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/v7/rpt/7001/docs/readme/readme_soa.html.
Rational Tester for SOA Quality is powered by Rational Performance Tester. See the release notes for version 7.0 of Rational Performance Tester to learn about its new features and any limitations or problems known at the time of its release. The release notes for version 7.0 of Rational Performance Tester are available at http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/v7/rpt/70/docs/readme/readme.html.
IBM Rational Tester for SOA Quality and IBM Rational Performance Tester Extension for SOA Quality are the same product—but the former is being produced as a separate product and comes with only one virtual user. Because the virtual users are limited, the two versions are used for different purposes. The following table shows the differences between the two versions:
Task IBM Rational Tester for SOA Quality IBM Rational Performance Tester Extension for SOA Quality Overall goal Test the functional behavior of an SOA system Test the behavior and performance of an SOA system Emulating workloads in tests This help section does not apply to the product This help section applies to the product Running performance tests Click Run > Run Performance Test Click Run > Run Performance Schedule Evaluating performance test results The reports of interest are the Test log and Web Service Verification Point report The reports of interest are the Web Service Performance report and the Web Service Verification Point report
For general installation information, see the installation instructions for Rational Performance Tester, on the Web at http://download.boulder.ibm.com/ibmdl/pub/software/rationalsdp/v7/rpt/70/docs/install_instruction/install.html.
You can also view the installation guide for your product from the installation launchpad and in the documents directory of the first product CD.
Rational Performance Tester Extension for SOA Quality Version 7.0 requires Rational Performance Tester Version 7.0.0.1 or higher to install. If you attempt to install Rational Performance Tester Extension for SOA Quality Version 7.0 to an installation of Rational Performance Tester 7.0, Installation Manager will display a validation error message. To work around this behavior, upgrade Rational Performance Tester to Version 7.0.0.1 or higher before attempting to install Rational Performance Tester Extension for SOA Quality.
Until Rational Performance Tester 7.0.0.2 is available, do not attempt to install Rational Tester for SOA Quality into a common shell with Rational software products other than Rational Performance Tester. When multiple Rational software products are installed on a single system, they can share a single common Eclipse instance. This is known as shell sharing. Rational Tester for SOA Quality is powered by Rational Performance Tester. Installing Rational Tester for SOA Quality into a common shell with Rational software products is not supported on Rational Performance Tester 7.0.0.1. Shell sharing will be supported on Rational Performance Tester 7.0.0.2.
When you import a test that uses a WSDL file that contains XSD or WSDL import references, these XSD or WSDL files are not imported as resources in the project. You must import these files into the workspace manually.
When you import a test suite that has references to WSDL with XSD or WSDL imports, the documents contained in the WSDL file are not imported.
In the WS Protocol Data view, the XML Diff Help is not dynamically updated when the preferences are changed.
Change the preferences (Window > Preferences > General > Compare/Patch) before opening the WS Protocol Data view.
If the WS Protocol Data view is already open, close and re-open it to use the new preferences.
When you create a new Web Services Call, the default SOAP envelope generated does not address all the XSD types and constraints. For constraints, the envelope will only be created with 0 elements or 1 element. Complex constraints on the quantity of elements are not supported. Array types are not supported. The same limitations apply to an XSD specification made using attributes in the schema. To work around this behavior, manually insert elements using the views provided for editing SOAP envelopes.
When a port binding or call definition used in a test cannot be found after a WSDL modification, an error mark is displayed on the resource in the test navigator. Sometimes an error mark is displayed in the error log view but not in the test navigator. When the mark is displayed, the mark does not always disappear after the error has been fixed; however, the error log is correctly updated.
When you import a test and then rename the WSDL file, the WSDL file is always referenced in the test, even when you re-import the test. To avoid this behavior, delete the renamed WSDL file before re-importing a test that you have imported previously.
The menu item "Add from schema" is available in the detailed view of a Web service call element. When you select "Add from schema," the default SOAP envelope generated does not address all the XSD types and constraints. For constraints, the envelope will only be created with 0 elements or 1 element. Complex constraints on the quantity of elements are not supported. Array types are not supported. The same limitations apply for an XSD specification made using attributes in the schema. To work around this behavior, manually insert elements using the views provided for editing SOAP envelopes.
If you are recording a Web service which does not declare the soapAction element in its WSDL file, you might observe an error message after recording, during the generation of the test suite. This message warns you that the tools have not been able to bind the URL observed during the recording to the port of the associated WSDL.
The workaround is to explicitly declare the soapAction in the WSDL file, as in this example (soapAction=""):
<wsdl:operation name="example">
<soap:operation soapAction=""/>
<wsdl:input name="exampleRequest"> ...
If you manually create a Web service call in a test suite, the default generation process does not handle the header tag. It only focuses on the input required for the method call. If you already defined the types that will compose the header in your WSDL file, you will need to create them manually in the views used for editing the SOAP message.
IBM Rational Software Support provides you with technical assistance.
For contact information and guidelines or reference materials that you will need when you require support, read the IBM Software Support Handbook.
Rational Tester for SOA Quality is powered by Rational Performance Tester. For product information about Rational Performance Tester, visit the product home page at www.ibm.com/software/awdtools/tester/performance/.
For FAQs, lists of known problems and fixes, and other support information, visit the product support page at www.ibm.com/software/awdtools/tester/performance/support/index.html.
For Rational software product news, events, and other information, visit the IBM Rational Software Web site.
Before you contact IBM Rational Software Support, gather the background information that you will need to describe your problem. When describing a problem to an IBM software support specialist, be as specific as possible and include all relevant background information so that the specialist can help you solve the problem efficiently. To save time, know the answers to these questions:
- What software versions were you running when the problem occurred?
- Do you have logs, traces, or messages that are related to the problem?
- Can you reproduce the problem? If so, what steps do you take to reproduce it?
- Is there a workaround for the problem? If so, be prepared to describe the workaround?
© Copyright IBM Corporation 2000, 2007.
The XDoclet Documentation included in this IBM product is used with permission and is covered under the following copyright attribution statement: Copyright © 2000-2004, XDoclet Team. All rights reserved.
U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
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 documentation 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 documentation. The furnishing of this documentation does not give 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, 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 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 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.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:
Intellectual Property Dept. for Rational Software
IBM Corporation
20 Maguire Road
Lexington, Massachusetts 02421-3112
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 documentation 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.
All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.
This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples may 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 illustrates 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:
© (your company name) (year). Portions of this code are derived from IBM Corp. Sample Programs. © Copyright IBM Corp. 2000, 2007.Trademarks and service marks
The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:
AIX
CICS
ClearCase
developerWorks
IBM
IMS
OS/400
Rational
Tivoli
Tivoli Enterprise
WebSphere
z/OS
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.
Microsoft and Windows are trademarks of Microsoft Corporation in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Linux is a trademark of Linus Torvalds in the United States, other countries, or both.
Other company, product or service names, may be trademarks or service marks of others.