JServer Hello World!

If you have just compiled everything from source, cd into the bin subdirectory. If you have downloaded the binary distribution, unpack it in a working directory (ideally called jk-0.91), start a command shell, and cd into the bin subdirectory.

To run the HelloWorld servlet (which works under NT, but hangs under Solaris for unknown reasons), you first have to launch the JServer. To run the JServer as a standalone web server, enter:

C:\jk-0.91\bin> jview /cp:p . cornell.slk.jkernel.std.Main cornell.slk.jos.manager.Main -config config\jserver-config.txt SERVER_TYPE=STANDALONE

Welcome to JOS v0.91
Booting...
Starting service cornell.slk.jos.rpc.subsystem.RPCSubsystem
RPCEndpointManager: Accepting RPC connections at port 45678
IIS_HOST=null
SERVER_TYPE=STANDALONE
ServletLoader servlet installed.
SubsystemLoader servlet installed.
Boot completed.
Press any key to shutdown.
StandAloneServer: Now accepting connections on port 8008.

Your standalone JServer is up and running. The URL of your standalone JServer is:

http://<your machine>:8008/

Now, run your favorite web browser and open the above URL. Your browser will send an HTTP request to your JServer, and you should see the following message in your browser window as a response:

Welcome to the J-Server 0.91
Use the servlet loader to load/unload servlets.
Use the subsystem loader to load/unload subsystems.
J-Server Help
SLK Home Page

Before you can run the HelloWorld servlet, you must first upload it into the JServer. Click on the servlet loader link, and you will get an HTTP form that looks as follows. Enter the complete path of the bin directory (e.g. C:\jk-0.91\bin, as highlighted in maroon), and press "Submit Query". This loads the HelloWorld servlet into the JServer, and you should see a message in your browser saying so.

servlet HTTP handle [mandatory]:

action [load=0, unload=1]:

servlet entry class [mandatory if loading]:

packages [mandatory if loading]:

additional classes [optional]:

Enter the path and/or url where the entry class, packages, and additional classes are found. Use ; as separators. [mandatory if loading]
path:
c:\jk-0.91\bin
url:

Additional resolvers [optional, use ; as separators] :

servlet arguments [= pairs, use ; as separators (e.g. foo=1;bar=goo]):

Finally, to run the HelloWorld servlet, append the servlet handle hello to your JServer's URL:

http://<machine>:8008/hello

and you should see

Hello World!

in your browser window. Hit any key to stop the JServer. You can also follow same steps described above using a JServer running as a Microsoft IIS plug-in. You need first to install the JServer binaries on IIS. The only difference is that the URL of your IIS/JServer is:

http://<IIS machine>/jserver/win32/jserver.dll/

That's it!

Home