Installing IBM WebSphere Application Server Version 3.5
for Linux (Intel processor)

This article describes how to install IBM WebSphere Application Server that uses:

You are viewing the 12/19/2000 version of the document. The latest version of this document is posted at:

http://www-4.ibm.com/software/webservers/appserv/doc/v35/ae/infocenter/was/inst_wasv35_linux.html

Contents

Prerequisites

Instructions for installing from the CD:

  1.    Install the pdksh
  2.    Run the installation script
  3.    Configure the Web server
  4.    Start the Web server
  5.    Test the installation
  6.    Perform advanced verification

Installing the 60-day trial version (Web download)

Prerequisites

For information about the supported product prerequisites, see:


http://www-4.ibm.com/software/webservers/appserv/doc/v35/prereq.html

The site provides information such as the supported levels and types of IBM Developer Kits and databases for use with this product.

Instructions

  1. Install pdksh
  2. Obtain the Public Domain Korn Shell (pdksh) for your Linux distribution from the compact disk for your Linux distribution, or from the pdksh Web site:

          http://www.cs.mun.ca/~michael/pdksh/
    

  3. Run the installation script
  4. If you plan to use an existing Web server with IBM WebSphere Application Server, stop the Web server before running the product installation script.

    Install WebSphere Application Server Version 3.5:

    1. Mount the product CD.
    2. Change directory to the CD-ROM directory.
    3. Run the installation script:
      ./install.sh

    The script will prompt you through the following decisions and activities.

    (Note, if installing IBM WebSphere Application Server Standard Edition, some prompts will be omitted because an InstantDB database is always installed -- DB2 and other database choices are not available.)

    The script leads you through:

    For the administrative database configuration, be prepared to provide the following information:

    For help with the above items, see InfoCenter article 1.2.3.6

    Note, if you select the custom database configuration route, the installation script will not check whether the database information you enter applies to a supported database. Configuring IBM WebSphere Application Server to use an unsupported database will severely limit your IBM support options. See the above Prerequisites section for a pointer to the list of supported databases.

  5. Configure the Web server
  6. If using the Apache Server, you will need to configure the Web server before proceeding:

    1. Open the Web server configuration file, httpd.conf.
    2. Add the following lines:
         LoadModule app_server_module /opt/IBMWebAS/bin/mod_app_server.so
         AddModule mod_app_server.c
         Alias /IBMWebAS/ /opt/IBMWebAS/web
         NcfAppServerConfig BootFile /opt/IBMWebAS/properties/bootstrap.properties  
              
    3. Copy the WebSphere Samples to the Web server document root, shown here as document_root:
      cp -r /opt/IBMWebAS/WSsamples document_root
      cp -r /opt/IBMWebAS/WSsamplesIDB document_root
      

  7. Start the Web server
  8. Whether you are using IBM HTTP Server or Apache Server, if the Web server is now running, you must stop it. Use the restart command to stop the server and start it again.

    To start IBM HTTP Server 1.3.12, use the following command:

    /opt/IBMHTTPServer/bin/apachectl restart

  9. Test the installation
    1. Start the WebSphere administrative server as root in a separate terminal, by invoking the following executable program:
          cd /opt/IBMWebAS/bin
          ./startupServer.sh
          
    2. Wait (typically up to five minutes) until the message is displayed: "WebSphere Administration Server is open for e-business" in the file:
      /opt/IBMWebAS/logs/tracefile

    3. Start the Java administrative console as root in a separate terminal, by invoking the following executable program:
          cd /opt/IBMWebAS/bin
          ./adminclient.sh
          
    4. You are ready to run when you receive the console ready note at the bottom of the terminal screen.

  10. Perform advanced verification
  11. Run a servlet to further verify a successful installation.

    1. In the Java administrative console (WebSphere Administrative Console) that you started in the previous step:

      1. Expand the Topology view by clicking the + sign next to WebSphere Administrative Domain.
      2. Your machine's host name should be listed in the Topology tree. Expand the view of that node, showing an entry called Default Server.
      3. Expand Default Server to display the default container and servlet engine.
      4. Select the default server. If the Current State of the default server is Stopped, click the Start icon on the toolbar, or right-click the server for a menu option.
      5. Wait for an information dialog to be displayed, stating that the server is running. Click OK. Note that the current state changes from Stopped to Running.
    2. Ensure that the Web server is running.
    3. Open a Web browser and go to:
        http://hostname_or_IPaddress/servlet/snoop
        
      Snoop is a standard example servlet installed by default. The browser should now display information on /servlet/snoop.


      Snoops Servlet browser

Installing the 60-day trial version

See the following Web page for information about the trial version:

http://www-4.ibm.com/software/webservers/appserv/download_linux.html

If installing a trial version of the IBM WebSphere Application Server Version 3.5 for Linux (Intel), note these differences in the installation procedure. Also consult the above Web page for additional notes and instructions.

Using the trial code as-is

By default, the trial version installation is a "Quick Install," meaning it automatically installs a supported IBM Developer Kit, IBM HTTP Server, and an InstantDB database product.

After downloading the trial package using the instructions provided on the Web page:

  1. Untar the trial download:
            tar -xvf edn_trial_was3_5.tar
    
    where edn is "adv" for the Advanced Edition or "std" for the Standard Edition.
  2. Run the quick installation script. Change directory:
    		cd edntrial
    
    then run the script:
        
                    ./quickinstall.sh
    
  3. You will see a number of messages as the rpm packages for the JDK, IBM HTTP Server, and WebSphere Application Server are installed.

    After it has completed the installation, restart the Web server, then start WebSphere Application Server. See the corresponding instructions in above CD installation procedure.

Using the trial code with an existing DB2 database (special instructions)

If you would like to use the trial download with an existing DB2 installation, do the following. Note, only IBM WebSphere Application Server Advanced Edition can use DB2, and the DB2 installation must meet the prerequisite requirements.

  1. Download the trial package using the instructions provided on the Web page.
  2. Untar the trial download:
            tar -xvf adv_trial_was3_5.tar
    
  3. Download install.sh, a script that is available separately from the trial code. The script is available from the same Web page as the trial code.
  4. Place install.sh in the root directory of the trial code that you untarred in a previous step.
  5. Follow the above instructions for installing the product from the CD, ignoring the instructions to mount the CD and change to the CD-ROM directory.

    When the installation script prompts you whether to install DB2 or use a custom database, select the latter option.