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-15
setup:
The setupjava script is expected to be run only once when the product is first unpaxed
(by using COPYOSS) into its version specific location. Running it a second time is not
typically necessary unless you need to re-install the T1222 NSJSP libraries and/or class
files.
setup:
The setup script is used to integrate the T1222 NSJSP with a previously installed iTP
WebServer. This script will prompt you for the location of an installed iTP WebServer to
which you wish to add NSJSP Servlets/JSP support. To run the setup script you must use
the same userid as you used to install the iTP WebServer.
For example, if previously you used the SUPER.WEB userid to install the iTP
WebServer you must now use SUPER.WEB to install this portion of the product as
follows:
TACL> LOGON SUPER.WEB
TACL> OSH
OSS: cd /usr/tandem/webserver/servlet_jsp/<version>
OSS: ./setup
After the setup script is executed, the default servlet.config file will be located in the
WebServer's /conf directory. When the script is run, if there is a pre-existing T0094 SSC
servlet.config file, the script will automatically back up the pre-existing T0094 SSC
servlet configuration files in the /conf directory. If a pre-existing T1222 NSJSP
configuration already exists, no backup is made and the pre-existing T1222 NSJSP
configuration files are kept unmodified.
Once the setupjava and setup scripts have run, do not delete or modify the version
specific directory (/usr/tandem/webserver/servlet_jsp/<version>) or its subdirectories as
there are OSS symbolic links pointing back to that directory tree. If you do delete any of
these directories or subdirectories, you will have to reinstall the entire product starting
with unpaxing the product PAX file.
Verify the VPROC of the WebServer's /bin/servlet.ssc binary. There should be a T1222
vproc that matches with the <version> portion of the installation directory. If there is not
a match, then an installation error has occurred and must be corrected before proceeding.
A running TCP/IP process is required when the NSJSP software is started. The default
NSJSP installation assumes that the running TCP/IP process will be named $ZTC0. If
$ZTC0 is not running, then the servlet.config file located in the iTPWebServer's /conf
directory must be modified. The servlet.config file's "Server" directive must be modified
to add a MapDefine that indicates the OSS process name of the correct TCP/IP process.
For example, if the TCP/IP process name is $ZTCxx, then the servlet.config would be
modified as follows:
Server $server_objectcode {
...
MapDefine =TCPIP^PROCESS^NAME /G/ZTCxx
...
}