Ying-Hung Chen

6-10-2001

Last updated 11-4-2001

Instructions for installing tomcat and frontpage extension for Linux with apache web server

1. Require software packages:

· Java JDK from http://www.blackdown.org (jdk-1.2.2-RC4-linux-i386-glibc-2.1.2.tar.bz2)

NOTE: Roll back to jdk-1.18v3 as recommended by Oracle. --11-4-2001

· Frontpage extension package from http://www.rtr.com/fpsupport (fp40.linux.tar.gz)

· Working apache web server with frontpage server extension support. (Reference URL: http://www.linuxdoc.org/HOWTO/mini/Apache+SSL+PHP+fp.html) NOTE: There are many ways to have Apache Webserver to run with Frontpage server extension. Mandrake-Linux 8.0 development has mod_frontpage-1.5.x.rpm that I have used with minimal configuration file changed to get it work.

· Tomcat software from http://jakarta.apache.org/tomcat/tomcat-3.2-doc/tomcat-apache-howto.html (both jakarta-tomcat* packages) and follow the installation howto.

2. Brief Instructions:

• Java JDK: Extract the package into anywhere you like (i.e. /usr/local/java) and make sure to change the path to its executables. (i.e. $path=/usr/local/java/bin). NOTE: Linux distributions may includes other Java JDK that may or may NOT work properly. So, its better to get the standard version.

• To add frontpage server into Apache server may requires re-compiling the apache server (not recommended for inexperienced) Easier solution is running Linux-Mandrake 8.0 and install the frontpage module (i.e. mod_frontpage-1.5.x.rpm) This has being tested and worked.

• Frontpage extension package includes utilities that will be able to add users, change passwords ..etc, and it can be install anywhere (i.e. /usr/local/frontpage) Follow the instructions in http://home.edo.uni-dortmund.de/~chripo/ to initialize the frontpage extension.

In /usr/local/frontpage/version4.0 , run

/usr/local/frontage/version4.0/bin/fpsrvadm.exe

A dialog will look like this:

Please enter command:

0) quit

1) install

2) upgrade

3) uninstall

4) check and fix

5) enable authoring

6) disable authoring

7) change security settings

8) recalculate links

9) delete

10) rename

11) set directory executable

12) set directory no executable

13) putfile

14) recalcfile

15) create a subweb

16) merge a subweb into its parent web

17) full uninstall of all FrontPage information

18) chown

Your choice [1]: 1

Please enter server type:

0) apache

1) apache-fp

2) ncsa

3) netscape-enterprise

4) netscape-fasttrack

5) stronghold

Your choice [0]: 1

Enter server config filename: /etc/httpd/conf/httpd.conf

Enter host name for multi-hosting []:

Starting install, port: 8080, web: "root web"

Enter UNIX username []: <frontpageuser>

Enter UNIX group []: <frontpageuser>

User name to add to FrontPage group "administrators" [administrator]: fpadmin

Password for user "fpadmin":

Confirm password:

Chowning Content in service root web

Install completed.

Move the 8080.cn* to 80.cn* so frontpage extension runs on port 80.

NOTES:

1. To work around the frontpage scripts and Mandrake8.0 apache config file, I combine httpd.conf and commonhttpd.conf to ONE huge httpd.conf file, also uncommented out the

<IfDefine HAVE_FRONTPAGE> Tags in httpd.conf

• Follow the tomcat installation instructions carefully, it should be easy to get it up and running with apache. (It has a section explains how to make it work with apache web server) NOTE: It is required to run both apache web server (with tomcat aware mode) AND tomcat backend engine to get the Jserv and JSP working.

1. Check the tomcat-apache.conf for reference

2. Need to compile mod_jserv via command (apxs -c -o mod_jserv.so *.c) in the tomcat src

3. run bin/tomcat.sh start so it will create the tomcat-apache.conf.

4. Modify tomcat-apache.conf to fit our need and Include it in the httpd.conf

• NOTE: It is NOT trivial to have frontpage to work with tomcat 100% in sync due to the virtual host configuration and the ROOT path that frontpage software is looking for. In theory, ROOT path for the webserver and the display of the ‘/’ web page can be in distinct path without any problem, however, it doesn’t work with frontpage since it will confuse it, the work around is currently being worked on.

#make sure tomcat knows about oracle

LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/oracle/lib; export LD_LIBRARY_PATH

CLASSPATH=.:$ORACLE_HOME/jdbc/lib/classes111.zip; export CLASSPATH

ORACLE_BASE=/usr/oraInventory;export ORACLE_BASE

ORACLE_HOME=/usr/oracle;export ORACLE_HOME

ORACLE_SID=oralin;ORACLE_SID