Linux Test Project

WebSphere® Test Suite Installation on Linux HOWTO


Li Ge lge@us.ibm.com
v2.7 March 12, 2002 - Copyright © International Business Machines Corp., 2002

Table Of Contents

  1. Introduction
  2. Assumptions
  3. Installation Instructions
  4. Run Test
  1. Introduction

    This HOWTO describes the steps to install, configure and run the WebSphere test suite on Linux using a set of scripts. The WebSphere test suite consists of trial versions of IBM®  WebSphere Application Server 4.0, IBM DB2®  for Linux Enterprise Edition 7.2, and IBM "Trade 2" performance benchmark sample application. It can be used for validating the functionality of WebSphere on Linux or as part of Enterprise level testing on Linux. Running the test can create a heavy workload in order to test a Linux kernel. In Linux distributions, we concentrated our tests on Red Hat 7.2 and SuSE 7.2. Other distributions have not been tested. In this HOWTO, we only use Red Hat 7.2. Using these instructions, the whole installation procedure takes about half to one hour compared to over one day using a traditional instuction.

  2. Assumptions

    Before we start, please make sure you have Rat Hat 7.2 Linux installed and running. Also, you need to be logged in as root. Basic Linux concept and experience are needed as well.

  3. Installation Instructions

    WebSphere test suite is installed using a set of scripts in a gzip file. The gzip file is available here(link not available yet).Unzip the file under / directory and /lte directory will be created after. To make this package available for other machines, we can put it on a server with NFS exports. These exports will be mounted to /lte/linux and /lte/images on the local machine. Once the file is unzipped, install it using the following steps.

    Download WebSphere, DB2 and Trade 2 Application from IBM web sites

    1. Download IBM WebSphere Application Server (WAS) Trial Code, Advanced Edition, V4.0 for Red Hat Linux from http://www7b.boulder.ibm.com/dl/swws/swwsgddb-p and save it under /lte/images/was/websphere/. This WAS version works not only on Red Hat Linux, but also on some other Linux distributions such as SuSE. Extract it using the following commands: #cd  /lte/images/was/websphere
    #tar  -xvf  ibmwebas_trial_linux2.tar

    2. Download IBM DB2 UDB for Linux, Enterprise Edition, Version 7.2 from http://www6.software.ibm.com/dl/db2udbdl/db2udbdl-p and save it under /lte/images/db2/. Extract it into /lte/images/db2/V7.2 using the following commands: #cd  /lte/images/db2
    #tar  -xvf  040_EE_LNX_NLV.tar
    #mv  040_EE_LNX_NLV/  V7.2

    3. Download Trade 2 Application for Advanced Single Server Edition, V4.0 and DB2 (DB2_ AEs.zip) from http://www-4.ibm.com/software/webservers/appserv/wpbs_download.html (A direct link to the download package for WAS AEs and Linux is http://www6.software.ibm.com/dl/websphere27/benchmark-i?S_PKG=dlwasss40). Save it under /lte/images/trade/. Extract it using the following commands: #cd  /lte/images/trade
    #unzip  DB2_AEs.zip
    #unzip  DB2_AEs_scripts.zip

    Server side installation steps

    There are two options for server side installation. One is having the Trade 2 application database and WebSphere application server on the same machine. The other is having the Trade 2 application database and WebSphere application server on different machines, which means the application uses the remote database.

    Option I : Trade 2 application database on the local machine.

    1. Create an operating system user named trade with a password of trade on the local machine. Be sure to use all lower case letters when creating the trade user. Without this trade user, you cannot access the Trade database. The trade userid and password will be asked in the install scripts.

    2. Install and configure WebSphere and DB2 on the local machine. Also create the Trade 2 Application database on this machine.

    #cd  /lte/linux/webasdb2/scripts/install/install_server
    #./1.inst_conf_wasdb2 (Install and configure WebSphere and DB2)
    #./2.start_httpd (Start IBM HTTP server)
    #./3.start_was (Start WAS "WebSphere application server")
    #./4.inst_conf_trade_localdb (Install and configure Trade 2 Application)

    Option II : Trade 2 Application database is on the remote machine. In this case, both the local machine(A) and remote machine(B) need to have DB2 installed.

    1. Create an operating system user named trade with a password of trade on remote machine B. Be sure to use all lower case letters when creating the trade user. Without this trade user, you cannot access the Trade database. The trade userid and password will be asked in the install scripts.

    2. Install and configure DB2 and create the Trade 2 Application database on remote machine B. Make sure the /lte directory has been mounted before you do the following steps.

    #cd  /lte/linux/webasdb2/scripts/install/install_remote_tradedb
    #./1.inst_conf_db2 (Install and configure DB2 on remote machine B)
    #./2.create_tradedb (Create Trade 2 Application database on DB2)

    3. Install and configure WebSphere, DB2 on local machine A.

    #cd  /lte/linux/webasdb2/scripts/install/install_server
    #./1.inst_conf_wasdb2 (Install and configure WebSphere, DB2 on local machine A)
    #./2.start_httpd (Start IBM HTTP server)
    #./3.start_was (Start WAS)
    #./4.inst_conf_trade_remotedb (Install and configure Trade 2 Application with remote database on local machine A)

    Note: When you run "4.inst_conf_trade_localdb" or "4.inst_conf_trade_remotedb," follow prompts to complete the information requested.

    Client side installation steps

    Many test tools are available on the Internet to test different functions of the web server and web application server. You can choose a suitable one depending on your focus. In open source world, HammerHead 2 is available for free download. If you choose HammerHead 2 as the client application, please notice that the size of the log file will be extremely large when you perform a long term run such as 36 hours. You can install the client application either on the same machine as the server or on another machine.

  4. Running the Test


    Starting the servers

    After the test suite is installed, you can directly go to "Running the test for the first time" to get the test started. If  you have rebooted after the test suite is installed, you need use the scripts under the /lte/linux/webasdb2/scripts/start directory to start DB2, HTTP Server and WAS sequentially first. Since the WebSphere Trial Code is single server version, usually applications will be started once the WAS is started. Every time you start the WAS, all application servers will be started automatically. You can start the servers using the following steps:

    #cd  /lte/linux/webasdb2/scripts/start
    #./1.start_db2 (Start DB2 server)
    #./2.start_httpd (Start IBM HTTP server)
    #./3.start_was (Start WAS)

    When the Trade 2 Application database is on the remote machine, you need to start the DB2 server on the remote machine first using /lte/linux/webasdb2/scripts/start/1.start_db2. After that you can start DB2, HTTP Server, and WAS on the local machine using the steps above. Otherwise, a database connection error will occur when you start WAS. You can start the servers using the following steps:

    On the remote machine:

    #cd  /lte/linux/webasdb2/scripts/start
    #./1.start_db2 (Start DB2 server on remote machine)

    On the local machine:

    #cd  /lte/linux/webasdb2/scripts/start
    #./1.start_db2 (Start DB2 server on local machine)
    #./2.start_httpd (Start IBM HTTP server)
    #./3.start_was (Start WAS)

    Running the test for the first time

    Before you run the test for the first time, go to the Trade 2 Application main page (http://HOSTNAME/WebSphereSamples/TradeSample/TradeDocs/index.html) to complete the following configuration steps:

    1. Go to Configuration and click Populate Trade Database.

    **Note: This step only need to be done once before you run the test for the first time.
    2. Click Go Trade!to test the application from a Web browser.

    Running Benchmark tests

    Perform the following steps to drive benchmark load tests with the WebSphere Trade 2 application:

    1. Setup your Web load generator to drive the request URL: http://{HOSTNAME}/WebSphereSamples/TradeSample/servlet/TradeScenarioServlet

    2. Start your Web load generator to drive requests and measure system performance

    3. Go to Configuration and click Reset Trade link when a run is completed to reset the Trade runtime to a clean starting point by logging off all users, removing new registrations and other general cleanup. This step must be done between runs to ensure consistent results

    4. Go to Step 2

    You can use other configuration utilities provided by the Trade 2 Application to change the default configuration settings, such as Configure Trade run-time parameters , and Configure Trade logging. The detailed explanations of their functionality are described in the Configuration link.

    You can stop these servers using the scripts located in the /lte/linux/webasdb2/scripts/stop directory as the following. It is a good habit to stop all the servers before you shutdown the machine.

    #cd  /lte/linux/webasdb2/scripts/stop
    #./1.stop_was (Stop WAS)
    #./2.stop_httpd (Stop IBM HTTP server)
    #./3.stop_db2 (Stop DB2 server)

    The scripts located in the /lte/linux/webasdb2/scripts/remove directory can remove the whole test suite including WAS, HTTP Server, DB2, and Trade 2 Application from your machine. After removing these applications, make sure you reboot the machine before you reinstall the test suite. You can remove the servers using the following steps:

    #cd  /lte/linux/webasdb2/scripts/remove
    #./1.remove_washttp (Remove WAS and IBM HTTP server)
    #./2.remove_db2 (Remove DB2 server and DB2 users)

    IBM and its logos are registered trademarks of International Business Machines. Linux is a trademark of Linus Torvalds. SGI is a trademark of Silicon Graphics, Inc.

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

    The content of this document is provided solely for the information of the reader. It is provided on an "AS IS" basis and without guarantee or warranty. The reader uses this information solely at his/her own risk.


Sourceforge.net  Last modified on: August 02, 2006 - 17:13:54 UTC.
Theme: