Welcome!

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.

Overview

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:

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:


Preparing for installation

This section describes the prerequisites and steps necessary to prepare your system for installing IBM ServletExpress. It includes the following topics:

Software requirements

Operating systems

ServletExpress provides support for the following operating systems:

Server requirements

ServletExpress requires Lotus Domino Go Webserver Version 4.6.1 or later.

Java Development Kit requirements

The following levels of JDK support are required and are available for download from our Web site at http://www.ibm.com/java/servexp:

Downloading ServletExpress

To download IBM ServletExpress, go to http://www.ibm.com/java/servexp and follow the instructions.

Uninstalling the current Java support

Uninstalling on Windows NT

To uninstall the current Java support:

  1. Shut down the webserver if it is currently running.

  2. Run the uninstall program for Domino Go Webserver.

  3. Select the Java Servlet Component.

  4. 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.

Uninstalling on AIX

To uninstall under AIX:

  1. Logon as root.

  2. Shut down the webserver if it is currently running.

  3. Run the System Management Interface Tool (smit).

  4. Select software installation and maintenance.

  5. Select maintain installed software.

  6. Select remove software products.

  7. On the following screen

  8. Click OK.

  9. It will prompt you for confirmation. Confirm that you wish to uninstall.

  10. Once the Java support for Domino Go Webserver has been uninstalled, exit smit.

Uninstalling on Sun Solaris

  1. Logon as root.

  2. Shut down the webserver if it is currently running.

  3. Run admintool.

  4. Open the browse menu and select software.

  5. Select the Lotus Domino Go Webserver -- Java Servlets component.

  6. Open the edit menu and select delete.

  7. It will prompt you to confirm that you wish to remove this package. Click delete.

Java support has been removed.


Installing ServletExpress

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

To install under Windows NT:

  1. Logon as Administrator or make sure that the account you are installing from has administrative privileges.

  2. Shut down the webserver if it is currently running.

  3. Execute the s100bent.exe file. This will launch an InstallShield interface.

  4. Uninstall the previous servlet support if you have not already done so. You will be prompted should this step be necessary.

  5. 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.

  6. Read the README file (optional).

When installation is complete,

  1. 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:

    1. Print or view the Servlet and Eservlet directives in the servlet.cnf file.

    2. Open the Admintool GUI (See Chapter 4: Starting the Servlet Express Manager).

    3. 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.

  2. 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.

  3. 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\.


Installing ServletExpress on AIX

AIX Version 4.1.5

Note:ServletExpress will be installed in the /usr/lpp/ServletExpress directory.

  1. Logon as root.

  2. Shut down the webserver if it is currently running.

  3. Uncompress the s100beai.tar.Z file by executing uncompress s100beai.tar.Z.

  4. 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.

  5. Set the system environment variable JAVA_HOME to where the correct version of the Java Development Kit is installed.

  6. Run the System Management Interface Tool (smit).

  7. Select software installation and maintenance.

  8. Select install and update software.

  9. Select install software products at the latest level.

  10. Select install new software products at latest level.

  11. Supply the location of the ServletExpress.base file.

  12. On the following screen

  13. Click OK to begin the install.

  14. When installation is complete, continue to "Completing the AIX installation".

AIX Version 4.2

Note:ServletExpress will be installed in the /usr/lpp/ServletExpress directory.

  1. Logon as root.

  2. Shut down the webserver if it is currently running.

  3. Uncompress the s100beai.tar.Z file by executing uncompress s100beai.tar.Z.

  4. 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.

  5. Set the system environment variable JAVA_HOME to where the correct version of the Java Development Kit is installed.

  6. Run the System Management Interface Tool (smit).

  7. Select software installation and maintenance.

  8. Select install/update from LATEST available software.

  9. Supply the location of the ServletExpress.base file.

  10. On the following screen

  11. Click OK to begin the install.

  12. When the installation is complete, continue to "Completing the AIX installation".

Completing the AIX installation

When installation is complete,

  1. Set the system environment variable LD_LIBRARY_PATH to the value specified in the jvm.properties file.

  2. 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:

    1. Print or view the Servlet and Eservlet directives in the servlet.conf file.

    2. Open the Admintool GUI (See Chapter 4: Starting the Servlet Express Manager).

    3. 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.

  3. 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.

  4. 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:

The following directives were added or updated in the jvm.properties file:

Note:JAVA_HOME is the installation directory for the Java Development Kit.

Installing ServletExpress on Sun Solaris

Note:ServletExpress will be installed in the /opt/ServletExpress directory.

  1. Logon as root.

  2. Shut down the webserver if it is currently running.

  3. Uncompress the s100beso.tar.Z file by executing uncompress s100beso.tar.Z.

  4. 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.

  5. Set the system environment variable JAVA_HOME to where the correct version of the Java Development Kit is installed.

  6. Run admintool.

  7. Open the browse menu and select software.

  8. Open the edit menu and select add.

  9. Supply the directory path to the spool directory at the prompt. This should be the absolute path to the spool directory, including spool.

  10. Click ServletExpress and Go Webserver 4.6.1 Plugin, and select add.

When installation is complete:

  1. Set the system environment variable LD_LIBRARY_PATH to the value specified in the jvm.properties file.

  2. 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.

  3. 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:

The following directives were added or updated in the jvm.properties file:

Note:JAVA_HOME is the installation directory for the Java Development Kit.

Uninstalling ServletExpress

This chapter describes how to uninstall ServletExpress on each of the supported platforms. It includes the following topics:


Uninstalling ServletExpress on Windows NT

To uninstall ServletExpress:

  1. Logon as Administrator or make sure that the account you are installing from has administrative privileges.

  2. Shut down the webserver if it is currently running.

  3. Run the uninstall program which is located off the start menu in the program folder specified during installation for ServletExpress.

  4. Verify that you want to uninstall this package.

  5. Once this is done, restart the webserver.

Uninstalling ServletExpress on AIX

To uninstall under AIX:

  1. Logon as root.

  2. Shut down the webserver if it is currently running.

  3. Run the System Management Interface Tool (smit).

  4. Select software installation and maintenance.

  5. Select maintain installed software.

  6. Select remove software products.

  7. On the following screen

  8. Click OK.

  9. It will prompt you for confirmation. Confirm that you wish to uninstall.

  10. Once ServletExpress has been uninstalled, exit smit.

  11. Restart the webserver.

Uninstalling ServletExpress on SUN Solaris

  1. Logon as root.

  2. Shut down the webserver if it is currently running.

  3. Run admintool.

  4. Open the browse menu and select software.

  5. Click on the ServletExpress -- Java Servlet Engine and the Go Webserver 4.6.1 Plugin.

  6. Open the edit menu and select delete.

  7. Confirm that you want to remove this package by clicking delete.

  8. Exit the admintool and restart the webserver.