JSP

MiniPortal can be used with JSP, providing Apache Tomcat is installed and correctly configured. There is currently no plugin for this (and it is unsupported), but there are instructions below for manual setup and configuration.

It is highly recommended to use Windows 2000 or XP for JSP. There has been some success with Win9x, but it is problematic.

Instructions for adding JSP support to MiniPortal

1. Stop all MiniPortal servers

2. Download and Install the Sun JDK (J2SE) from:
http://java.sun.com
(e.g. http://java.sun.com/j2se/1.4.1/download.html)

3. Download and Install the JSP Server: Jakarta-Tomcat from:
http://jakarta.apache.org
(e.g. http://jakarta.apache.org/builds/jakarta-tomcat-4.0/archives/v4.0.1/bin/jakarta-tomcat-4.0.1.exe)

4. Download and Install the Apache 'webapp_module' from:
http://jakarta.apache.org
(e.g. http://jakarta.apache.org/builds/jakarta-tomcat-4.0/archives/v4.0.1/bin/win32/)

Copy the files 'libapr.dll' and 'mod_webapp.so' into the ..\MiniPortal\Apache\modules directory

5. Add the following line to ..\MiniPortal\Apache\conf\httpd.conf after the last 'LoadModule' statement:

• LoadModule webapp_module modules/mod_webapp.so

6. Add the following line to ..\MiniPortal\Apache\conf\httpd.conf after the last 'AddModule' statement:

• AddModule mod_webapp.c

7. Add the following 2 lines at the end of ..\MiniPortal\Apache\conf\httpd.conf

• WebAppConnection conn warp localhost:8008
• WebAppDeploy examples conn /examples

8. Start Tomcat (from the Start menu) and wait until it is *completely* up and running (~15 seconds).

9. Start MiniPortal and the web server

10. Access http://127.0.0.1/examples/
(Note: must include the trailing '/')

Then, click on 'jsp' for a list of examples to try. If you encounter errors, stop Tomcat and then stop MiniPortal's web server. Then, restart Tomcat and MiniPortal's web server.

Troubleshooting:

If the examples fail, try the following:

1. Check the Tomcat apache log file for error messages:
   (e.g. c:/program files/apache tomcat 4.0/logs/apache_log_xxx)
2. Set the environment variable 'JAVA_HOME' to the JDK path
   (e.g. JAVA_HOME=c:\j2sdk1.4.1_01)
3. Edit the Jakarta-Tomcat file 'server.xml' file:
   (e.g. c:\apache tomcat 4.0\conf\server.xml)
   Near the bottom of the file, look for the comment:

• 'Replace "localhost' with what your Apache "ServerName" is set to'.
  Two lines down, change:
  name="Apache"
  to
  name="localhost"