mod_perl is an add-on Apache module that glues together the Perl runtime library, server software and an object-oriented Perl interface to Apache's C language API. It enables Apache modules to be written entirely in Perl and improves performance of Perl cgi scripts. The Prerequisites section in the apache.admin.guide contains requirements for mod _perl. It is still under development because of its dependency on Apache's API.
Auth_ldap is the connector between Apache and an LDAP directory server module allowing Apache to authenticate HTTP clients by using entries in an LDAP directory. Auth_ldap supports iPlanet(Netscape) Directory Server and OpenLDAP Server.
apr_shm is a library that abstracts the usage of shared memory on UNIX platforms. It was previously called "Shmem" in this release. apr_shm support allows the /opt/hpws22/apache/conf/ssl.conf SSLSessionCache directives shmht: /opt/hpws22/apache/logs/ssl _scache (51200) and shmcb: /opt/hpws22/apache/logs/ssl _scache (51200) to be used. 51200 represents the size of the shared memory being created and can be changed based on the system resources. Shmht refers to the
hash table method of session caching and shmcb refers to the circular buffer method of session caching. Please note that either shmht or shmcb can be specified.
Tomcat is an implementation of the Java Servlets 2.3 and JavaServer Pages 1.2 specifications. Tomcat can work either standalone or with the HP-UX Apache-based Web Server depending on the configuration. Tomcat is pre-configured to run with HP-UX Apache-based Web Server. Tomcat listens on port number 8081.
Tomcat is installed in /opt/hpws22/tomcat. For more information, please see /opt/hpws22/hp_docs/tomcat/tomcat.admin.guide
OpenSSL is a fully-featured Open Source toolkit implementing the Secure Sockets Layer and Transport Layer Security protocols with full-strength cryptography worldwide.
OpenSSL is installed in /opt/hpws22/apache/ssl/openssl_bsafe/bin/openssl.
PHP is an HTML embedded, server-side, cross-platform, scripting language with support for database access. This version includes the security fix to correct POST vulnerabilities in previous versions. For more information see: http://www.php.net/releases/5_http://www.php.net/release 4 2_6.php
For more information on PHP, please see php.admin.guide and php.user.guide in the /opt/hpws22/hp_docs/apache directory.
Administration and Configuration GUI, a customized version of Webmin for HP-UX Web Server Suite. Webmin can configure the MPM directives that are new to Apache 2.2. It has also been enhanced to generate Certificate Authority (CA) Server Keys and Certificates using the OpenSSL toolkit.
Webmin is installed in the /opt/hpws/webmin/ directory. For more information on Webmin, please see /opt/hpws22/hp_docs/webmin/webmin.admin.guide
Apache modules in C
The HP-UX Apache-based Web Server supports loading of Apache modules written in C . For more information on building and using C modules, see /opt/hpws22/apache/build/examples/README and the FAQ under Troubleshooting - "Why does my C module fail to load?".
Automatic Restart of Apache/Tomcat/Webmin
Apache/Tomcat/Webmin can be started automatically on reboot. For more information on customization/configuration of this feature, see /opt/hpws22/hp_docs/apache/apache.admin.guide
The Apache product is built with options that provide maximum flexibility to allow enabling of new modules or disabling of existing modules. The modules included by default as shared objects with the HP-UX Apache-based Web Server are listed below. These modules are located in the /opt/hpws22/apache/modules/ directory.
For a detailed description of the standard Apache modules, see http://httpd.apache.org/docs/2.2/mod/http://httpd.apache.org/docs-2.0/mod/index-bytype.html.
For more information about new and changed features included in each HP-UX Web Server Suite release, see the release notes for each release on the web site:
For additional information, see:
Table 4.3.1 : Components & Features of Apache and HP-UX Web Server Suite
Components & Features
Apache 2.0 from ASF1
HP Apache 2.0.x
Apache 2.2 from ASF1
HP–UX Web Server Suite
PA / IPF 2
Latest HP Apache Available on HP SW Depot (Aug. 2002)
Note:The version numbers in the preceding table are correct for the HP Apache-based Web Server 2.0.x and HP-UX Web Server Suite 3.x. For later releases, see the Release Notes in the documentation directory, or on the website:
5 Preparing for Installing HP-UX Web Server Suite B.3.0
5.1 Hardware and Software Requirements
The HP-UX Web Server Suite runs on, 11i Version 2 or later. There are a small number of required patches that affect functionality. These can be reviewed after installation. They are listed in the Admin Guides for each component, which can be found in the directory /opt/hpws22/hp_docs.
The following table shows the necessary hardware and software for installing and running the HP Apache or HPUX- Web Server Suite. These requirements must be met before beginning a migration.
350MB of disk space is required to install the entire HP-UX Web Server Suite. Installed separately, each product uses the:
HP-UX Apache-based Web Server 150 MB
HP-UX Tomcat-based Servlet Engine 20 MB
HP-UX Webmin-based Admin 17 MB
5.3 Perl Requirements
Perl is needed when you use perl scripts, mod_perl, or Webmin. The Release Notes bundled with the product describe how to configure mod_perl and Webmin.
apxs is a utility perl script provided by Apache for compiling and installing modules. HP Apache-based Web Server 2.0.x for IPF expects perl to be at /usr/contrib/Q4/bin. All other versions expect Perl to be at /opt/perl/bin/perl.
The mod _perl module is an add-onfeature that is compiled into HP Apache or HP-UX Apache-based Web Server but is not configured by default. mod _perl enables Perl CGI to run faster and allows Apache add-on modules to be written in Perl.
The Webmin tool is the web-based GUI administrator for HP Apache or HP-UX Web Server Suite. The Webmin tool requires Perl version 5.002 or higher; HP-UX Web Server Suite mod_perl requires Perl v 5.8.8. Therefore, using Perl 5.8.8 is recommended. (Perl 5.6.1 is the same version as was required by HP Apache 220.127.116.11 and up.)onwards
On IPF, Apache 2.x is a native 64-bit application. Its mod_perl modules require respective 64-bit perl libraries v 5.8.8.
To download Perl 5.8.8, go to HP Software Depot at software.hp.com and search for “Perl v.5.8.8”.
5.4 Java Development Kit (JDK) Requirements
As part of its distribution, the HP Apache-based Web Server or HP-UX Web Server Suite includes a servlet and a JSP container. Apache 2.0.x bundled Tomcat and JServ; the HP-UX Web Server Suite bundles only Tomcat (JServ is being phased out). If you want to use a servlet/JSP container, you must have HP-UX Java Developer’s Kit (JDK) release 1.2.2.04 or later. However, it is recommended that you use version 18.104.22.168 or later.
The latest versions of Java can be downloaded from: www.hp.com/go/java.
The IPv6 version of the HP-UX Web Server Suite requires JDK 1.4 only if your Tomcat servlets or JSPs use IPv6 addresses. For example, in many cases Apache handles the long IPv6 addresses and Tomcat is insulated from them. In this situation, the earlier version of the JDK is sufficient. In other words, if you use Java classes that require IPv6 support, JDK 1.4 is required. If you use Java classes without reference to IP addresses, the earlier JDK is adequate.
5.5 Java Servlet Development Kit (JSDK 2.x)
Apache 2.0.x requires JSDK 2.x to support Apache’s JServ. Because the JServ module is no longer used in the HP-UX Web Server Suite, JSDK 2.x is no longer required.
If you are using JServ on HP Apache 2.0.x, you must migrate to tomcat/mod_j k when you upgrade to the HP-UX Web Server Suite. After you install the HP-UX Web Server Suite, perform the steps described in Migrating Tomcat and Java.
SeeFor more information, s tomcat.migration.guide available at: /opt/hpws22/hp _docs/tomcat
6 Installing HP-UX Web Server Suite
The following procedures describe two methods of upgrading to the HP-UX Web Server Suite. Choose the procedure that is appropriate to your site environment.
Installing HP-UX Web Server Suite on a Server Where 2.0.x is Not Running
Choose this method if you need to make the web server you are upgrading unavailable while installing the HP-UX Web Server Suite.
Installing HP-UX Web Server Suite on a Server Concurrently Running 2.0.x
Choose this method if you need to have HP Apache 2.0.x continuously running on the server you are upgrading to the HP-UX Web Server Suite.
6.1 Installing HP-UX Web Server Suite on a Server 2.0.xwhere is Not Running
Step 1: Preparing the Web Server Environment
Prepare the web server environment if not done. For more information, see Preparing for Installing HP-UX Web Server Suite,.
Note: Remember to backup your system.
Step 2: Remove Technology Preview Installation
If you participated in the Technology Preview Program and still have HP Apache-based Web Server Version 2.0.0 Tech Preview installed on your system, ensure that it is removedtime.enterTo check to see if it is installed type:
/usr/sbin/swlist | grep B9416AA
The product is installed ifthe following is listed:
B9416AA 2.0.00.00.02 HP Apache-based Web Server with Strong
To stop Apache, Tomcat, and Webmin as root type:,enter
To uninstall the Technology Preview, as root, enter: /usr/sbin/swremove B9416AA
Also remove the directories completely. As root, enter: rm –rf /opt/hpapache2
Step 3: Stopping HP Apache 2.0.x
Before you install hpws (which uses default ports 80 and 443), ensure that HP Apache Version 2.0.x (which uses the same default ports) is stopped. This ensures that there will be no conflict in port numbers between the two versions of HP Apache.
To stop Apache, Tomcat, and Webmin as root type:,enter
/opt/hpws/apache/bin/apachectl stop /opt/hpws/tomcat/bin/shutdown. sh
Install using the HP-UX 11 I v2 Application Release CDs (when available).
Step 5: Startup after Installation
Enter the following command line to start Apache after installation: /opt/hpws22/apache/bin/apachectl start
Step 6: Perform a Quick Check of the HP-UX Web Server Suite Installation
AccessTo a the index.html page, enter:
theT HP-UX Apache-based Web Server home page. appears
ExecuteTo e the test CGI script, enter:
severalS lines of text listing the environment variables. appear The first line must be: CGI/1.0 test script report:
Step 7: Stop HP-UX Apache-based Web Server
Stop HP-UX Apache-based Web Server, if it is running, before continuing with the migration. process As root, type:enter /opt/hpws22/apache/bin/apachectl stop
Step 8: Migrating to an HP-UX Web Server Suite Environment
configureC your HP-UX Web Server Suite to retain any customizations you have made to your HP Apache-based Web Server 2.0.x environment.For more information, see Migrating Your Apache Configuration from 2.0.x to HP-UX Apache-based Web Server 3.x.
You can also refer the release documents that are bundled with the product to familiarize yourself withthe HP-UX Web Server Suite’s capability. For administrator guides, user guides, and configuration information, see:
6.2 Installing HP-UX Apache-based Web Server on a Server Concurrently Running 2.0.x
The HP Apache 2.0.x and HP-UX Apache-based Web Server can run simultaneously on the same machine if they use different port numbers or use different IP addresses. Each web server has its own binary.
Both HP Apache-based Web Server 2.0.x and HP-UX Web Server Suite use port 80 and port 443 (SSL) by default. If you want to maximize availability during the migration by keeping HP Apache 2.0.x running on the server you are upgrading, you can temporarily change ports using the following procedure.