Problem
How do I install and configure the Apache Web Server product on SCO OpenServer 5.0.4 or 5.0.5 so that I can use Tarantella?
Solution
The Apache 1.3.9 Web Server product is available for download from:
http://www.sco.com/downloadSelect the link labeled:Apache Web Server 1.3.9 for SCO OpenServer 5.0.4+Save the file(s) to disk.DL40010P000.html 13.3 K (13337 bytes)
DL40011P000.tar 1.5 M (1495040 bytes)I. INSTALLATIONUntar the file before beginning to install the Apache 1.3.9 VOLS package.
As root, run Software Manager (custom)-> Install New-> From Host machine.
Choose Media Images and then specify the path where the VOL.000.000 file resides. You will see:
Installation in progress. . . .Installation of Apache Web Server (apache) was successful.
NOTE: While it is possible to have both Apache and Netscape FastTrack running, SCO is no longer developing Netscape FastTrack and is now supporting Apache 1.3.9+ as the Web server of choice for SCO OpenServer 5 and UnixWare 7.
II. INITIAL CONFIGURATIONBy default, the product is installed in the /usr/internet/apache directory and now needs to be configured and activated.
From the OpenServer 5 Netscape browser, open the location:
file:/usr/internet/apache/htdocs/manual/install.htmlThis details the main configuration files and startup sequence. If the initial installation is complete, there should be an "http" binary in the /usr/internet/apache/bin directory.
The configuration files are in the /usr/internet/apache/conf directory. The Apache distribution gives you the main files:
srm.conf-default
access.conf-default
httpd.conf-default (the main configuration file!)These have to be copied to the files to be used on this particular system by stripping off the "-default" suffix. This is already done on the SCO OpenServer 5 installation. Edit the file "httpd.conf" and set the following "directives":
ServerAdmin root@scotest.sco.comServerName scotest.sco.comwhere the "scotest.sco.com" examples would be replaced by the name of your system and its domain.
The ScriptAlias and Alias directives below are used to configure Apache for Tarantella use:
ScriptAlias /tarantella/cgi-bin /opt/tarantella/cgi bin
Alias /tarantella /opt/tarantellaLeave the "access.conf" and "srm.conf" files as is; by default these files are left blank.
Start the daemon (on port 80 by default) as follows:
# /etc/apache startThe daemon can be seen running with the command:
# ps -ef | grep apachewhich shows something similar to this:daemon 1148 1127 0 09:33:34 ? 00:00:00 /usr/internet/apache/bin/httpd
daemon 1149 1127 0 09:33:34 ? 00:00:00 /usr/internet/apache/bin/httpd
root 1127 1 0 09:30:46 ? 00:00:01 /usr/internet/apache/bin/httpdNow that the server is started, you need to verify it. Connect to the server from another networked system with a browser to its port. For example, if you connect to:
http://scotest.sco.comyou should see the Apache welcome page:
It Worked! The Apache Web Server is Installed on this Web Site!
To start using Apache as your department web server, you generally need to replace this placeholder page with your own parent page and subpages/directory structures. You also need to configure the system to start and stop the Web Server on system boot and shutdown. (You can configure your site in other regards, such as access, but these subjects are not within the scope of this article.)
To start the server on boot, a file can be added to the SCO OpenServer 5 "/etc/rc2.d" directory of startup files.
# /etc/apache enable This will create an S90Apache fileStopping the server is also discussed in the Apache documentation at:
/usr/internet/apache/htdocs-default/stopping.htmlTo stop the server, type:# /etc/apache stopTo stop the Apache server as part of any SCO OpenServer 5 shutdown, a file can be added to the system "/etc/rc0.d" directory. For example, create the file "K68Apache" with the following contents:
:
#
# Stop the Apache Web Server
#
echo "Stopping Apache ..."
/etc/apache stop
exitSet the permissions as:# chmod 544 K68apache
# chown root:sys apacheYou can also use the SCO supplied script "/etc/apache" to stop and start the Web Server, for example:
# /etc/apache start
Starting apache . . . done.# /etc/apache stop
Stopping apache . . . done.Again, you can type "# apache help" for options.
The default Apache page seen on first connection is located at:
/usr/internet/apache/htdocs/index.htmlYou can replace this with your own page and directory structure as follows. The existing file is:
-rw-r--r-- 1 root sys 1622 Feb 24 10:22 index.html
Move this out of the way:# mv index.html index.html.orgAdd your own page, by creating another "index.html".
Now set the permissions:# chmod 544 index.htmlThe default web server parent structure:/usr/internet/apache/htdocscan also be "moved" to another area of the SCO OpenServer 5 filesystem by symbolically linking it using the ln(1) command to another area of the disk.
III. REMOVALTo remove the Apache package, run the following:
# apache stop
/etc/apache stopStopping apache . . . done.As root, run Software Manager (custom)-> Install New-> From Host machine.
Highlight Apache Web Server Version 1.3.9 and select Software-> Remove. You will see:
Do you want to remove this package [Yes,No,?,quit] y
Removal of <apache> was successful. See also
ta110910, "Do I need to install a Web server to run Tarantella Express?"
The Apache online documentation that is installed as part of the distribution:
/usr/internet/apache/htdocs.index.htmlApache's home page:http://www.apache.org/