5 Prerequisite Requirements and Preliminary Setup

This chapter describes prerequisite requirements and preliminary setup that you must satisfy before you begin installing Business Transaction Management. Business Transaction Management is composed of several types of components. Some of the following requirements pertain to all Business Transaction Management components while other requirements pertain to a subset of components.

Web Browser Requirements

The requirements in this section pertain to the web browser that you use to perform the initial configuration of Business Transaction Management and to access the Business Transaction Management Console.

  • The web browser requires the Adobe Flash plugin version 10.1 or higher.

  • If you are using Internet Explorer as your web browser, you must configure it to allow the Flash player's Active X control. Consult your Internet Explorer documentation for instructions on enabling this setting.

Setting up your WebLogic Environment

Note:

If you are using WebLogic Node Manager, you will use the WebLogic Administrative Console to adjust settings rather than edit scripts.

  1. Ensure that the appropriate database driver for your Oracle RDBMS is in the WebLogic server's classpath for each central server and monitor.

    Drivers are supplied in the jdbc directory of BTM_Servers_*.zip. Use ojdbc5.jar with JDK 1.5 and ojdbc6.jar with JDK 1.6.

  2. Ensure that each WebLogic server in which you install a Business Transaction Management central server or monitor is uniquely identified so that the central servers and monitors can reliably connect to each other. You can perform this task in either of the following ways:

    • Ensure that any and all IP addresses assigned to the host machine uniquely identify that machine.

    • Ensure that the WebLogic server's Listen Address property is set to a hostname or IP address that uniquely identifies the server.

      To set this property, navigate in the WebLogic Administration Console to Environment > Servers, then click your server and display the Configuration/General tab.

    Note:

    If the machine has an IP address that is shared with another machine on the network, or the machine has multiple IP addresses that are treated as separate virtual machines, you must set the domain's Listen Address property as described above.

  3. For central servers and monitors, ensure that memory allocation for your WebLogic server is set appropriately. Two methods of setting the Java options that control memory allocation are described below. Use the method that is appropriate for how you start and stop your managed servers:

    If you use the Node Manager to remotely start and stop your managed servers, set the Java memory options for your server using this method:

    1. Open the WebLogic Administration Console.

    2. Select your managed server.

    3. Select the Configuration > Server Start tab.

    4. Enter the following Java options in the Arguments field, making sure to separate all entries in the field with a space:

      -Xms256m -Xmx768m -XX:MaxPermSize=256m

      These are the minimum recommended settings. Depending on your environment, you might have to set them higher.

    If you start and stop your managed servers by executing local script files, set the Java memory options for your server using this method:

    1. Open the setDomainEnv script file for your domain in a text editor.

      On Windows systems, open setDomainEnv.cmd; on UNIX-like systems, open setDomainEnv.sh. These script files are located in the user_projects\domains\domain_name\bin directory of your WebLogic installation.

    2. Locate the following settings and ensure that they are set to at least the values indicated (depending on your environment, you might have to set them higher.):

      MEM_ARGS=-Xms256m -Xmx768m

      -XX:MaxPermSize=256m

      There are several of these entries; set them all.

      Depending on your version of WebLogic, you might also see separate 32-bit and 64-bit settings like these:

      set WLS_MEM_ARGS_64BIT=-Xms256m -Xmx512m
set WLS_MEM_ARGS_32BIT=-Xms256m -Xmx512m
set MEM_MAX_PERM_SIZE_64BIT=-XX:MaxPermSize=256m
set MEM_MAX_PERM_SIZE_32BIT=-XX:MaxPermSize=128m

      In this case, set them all to at least the minimum recommended settings.

  4. Set up an administrative user on the WebLogic server in which you will install the Main server (btmMain.ear).

    Business Transaction Management maps roles defined in WebLogic to its own application roles. See Mapping WebLogic Users to Business Transaction Management Roles for more information.

Setting up your WebSphere Environment

  1. Ensure that the appropriate database driver for your Oracle RDBMS is in your WebSphere server's classpath for each central server and monitor.

    If you edit the classpath while the server is running, be sure to restart WebSphere before configuring Business Transaction Management.

    Drivers are supplied in the jdbc directory of BTM_Servers_*.zip. Use ojdbc5.jar with JDK 1.5 and ojdbc6.jar with JDK 1.6.

  2. Use the WebSphere Administrative Console to specify Initial Heap Size of no less than 256, and Maximum Heap Size of no less than 1024.

    Perform this task on each WebSphere instance in which you install Business Transaction Management components.

  3. Enable global security on WAS, including application and Java 2 security.

    Perform this task on each WebSphere instance in which you install Business Transaction Management components.

  4. Set up an administrative user on the WebSphere server on which you will install the Main server (btmMain.ear).

    Business Transaction Management maps roles defined in WebSphere to its own application roles. See Mapping WebSphere Users to Business Transaction Management Roles for more information.

Setting up Business Transaction Management Databases

Several Business Transaction Management system services use a database to store persistent information and log messages. You must use an Oracle 10g or 11g RDBMS for these databases, and it must be configured to support SQL authentication mode and TCP/IP connections.

Before you configure Business Transaction Management, create the following database users (these are suggested names):

  • sphereDB

  • measurementDB

  • transactionDB

  • messageLogDB

You can create the database users in the same Oracle instance or in separate instances. You must create these users before starting configuration of Business Transaction Management. When you configure Business Transaction Management (see Initial Configuration of Business Transaction Management), the system will automatically create the appropriate database tables.

If you prefer to create the schemas manually for the first three of these databases (sphereDB, measurementDB, and transactionDB), your DBA can create them beforehand (see the following note). If you intend to let the system automatically create these tables and indexes, the database users must have create table, create index, create view, and analyze privileges. You cannot create the fourth schema (messageLogDB) beforehand because the system must be able to create and drop tables dynamically in response to changes in your monitored applications. For this database, the user must have create table, drop table, create index, create view, and analyze privileges. (Note: It is not sufficient to assign the privileges to the roles associated with the user. You must explicitly assign the privileges to the user.)

Note:

Your DBA can manually create the tables and indexes for the sphereDB, measurementDB, and transactionDB databases using the datastoreUtil utility. This utility generates the appropriate schema definitions. Documentation on using this utility to generate the schema definitions is provided in Chapter 17, "The datastoreUtil Utility."