This is short guide for installing gnujsp 1.0 on vqserver 1.9.17.
The vqserver 1.9.17 package contains a description of how to 
install gnujsp 0.9 which is mostly correct so take that 
as an additional help.

You need:
	- vqserver 1.9.17 or above (didn't tried older versions)
	- jar-File for gnujsp 1.0 (o.k. since you read this you
	  most probably have it already)

I only use vqserver for testing gnujsp, so please check the
documentation for security, etc.

vqserver is installed in /home/heyl/work/vqserver-1.9.17

1. I needed to put vqserver on another port so I changed 
   "vq/server/cfg/server.cfg":

Port 8030

2. To run vqserver I used (this is for Unix, sh-Shell)

CLASSPATH=/home/heyl/work/vqserver-1.9.17/classes/classes.zip:${CLASSPATH}
export CLASSPATH

Using the gui was very unstable on Linux:
java vq.server.console

Better using the console frontend:
java vq.server.console -nogui -console

If you plan to execute the testsuite you may need to say:
java -mx100000000 vq.server.console -nogui -console

3. Now lets take a look at the vqserver gnujsp howto and follow it's commands
   (I list them here, too.)

http://127.0.0.1:8030/vq/server/docs/howto/gnujsp.html

mkdir jsp
mkdir jsp/repository
mkdir jsp/lib

cp .../gnujsp10cvs.jar jsp/lib
cp -apr .../testsuite jsp

4. Access the Adminserver and do the configuration:
http://127.0.0.1:9090/
User: admin
Password: admin

(You should change that for serious use :-)

Enter: Main Web Server/Aliases

Add a "New alias":
alias java/jsp
Real name: jsp/lib/gnujsp10cvs.jar/org.gjt.jsp.JspServlet
Action: Run Java servlet

Press "OK" 2 times.

Click on Icon for properties and set: 
(see README or INSTALL.apache for explanation and additional parameters)

scratchdir: /var/local/apache/jsp-vq
compiler: builtin-javac -g -classpath %classpath%:%scratchdir%:/usr/local/gnujsp-1.0cvs/lib/gnujsp10cvs.jar:/home/heyl/test/java/jdbcbeans -d %scratchdir% -deprecation %source%
debug: true
pagebase: /home/heyl/work/vqserver-1.9.17

New alias:

Alias: /testsuite/ 
Real name: jsp/testsuite/
Action: Serve file 
Read access: anyone

Control center: File Types
New File Type

File extension: jsp
Filter: /servlet/jsp

Test: http://127.0.0.1:8030/testsuite/java1.jsp

And don't forget to save your setting:

Control center: Others/Save Settings!

Have fun and tell us about bugs on gnujsp@gjt.org.

Carsten Heyl <alph@gjt.org>