Installing IBM HTTP Server 1.3.19

This article describes how to install and test the operation of IBM HTTP Server on a HP machine from files downloaded from the IBM HTTP Server Download Web site at www.ibm.com/software/webservers/httpservers/download.html. If you are installing WebSphere Application Server from the product CD-ROM, you do not need to follow these instructions because IBM HTTP Server is installed by default during installation of WebSphere Application Server.

If you install IBM HTTP Server from downloaded files, it is recommended that you install IBM HTTP Server before installing WebSphere Application Server. The WebSphere Application Server installation process changes a Web server's configuration so that the Web server directs certain requests (such as servlet requests) to WebSphere Application Server. If the Web server is not installed before WebSphere Application Server, WebSphere Application Server might function incorrectly. If you will be acting as administrator, also complete the steps in "Administering IBM HTTP Web Server as a user other than the user root."

These instructions assume the following:

  • You do not have a previous version of IBM HTTP Server already installed on your machine. If you do have a previous version of IBM HTTP Server installed, you must remove it before installing the new version of IBM HTTP Server. Refer to the instructions in the product README document accessible from the IBM HTTP Server Library Web site at www.ibm.com/software/webservers/httpservers/library.html.
  • Your machine has enough memory and disk space for your installation.
  • You have checked the WebSphere Application Server Supported Hardware, Software, and APIs Web site at www.ibm.com/software/webservers/appserv/doc/latest/prereq.html to learn what level of IBM HTTP Server you need to download.
  • You have downloaded the appropriate version of IBM HTTP Server from the IBM HTTP Server Download Web site at www.ibm.com/software/webservers/httpservers/download.html by following the steps given on that site.

Installing IBM HTTP Server

Perform the following steps to install IBM HTTP Server from .tar or .tar.Z files that you have downloaded:

  1. Ensure that you are logged into the host machine with superuser (root) privileges.
  2. Move to the directory containing the downloaded files.
  3. Uncompress and untar any .tar or .tar.Z files to extract the IBM HTTP Server files.
  4. Ensure that the TERM and DISPLAY environment variables are set correctly for your system.
  5. Start the HP-UX System Administration Manager (SAM) utility by entering the following command:
    # sam
  6. Click Software Management. The Software Management screen is displayed.
  7. Click Install Software to Local Host. The Specify Source screen is displayed.
  8. From the Source Depot Type field, select Local Directory.
  9. Ensure that the name of the local machine is displayed in the Source Host Name field.
  10. In the Source Depot Path field, enter the path name for the directory that contains the untarred IBM HTTP Server bundles.
  11. Ensure that the Software Filter field is set to None, and then click OK. The Software Selection screen is displayed.
  12. From the list of bundles and products, select the bundles that you want to install, then click Actions > Install (analysis). The Install Analysis screen is displayed.
  13. When the analysis completes successfully, click OK.
  14. The Confirmation screen is displayed. Click Yes to begin the installation. The Install Window screen displays information about the progress of the installation. The SAM utility installs the selected files in the /opt/HTTPServer directory.
  15. After the installation is complete, click Done and exit from SAM.

Testing installation of IBM HTTP Server

Perform the following steps to verify that the IBM HTTP Server is installed correctly:

  1. Ensure that the Web server is running or start it by entering the following command:
    # /opt/HTTPServer/bin/apachectl start
    
  2. Open a Web browser window and type the name of the host machine as the Universal Resource Locator (URL) (http://host_machine or localhost). If you see the Welcome to the IBM HTTP Server page, the server has been installed correctly.
    Welcome to the IBM HTTP Server

    Note that you might need to make configuration adjustments to the server in order to run it successfully on your system. See the IBM HTTP Web Server documentation at www.ibm.com/software/webservers/httpservers/library.html for more information.

    To enable the Secure Sockets Layer (SSL) on IBM HTTP Server, see the IBM HTTP Server documentation at www.ibm.com/software/webservers/httpservers/doc/v1319/9atstart.htm for more information.

If you are going to install Websphere Application Server, you must stop IBM HTTP Server.

Stopping IBM HTTP Server

Before installing WebSphere Application Server, stop IBM HTTP Server by entering the following command:

# /opt/HTTPServer/bin/apachectl stop 
A message informs you that the server is stopped.

Changing the language recognized by IBM HTTP Server

To change the language recognized by the Web server, perform the following steps:

  1. As the user root, enter the following command:
    # /opt/HTTPServer/bin/setuplang
  2. When prompted, set the desired language.

Administering IBM HTTP Server as a user other than the user root

If you want to administer IBM HTTP Server as a user other than root, complete the following steps:

  1. Create the user name and password to be used to admininster the server by performing the following steps:
    1. Enter the following command where user_name is the user name you want to use to administer the administrative server:
      # /opt/HTTPServer/bin/htpasswd -m ../conf/admin.passwd user_name
    2. When prompted, enter and verify the password you want to use to administer the server.
  2. By default, the configuration files are owned by the user root after installation. You must give write permission to the user that you want to administer the server by performing the following steps:

    1. As the user root, navigate to the /opt/HTTPServer/conf directory.
    2. Change ownership of the configuration files admin.conf, httpd.conf, and admin.passwd to the user and group designated for administration of the server and give this user write permission to these files by entering the following commands:
      # chown HTTP_Web_Server_admin_user_name:HTTP_Web_Server_admin_group_name \
      admin.conf httpd.conf admin.passwd
      # chmod 640 admin.conf httpd.conf admin.passwd
    3. Open the files admin.conf and httpd.conf in a text editor.
    4. Change the User parameter in each file so that it specifies the user designated for administration of the server. Similarly, change the Group parameter in each file so that it specifies the group designated for administration of the server.

    For more information on administration of the server, refer to files in the /opt/HTTPServer/readme directory.

  3. Start the IBM HTTP Server administrative server by performing the following steps:
    1. As the user designated to administrate the server, enter the following command:
      $ /opt/HTTPServer/bin/adminctl start
    2. After the server starts, open a Web browser window and enter the following URL: http://host_machine or localhost:8008.
    3. Supply the user name and password to administer the server.
  4. To stop the IBM HTTP Server administrative server, as the user designated to administrate the server, enter the following command:
    $ /opt/HTTPServer/bin/adminctl stop