Installing IBM WebSphere Application Server Version 3.5
for Linux on S/390

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

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 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 on a client machine 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