Apache 1.3.4 for MPE/iX 6.0

Software

Papers & Training

Java

HP Partners

News & Events

Register for more info

This page contains information about running Apache 1.3.4 on MPE/iX Release 6.0. For other releases of Apache, please consult the release information. The resources section lists Apache 1.3.4 documents. Even though these documents are written for Apache 1.3.4 on 6.5, their content applies to Apache 1.3.4 on 6.0. Apache 1.3.4 on 6.0 and 6.5 differ only in the installation process.

Last updated 3/16/01

Registration and download

Please register to download Apache 1.3.4.

Configuring Apache 1.3.4

Once Apache has been installed, the following will direct you in how to configure and start up Apache.

Configuration files

Apache 1.3.4 comes with 5 configuration files. These are located in /APACHE/PUB/conf. You will need to copy these configuration files to create your own set. The httpd.conf.sample contains MPE specific content and should be used as your base file for httpd.conf. Make sure to log on as MGR.APACHE before copying the configuration files. This will ensure that they have the correct permissions.

:HELLO MGR.APACHE
:xeq sh.hpbin.sys -L
shell/iX>cd /APACHE/PUB/conf
shell/iX>cp httpd.conf.sample httpd.conf
shell/iX>cp magic.default magic
shell/iX>cp mime.types.default mime.types
shell/iX>cp srm.conf.default srm.conf        (optional)
shell/iX>cp access.conf.default access.conf  (optional)

The copies of srm.conf and access.conf are optional. These configuration files are empty by default because their functionality is now included in httpd.conf. They are made available for backward compatibility to earlier Apache versions. If you copy these files, Apache will read them at startup after reading the httpd.conf file.

Configuration recommendations

You can now customize your new httpd.conf file by editing its content. Httpd.conf is a bytestream file so you'll need an editor that handles bytestream files (such as "vi") or you can use your PC if you have Samba running.

• You will probably want to modify the ServerAdmin and ServerName directives by replacing "yourserver.com" with your own server's name.

  ServerAdmin MGR.APACHE@yourserver.com 
  #ServerName yourserver.com 
  

• We strongly recommend deactivation of the persistant connections feature. This is done by setting the KeepAlive directive off. With keepalive on, available sockets may be used up so that new requests are ignored. When this occurs, Apache will appear hung and need to be restarted.

  KeepAlive off
  

• You may also choose to make other changes. The Apache Server Project web site, has information about all of the configuration directives.

JHTTPD

You may want to modify the JHTTPD file to include a password and to set the timezone variable, TZ. JHTTPD is an MPE file that can be edited with a traditional MPE editor. TZ should be set to your local timezone(for example, EST5EDT for Eastern Daylight Time, PST8PDT for Pacific Daylight Time, and MST7MDT for Mountain Daylight Time). For more information about setting the timezone value, do a "man timezone" in the POSIX shell to read the POSIX help file.

!job jhttpd,www.apache,pub;outclass=,2
!setvar TZ 'PST8PDT'
!run HTTPD;info='-f /APACHE/PUB/conf/httpd.conf'
!eoj

Optional setup

Here are some features of your web server you may want to try.

• Create a home page for MGR.APACHE:

  :HELLO MGR.APACHE
  :xeq sh.hpbin.sys -L
  shell/iX>cd /APACHE/PUB/public_html
  shell/iX>cp index.html.sample index.html
  

  Now you can edit index.html with your own site information.

• Experiment with the test-cgi script distributed with Apache,

  shell/iX>cd /APACHE/PUB/cgi-bin
  shell/iX>chmod +x test-cgi
  

  Execute test-cgi by entering,

  http://yourhost.com/cgi-bin/test-cgi
  

Running Apache 1.3.4

Apache can be started either from the Command Interpreter or in the POSIX shell:

:STREAM JHTTPD.PUB.APACHE
or
shell/iX>callci stream jhttpd.pub.apache

Verify that Apache is running:

• Access the Apache Software Foundations's Welcome Page from your browser by entering http://yourhostname
• Access the home page of MGR.APACHE from your browser by entering http://yourhost.com/~MGR.APACHE (see optional setup)
• Look at the online Apache 1.3.4 documentation at http://yourhost.com/manual

If Apache does not start, try the Troubleshooting Checklist for tips on locating and fixing the source of the problem.

Stopping Apache 1.3.4

Apache can be stopped either from the Command Interpreter or in the POSIX shell. The kill command is the preferred method for shutting down Apache. This ensures that all Apache resources are cleanup up.

:ABORTJOB JHTTPD,WWW.APACHE
or
shell/iX>callci abortjob jhttpd,www.apache
or
:xeq sh.hpbin.sys "-c 'kill `cat /APACHE/PUB/logs/httpd.pid`'"
or
shell/iX>kill `cat /APACHE/PUB/logs/httpd.pid`

Apache 1.3.4 modules

These modules are built into the MPE/iX Apache binary and determine the Apache 1.3.4 feature set on MPE/iX.