White Paper

June 2006

Configuring Tomcat 5.x web

server and application
server
Copyright 1991–2006 BMC Software, Inc. All rights reserved.

BMC, the BMC logo, all other BMC product or service names, BMC Software, the BMC Software logos, and
all other BMC Software product or service names, are registered trademarks or trademarks of BMC
Software, Inc. All other trademarks belong to their respective companies.

BMC Software, Inc., considers information included in this documentation to be proprietary and
confidential. Your use of this information is subject to the terms and conditions of the applicable end user
license agreement or nondisclosure agreement for the product and the proprietary and restricted rights
notices included in this documentation.

For license information about the OpenSource files used in the licensed program, please read
OpenSourceLicenses.pdf. This file is in the \Doc folder of the distribution CD-ROM and in the
documentation download portion of the product download page.

Restricted Rights Legend

U.S. Government Restricted Rights to Computer Software. UNPUBLISHED -- RIGHTS RESERVED UNDER THE
COPYRIGHT LAWS OF THE UNITED STATES. Use, duplication, or disclosure of any data and computer software by the
U.S. Government is subject to restrictions, as applicable, set forth in FAR Section 52.227-14, DFARS 252.227-7013, DFARS
252.227-7014, DFARS 252.227-7015, and DFARS 252.227-7025, as amended from time to time. Contractor/Manufacturer is
BMC Software, Inc., 2101 CityWest Blvd., Houston, TX 77042-2827, USA. Any contract notices should be sent to this address.

Contacting Us
If you need technical support for this product, contact Customer Support by email at
support@remedy.com. If you have comments or suggestions about this documentation, contact
Information Development by email at doc_feedback@bmc.com.

This edition applies to version 7.0 of the licensed program.

BMC Software, Inc.

www.bmc.com
White Paper

Configuring Tomcat 5.x web server and

application server
You can configure the Tomcat 5.x web server and application server. The
process to set up this configuration is:

Step 1 Install Tomcat 5.x.

Step 2 Install the BMC Remedy Mid Tier.

Step 3 Complete the post-installation tasks.

Configuring Tomcat 5.x web server and application server ! 3

White Paper

" To install Tomcat

1 Obtain the Tomcat binary package.
You can obtain it from http://tomcat.apache.org/.
2 Unpack the package to a directory, for example, /export on UNIX or
C:\Program Files on Windows.

After unpacking, you should see a Tomcat directory such as /export/

jakarta-tomcat-5.0.28 on UNIX or C:\Program Files\jakarta-tomcat-
5.0.28 on Windows.

3 Open the catalina.sh (UNIX) or catalina.bat (Windows) file, which can

be found in the <tomcat_install_dir>/bin directory. Set the JAVA_HOME
environment variable.
The following examples use a Java SDK installation directory of /usr/j2se
on UNIX and C:\j2sdk1.4.2 on Windows.
! UNIX: JAVA_HOME=/usr/j2se; export JAVA_HOME
! Windows: set JAVA_HOME=C:\j2sdk1.4.2
4 Start Tomcat to test your installation using the startup.sh script (UNIX) or
startup.bat script (Windows). For example:

! UNIX: <tomcat_install_dir>/bin/startup.sh
! Windows: <tomcat_install_dir>\bin\startup.bat
5 Verify the Tomcat examples by accessing the following URL:
http://<your_web_server>:8080

6 Click the JSP examples and Servlet Examples links. Click examples on both
pages to confirm JSP and servlet functionality.

" To install the BMC Remedy Mid Tier

1 Run the mid-tier installation.
For more information, see the Installing and Administering BMC Remedy Mid
Tier guide.
2 When prompted, select Other web server.
3 UNIX only: When prompted, enter Y to indicate that you have a JSP engine
installed.
4 When prompted, select Other JSP engine.

4 "Configuring Tomcat 5.x web server and application server

 Configuring Tomcat 5.x web server and application server

5 Specify the mid tier installation directory as a directory under

<tomcat_install_dir>/webapps.

The default name is arsys. It is recommended that you use this name.
Based on the previous examples of the Tomcat installation directory, you
would use the following path:
! UNIX: /export/jakarta-tomcat-5.0.28/webapps/arsys
! Windows: C:\Program Files\jakarta-tomcat-5.0.28\webapps\arsys

" To complete the post-installation tasks

1 Shut down Tomcat.
! UNIX: <tomcat_install_dir>/bin/shutdown.sh
! Windows: <tomcat_install_dir>\bin\shutdown.bat
2 UNIX only: Modify the catalina.sh file to add the library path.
Add this library variable near the top of the file. Based on the previous
example of an installation directory of /export/jakarta-tomcat-5.0.28/
webapps/arsys for the mid tier, you would need to define the following
variables.
For Solaris and Linux, enter the following definition:
LD_LIBRARY_PATH=/export/jakarta-tomcat-5.0.28/webapps/arsys/WEB-
INF/lib; export LD_LIBRARY_PATH

For HP-UX, enter the following definition:

SHLIB_PATH=/export/jakarta-tomcat-5.0.28/webapps/arsys /WEB-INF/
lib; export SHLIB_PATH

For AIX, enter the following definition:

LIBPATH=/export/jakarta-tomcat-5.0.28/webapps/arsys/WEB-INF/lib;
export LIBPATH

3 Restart Tomcat.
! UNIX: <tomcat_install_dir>/bin/startup.sh
! Windows: <tomcat_install_dir>\bin\startup.bat
4 Verify that the mid tier is working for Tomcat. (The default password is
arsystem.)
http://<your_web_server>:8080/arsys/shared/config/config.jsp

!5
B65704.fm Page 18 Monday, October 16, 2006 2:06 PM

*65704*
*65704*
*65704*
*65704*
*65704*