These release notes support Apache Web Server V1.3.12 on systems running DYNIX/ptx® V4.4.4 or later maintenance releases, or DYNIX/ptx V4.5.x. This product includes software developed by the Apache Software Foundation for use in the Apache HTTP server project. Read this document before you install or run this release of Apache Web Server.
The changes in Apache Web Server V1.3.12 since V1.3.4 are as follows:
Apache Web Server V1.3.12 is a port of the Apache HyperText Transfer Protocol (HTTP) server 1.3.12 from the Apache Software Foundation. The previous release of Apache Web Server on DYNIX/ptx was a port of Apache HTTP server 1.3.4.
Apache HTTP server 1.3.12 was released following the recent CERT® advisory on cross-site scripting. It was shown that malicious HTML tags could be embedded in client web requests if the server or script handling the request did not carefully encode all information displayed to the user. Using these vulnerabilities attackers could, for example, obtain copies of your private cookies used to authenticate you to other sites. For further details on the CERT advisory, refer to the following URL:
http://www.cert.org/advisories/CA-2000-02.html
The problem is not specific to the Apache HTTP server and has wide-reaching consequences for anyone who uses or writes scripts for web servers. The Apache Software Foundation has published comprehensive details of the problem and you should check any scripts that you use. For details, refer to "Cross Site Scripting Info" at the following URL:
http://www.apache.org/info/css-security/
Apache HTTP server 1.3.12 contains fixes for these vulnerabilities.
As part of the CERT advisory changes, the handling of character sets was improved in Apache HTTP server 1.3.12. Specifically, two new directives were added: AddDefaultCharset and AddDefaultCharsetName. These directives allow Apache to specify the given character set on any document that does not have one explicitly specified in the headers. Sending the correct character encoding allows a document to be interpreted and displayed appropriately.
There have been several releases of the Apache HTTP server since Apache 1.3.4 was ported to DYNIX/ptx. For details on the new features and problems fixed in each of these releases, refer to the following issues of the free electronic publication Apache Week:
The features in Apache Web Server are as follows:
Apache Web Server is a port of the Apache HTTP server from the Apache Software Foundation with no patches, changes, or extensions beyond those required to build and run on DYNIX/ptx.
For more information about the Apache HTTP server and the Apache Software Foundation, refer to the following URL:
As required by the Apache license agreement, Apache Web Server includes binaries and the source code that were used to build these binaries for DYNIX/ptx.
The DYNIX/ptx operating system supports the Dynamic Shared Object (DSO) feature that is supported by Apache HTTP server. DSO enables Apache modules to be loaded at runtime, which means that modules can be loaded into the server process space only when necessary. With DSO, overall memory usage by Apache should be significantly reduced. For more information on DSO support in Apache HTTP server, point your web browser at the following URL after you install Apache Web Server, where hostname is the name of your Apache Web Server host:
http://hostname/manual/dso.html
The DYNIX/ptx version of Apache Web Server does not provide or support encryption through the Secure Sockets Layer (SSL) protocol.
Apache Web Server contains several man pages. For more information, refer to "Man Pages" later in these release notes.
Apache Web Server V1.3.12 runs on DYNIX/ptx V4.4.4 and later maintenance releases, or DYNIX/ptx V4.5.x on NUMA-Q and Symmetry® systems. Additionally, Apache Web Server requires the following software. Note that this list includes the minimum versions required by DYNIX/ptx V4.4.4; later versions will work as long as they are compatible with the version of DYNIX/ptx on your system.
Installing Apache Web Server requires approximately 10MB.
Apache Web Server is available only from the SequentDirect web site. It is not available on CD-ROM. Apache Web Server is installed with the standard ptx/INSTALL installation process. The SequentDirect web site is located at the following URL:
http://www.sequent.com/direct/software.asp
Complete the following steps to download Apache Web Server from the web and install it on a DYNIX/ptx host:
On the Download Your Software Now web page, click the Download Now button.
When the Unknown File Type dialog box is displayed, click on the Save File button, then designate the location where you want the file saved.
If needed, move the downloaded file, apache1312.tar, to a directory on the DYNIX/ptx host where you want to install Apache Web Server. For example, you could move it to /tmp. The exact method you use depends on the network configuration of your site. Most likely, you can use the ftp command or Microsoft® Windows® Explorer to move the file to the DYNIX/ptx host.
Login as root on the DYNIX/ptx host:
# su root
Extract Apache Web Server from the downloaded file:
# tar -xvf apache1312.tar
This command will create an apache1312 subdirectory that contains the ptx/INSTALL image used to install Apache Web Server.
Use ptx/INSTALL and the ROOT installation procedures to install Apache Web Server. The following steps provide a quick reference for doing this task:
From ptx/ADMIN, select System Administration -> Software Management -> Install Software Package.
For the installation source type, enter directory.
For the location of the installation source, enter the path to the apache1312 directory, for example, /tmp/apache1312.
Complete the remainder of the installation process as prompted by ptx/ADMIN.
By default, Apache Web Server is installed in the root filesystem under /usr/local/apache. Alternatively, you can install Apache Web Server in a different filesystem. If you do so, /usr/local/apache is created as a symbolic link to the actual installation directory.
For more information about the DYNIX/ptx installation process, refer to the appropriate version of the DYNIX/ptx and Layered Products Software Installation Release Notes.
Once the installation is complete, you can either remove or archive the apache1312.tar file and the apache1312 directory.
The subdirectories in the Apache Web Server directory are as follows:
http://hostname/manual/mod/mod_proxy.html
By default, Apache Web Server does not automatically start or stop when the system comes up or goes down. However, Apache Web Server does contain a script called /usr/local/apache/bin/apachectl that you can use to automatically start and stop Apache Web Server.
To do so, copy this script to /etc/init.d/apachectl, then link the script to the transition files /etc/rc2.d/S96apache and /etc/rc0.d/K09apache. Once the script is linked to the transition files, Apache Web Server will automatically start when the system is booted and stop when the system is gracefully stopped.
You can also manually start and stop Apache Web Server with this script. For example, to start Apache Web Server, enter the following command:
# sh /etc/init.d/apachectl start
Similarly, to stop Apache Web Server, enter the following command:
# sh /etc/init.d/apachectl stop
Apache Web Server is installed as a minimally configured web server using the standard web server port of 80 for the HTTP protocol. If this port is already in use, you must change it to a different value before you can start Apache Web Server. Note that you must start a server with a port number of 1024 or lower as superuser.
By default, the URL to the server contains the hostname and port number. For example, if the host is called host1 and uses port 80, your server's URL will be http://host1:80/. By default, basic logging is enabled. When the httpd daemon is started, six httpd processes are started.
Apache Web Server contains directives, which are configuration parameters used to control the core Apache features. For example, the port directive is used to change the web server port number after installation. To customize your installation of Apache Web Server, you should review the Apache directives and set them according to your needs. For more information on Apache directives, point your web browser at the following URL, where hostname is the name of the Apache Web Server host:
http://hostname/manual/mod/directives.html
After reviewing the remainder of these release notes, you can obtain further information about Apache Web Server by referring to the HTML documentation provided by the Apache Software Foundation. For more information about this documentation, refer to "Product Documentation" later in these release notes.
Your host may not have enough TCP endpoints if the following events repeatedly occur:
An excessive number of browser sessions time out while connected to your Apache Web Server, fail to connect to your Apache Web Server, or have other socket failures.
Multiple browser sessions go into a TIMEWAIT state for two minutes.
Your host has problems with networking commands such as telnet, ftp, or rlogin.
To see if insufficient TCP endpoints are a problem on your host, use the netstat -a command to show network status. Examine the TCP state column for browser sessions that are in the TIMEWAIT state. If a significant percentage of the total TCP endpoints are in the TIMEWAIT state, consider increasing the value of the N_TCP_PCB_FREE kernel parameter, which defines the number of TCP endpoints on the system.
For more information about the N_TCP_PCB_FREE kernel parameter, refer to the ptx/TCP/IP Administration Guide. For information about kernel configuration, refer to the DYNIX/ptx System Configuration and Performance Guide.
Binary releases of Apache source files are made with the binbuild.sh script, which is part of every standard Apache distribution. This script is located in the /usr/local/bin/apache/src/src/helpers directory. Binaries are configured with the configure script. The following Apache Autoconf-style Interface (APACI) options were used to build Apache Web Server for DYNIX/ptx:
--enable-shared=max --enable-module=most --server-gid=nobody --with-perl=/usr/local/bin/perl --without-confadjust --enable-rule=SHARED_CHAIN --verbose
If your host does not have a copy of the perl (Practical Extraction and Report Language) program or if perl is not located in /usr/local/bin, then some administrative shell scripts will not function until perl is installed or it can be found under /usr/local/bin. Some examples of administrative shell scripts that will not function in this scenario are dbmmanage, apxs, and printenv.
Apache Web Server contains several man pages. By default, these man pages are not installed in /usr/catman. To view these man pages, take one of the following actions at the operating system prompt:
Use the man -P command to view the man pages from the Apache installation directory. For example, to view the apachectl(8) man page, use the following command:
# man -P /usr/local/apache/man apachectl
Move or copy the man pages from the Apache installation directory into the /usr/catman directory structure. For example:
# cp /usr/local/apache/man/man1/* /usr/catman/man1
# cp /usr/local/apache/man/man8/* /usr/catman/man8
Once the compressed man pages reside under /usr/catman, you can use the man command without supplying a path to the file. For example, to view the httpd(8) man page, enter the following command:
# man httpd
Apache Web Server includes the following man pages:
These release notes are the only documentation written for the Apache Web Server on DYNIX/ptx. However, the Apache Web Server installation directory contains the HTML documentation provided by the Apache Software Foundation as part of the Apache HTTP server 1.3.12 release. You should always refer first to these DYNIX/ptx release notes and then secondarily to the Apache HTML documentation. To display the top-level index page for this documentation, point your web browser at the following URL, where hostname is the name of the Apache Web Server host:
http://hostname/manual/index.html
The HTML documentation includes release notes, a reference manual, and other notes. For background information about Apache, general troubleshooting information, and other general technical information, refer to Apache Server Frequently Asked Questions by pointing your web browser at the following URL, where hostname is the name of the Apache Web Server host:
http://hostname/manual/misc/FAQ.html
The latest documentation provided by the Apache Software Foundation can be found at the following URL. Note that this documentation may include references to releases beyond Apache HTTP server 1.3.12, which are not applicable to the DYNIX/ptx version of Apache Web Server V1.3.12.
More information about Apache is also available in the free electronic publication called Apache Week at the following URL:
There are no open problem reports against Apache Web Server on DYNIX/ptx. For information on problems that have been reported to Apache Software Foundation against Apache HTTP server, refer to the following URL: