Installing WebSphere Application Server 4.0

This article describes how to install WebSphere Application Server on a Linux machine by using the Custom Installation option.

These instructions assume the following:

• The machine has enough memory and disk space for your installation. See the WebSphere Application Server Supported Hardware, Software, and APIs Web site at www.ibm.com/software/webservers/appserv/doc/latest/prereq.html for the requirements.
• You will select IBM HTTP Server for installation during the WebSphere Application Server installation process. IBM HTTP Server is provided with WebSphere Application Server.
• You have installed and configured a supported database for use with WebSphere Application Server.
• You do not have a previous version of WebSphere Application Server already installed on this machine. If you do have a previous version of WebSphere Application Server already installed, do not follow these instructions. Instead, see the InfoCenter article "Migration overview."

Perform the following steps to install WebSphere Application Server:

1. Ensure that you are logged into the machine with superuser (root) privileges.
2. If IBM HTTP Server or another Web server is running on your system, stop the Web server.
3. If you have a version of IBM HTTP Server older than version 1.3.19 installed on your machine, you must uninstall it before using the WebSphere Application Server installation program to install IBM HTTP Server 1.3.19.
4. Insert the WebSphere Application Server CD-ROM into the CD-ROM drive.
5. If necessary, use the mkdir command to create a mount point for the CD-ROM. The following command creates a mount point at the directory /cdrom; you can mount the CD-ROM at any location on the machine's local file system.

   # mkdir /cdrom

   The commands in these steps assume the CD-ROM is mounted at /cdrom. If you mount the CD-ROM at a different location, use that location when issuing commands.

6. Mount the CD-ROM drive by entering the following command:

   # mount -t isso9660 -r /dev/cdrom /cdrom

   Note that some window managers automatically mount a CD-ROM for you. Consult your operating system documentation for more information.

7. Ensure that your DISPLAY and TERM environment variables are set properly. To bring up a Linux on zSeries (390) GUI, you can use programs such as Xwindows or Exceed. You can also export your display via telnet. afor example, if you are telneting to a 390 machine from an AIX (UNIX) system, here are the steps to bring up the 390 GUI:
   1. Enter xhost at your AIX command prompt. This allows the AIX system to accept connections from any host.
   2. Telnet to the Linux 390 machine and log in.
   3. After logging in, enter an export command such as export DISPLAY=AIX.raleigh.ibm.com:0.0. Exporting allows you to bring up a GUI on the AIX box.

8. If the supported Web server or database you plan to use with WebSphere is newer than the version currently required by WebSphere Application Server, you must update the prereq.properties file or disable the prerequisite checking functionality before installing WebSphere Application Server.

   To obtain an updated prereq.properties file, download the latest version from the WebSphere Application Server Tools Web site at www.ibm.com/software/webservers/appserv/tools.html. Ensure that the updated prereq.properties file is downloaded or copied into the local /tmp directory.

   To disable prerequisite checking functionality, perform the following steps:

   1. Copy the prereq.properties file from the /cdrom directory to the /tmp directory on the machine on which you plan to install WebSphere Application Server.
   2. Open the prereq.properties file in a text editor and disable prerequisite checking for an individual component by changing the value of the specific key from 1 to 0.
   3. Save the edited prereq.properties file.

9. Navigate to the /cdrom directory.
10. If you have not downloaded an updated prereq.properties file or disabled the prerequisite checking functionality, start the WebSphere Application Server installation program by using the install.sh command, as follows:

    # ./install.sh

    If you have downloaded an updated prereq.properties file or disabled the prerequisite checking functionality as detailed in Step 8, start the WebSphere Application Server installation program by using the install.sh command, as follows:

    # ./install.sh -prereqfile /tmp/prereq.properties

11. The Welcome to the IBM WebSphere Application Server Setup program dialog box opens. Click Next to continue.
12. The Install Options dialog box opens. Select Custom Installation, and click Next.
13. The Choose Application Server Components dialog box opens. Select the components you want to install and deselect the components you do not want to install. Note the following information:
    • The Java 2 Software Developer's Kit (SDK) is installed by default.
    • The Server, Admin, Samples, Application Assembly and Deployment Tools, IBM HTTP Server, and Web Server Plugins components are selected for installation by default.
    • Because you will be using WebSphere Application Server with IBM HTTP Server, ensure that the IBM HTTP Server and Web Server Plugins options are selected.

    No plug-ins are required to launch the Application Server or the administrative console. However, for production applications, you will not be able to serve servlets without having installed a supported Web server and corresponding Web server plug-in.

    For non-production applications, you can use the internal HTTP transport system to serve servlets without installing a Web server plug-in by using the internal HTTP transport port 9080. For example, to serve the sample snoop servlet by using the internal HTTP transport, enter the URL http://local_host:9080/servlet/snoop. The internal HTTP transport mechanism is not designed for use in a production environment.

    These instructions assume that you are installing all of the components. Thus, ensure that you select the IBM HTTP Server option or have the Web server already installed on the machine, then click Next to continue.

14. Because you selected the Web Server Plugins option, the Choose Application Server Components dialog box opens. Select the appropriate plug-in for your Web server, and click Next.
15. The Database Options dialog box opens. Because you are using DB2, perform the following steps in the Database Options dialog:
    1. In the Database Type field, select DB2 from the pull-down menu.
    2. Ensure that Remote DB is not selected. For this example, the database and WebSphere Application Server are installed on the same node.
    3. In the Database Name (Database SID) field, type the name of the database, was40.
    4. In the DB Home field, type the full pathname of the home directory of the DB2 instance owner, /home/db2inst1, or specify the full pathname of the home directory by using the Browse button.
    5. The DB URL field cannot be edited.
    6. The Server Name field cannot be edited.
    7. The Port Number field cannot be edited.
    8. In the Database User ID field, type the name of the database instance owner, db2inst1.
    9. In the Database Password field, type the current password for the database instance owner.
    10. Click Next to continue.
16. The Select Destination Directory dialog opens. Specify the directory in which you want to install WebSphere Application Server. You can either accept the default destination directory or specify a different one by typing the full pathname or by clicking Browse. Note that if you've selected IBM HTTP Server for installation, you cannot modify the destination directory. Click Next to continue.
17. The Install Options Selected dialog box opens. Verify that the information is correct and click Install to complete the installation.
18. Depending on the machine's configuration, the Location of Configuration files dialog box can open. It prompts you to enter the full pathname of the directory in which you want to store the specified Web server configuration file. Specify the full pathname of the file by typing it in the field or by clicking Browse.
19. The Setup Complete dialog box opens. Click Finish to exit from the WebSphere Application Server installation program.
20. The WebSphere Application Server - First Steps dialog box opens. You can use this GUI to access product information in the InfoCenter, start the administrative server, launch the administrative console, or launch the application assembly tool. Because you must first start and possibly configure the Web server before using WebSphere, close this dialog for now. You can launch the First Steps GUI at a later time by running the firststeps.sh script located in the /opt/WebSphere/AppServer/bin directory.
21. Unmount the CD-ROM before removing it from the CD-ROM drive by using the umount command, as follows:

    # umount /cdrom

22. Perform the following steps to verify that IBM HTTP Server is installed and configured correctly:
    1. Ensure that the Web server is running. If not, start it by entering the following command:

       # /opt/IBMHTTPServer/bin/apachectl start

    2. Start a browser and enter the name of the local machine as the URL. If you see the IBM HTTP Server Web page, the server is installed and configured correctly.

    See the IBM HTTP Server documentation Web site at www.ibm.com/software/webservers/httpservers/library.html for more information about configuring IBM HTTP Server.

    To enable the Secure Sockets Layer (SSL) for IBM HTTP Server, see the IBM HTTP Server documentation Web site at www.ibm.com/software/webservers/httpservers/doc/v1319/index.html for more information.

23. Proceed to the article "Testing the installation."