IBM HTTP Server

Getting Started

Version 6.1
Note

Before using this information, be sure to read the general information under Notices.

Compilation date: 7 Feb 2006
Copyright International Business Machines Corporation 2004. All rights reserved.
US Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

How to send your comments
About this book
Accessing this information online
Installing IBM HTTP Server
Mounting CD-ROMS on Linux and UNIX operating systems
Starting and stopping IBM HTTP Server
Installing IBM HTTP Server with a non-administrator user ID
Notices
Trademarks and service marks

How to send your comments

Your feedback is important in helping to provide the most accurate and highest quality information.

When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you.

About this book

This document is about installing and starting IBM HTTP Server. The information in this book is also available online, which is the most current version.

Accessing this information online

This information unit is compiled from information center articles that are available at Web address: http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp.

The information center has many intertopic links that this book is not able to replicate in its subset of information. Although some effort was made to remove such links and replace them with links to external information center articles, it is possible that some links were missed.

Intertopic links to articles that are not in this information and that we did not change to point to the external information center do not function properly. Such links were overlooked during the production of this document. We apologize for any inconvenience that a broken link causes and ask you to look for the information in the information center.

Link to external articles on the Web and in the external information center work correctly.

Links to articles that are within this document work correctly.

To view an article in the information center, go to the Web address and search for the title of the document.

The online information in the information center is always the most current, and the only official documentation for IBM HTTP Server.

Installing IBM HTTP Server

Install the IBM HTTP Server Version 6.1 product and its plug-in.

What's new in this release of IBM HTTP Server

See the Information center for IBM HTTP Server Version 6.1 for more information.

Steps for this task

  1. Prepare your operating platform for installing IBM HTTP Server as you would for installing any of the installable components on the product disc. See the WebSphere Application Server Version 6.1 Information Center for more information. Search for the topic "Preparing the operating system for product installation," or search for the topic ID tins_prepare.
  2. Insert the product disc and mount the disc if necessary. See Mounting CD-ROMS on Linux and UNIX operating systems for information about mounting the product disc, if you are installing IBM HTTP Server on a Linux or UNIX platform.
  3. Start the installation with the launchpad.sh command on Linux and UNIX platforms or the launchpad.bat on Windows platforms. You can also start the installation using the /IHS/install command, where IHS is the installable component directory on the product disc:

    When using the launchpad, launch the Installation wizard for IBM HTTP Server.

    After launching the Installation wizard from the launchpad or from the command line, the InstallShield for MultiPlatforms (ISMP) wizard initializes and then displays the Welcome panel.

    Separate installation procedures for the WebSphere Application Server product, the IBM HTTP Server product, and the Web server plug-ins let you install only what you need on a particular machine. Installation of the product code is simplified and faster than in Version 5. The installation program installs the system files (shared binary files), which you do not update until you install a service fix. Creation and configuration of application servers do not change the system files.

  4. Click Next to display the License agreement panel.
  5. Accept the license agreement, then click Next to display the installation root directory panel.
  6. Specify the root directory information, then click Next to display the feature type selection panel.

    If the installation directory already contains an existing IBM HTTP Server installation, the wizard prompts you with an Update installation panel. To install into a different directory, click Back to return to the installation directory panel.

    If you update the existing installation, verify that the server is stopped.

    Note: The Installation wizard does not let you update IBM HTTP Server 1.3.x versions.

  7. Click Custom to select features, then click Next to display the Features selection panel.

    Use the panel to bypass features selection by accepting typical features. Select Custom to select features in the Features selection panel. Selecting a custom installation enables you to modify the IBM HTTP Server port configurations. The default port values are 80 for IBM HTTP Server and 8008 for the IBM HTTP administration module. If the default ports are already in use by another application on the IBM HTTP Server installation, use the Port panel to adjust the port settings.

  8. Select features to install, define non-conflicting ports, and then click Next to display the Windows service authorization panel, when installing IBM HTTP Server on a Windows platform.

    windows This panel gives the option to create a Windows service for IBM HTTP Server and the IBM HTTP administration server. Create a Windows service for IBM HTTP Server and the IBM HTTP administration server. Configure the services to run as LocalSystem or as a user ID that you specify. The user ID requires the following advanced user rights, Act as part of the operating system and Log on as a service.

  9. windows Specify your user ID and password information, then click Next when installing IBM HTTP Server on a Windows platform.
  10. Review the pre-installation summary panel to verify your selections, then click Back to change any of your specifications or Next to begin installing IBM HTTP Server.

    After displaying installation status, the wizard displays the Completion status panel that indicates a successful installation.

  11. Click Next to display the Web server plug-ins prompt panel.
  12. Click Next to launch the Plug-ins installation wizard.

    See Installing Web server plug-ins for WebSphere Application Server to continue the installation.

Installing silently

A silent installation uses the Installation wizard to install the product in silent mode, without the graphical user interface. Instead of displaying a wizard interface, the silent installation enables the installation program to read all of your responses from a file that you provide.

Steps for this task

  1. Log on as root on a Linux or UNIX operating system, or as a member of the administrator group on a Windows operating system. Considerations for Windows operating systems follow:
  2. Copy the responsefile.txt file to your disk drive and rename it, for example myoptionsfile.txt. You can now customize it. Accept the IBM HTTP Server license by setting -W silentInstallLicenseAcceptance.value="true" in your response file.
  3. Issue the proper command to use your custom response file. For example, issue one of the following commands:

You can find the sample options response file in the /IHS directory on the product CD.

Uninstalling the IBM HTTP Server

This section contains procedures for uninstalling the IBM HTTP Server. The uninstaller program is customized for each product installation, with specific disk locations and routines for removing installed features. The uninstaller program does not remove configuration and log files.

Steps for this task

  1. Stop IBM HTTP Server.
  2. Change directories to the directory where you installed the IBM HTTP Server, then go to the _uninst directory.
  3. Double-click uninstall to launch the uninstaller program. You can also choose to do a silent uninstall by running the uninstall -silent command. The uninstall process on Linux and UNIX systems does not automatically uninstall the GSKit. You have to uninstall the GSKit manually by using the native uninstall method.
  4. Click Next to begin uninstalling the product.The Uninstaller wizard displays a Confirmation panel that lists the product and features that you are uninstalling.
  5. Click Next to continue uninstalling the product. The Uninstaller wizard deletes existing profiles first. After deleting profiles, the Uninstaller wizard deletes core product files by component.
  6. Click Finish to close the wizard after the wizard removes the product.

Result

The IBM HTTP Server uninstallation is now complete. The removal is logged in the ihs_install_directory/ihsv6_uninstall.log file.

Starting and stopping IBM HTTP Server

You can use the WebSphere administrative console to start and stop IBM HTTP Server. You can also use commands. See the following topics for more information:

Starting and stopping IBM HTTP Server with the WebSphere Application Server administrative console

Use the WebSphere Application Server administrative console to start and stop IBM HTTP Server.

  1. Launch the WebSphere Application Server administrative console.
  2. Click Servers > Web servers.
  3. Select your server by clicking the check box.
  4. Click Start.

You can stop IBM HTTP Server by clicking Stop.

Starting IBM HTTP Server on Linux and UNIX platforms

This section provides information on getting started with IBM HTTP Server on Linux and UNIX platforms.

The apachectl command is used to start and stop IBM HTTP Server. The apachectl command is located in the bin subdirectory within the IBM HTTP Server installation directory. If that directory is not in your PATH, the full path should be given on the command line.

Starting IBM HTTP Server. To start IBM HTTP Server using the default httpd.conf configuration file, run the apachectl start command.

Stopping IBM HTTP Server. To stop IBM HTTP Server using the default httpd.conf configuration file, run the apachectl stop command.

Issue the commands from the default directories, based on your operating system:

To start IBM HTTP Server using an alternate configuration file, run the apachectl -k start -f path_to_configuration_file command. To stop IBM HTTP Server using an alternate configuration file, run the apachectl -k stop -f path_to_configuration_file command.

Example

apachectl/usr/IBMIHS
# /usr/IBMIHS/bin/apachectl start
# /usr/IBMIHS/bin/apachectl stop

The apachectl command is not in your PATH, the IBM HTTP Server installation directory is /opt/IBMIHS, and an alternate configuration file, /opt/IBMIHS/conf/nodeb.conf, is used as follows:

# /opt/IBMIHS/bin/apachectl -k start -f /opt/IBMIHS/conf/nodeb.conf
# /opt/IBMIHS/bin/apachectl -k stop -f /opt/IBMIHS/conf/nodeb.conf

To confirm that IBM HTTP Server started successfully, open a browser and type in your server name in the URL box.

If the IBM HTTP Server started successfully, you can configure your server for SSL, LDAP and FRCA.

Starting IBM HTTP Server on Windows operating systems

This section provides information on getting started with IBM HTTP Server on Windows operating systems.

To start IBM HTTP Server as a Windows service:

  1. Click Start > Programs > IBM HTTP Server 6.1 > Start Server. A message box is displayed that indicates the server has started.
  2. To confirm that IBM HTTP Server started successfully, open a browser and type in your server name in the URL box.

    If you use the developer installation option, then the IBM HTTP Server does not install as a service. Run the apache.exe command from a command line, instead.

If IBM HTTP Server does not start:

  1. Go to Services in the Control Panel.
  2. Double-click IBM HTTP Server 6.1 to start the server.
  3. To confirm that IBM HTTP Server started successfully, open a browser and type in your server name in the URL box.

If IBM HTTP Server started successfully, you can configure your server for SSL, LDAP and FRCA.

Mounting CD-ROMS on Linux and UNIX operating systems

The following sections describe how to mount the CD-ROM on Linux and UNIX operating systems.

Before you begin

After inserting a CD-ROM into a drive, some Linux and UNIX operating systems require you to mount the drive.

Why and when to perform this task

Use these procedures to mount the product discs.

Steps for this task

Installing IBM HTTP Server with a non-administrator user ID

The common way to install IBM HTTP Server is to run the installation program using an administrator user ID. However, it is sometimes necessary to install IBM HTTP Server using a non-administrator (non-root) user ID.

About this task

Launching the IBM HTTP Server installation program is done the same way for a non-root installation as it is for a root installation, but there are several installation steps that require root privileges that cannot be completed or must be completed separately. The installation steps are as follows:

Steps for this task

What to do next

Uninstall a non-root installation of IBM HTTP as follows:

Notices

References in this publication to IBM products, programs, or services do not imply that IBM intends to make these available in all countries in which IBM operates. Any reference to an IBM product, program, or service is not intended to state or imply that only IBM's product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any of IBM's intellectual property rights may be used instead of the IBM product, program, or service. Evaluation and verification of operation in conjunction with other products, except those expressly designated by IBM, is the user's responsibility.

IBM may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:

    IBM Director of Licensing
    IBM Corporation
    500 Columbus Avenue
    Thornwood, New York  10594 USA

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

Trademarks and service marks

The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both:

Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

LINUX is a trademark of Linus Torvalds in the U.S., other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

Intel, Intel Inside (logos), MMX and Pentium are trademarks of Intel Corporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and other countries.

SET and the SET Logo are trademarks owned by SET Secure Electronic Transaction LLC.

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