Installation Instructions: IBM HTTP Server

1 of 10

http://www-01.ibm.com/software/webservers/httpservers/doc/v1319/9a...

Installation Instructions
Installation Instructions on AIX
Installation Instructions on HP
Installation Instructions on Linux
Linux for S/390: SuSE Distribution Init Run Command Entries
Installation Instructions on Solaris
Installation Instructions on Windows NT
From Web Download site
Additional step for installing on Windows NT Backup Domain
Controller (BDC)
Administration Server Password Protection
Related Information

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:
a. Log on as root.
b. Stop the server by changing to /usr/HTTPServer/bin.
c. Type ./apachectl stop.
d. Type smit &
e. Select Software Installation and Maintenance.
f. Select Software Maintenance and Utilities.
g. Select Remove Installed Software.
h. Click List under Software Name.
i. 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))

8/20/2015 8:46 AM

Installation Instructions: IBM HTTP Server

2 of 10

http://www-01.ibm.com/software/webservers/httpservers/doc/v1319/9a...

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:
a. Uncompress filename filename.tar.Z file
b. tar -xvf filename.tar
c. 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.

8/20/2015 8:46 AM

Installation Instructions: IBM HTTP Server

3 of 10

http://www-01.ibm.com/software/webservers/httpservers/doc/v1319/9a...

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
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:
a. Log on as root.
b. Go to the command prompt and type swremove
c. Select the software package to remove
d. Click Actions and select Mark for Remove. Verify a "Yes" is marked by
the packages selected for installation.
e. Select Remove (analysis)
f. 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

8/20/2015 8:46 AM

Installation Instructions: IBM HTTP Server

4 of 10

http://www-01.ibm.com/software/webservers/httpservers/doc/v1319/9a...

temporary directory.
a. Uncompress filename.tar.Z file
b. tar -xvf filename.tar
c. 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:
a. Right-mouse-click and select Open Item IHS_xx_xx, where xx_xx is
a four letter abbreviation
b. IHS_ADMIN_SERVER (IBM HTTP Server Admin Server)
c. IHS_ADMIN_MSG (IBM HTTP Server Admin Server Messages)
To select languages in IHS_ADMIN_MSG:
a. Right-mouse-click and select Open Item IHS_ADMIN_xx_xx, where
xx_xx is a four letter abbreviation
b. IHS_SSL_128 (IBM HTTP Server SSL Module - 128 encryption)
c. IHS_SSL_MSG (IBM HTTP Server SSL 128 Messages)
d. IHS_SSL_CORE (IBM HTTP Server Base)
To select languages for IHS_SSL_128_MSG:
a. Right-mouse-click and select Open Item IHS_SSL_xx_xx, where
xx_xx is a four letter abbreviation
b. 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
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:
a. Log on as root.
b. Stop the server by changing to /opt/IBMHTTPServer/bin
c. Type ./apachectl stop

8/20/2015 8:46 AM

Installation Instructions: IBM HTTP Server

5 of 10

http://www-01.ibm.com/software/webservers/httpservers/doc/v1319/9a...

d. 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.
e. 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:
a. gzip -d filename.tar.gz file
b. 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_Server1.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

8/20/2015 8:46 AM

Installation Instructions: IBM HTTP Server

6 of 10

http://www-01.ibm.com/software/webservers/httpservers/doc/v1319/9a...

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.
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

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:

8/20/2015 8:46 AM

Installation Instructions: IBM HTTP Server

7 of 10

http://www-01.ibm.com/software/webservers/httpservers/doc/v1319/9a...

a. Log on as root
b. Stop the server by changing to /opt/IBMHTTPD/bin
c. Type ./apachectl/stop
d. Type admintool &, at the command prompt
e. Select <Browse>Software
f. 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)
g. Select Edit >Delete
h. 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:

8/20/2015 8:46 AM

Installation Instructions: IBM HTTP Server

8 of 10

http://www-01.ibm.com/software/webservers/httpservers/doc/v1319/9a...

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.
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)

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 >

8/20/2015 8:46 AM

Installation Instructions: IBM HTTP Server

9 of 10

http://www-01.ibm.com/software/webservers/httpservers/doc/v1319/9a...

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.
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:
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.
On HP:

8/20/2015 8:46 AM

Installation Instructions: IBM HTTP Server

10 of 10

http://www-01.ibm.com/software/webservers/httpservers/doc/v1319/9a...

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.
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.
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.
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.
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...
Troubleshooting
Language configuration for IBM HTTP Server and Administration Server

(Back to Top)

8/20/2015 8:46 AM