White Paper
Configuring BEA WebLogic
Server 9.1 or 9.2 for BMC
Remedy Mid Tier
September 2007
www.bmc.com
Contacting BMC Software
You can access the BMC Software website at http://www.bmc.com. From this website, you can obtain information
about the company, its products, corporate offices, special events, and career opportunities.
United States and Canada
Address BMC SOFTWARE INC Telephone 713 918 8800 or Fax 713 918 8000
2101 CITYWEST BLVD 800 841 2031
HOUSTON TX 77042-2827
USA
Outside United States and Canada
Telephone (01) 713 918 8800 Fax (01) 713 918 8000
If you have comments or suggestions about this documentation, contact Information Design and Development by email at
[email protected].
© Copyright 1991–2007 BMC Software, Inc.
BMC, BMC Software, and the BMC Software logo are the exclusive properties of BMC Software, Inc., are registered with the U.S. Patent
and Trademark Office, and may be registered or pending registration in other countries. All other BMC trademarks, service marks, and
logos may be registered or pending registration in the U.S. or in other countries. All other trademarks or registered trademarks are the
property of their respective owners.
DB2 is a registered trademark of International Business Machines Corporation.
IBM is a registered trademark of International Business Machines Corporation.
ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the
U.S. Patent and Trademark Office.
Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.
Oracle is a registered trademark of Oracle Corporation.
UNIX is a registered trademark of The Open Group.
BMC Software 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 for the product and the proprietary and restricted
rights notices included in this documentation.
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.
Customer Support
You can obtain technical support by using the Support page on the BMC Software website or by contacting Customer
Support by telephone or email. To expedite your inquiry, please see “Before Contacting BMC Software.”
Support website
You can obtain technical support from BMC Software 24 hours a day, 7 days a week at
http://www.bmc.com/support_home. From this website, you can:
■ Read overviews about support services and programs that BMC Software offers.
■ Find the most current information about BMC Software products.
■ Search a database for problems similar to yours and possible solutions.
■ Order or download product documentation.
■ Report a problem or ask a question.
■ Subscribe to receive email notices when new product versions are released.
■ Find worldwide BMC Software support center locations and contact information, including email addresses, fax
numbers, and telephone numbers.
Support by telephone or email
In the United States and Canada, if you need technical support and do not have access to the Web, call 800 537 1813 or
send an email message to
[email protected]. (In the Subject line, enter
SupID:<yourSupportContractID>, such as SupID:12345.) Outside the United States and Canada, contact your local
support center for assistance.
Before contacting BMC Software
Have the following information available so that Customer Support can begin working on your issue immediately:
■ Product information
— Product name
— Product version (release number)
— License number and password (trial or permanent)
■ Operating system and environment information
— Machine type
— Operating system type, version, and service pack
— System hardware configuration
— Serial numbers
— Related software (database, application, and communication) including type, version, and service pack or
maintenance level
■ Sequence of events leading to the problem
■ Commands and options that you used
■ Messages received (and the time and date that you received them)
— Product error messages
— Messages from the operating system, such as file system full
— Messages from related software
License key and password information
If you have a question about your license key or password, contact Customer Support through one of the following
methods:
■ E-mail
[email protected]. (In the Subject line, enter SupID:<yourSupportContractID>, such as
SupID:12345.)
■ In the United States and Canada, call 800 537 1813. Outside the United States and Canada, contact your local support
center for assistance.
■ Submit a new issue at http://www.bmc.com/support_home.
White Paper
Configuring BEA WebLogic Server 9.1
or 9.2 for BMC Remedy Mid Tier
You can configure the BEA WebLogic Server 9.1 or 9.2 for the mid tier. The
following topics are provided:
! Creating a new domain (page 6)
! Installing an Enterprise application (page 7)
! Changing the context name (page 8)
! Testing the mid tier (page 8)
IMPORTANT
BMC Software recommends that you do not use the .war file to deploy mid tier on
WebLogic at this time. Instead, use the mid tier installer and follow the
configuration steps outlined in this white paper.
Configuring BEA WebLogic Server 9.1 or 9.2 for BMC Remedy Mid Tier 5
White Paper
Creating a new domain
Before you install BMC Remedy Mid Tier with BEA WebLogic Server 9.1 or 9.2, you
must create a new domain.
! To configure a new domain
1 Start the WebLogic Configuration Wizard.
Windows
a Choose All Programs > BEA Products > Tools > Configuration Wizard.
Unix
a Make sure that you have UI access enabled. (Set your display, or run from the
console.)
b After a clean installation of WebLogic Server 9.1, go to the WebLogic
../common/bin directory, and run the config.sh script.
The Welcome screen appears.
2 Select Create New WebLogic Domain, and click Next.
The Select Domain Source screen appears.
3 Select Generate a domain configured automatically.
The WebLogic Server (recommended) option is selected by default.
4 Click Next.
The Configure Admin Username and Password screen appears.
5 In the Username field, enter weblogic.
6 In the Password fields, enter weblogic, and click Next.
The Configure Start Mode and JDK screen appears.
7 Select Development Mode, and select BEA Supplied JDK (or an alternate) and click
Next.
The Customize Environment and Services Settings screen appears.
8 Select No, and click Next.
The Create Domain screen appears.
9 Enter a Domain Name (such as testing), enter the Domain Location, and click
Create.
The Creating Domain screen appears.
10 After the scripts finishes the configuration, click Done.
11 Start WebLogic.
6 Configuring BEA WebLogic Server 9.1 or 9.2 for BMC Remedy Mid Tier
Configuring BEA WebLogic Server 9.1 or 9.2 for BMC Remedy Mid Tier
Installing an Enterprise application
After creating a domain, you are ready to install the mid tier and set up WebLogic.
! To install an Enterprise application
1 Install BMC Remedy Mid Tier as described in the BMC Remedy Action Request
System 7.1.00: Installing and Configuring BMC Remedy Mid Tier guide.
2 Log in to the WebLogic Administration Console through a URL similar to:
http://<host_name>:7001/console
Use the login information you specified in step 5 and step 6 in “To configure a new
domain” on page 6.
3 Under the Change Center, complete the following steps:
a Click Lock and Edit.
b Click the Deployments folder.
c Click Install.
d Click Location (host name), and go to where the mid tier is installed.
e Click Next.
f Select Install this deployment as an application, and click Next.
g In the Name for deployment field, enter arsys, and click Next.
h Click Finish, and click Save.
4 Under the Change Center, click Activate Change.
5 Click Start.
6 On Windows platforms, verify the \WEB-INF\lib mid tier installation directory
path in the PATH variable. (The mid tier installer automatically adds this path.)
7 On UNIX systems, update the mid tier installation path in the BEA WebLogic start
script as follows:
a Stop the WebLogic server.
b Update the BEA WebLogic start script with the appropriate path:
AIX LIBPATH=/usr/ar/mid-tier/WEB-INF/lib:$LIBPATH;export LIBPATH
HP_UX SHLIB_PATH =/usr/ar/mid-tier/WEB-INF/lib:$SHLIB_PATH;export
SHLIB_PATH
Solaris and LD_LIBRARY_PATH=/usr/ar/mid-tier/WEB-INF/
Linux lib:$LD_LIBRARYPATH;export LD_LIBRARY_PATH
c Restart the WebLogic server.
Installing an Enterprise application 7
White Paper
Changing the context name
It is recommended that you change the context name to the standard name of
arsys.
! To change the context name
1 Create a weblogic.xml file in one of the following directories:
! Windows: C:\Program Files\AR System\Mid-Tier\WEB-INF
! UNIX: /usr/ar/mid-tier/WEB-INF
2 Add the following lines to the file:
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE weblogic-web-app>
<weblogic-web-app>
<context-root>arsys</context-root>
</weblogic-web-app>
Testing the mid tier
To make sure that the mid tier is functioning correctly, verify that you can access
the configuration page and one or more forms.
To open the configuration page, enter the following URL in the BMC Remedy Mid
Tier Configuration Tool:
http://<hostname>:<port>/<mid_tier_name>/shared/config/config.jsp
To open forms, enter:
http://<hostname>:<port>/<mid_tier_server>/forms
/<AR_System_server_name>/<form_name>/<view_name>
The default port is 7001, and the recommended <mid_tier_name> is arsys.
8 Configuring BEA WebLogic Server 9.1 or 9.2 for BMC Remedy Mid Tier
*84376*
*84376*
*84376*
*84376*
*84376*
