This book contains instructions for installing ServletExpress and using the
ServletExpress Manager to manage servlets.
The most current version of this book is available in HTML and PDF formats
on the ServletExpress Web site. To access the online book, open the
following URL:
http://www.ibm.com/java/servexp/sedocd.html.
IBM ServletExpress enables you to achieve your "write once,
use everywhere" goal for servlet development. The product consists of a
Java-based servlet engine that is independent of your Web server.
ServletExpress offers a choice of server plug-ins that are compatible with the
most popular server application programming interfaces (APIs). The
supported Web servers are:
- Domino Go Webserver Version 4.6.1
- Netscape** Enterprise Server Version 2.01 or higher and Version
3.0 or higher
- Netscape FastTrack Server Version 2.01 or higher and Version
3.0 or higher
- Microsoft** Internet Information Server Version 2.0 or higher and
Version 3.0 or higher
- Apache Server Version 1.2.4
Note: | ServletExpress is packaged separately for each operating system. This
document is for the package that supports Domino Go Webserver. If you
want the beta packages for the other server types, refer to
http://www.ibm.com/java/servexp. To download the
product packages, participate in the discussion forum, and obtain product
support information, refer to
http://www.ibm.com/java/servexp.
|
In addition to the servlet engine and plug-ins, ServletExpress
provides:
- Implementation of the JavaSoft Java Servlet API and extensions to session
tracking
- Sample applications that demonstrate those extensions
- ServletExpress Manager, a graphical interface that makes it easy to set
options for loading local and remote servlets, set initialization parameters,
specify servlet aliases, create servlet chains and filters, log servlet
messages, and perform other servlet management tasks
- Support for a new tag, <JAVA>, and a new file type, JHTML, that
enable you to embed Java coding for servlets inline in your HTML coding
This section describes the prerequisites and steps necessary
to prepare your system for installing IBM ServletExpress. It includes
the following topics:
- Software requirements
- Uninstalling the current Java support
ServletExpress provides support for the following operating
systems:
- Microsoft NT** Version 4.0.
- AIX Version 4.1.5 or later.
- Sun** Solaris Version 2.5.1 or later. It must also
include the Native Threads Package.
ServletExpress requires Lotus Domino Go Webserver Version
4.6.1 or later.
The following levels of JDK support are required and are available for
download from our Web site at
http://www.ibm.com/java/servexp:
- NT: JDK 1.1.4 or greater
- AIX: JDK 1.1.2
- Sun Solaris: JDK 1.1.4 with Native Threads Package or
greater
To download IBM ServletExpress, go to
http://www.ibm.com/java/servexp and follow the
instructions.
To uninstall the current Java support:
- Shut down the webserver if it is currently running.
- Run the uninstall program for Domino Go Webserver.
- Select the Java Servlet Component.
- Click OK.
Attention: | Make sure you have selected only the Java Servlet Component before you click
OK. The program does not ask for confirmation that you wish to
uninstall the selected components.
|
To uninstall under AIX:
- Logon as root.
- Shut down the webserver if it is currently running.
- Run the System Management Interface Tool (smit).
- Select software installation and maintenance.
- Select maintain installed software.
- Select remove software products.
- On the following screen
- Click the list button next to the software field.
- Select all
internet_server.java.*
files.
- Select yes for remove dependent software.
- Click OK.
- Click OK.
- It will prompt you for confirmation. Confirm that you wish to
uninstall.
- Once the Java support for Domino Go Webserver has been uninstalled, exit
smit.
- Logon as root.
- Shut down the webserver if it is currently running.
- Run admintool.
- Open the browse menu and select software.
- Select the Lotus Domino Go Webserver -- Java Servlets
component.
- Open the edit menu and select delete.
- It will prompt you to confirm that you wish to remove this package.
Click delete.
Java support has been removed.
If you are just getting started, review "Software requirements". This chapter describes the installation procedure for
each of the various platforms that support ServletExpress. It includes
the following topics:
- Installing ServletExpress on Windows/NT
- Installing ServletExpress on AIX
- Installing ServletExpress on SUN Solaris
To install under Windows NT:
- Logon as Administrator or make sure that the account you are installing
from has administrative privileges.
- Shut down the webserver if it is currently running.
- Execute the s100bent.exe file. This will launch
an InstallShield interface.
- Uninstall the previous servlet support if you have not already done
so. You will be prompted should this step be necessary.
- You will be asked where you wish to install ServletExpress. This is
referred to as your servletexpress_install_root. You may
specify a directory or simply select NEXT to accept the default. The
installation will create a folder with a README file and an UNINSTALL program
for ServletExpress.
- Read the README file (optional).
When installation is complete,
- You will need to migrate the Servlet and Eservlet directives stored in the
servlet.cnf file to the new server. This can be accomplished in
the following manner:
- Print or view the Servlet and Eservlet directives in the
servlet.cnf file.
- Open the Admintool GUI (See Chapter 4: Starting the Servlet Express
Manager).
- Each Servlet and Eservlet directive will need to be added then configured
(See the section on Managing Servlets in Chapter 5).
Note: | ServletExpress does not distinguish between internal and external
servlets.
|
- You will also need to move the servlets from their current location in
www\servlets\public or other previously specified directories to
servletexpress_root\servlets.
- Once this is done, restart the webserver.
Attention:: | ServletExpress can only be run with one web server at a time.
|
During the installation process two configuration files were either
modified or created. The following directives have been modified or
created in the ServletExpress configuration file, jvm.properties:
The following directives have been modified or created in the Domino Go
Webserver configuration file, httpd.cnf. The
servletexpress_install_root sections refer to the path you specified
during the installation. The default path, for example is:
c:\ServletExpress\.
- Service /servlet/*
servletexpress_install_root\plugins\nt\adpter.dll:AdapterService
- Service /*.jhtml
servletexpress_install_root\plugins\nt\adpter.dll:AdapterService
- Service /*.shtml
servletexpress_install_root\plugins\nt\adpter.dll:AdapterService
- ServerInit
servletexpress_install_root\plugins\nt\adpter.dll:AdapterInit
servletexpress_install_root\properties\server\ncf\ncfservice\jvm.properties
- ServerTerm
servletexpress_install_root\plugins\nt\adpter.dll:AdapterExit
Note: | ServletExpress will be installed in the /usr/lpp/ServletExpress
directory.
|
- Logon as root.
- Shut down the webserver if it is currently running.
- Uncompress the s100beai.tar.Z file by executing
uncompress s100beai.tar.Z.
- You will then have to untar the s100beai.tar file. This is
done by executing tar -xf s100beai.tar. When this
completes there will be a ServletExpress.base file.
- Set the system environment variable JAVA_HOME to where the correct version
of the Java Development Kit is installed.
- Run the System Management Interface Tool (smit).
- Select software installation and maintenance.
- Select install and update software.
- Select install software products at the latest level.
- Select install new software products at latest level.
- Supply the location of the ServletExpress.base file.
- On the following screen
- Click the list button next to the field for software to install
- Select the following files from the list:
- ServletExpress Base Release
- ServletExpress Base Release -- English Web Files
- ServletExpress Plugins -- Go Webserver 4.6.1
Plugin
- Click OK.
- Click OK to begin the install.
- When installation is complete, continue to "Completing the AIX installation".
Note: | ServletExpress will be installed in the /usr/lpp/ServletExpress
directory.
|
- Logon as root.
- Shut down the webserver if it is currently running.
- Uncompress the s100beai.tar.Z file by executing
uncompress s100beai.tar.Z.
- You will then have to untar the s100beai.tar file. This is
done by executing tar -xf s100beai.tar. When this
completes there will be a ServletExpress.base file.
- Set the system environment variable JAVA_HOME to where the correct version
of the Java Development Kit is installed.
- Run the System Management Interface Tool (smit).
- Select software installation and maintenance.
- Select install/update from LATEST available software.
- Supply the location of the ServletExpress.base file.
- On the following screen
- Click the list button next to the field for software to install
- Select the following files from the list:
- ServletExpress Base Release
- ServletExpress Base Release -- English Web Files
- ServletExpress Plugins --Go Webserver 4.6.1
Plugin
- Click OK.
- Click OK to begin the install.
- When the installation is complete, continue to "Completing the AIX installation".
When installation is complete,
- Set the system environment variable LD_LIBRARY_PATH to the value specified
in the jvm.properties file.
- You will need to migrate the Servlet and Eservlet directives stored in the
servlet.conf file to the new server. This can be accomplished in
the following manner:
- Print or view the Servlet and Eservlet directives in the
servlet.conf file.
- Open the Admintool GUI (See Chapter 4: Starting the Servlet Express
Manager).
- Each Servlet and Eservlet directive will need to be added then configured
(See the section on Managing Servlets in Chapter 5).
Note: | ServletExpress does not distinguish between internal and external
servlets.
|
- You will also need to move the servlets from their current location in
web_server_root/servlets/public or other previously
specified directories to
servletexpress_root/servlets.
- Once this is done, restart the webserver in the same session and shell
that was used to install IBM ServletExpress. If you do not, you will
need to export the LD_LIBRARY_PATH and JAVA_HOME environment variables.
Attention:: | ServletExpress can only be run with one web server at a time.
|
During the installation process two configuration files were either
modified or created. The following directives were added or updated in
httpd.conf:
- Service /servlet/*
/usr/lib/adpter.so:AdapterService*
- Service /*.jhtml
/usr/lib/adpter.so:AdapterService
- Service /*.shtml
/usr/lib/adpter.so:AdapterService
- ServerInit /usr/lib/adpter.so:AdapterInit
/usr/lpp/ServletExpress/properties/server/ncf/ncfservice/jvm.properties
- ServerTerm /usr/lib/adpter.so:AdapterExit
The following directives were added or updated in the jvm.properties
file:
Note: | JAVA_HOME is the installation directory for the Java Development
Kit.
|
Note: | ServletExpress will be installed in the /opt/ServletExpress directory.
|
- Logon as root.
- Shut down the webserver if it is currently running.
- Uncompress the s100beso.tar.Z file by executing
uncompress s100beso.tar.Z.
- Untar the s100beso.tar file by executing tar -xf
s100beso.tar. When this completes, there will be a spool
directory off the directory containing the ServletExpress.tar
file.
- Set the system environment variable JAVA_HOME to where the correct version
of the Java Development Kit is installed.
- Run admintool.
- Open the browse menu and select software.
- Open the edit menu and select add.
- Supply the directory path to the spool directory at the prompt.
This should be the absolute path to the spool directory, including
spool.
- Click ServletExpress and Go Webserver 4.6.1
Plugin, and select add.
When installation is complete:
- Set the system environment variable LD_LIBRARY_PATH to the value specified
in the jvm.properties file.
- You will also need to move the servlets from their current location in
web_server_root/servlets/public or other previously
specified directories to
servletexpress_root/servlets.
- Once this is done, restart the webserver in the same session and shell
that was used to install IBM ServletExpress. If you do not, you will
need to export the LD_LIBRARY_PATH and JAVA_HOME environment variables.
Attention:: | ServletExpress can only be run with one web server at a time.
|
During the installation process two configuration files were either
modified or created. The following directives were added or updated in
httpd.conf:
- Service /servlet/*
/usr/lib/adpter.so:AdapterService*
- Service /*.jhtml
/usr/lib/adpter.so:AdapterService
- Service /*.shtml
/usr/lib/adpter.so:AdapterService
- ServerInit /usr/lib/adpter.so:AdapterInit
/opt/ServletExpress/properties/server/ncf/ncfservice/jvm.properties
- ServerTerm /usr/lib/adpter.so:AdapterExit
The following directives were added or updated in the jvm.properties
file:
Note: | JAVA_HOME is the installation directory for the Java Development
Kit.
|
This chapter describes how to uninstall ServletExpress on
each of the supported platforms. It includes the following
topics:
- Uninstalling ServletExpress on Windows/NT
- Uninstalling ServletExpress on AIX
- Uninstalling ServletExpress on SUN Solaris
To uninstall ServletExpress:
- Logon as Administrator or make sure that the account you are installing
from has administrative privileges.
- Shut down the webserver if it is currently running.
- Run the uninstall program which is located off the start menu in the
program folder specified during installation for ServletExpress.
- Verify that you want to uninstall this package.
- Once this is done, restart the webserver.
To uninstall under AIX:
- Logon as root.
- Shut down the webserver if it is currently running.
- Run the System Management Interface Tool (smit).
- Select software installation and maintenance.
- Select maintain installed software.
- Select remove software products.
- On the following screen
- Click the list button next to the software field
- Select the following files from the list:
- ServletExpress.base.java
- ServletExpress.base.plugin.gwapi
- ServletExpress.base.web.en_US
- Select yes for remove dependent software.
- Click OK.
- Click OK.
- It will prompt you for confirmation. Confirm that you wish to
uninstall.
- Once ServletExpress has been uninstalled, exit smit.
- Restart the webserver.
- Logon as root.
- Shut down the webserver if it is currently running.
- Run admintool.
- Open the browse menu and select software.
- Click on the ServletExpress -- Java Servlet Engine and the
Go Webserver 4.6.1 Plugin.
- Open the edit menu and select delete.
- Confirm that you want to remove this package by clicking delete.
- Exit the admintool and restart the webserver.