RBNB Servlet Deployment Guide
This guide outlines the process by which additional applications and PlugIns
may be added to the servlet-based web configuration and deployment system.
Operationally, from the displayed list of available servlets, a user clicks
to a configuration page. Once the configuration is complete, the
user clicks to start. The HTML document invokes a Javaserver Page,
which in turn invokes the appropriate Java class.
Getting Started
There are three steps to deploying a new servlet. First, copy the
class file into the appropriate directory. Second, create a HTML
document to configure and start it. Third, edit the HTML document
which lists and links the available servlets.
You will need a Java class file for the servlet you are adding to the
system, and knowledge of the configuration parameters for it. Source
code for the VSourcePlugIn and VChansPlugIn is provided, but you will need
a javac compiler. A version is available at no charge from
Sun as part of the JDK.
All directories and files mentioned here are relative to the RBNB install
directory.
Copy Class File
Copy the servlet class file into the
jakarta-tomcat-4.0.1\webapps\webTurbine\WEB-INF\classes
directory. This directory contains the class files for all servers,
applications, and PlugIns deployed by the system.
Create HTML Document
In the
jakarta-tomcat-4.0.1\webapps\webTurbine
directory, copy StartVSourcePI.html and rename for your servlet.
Edit this file, tailoring the names and configuration options to your servlet.
For most servlets, using the provided Javaserver Page, StartPlugIn.jsp,
is recommended. If there are unusually complex configuration options,
a specialized Javaserver Page may be written.
Edit List of Available Servlets
Edit the
jakarta-tomcat-4.0.1\webapps\webTurbine\index.html
file, adding a link to and brief description of your servlet.