iTP Secure WebServer System Administrator's Guide (iTPWebSvr 5.1+)

Using NonStop Servlets for JavaServer Pages With
The iTP Secure WebServer
iTP Secure WebServer System Administrator’s Guide—522659-001
9-17
Configuration Overview
Possible Error Conditions
•
The NSJSP servlet class file (iTP_Servlet_JSP.jar) and servlets JNI
(libtandemservlet.a) must be the same version. If they do not match, startup of the
NSJSP environment fails and a message reporting the error appears in the OSS
syslog file. You can use the Administration Server (described in Section 12,
Managing the iTP Secure WebServer From Your Browser) to view event messages.
•
If you are using the new parallel library version of TCP/IP support, you can no
longer use the restarth script to change the NonStop Servlets for JavaServer Pages
configuration dynamically.
Configuration Overview
This is an overview of the configuration process.
Web Container Configuration
on page 9-17 shows the directory structures and
configuration files that support the web container environment. These configuration files
contain default values.
Web Application Configuration
on page 9-23 shows the directory structures for
applications and the changes you make to the configuration files in order to host an
application and deploy its servlets.
Web Container Configuration
The Main Configuration Files
The examples in this section assume the default root path of /usr/tandem/webserver.
There are three related configuration files:
The servlet.config File
contains the configuration information required for the servlet
server class and the file mapping for the iTPWebServer. The file is located in
/usr/tandem/webserver/conf.
The iTP_server.xml File
contains the initial attributes of the web container to work with
the iTPWebServer. The file is located in /usr/tandem/webserver/servlet_jsp/conf.
The web.xml File
contains configuration contexts for servlets. There is a default version
located in /usr/tandem/webserver/servlet_jsp/conf, and for each application you can
create an application-specific version used to support specific servlet initializations
which is located at the root level of the application.
The servlet.config File
This file contains the configuration information required for the servlet server class and
the filemap. The file is located (by default) in /usr/tandem/webserver/conf.
When you run a new installation (of T1222) for the first time, for security purposes, the
setupjava script will automatically make a backup of any pre-existing servlet.config file.
You may then make any changes to the default, such as adding filemaps.