More Related Content
Similar to IBM Rational Sample Environment Setup Guide
Similar to IBM Rational Sample Environment Setup Guide (20)
More from Darrel Rader (7)
IBM Rational Sample Environment Setup Guide
- 1. Using the sample environment for
IBM Rational Service Testing and
Virtualization products
Note: This information contains examples of data and reports used in daily business operations. To illustrate
them as completely as possible, the examples 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.
Note
Before using this information and the product it supports, read the information in “Legal Notices” on page
42.
Note: This information contains examples of data and reports used in daily business operations. To illustrate
Page 1 of 14
© IBM Corporation 2001, 2014
- 2. them as completely as possible, the examples 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.
1
SCENARIO OVERVIEW .................................................................................................................... 4
1.1
USAGE .................................................................................................................................. 4
1.2
PURPOSE .............................................................................................................................. 4
1.3
AUDIENCE .............................................................................................................................. 4
1.4
INSTALLED SOFTWARE ............................................................................................................ 4
1.5
SOFTWARE THAT NEEDS TO BE INSTALLED BY THE USER ............................................................ 4
1.5.1
Libstatgrab .................................................................................................................................... 4
1.5.2
SQLite........................................................................................................................................... 5
1.6
LICENSES .............................................................................................................................. 5
1.7
VMW ARE REQUIREMENTS ....................................................................................................... 5
1.8
HARDWARE REQUIREMENTS .................................................................................................... 5
1.9
STARTING THE SERVICES ........................................................................................................ 5
1.10 STOPPING THE SERVICES ........................................................................................................ 5
1.11 HOSTS CONFIGURATION .......................................................................................................... 6
2
SYSTEM OVERVIEW ....................................................................................................................... 7
3
VALIDATION OF THE VACATION BOOKING SYSTEM ........................................................................... 9
3.1
3.2
TOMCAT ................................................................................................................................ 9
3.3
TOMCAT AND DB2 .................................................................................................................. 9
3.4
TOMCAT AND THE HOTELS WEB SERVICE ................................................................................ 10
3.5
TOMCAT AND THE BOOKING MANAGEMENT WEB SERVICES ....................................................... 10
3.6
4
INTRODUCTION ....................................................................................................................... 9
TOMCAT, W EBSPHERE MQ, W EBSPHERE APPLICATION SERVER AND DB2 .............................. 10
EXTRA COMPONENTS AND CONFIGURATION .................................................................................. 11
4.1
ADDNUMBERS CLIENT ........................................................................................................... 11
5
VERIFYING SYSTEM STATUS ......................................................................................................... 12
6
FINAL CONFIGURATION AND SYSTEM VALIDATION .......................................................................... 13
Page 2 of 14
© IBM Corporation 2001, 2014
- 3. 6.1
6.2
UPDATING SETTINGS – FILE ASSOCIATIONS ............................................................................. 13
6.3
7
UPDATING SETTINGS – RESULTS DATABASE ............................................................................ 13
FINAL TESTS ........................................................................................................................ 13
LEGAL NOTICES ......................................................................................................................... 15
Page 3 of 14
© IBM Corporation 2001, 2014
- 4. 1 Scenario overview
1.1 Usage
•
•
The virtual image described in this guide is NOT to be used for production use or for training of
clients.
The SUSE operating system included in the image is being distributed per agreements with Novell for
evaluation of and/or education about IBM products. Use of the operating system outside this context
is not permitted.
1.2 Purpose
This document describes how to use the Vacation Booking sample application environment based on SUSE
Linux.
Virtual image login id: root
Password: greenhat
1.3 Audience
Familiarity with SUSE Linux is required to install a few components that are not included in the image but
are needed by the sample application. Knowledge of Linux in general will help with the use of this image.
1.4 Installed Software
Operating system - SUSE Linux 11
IBM WebSphere MQ 7.1.0.3
IBM WebSphere Application Server 8.5.5.0
IBM DB2 10.5
Apache Tomcat 7.0.27
Rational Integration Tester 8.5.0.2
Rational Test Control Panel 8.5.0.2
1.5 Software that needs to be installed by the user
Because certain software cannot be distributed by IBM, the user has to do this manually.
1.5.1 Libstatgrab
In order to use the System Statistics probe for measuring the performance of the system, Rational Integration
Tester requires a library called libstatgrab. This will be useful when doing performance testing
demonstrations, and required by the performance testing training material. Download version 0.17 of this
library from http://www.i-scream.org/libstatgrab/ . Note that there is a newer version available,
but as this was released after the 8.5 release of Rational Integration Tester and features a number of API
changes, that newer version is unlikely to work.
Once downloaded, you may then build and install the library, as described in the README file accompanying
the software. Note that this will require that you have installed a C compiler – you may need to add this to
your system through your preferred package management software, though it will probably be there as part of
the operating system install.
Page 4 of 14
© IBM Corporation 2001, 2014
- 5. On a 64 bit system, you will need to make sure that the libraries are accessible, as the installation process will
only set them up for a 32 bit system. To do this, run the following commands after installing the library:
ln -s /usr/local/lib/libstatgrab.so.6.2.3 /usr/lib/libstatgrab.so.6
ln -s /usr/local/lib/libstatgrab.so.6.2.3 /usr/lib/libstatgrab.so.6.2.3
1.5.2 SQLite
To use the example database in the integration testing course, a JDBC driver for SQLite is required. This is
available from https://bitbucket.org/xerial/sqlite-jdbc . Download the .jar file from that site,
and put it in /opt/sqlite/ , making sure that all users have read permission on the folder and file. You will
then need to add it to Rational Integration Tester using the Library Manager.
1.6 Licenses
Except for the operating system and Tomcat, all software mentioned above requires a license. Eval licenses
from IBM will suffice although the consumer is expected to provide production licenses.
1.7 VMWare requirements
VMWare 8 or later
1.8 Hardware requirements
As there is a lot of software involved in this setup, it is recommended that any machine used for this
environment have at least 4GB RAM. More RAM is suggested; less may lead to some components
malfunctioning due to the need to swap between RAM and the hard drive, and the timeouts that will occur as
a result.
1.9 Starting the services
Start the services by using the icons on the desktop:
Start Tomcat by double clicking this icon:
Start WebSphere Application Server by double clicking this icon:
Start the Flight Confirmation Server:
1.10 Stopping the services
Stop Tomcat by double clicking this icon:
Stop WebSphere Application Server by double clicking this icon:
Page 5 of 14
© IBM Corporation 2001, 2014
- 6. Stop the Flight Confirmation Server by typing CTRL+C in the server’s console:
1.11 Hosts configuration
As everything is running within a single machine, it may be preferable to set up multiple hostnames for that
machine, to allow the appearance of running the environment across multiple machines. This will also help
avoid problems with changing hostnames is operating within a larger cloud environment. As an example, a
training environment may be set up with modifications to the file /etc/hosts to allow you to use the
domains www.vbooking.com, was.vbooking.com, mq.vbooking.com, db2.vbooking.com, and
rit.vbooking.com, all pointing at 127.0.0.1. Note that this step is entirely optional. All steps in this
guide may be completed by using localhost or the hostname of the machine.
Page 6 of 14
© IBM Corporation 2001, 2014
- 7. 2 System overview
The Vacation Booking system has 3 main flows through it, which involve several different pieces. Before
you set up the system, let’s look at what’s included.
Flight search and booking:
Services for:
Booking Request (XML/MQ)
MakeBooking
ProcessGlobal
ProcessMultinational
ProcessWorldwide
Services For:
Booking Management (SOAP/HTTP)
Vacation Booking
webapp
Logon/Logoff
FindBooking
UpdateBooking
CancelBooking
JDBC
Reservation Database (DB2)
Services For:
Flight Search (REST/JSON)
Flight Search
The Flight search and booking system has 3 different sections to it:
• A user may choose to search for a flight from their web browser. The Tomcat web server will then
make a REST-based query to an application running inside the WebSphere Application Server, which
talks to the DB2 database in turn. A response is sent back to the Tomcat web server in JSON format,
which is then formatted as a set of results for the user’s web browser
• A user can book a flight from their web browser, either following a search, or by using a quick link to
a particular flight. This sends an XML booking request using WebSphere MQ, which is picked up by
the MakeBooking service running on the WebSphere Application Server. This also communicates to
other services running inside the same application server, also over WebSphere MQ, to handle any
credit card information. These services will read and write to the DB2 database, and finally, the
MakeBooking service will send a response back to the web server, using XML over WebSphere MQ.
• Finally, a user can lookup, modify, or cancel existing bookings using a set of web services. These are
running inside the WebSphere Application Server, talk to the DB2 database, and again are accessed
by the Tomcat web server.
Hotel search and booking:
Page 7 of 14
© IBM Corporation 2001, 2014
- 8. This is a very simple part of the system. A user can search and book a hotel room. The Vacation Booking
web application running inside Tomcat will talk to the HotelFinder web service to handle this functionality.
Note that the HotelFinder web service is also hosted by Tomcat.
Flight upgrade and check-in:
Copybook/MQ
Flight Confirmation Server
SOAP/HTTP
Vacation Booking
Admin webapp
getPassengerReservations
requestUpgrade
JDBC
JDBC
Reservation Database (DB2)
Through the Vacation Booking Administration web application running inside Tomcat, other functionality is
also available. Firstly, a couple of web services are provided to allow the user to check whether or not a
passenger may be upgraded. On trying to check in a passenger, regardless of whether or not they have been
upgraded, a message is sent to the flight confirmation server using WebSphere MQ – this communication is
in COBOL Copybook format. A response in the same format is sent back to the web application, at which
point it updates the database directly.
Page 8 of 14
© IBM Corporation 2001, 2014
- 9. 3 Validation of the Vacation Booking system
3.1 Introduction
It’s a good idea to check that the software is set up correctly, and that all components are communicating
without any issues. Note that WebSphere Application Server may take some time to start up – if you have
started it from the console, you will need to wait for the message open for eBusiness to appear.
3.2 Tomcat
To verify that Tomcat is running the supplied web applications correctly, try to load the pages at
http://localhost:8089/vbooking-home/ and http://localhost:8089/vbooking-admin/ .
These should both appear in your browser window.
Vacation Booking Home:
Vacation Booking Admin:
3.3 Tomcat and DB2
To check that Tomcat can communicate with the database, load http://localhost:8089/vbookingadmin/ in your web browser. You can now log into the page – no username or password is required.
Following this, you should see that the flights WW047 and WW297 appear. This tells us that the database is
up and running, and that we can communicate with it through the JDBC driver installed into Tomcat.
Page 9 of 14
© IBM Corporation 2001, 2014
- 10. 3.4 Tomcat and the Hotels web service
The hotel booking service is available from http://localhost:8089/vbooking-home/ . On the left of
the page, search for hotels in Barcelona. There should be 3 hotels listed on the following page. Note that
most cities will not return hotels, and that the search is case sensitive – attempting to search for hotels in
other cities will not work.
3.5 Tomcat and the Booking Management web services
The WebSphere Application Server hosts a number of web services used by Tomcat. To access these, return
to http://localhost:8089/vbooking-home/ and follow the Amend my flight booking link. When
asked for a username and password, don’t enter anything – just press the login button. If you are then
presented with the option to search for a reservation, then communications with the web service are working
correctly. Follow the logout link to return to the main booking page.
3.6 Tomcat, WebSphere MQ, WebSphere Application Server and DB2
The final test checks that all components are working together. If you have not already done so, return to
http://localhost:8089/vbooking-home/. Choose the Book Now link listed under Stansted to
Barcelona. A booking form will then appear – after filling out all fields in the form, click Proceed to submit
the form. Following a short delay, the reservation number A00010 should appear in the final screen. If this
and the sections above have been successful, then the system is configured correctly, and you are ready to
install Rational Integration Tester on top of that system.
e read access to the folder /var/ibm/InstallationManager/license/LUM, and all files inside it.
Page 10 of 14
© IBM Corporation 2001, 2014
- 11. 4 Extra Components and configuration
4.1 AddNumbers client
For simple demonstrations, or for the training course, there is a simple web service, called AddNumbers,
which is bundled with Rational Integration Tester. A client is available – and needs to be available to the
user. The client is simply a .jar file, and a shell script to execute it, and can be placed in any convenient
location.
Page 11 of 14
© IBM Corporation 2001, 2014
- 12. 5 Verifying system status
You may want to make sure that all parts of the system are running. To check each part of the system, you
can use the following procedures:
Services:
For the four services described in the previous section, the root user can check whether each one is running
from the console with the command service <service_name> status .
DB2:
As the database instance used in Vacation Booking is very simple anyway, the easiest thing to do here is to
execute the db2start command as either the user account that owns the instance (by default, db2inst1), or
the end user account, provided you have followed the instructions earlier in this document. If the database is
running, the db2start command will tell you there is nothing to do; if not, it will start the database. If the
command fails to run at all, you may have missed some of the Vacation Booking post-installation steps
specified earlier in this document.
Tomcat:
Visit the URLs bookmarked on port 8089, as described earlier in this chapter – the Vacation Booking home
page and admin page. If these are running, then Tomcat is responding.
WebSphere Application Server
Visit the main console page, as bookmarked earlier in this chapter. If you receive a response, then the
application server is running. To check the individual applications, log in, then use the menu on the left of
the page to navigate to Applications > Application Types > WebSphere enterprise applications. You
should then be able to see the status of each of the individual applications running on the server. Note that if
the WebSphere MQ queue manager or DB2 database were not running when the application server started,
some applications may be in a Stopped state, and will need to be started.
Flight Confirmation Server:
This runs in a console, so it should be visible from that console.
Page 12 of 14
© IBM Corporation 2001, 2014
- 13. 6 Final configuration and system validation
Once the system is set up, you can change a few simple settings within Rational Integration Tester for ease of
use, and check that you can record, test, and stub against the Vacation Booking System.
6.1 Updating settings – results database
At the beginning of a training course, it is preferable that students are able to start using the software as
quickly as possible. To help students with this, you can create a new project that refers to your results
database. Any projects created subsequently will then use the same database settings.
To be certain that any database settings will be remembered later, add the connection details for your results
database on the Server Settings page while creating a new project.
6.2 Updating settings – file associations
As with results databases, there is little reason to ask students to locate an editor for CSV or Excel files.
Rational Integration Tester has settings that state how these types of files should be opened.
1. Once a new project has been created, go to the menu item Project > Preferences.
2. The Preferences window will appear. Select Applications from the left hand column of the dialog.
3. Press Add.
4. Another dialog will appear, allowing you to enter a file extension, and a command to use when
opening files with that extension. Enter .xls as the first file extension, and provide the command to
launch an editor that can work with xls files. Press OK once you are finished.
5. Repeat this procedure for .xlsx files and .csv files. Note that some spreadsheet editors may
attempt to change the format of a .csv file, so you may prefer to use a text editor to work with those
files.
6.3 Final tests
Before concluding, you will need to check that everything is now integrated and working correctly. The
checklist below provides a set of checks that you can run on your system to make sure that it can handle
training courses and demonstration scenarios. Before attempting to run these checks, make sure that all parts
of the system are running.
It is assumed that any system verification is being carried out by an experienced Rational Integration Tester
user. Explanations of each check are not provided within this document.
Run through all checks in Chapter 5 of this guide.
Start the addNumbers web service and the Login web service
Connect to RTCP with your web browser, and log in
View any agents and proxies in the system from RTCP. Note that any JDBC proxies may
not appear until the program using the proxy has executed an SQL command.
Create a new project in Rational Integration Tester, successfully connecting to RTCP and the
results database
Connect to the physical transports for the WebSphere MQ server, WAS, and DB2
Connect to all 4 physical http connections, on ports 8086, 8088, 8089 and 9080.
Record traffic on WebSphere MQ, as well as on HTTP ports 8089 and 9080
Run a test using each of the transports used within the system
Run a test suite, and view the results in both the RIT Results Gallery and RTCP.
Run a stub over WebSphere MQ, and for the HTTP services on ports 8089 and 9080
Run stubs using sift and pass through on WebSphere MQ and HTTP services; be sure to test
Page 13 of 14
© IBM Corporation 2001, 2014
- 14. scenarios where the stub handles the message, and where the stub passes the message on to
the live system.
Record JDBC interactions through the JDBC proxy
Create and run a database stub
Run a performance test on any transport, using the System Statistics probe, and view the
results
Publish and deploy a stub using RTCP and the Agent
Page 14 of 14
© IBM Corporation 2001, 2014
- 15. 7 Legal Notices
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 document 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 document.
The furnishing of this document does not grant 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:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 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 OF NONINFRINGEMENT, 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.
If you are viewing this information in softcopy, the photographs and color illustrations may not
appear.
Any references in this information to non-IBM websites are provided for convenience only and do not
in any manner serve as an endorsement of those websites. The materials at those websites are not part
of the materials for this IBM product and use of those websites is at your own risk.
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
Page 15 of 14
© IBM Corporation 2001, 2014
- 16. 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 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 illustrate
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. The sample programs are provided "AS IS", without
warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample
programs.
Trademarks and service marks
•
•
•
•
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business
Machines Corp., registered in many jurisdictions worldwide. Other product and service names might
be trademarks of IBM or other companies. A current list of IBM trademarks is available on the web at
www.ibm.com/legal/copytrade.shtml.
Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle
and/or its affiliates
Other company, product, or service names may be trademarks or service marks of others.
Page 16 of 14
© IBM Corporation 2001, 2014