Apache Web Server for SCO OpenServer 5.0 Release and Installation Notes

System requirements
Installing and removing Apache
    Installing Apache
    Removing Apache
Installation directory
Existing server configuration files and content
Starting and stopping the Apache web server
Port 80 default server, and interactions with Netscape FastTrack
Documentation notes


Apache for OpenServer 5.0 is a robust, full-featured HTTP web server derived from the Apache Project open source server.

The following notes apply only to the supported Apache web server Release 1.3.12 installed from the Skunkware 2000 CD on OpenServer 5.0 systems.

System requirements

Apache software

Software: SCO OpenServer 5.0.4, 5.0.5, or greater
RAM: >64MB
Disk Space: 4MB free disk space

Apache documentation

Disk Space: 1.5MB free disk space

Installing and removing Apache

Installing Apache

Before installing Apache, you need to first install the Glib library from the Skunkware 2000 CD, using the following command:
/etc/custom -p SKUNK2000:default:Glib -i -m /dev/rcd0
To install Apache, use custom(ADM).

See your OpenServer 5.0 documentation for details.

During installation, you will see the following message:

Do you wish to disable the Netscape FastTrack web server?

Answering "yes" will disable all instances of Netscape FastTrack running or installed on the system, including any instances of the web server running on other ports. If you would prefer to manually disable individual instances of Netscape FastTrack, answer "no" to this question, and see the instructions for disabling Netscape FastTrack below, under "Port 80 default server".

Removing Apache

To remove a layered product or patch, use custom(ADM).

See your OpenServer 5.0 documentation for details.

Installation directory

The Apache server root directory is /usr/local/lib/apache.  Much of the Apache.org documentation refers to Apache being installed in /usr/local/apache: Please be aware of this difference when reading the Apache documentation and executing programs. In this directory you will find the following subdirectories:
 
/bin
Apache executable programs
/cgi-bin
Location for CGI-bin gateway programs; this directory and programs in it are created on installation if no such directory already exists, otherwise, the existing files are left in place
/conf
Apache configuration files
/htdocs
Location for HTML content files; this directory and files in it are created on installation if no such directory already exists, otherwise, the existing files are left in place
/icons
Images used by Apache when creating HTML pages, typically directory indexes
/include
C-language header files for Apache data structures
/libexec
Dynamically loadable .so files
/logs
Default location of the server access and error log files
/man
Nroff format manual pages for the server and various support utilities
/proxy
Caching directory for the Apache proxy module
/servlets
An example directory of Java servlets

Existing server configuration files and content

On installation, Apache will preserve any pre-existing Apache configuration files it finds, renaming them to files with a .bak extension.

If existing /htdocs and /cgi-bin directories are found on the system, the Apache installation will not install its own web server content.  Otherwise, it builds up a default set of content from the /htdocs-default and /cgi-bin-default directories.

Starting and stopping the Apache web server

The standard way to start an Apache web server is using the apachectl script; this script is provided in the /usr/local/lib/apache/bin/apachectl subdirectory of the Apache installation.
/usr/local/lib/apache/bin/apachectl start

As an alternative, the /etc/apache script is provided.  This script also allows the server to be enabled to start on system boot.  See the apache(APACHE) manual page for details of how to use this script.

Port 80 default server, and interactions with Netscape FastTrack

By default, Apache creates a port 80 web server instance, and creates some default server content if none exists already.  This server runs as user nouser, and serves documents from /usr/local/lib/apache/htdocs.

If the Netscape FastTrack port 80 server is already running on the system, the Apache port 80 server will fail to start, and log the following type of message to its error log file:

[crit] (125)Address already in use: make_sock: could not bind to port 80
In this case, either stop, or disable, the FastTrack server before starting Apache, or move one or the other of the servers to a different port.



NOTE: On OpenServer 5.0, the Netscape FastTrack port 80 server is usually enabled to start on boot.  To disable Netscape FastTrack and prevent it from starting up again, execute the following steps, as root:

Comment out the following line in /etc/rc2.d/S90atlas

/bin/su root -c /usr/internet/lib/ns_admin/webservers start ns_httpd

Disable the Fastrack S-file by changing the uppercase "S" to lowercase in the following file:

mv /etc/rc2.d/S90fasttrack /etc/rc2.d/s90fasttrack

Comment out the following line in /etc/rc0.d/K78atlas

/usr/internet/lib/ns_admin/webservers stop

Kill all running Netscape FastTrack processes:

ps -e | grep ns-httpd

Enable Apache:

/usr/local/lib/apache/bin/apachectl start

The system will now function as before, with SCO Help and the internet manager still running, but Apache will replace Netscape FastTrack on port 80. No reboot is required.

To re-enable Netscape FastTrack, reverse these steps.


In general, both Apache and Netscape FastTrack can run together on a single system, providing that they are not trying to listen on the same network port or ports.

Documentation notes

The Apache User's Guide is installed in the default document root for the Apache Web Server and will be available through the Apache Web Server by pointing your browser to http://insert your server name/manual, or through the file /usr/local/lib/apache/htdocs/manual/index.html.

The following manual pages are available:

apache, ab, apachectl, apxs, dbmmanage, htdigest, htpasswd, httpd, logresolve, rotatelogs, and suexec

In order to view the Apache man pages, you must first edit the file /etc/default/man and add the path :/usr/local/man to the end of the MANPATH variable.

For example:

MANPATH=scohelp:/usr/man:/usr/local/man

Next, in the same file, add :1:2:3:4:5:6:7:8:9:n to the end of the ORDER variable.

For example:

ORDER=C:S:CP:CT:......:LMC:NWG:PCI:1:2:3:4:5:6:7:8:9:n

You can then access these pages with the man(C) command. For example:

man apachectl

You can also access the latest Apache documentation directly from the Apache organization, at http://apache.org.

The Java Servlet Development Kit documentation can be found in /usr/local/java/jsdk/doc.

the Apache JServ Java Servlet engine documentation can be found in /usr/local/java/jserv/docs.


© 1999 The Santa Cruz Operation, Inc. All rights reserved.