Installation Instructions: IBM HTTP Server
Installation Instructions IBM HTTP Server documentation
Applies to AIX
Applies to HP-UX
Applies to Linux
Applies to Linux for S/390
Applies to Solaris
Applies to Windows NT

Installation Instructions


Applies to AIX

Installation Instructions on AIX

  1. Backup your Web server configuration files in the /usr/HTTPServer/conf directories and backup the Web site created under the htdocs directory.
  2. Uninstall any previous versions of the server:
    1. Log on as root.
    2. Stop the server by changing to /usr/HTTPServer/bin.
    3. Type ./apachectl stop.
    4. Type smit &
    5. Select Software Installation and Maintenance.
    6. Select Software Maintenance and Utilities.
    7. Select Remove Installed Software.
    8. Click List under Software Name.
    9. Select the packages from the following list, if you currently have IHS 1.3.12 installed (xx_xx specifies a language: Ja_JP, Zh_CN, Zh_TW, de_DE, en_US, es_ES, fr_FR, it_IT, ko_KR, pt_BR):
      • http_server.admin (HTTP Server Administration)
      • http_server.frca (HTTP Server Fast Response Cache)
      • http_server.html.xx_xx (HTTP Server Documentation)
      • http_server.man.en_US (HTTP Server Manual Pages (U.S. English))
      • http_server.modules.fcgi (HTTP Server Fast-CGI)
      • http_server.modules.snmp (HTTP Server SNMP Module)
      • http_server.modules.ldap (HTTP Server LDAP Module (Export SSL))
      • http_server.modules.ldap.128 (HTTP Server LDAP Module (Domestic SSL))
      • http_server.msg.xx_xx.admin (HTTP Server Admin Messages)
      • http_server.msg.xx_xx.ssl.core (HTTP Server SSL Messages)
      • http_server.ssl.128 (HTTP Server SSL Module (128-bit Encryption))
      • http_server.ssl.core (HTTP Server SSL Module Common)
      • http_server.base.source (HTTP Server Source Code)
      • http_server.base.rte (HTTP Server Base Run-Time)
      • gskit.rte (GSKit) Only remove if not required by another package.

      Select the following packages from the following list, if you currently have IHS 1.3.6.x installed (xx_xx specifies a language: JA_JP, Zh_CN, Zh_TW, de_DE, en_US, Es_ES, Fr_FR, it_IT, KO_KR, pt_BR):

      • http_server.html.xx_xx (HTTP Server Documentation)
      • http_server.base.rte (HTTP Server Base Run-time)
      • http_server.base.source (HTTP Server Source Code)
      • http_server.modules.ldap (HTTP Server LDAP Module (Export SSL))
      • http_server.modules.snmp (HTTP Server SNMP Module)
      • http_server.frca (HTTP Server Fast Response Cache Accelerator)
      • http_server.modules.ldap.128 (HTTP Server LDAP Module (Domestic SSL))
      • http_server.msg.xx_xx.admin (HTTP Server Admin Messages)
      • http_server.msg.xx_xx.ssl.core (HTTP Server SSL Messages)
      • http_server.ssl.128 (HTTP Server SSL Module (128-bit encryption))
      • http_server.ssl.core (HTTP Server SSL Module Common)
      • gskru301 (gskru301 for AIX) Only remove if not required by another package
      • gskrf301 (gskrf301 for AIX) Only remove if not required by another package
  3. Install the Java Development Kit (JDK), V 1.3.

    The JDK is available from the Java JDK Web site at: http://www.ibm.com/java/jdk/

  4. If you plan to enable LDAP, install the LDAP Client Toolkit, V 3.2.x, which is available at http://www.software.ibm.com/network/directory.

  5. Log on as root.
  6. If you are downloading from the Web site, extract all downloaded files to a temporary directory:
    1. Uncompress filename filename.tar.Z file
    2. tar -xvf filename.tar
    3. CD into the temp directory.
  7. If you are installing from a CD, insert the CD into the CD-ROM drive and go to the AIX subdirectory
  8. Type smit &
  9. Select Software Installation and Maintenance
  10. Select Install and Update Software
  11. Select Install and Update Software by Package Name
  12. If you are downloading from the Web site, enter "." (without quotes) and press Return, at the Input device/directory for software prompt.
  13. If you are installing from a CD, select List at the Input device/directory for software prompt and select the CD-ROM. Select List from the Software to Install option. Click OK
  14. Look at the Select Packages to list; http_server is highlighted. Press Return.
  15. Select the packages to install:
    • http_server.base (IBM HTTP Server)
    • http_server.admin (Administration Server-used to configure the IBM HTTP Server)
    • http_server.msg.xx_XX.admin (where xx_XX is your country code)
    • http_server.frca
    • http_server.html.xx_XX (where xx_XX is your country code)
    • http_server.man.en_US (Apache documentation)
    • http_server.modules

    LDAP

    • http_server.modules.ldap.128 (if using LDAP with SSL 128-bit encryption)
    • ldap.client

    SSL

    • http_server.ssl.core
    • http_server.ssl.128
    • http_server.msg.xx_XX.ssl.core
    • gskkm
  16. Use the following install options:
    • Automatically install registered software
    • Automatically install requisite software (with this option, xlC.rte 3.1.4.8 is installed, if necessary.)
    • Overwrite existing files
    • Verify
    • Detailed
  17. Click OK
  18. Answer yes to the confirmation messages. The path /usr/HTTPServer is used as the base directory
Applies to HP-UX

Installation Instructions for HP

The installation for HP requires HP-UX 11.

  1. Backup your Web server configuration files in the /opt/HTTPServer/conf directories and backup the Web site created under the htdocs directory.
  2. Uninstall any previous versions of the server:
    1. Log on as root.
    2. Go to the command prompt and type swremove
    3. Select the software package to remove
    4. Click Actions and select Mark for Remove. Verify a "Yes" is marked by the packages selected for installation.
    5. Select Remove (analysis)
    6. Click OK, once the analysis is complete.
  3. If you plan to use the Key Management (IKEYMAN) utility to create server certificates for SSL, install the Java Development Kit (JDK), V 1.3. The JDK is available from the HP Web site at:
    www.unixsolutions.hp.com/products/Java
  4. Log on as root
  5. If you are downloading from the Web site, extract all downloaded files to a temporary directory.
    1. Uncompress filename.tar.Z file
    2. tar -xvf filename.tar
    3. Type swreg -1 depot <temp directory>/FILENAME_DEPOT to register the DEPOT file

    If you are installing from a CD, mount the CD

  6. Type swinstall
  7. Verify the following, in the Specify Source window:
    • Source depot type is "local directory", if downloading from a Web site; "CDROM", if installing from a CD
    • Host name
    • Source depot path points to install package
  8. Click OK
  9. Select the packages to install:
    • IHS_BASE (IBM HTTP Server)
    • IHS_BASE_DOC_MSG (IBM HTTP Server Documentation)

      To select languages in IHS_BASE_DOC_MSG:

      1. Right-mouse-click and select Open Item IHS_xx_xx, where xx_xx is a four letter abbreviation
      2. IHS_ADMIN_SERVER (IBM HTTP Server Admin Server)
      3. IHS_ADMIN_MSG (IBM HTTP Server Admin Server Messages)

      To select languages in IHS_ADMIN_MSG:

      1. Right-mouse-click and select Open Item IHS_ADMIN_xx_xx, where xx_xx is a four letter abbreviation
      2. IHS_SSL_128 (IBM HTTP Server SSL Module - 128 encryption)
      3. IHS_SSL_MSG (IBM HTTP Server SSL 128 Messages)
      4. IHS_SSL_CORE (IBM HTTP Server Base)

      To select languages for IHS_SSL_128_MSG:

      1. Right-mouse-click and select Open Item IHS_SSL_xx_xx, where xx_xx is a four letter abbreviation
      2. Certificate and SSL Base Runtime (gsk5bas)
  10. Click Actions and select Install Analysis
  11. Click OK, once the analysis is complete
  12. Answer yes, to the confirmation messages. The path /opt/HTTPServer is used a the base directory.
  13. Click Done
  14. Click Exit
Applies to Linux

Installation Instructions for Linux

These instructions apply to both Linux and Linux for S/390, except where noted.

  1. Backup your Web server configuration files in the /opt/IBMHTTPServer/conf directories and backup the Web site created under the htdocs directory.
  2. Uninstall any previous versions of the server:
    1. Log on as root.
    2. Stop the server by changing to /opt/IBMHTTPServer/bin
    3. Type ./apachectl stop
    4. If uninstalling IBM HTTP Server 1.3.12.2, a supplied script is provided to uninstall the IBM HTTP Server. This script is named uninstall and is located in /opt/IBMHTTPServer.
    5. If uninstalling IBM HTTP Server 1.3.6.X(Intel only), uninstall the following packages with rpm -e:
      • IBM_HTTP_Server
      • IBM_ADMIN_Server
      • IBM_ADMIN_Forms
      • IBM_Apache_Source
      • IBM_Machine_Translation
      • IBM_SNMP
      • IBM_SSL_128
      • IBM_SSL_56
      • IBM_SSL_Base
      • gsk4bas (if not required by another package)
  3. If you plan to use the Key Management (IKEYMAN) utility to create server certificates for SSL, install the Java Development Kit (JDK), V 1.3. If using IBM HTTP Server with WebSphere Application Server, you can use the default JDK that comes with the application server.
    The JDK is available from the IBM Java JDK Web site at: http://www.ibm.com/Java/jdk/
  4. Log on as root.
  5. If you are downloading from the Web site, extract all downloaded files to a temporary directory:
    1. gzip -d filename.tar.gz file
    2. tar -xvf filename.tar
  6. If you are installing from a CD, insert the CD into the CD-ROM and mount the CD: mount -o exec /dev/cdrom /mnt/cdrom, where /dev/cdrom must point to the correct CD ROM device.

    If installing the IBM HTTP Server for the first time, run command as root: rpm -ivh IBM_HTTP_Server-1.3.19-0.i386.rpm

    If upgrading from the IBM HTTP Server 1.3.6.x, run command as root: rpm -Uvh IBM_HTTP_Server-1.3.19-0.i386.rpm

    Install the optional packages by running the command as root: rpm -ivh IBM_XXX-1.3.19-0.i386.rpm where XXX is the name of the package.

  7. Change directory into the temp directory.
  8. Select the packages you want to install:

    Note: Version number, platform, and .rpm complete the filename, so IBM_HTTP_Server referenced below is actually IBM_HTTP_Server-1.3.19.i386.rpm (or s390, if Linux for S/390)

    Note: Linux for S/390 only includes English files. Any references to country code defaults to English

    • IBM_HTTP_Server (IBM HTTP Server)
    • IBM_Apache_Source (Apache Source)
    • IBM_ADMIN_Server (Administration Server - used to configure the IBM HTTP Server)
    • IBM_MSG_.XX (Where xx_XX is your country code) (HTML Documentation)
    • IBM_ADMIN_XX (Where xx_XX is your country code) (Admin Server Forms)
    • IBM_MAN_ENU (Apache documentation)
    • IBM_SNMP (SNMP Module)
    • IBM_FastCGI (Fast CGI module)
    • IBM_Machine_Translation (Linux/Intel only)

    SSL:
    • IBM_SSL_XX (Where xx_XX is your country code)
    • IBM_SSL_Base (Required in order to install SSL modules with encryption levels)
    • IBM_SSL_128
    • Certificate and SSL Base Runtime (gsk5bas) (Global security kit (GSK), Version 5)
  9. The path /opt/IBMHTTPServer is used as the base directory.
Applies to Linux for S/390

Linux for S/390: SuSE Distribution init run command entries

To enable IBM HTTP Server to run at machine startup, the following init run command entries are needed. To create these entries, execute the following commands:


ln -s /etc/rc.d/init.d/ibmhttpd /etc/rc.d/rc2.d/K20ibmhttpd

ln -s /etc/rc.d/init.d/ibmhttpd /etc/rc.d/rc2.d/S20ibmhttpd

ln -s /etc/rc.d/init.d/ibmhttpd /etc/rc.d/rc3.d/K20ibmhttpd

ln -s /etc/rc.d/init.d/ibmhttpd /etc/rc.d/rc3.d/S20ibmhttpd

If you have the default Apache Web server that comes with the operating system installed, there might be an init conflict if you attempt to run both servers on the same port. If this situation arises, disable the default Apache init run command entries when you enable the IBM HTTP Server run command entries. To take this action, execute the following commands:


rm /etc/rc.d/rc2.d/K20apache

rm /etc/rc.d/rc2.d/S20apache

rm /etc/rc.d/rc3.d/K20apache

rm /etc/rc.d/rc3.d/S20apache

Applies to Solaris

Installation Instructions for Solaris

  1. Backup your Web server configuration files in the /opt/IBMHTTPD/ directories and back up the Web site created under the htdocs directory.
  2. Uninstall any previous versions of the server:
    1. Log on as root
    2. Stop the server by changing to /opt/IBMHTTPD/bin
    3. Type ./apachectl/stop
    4. Type admintool &, at the command prompt
    5. Select <Browse>Software
    6. Select:
      • IBMHAENU - HTTP Admin Server Messages
      • IBMHL128 - HTTP Server LDAP Module
      • IBMHMENU - HTTP Server Manual pages
      • IBMHS128 - HTTP Server SSL Module (128-bit encryption)
      • IBMHSENU - HTTP Server Documentation
      • IBMHSLDP - HTTP Server Ldap Module
      • IBMHSMT - HTTP Server MT Module
      • IBMHSSNM - HTTP Server SNMP Module
      • IBMHSSRC - HTTP Server Source Code
      • IBMHSSSB - HTTP Server SSL Common Module
      • IBMHTTPA - HTTP Server Administration (run-time)
      • IBMHTTPD - HTTP Server Base Run-time
      • gskre301 - global security kit (If no other applications use this package)
      • gskrf301 - global security kit (If no other applications use this package)
      • gskru301 - global security kit (If no other applications use this package)
    7. Select Edit >Delete
    8. Answer "Yes" to the confirmation messages
  3. If you plan to use the Key Management (IKEYMAN) utility to create server certificates for SSL, install the Java Development Kit (JDK), V 1.3. The JDK is available from the Sun Java Web site at:
    http://java.sun.com/products
  4. Log on as root
  5. If downloading from the Web site, extract the downloaded file to create a temporary spool directory. If installing from the WebSphere Application Server CD, insert this CD into the CD-ROM drive.
  6. At a command prompt, type admintool &
  7. Select Browse >Software
  8. Select All software
  9. Select Edit >Add
  10. For software location, specify CD with Volume Management and enter the appropriate CD path.
  11. To install:

    Note: The IBM HTTP Server is packaged so that only the functions you need to use are installed. However, some functions depend on other installed functions. The Solaris installation tools do not automatically install dependencies. To ensure that the necessary functions are installed, install any dependencies first, or you will receive a warning during the installation.

    Select the packages you want to install:

    • IBMHTTPD (HTTP Server Base run-time)
    • IBMHSENU (HTTP Server Documentation-English)
    • IBMHMENU (HTTP Server Manual Pages-English only)
    • IBMHSxx (HTTP Server Documentation-Language, where xx is the two letter abbreviation for the language)
    • IBMHTTPA (HTTP Server Administration run-time)
    • IBMHAENU (HTTP Server Admin Message-English)
    • IBMHAxx (HTTP Server Admin Message-Language, where xx is the two letter abbreviation for the language)
    • IBMHSSSB (HTTP Server SSL Module Common)
    • IBMHS128 (HTTP Server SSL Module 128 bit encryption)
    • IBMHSSxx (HTTP Server SSL Module Message-Language, where xx is the two letter abbreviation for the language)
    • IBMHL128 (HTTP Server LDAP Module (Domestic SSL)
    • IBMHSLDP (HTTP Server LDAP Module (Export SSL)
    • IBMHSSNM (HTTP Server SNMP Module)
    • IBMHSFCG (HTTP Server Fast CGI Module)
    • IBMHSMT (HTTP Server Machine Translation)
    • Certificate and SSL Base Runtime (gsk5bas) (Global Security Kit)
  12. Click Add
  13. Answer Y to the confirmation messages. The path /opt/IBMHTTPD is used as the base directory.
Applies to Windows NT

Installation Instructions for Windows NT from CD

Note: If you are installing on a Windows NT backup domain controller, see Additional Step for Installation on a Windows NT Backup Domain controller (BDC).

  1. Uninstall any previous versions of the server by clicking Control Panel >Add/Remove Programs
  2. Install the Java Development Kit (JDK), V 1.3, if you plan to use the Key Management (IKEYMAN) utility to create server certificates for SSL.

    The JDK ships with the WebSphere Application Server on the CD and is available from the Java JDK Web site at: http://www.ibm.com/Java/jdk

  3. If you plan to enable LDAP, install the LDAP Client Toolkit, V 3.2.x, which is available at http://www.software.ibm.com/network/directory.
  4. Log on to the system with a valid Windows NT user ID and password. The ID must be a member of the local Administrators group. The default user ID for the IBM HTTP Server is "Administrator" and the password is "***"
  5. Insert the WebSphere Application Server CD into the CD-ROM drive
  6. Double-click NT\HTTPD\setup.exe and follow the installation panels for httpserver_us (United States and Canada edition)
Applies to Windows NT

Installation Instructions on Windows NT from Web Download site

Note:

If you are installing on a Windows NT backup domain controller, see the Additional Step for Installing on a Windows NT Backup Domain Controller (BDC)

  1. Uninstall any previous versions of the server, by clicking Control Panel > Add/Remove Programs.
  2. Install the Java Development Kit (JDK), V 1.3. The JDK is available from the IBM Java JDK Web site at: http://www.ibm.com/Java/jdk/.
  3. If you plan to enable LDAP, install the LDAP Client Toolkit, V 3.2.x, which is available at http://www.software.ibm.com/network/directory.
  4. Log on to the system with a valid Windows NT user ID and password. The ID must be a member of the local Administrators group.
  5. Change to the directory where the IBM HTTP Server exe file is downloaded.
  6. Double-click HTTPServer_xxx.exe and follow the installation panels.

Applies to Windows NT

Additional Step for Installation on a Windows NT Backup Domain Controller (BDC)

During the installation, when you are prompted for a user ID and password to use for the service, the install program attempts to give that user ID the "logon as a service" right on your Windows NT system. When installing on a BDC, the installation program is unable to perform this task and indicates this problem during the installation.

To assign the "Logon as a service" right to the user ID entered during the IBM HTTP Server installation:

  1. Click Start > Programs > Administrative Tools (Common) > User Manager.
  2. Click Policies > User Rights.
  3. Select Show Advanced User Rights on the User Rights Policy dialog.
  4. Select Log on as a service. If the user ID under which you installed the IBM HTTP Server is not in the list, click Add and follow the prompts to add that user. When the user has been added, the "Log on as a service" right is granted to the user ID. The server starts normally as a service, once this information is synchronized with the Primary Domain Controller.

Administration Server Password Protection

The Administration Server is installed with Authentication enabled for the directory containing all configuration forms. After installation, the Administration Server does not service a page without a user ID and password. This restriction protects the IBM HTTP Server configuration file from unauthorized access immediately after successful installation of the IBM HTTP Server and the Administration Server. At installation, the password file (admin.passwd) is empty on Solaris. On Windows NT, this default file contains the userid and password the user entered during the installation process to create Windows NT Services. Identify a user ID and password in the Administration Server Password filter (admin.passwd), to access the IBM HTTP Server configuration pages through the Administration Server.

Create a user ID and password, using the HTPASSWD utility shipped with the Administration Server:

Applies to AIX

On AIX:

  1. From /usr/HTTPServer/bin type:
    /htpasswd -m ../conf/admin.passwd your_userID
  2. You are prompted for a password and then prompted to retype the same password for verification.

Applies to HP-UX

On HP:

  1. From /opt/IBMHTTPServer/bin type:
    ./htpasswd -m ../conf/admin.passwd your_userID
  2. You are prompted for a password and then prompted to retype the same password for verification.
Applies to Linux

On Linux:

  1. From /opt/IBMHTTPServer/bin type:
    ./htpasswd -m ../conf/admin.passwd your_userID
  2. You are prompted for a password and then prompted to retype the same password for verification.
Applies to Solaris

On Solaris:

  1. From /opt/IBMHTTPD/bin type:
    ./htpasswd -m ../conf/admin.passwd your_userID
  2. You are prompted for a password and then prompted to retype the same password for verification.
Applies to Windows NT

On Windows NT:

Change a userid and password, by using the HTPASSWD utility shipped with the Administration Server.

  1. From the IBM HTTP Server root directory type: htpasswd -c conf\admin.passwd your_userID
  2. You are prompted for a password and then prompted to retype the same password for verification.
Applies to UNIX

This user ID and password allow access to the Administration Server Configuration GUI. Select a unique user ID for access to the Administration Server. The Administration Server directive "User" should not be the same user ID for access to the Administration Server.

 
Related information...

     (Back to Top)