6 Installing the Business Transaction Management Demo Kit

This chapter describes the steps required to install the Business Transaction Management demo kit and to that demo running. Oracle provides a Business Transaction Management "demo" kit that is specially packaged for ease of installation. If you merely want to demonstrate the Business Transaction Management features, then you can install this kit. The demo kit provides access to all Business Transaction Management features. The demo kit, however, cannot be scaled to meet production requirements and should not be used in a production environment. This demonstration installation includes the central servers and the monitor as described in Chapter 1, "Introduction."

6.1 Set up WebLogic

To create a WLS domain with JRF template and appropriate memory settings to host the sphere, transaction manager, performance manager and monitor:

Download WebLogic Server from the following location:
```
http://www.oracle.com/technetwork/middleware/weblogic/downloads/wls-main-097127.html
```
Note:
You must accept the license agreement at the top of the page before you can download the software.

WebLogic 10.3.6 is recommended, further documentation is available from:
```
http://docs.oracle.com/cd/E12839_01/doc.1111/e14142/toc.htm
```
Download Application Development Runtimes from the following location:
```
http://www.oracle.com/technetwork/developer-tools/adf/downloads/index.html
```
Application Development Runtime 11.1.1.7 is recommended, further documentation is available from:
```
http://docs.oracle.com/cd/E28280_01/install.1111/e14827/install.htm#CHDHCJEC
```
Create a WebLogic domain using the JRF template as described in
```
http://docs.oracle.com/cd/E28280_01/install.1111/e14827/configure.htm#CACEEJJJ
```
Configuration of OWSM is not necessary, therefore the steps for creating an MDS are not required.

For demonstration purposes, only an Admin Server (no managed servers) is required.
Adjust your WebLogic server's memory settings:
1. Open the Demo domain's setDomainEnv script file 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 set them to the indicated values:
```
MEM_ARGS=-Xms3072m –Xmx3072m
```
```
-XX:MaxPermSize=256m
```
  There are several of these entries; you must 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=-Xms5120m –Xmx5120m
set WLS_MEM_ARGS_32BIT=-Xms3072m –Xmx3072m
set MEM_MAX_PERM_SIZE_64BIT=-XX:MaxPermSize=512m
set MEM_MAX_PERM_SIZE_32BIT=-XX:MaxPermSize=256m
```
  In this case, set them all as indicated.

6.2 Set up the Oracle Database

Using the BTM embedded database is possible, but not recommended for demonstrations that last more than a few days. If you use the embedded database, skip these steps. To set up the Oracle database:

Download the Oracle database software from the following location:
```
http://www.oracle.com/technetwork/database/enterprise-edition/downloads/index.html
```
Oracle Database Release 11.2.0.4 is recommended and patch 13390677 available from My Oracle support provides links to full installers (not just patches).

Ensure that your database is configured to support SQL authentication mode and TCP/IP connections.

Replacing my_password with your actual password, use the following SQL script as sys user to create the database users required by Business Transaction Management.

drop user sphereDB cascade;
drop user transactionDB cascade;
drop user measurementDB cascade;
drop user messageLogDB cascade;
 
create user sphereDB identified by my_password;
grant connect, resource to sphereDB;
grant ANALYZE ANY to sphereDB;
grant create table, create view to sphereDB;
 
create user transactionDB identified by my_password;
grant connect, resource to transactionDB; 
grant ANALYZE ANY to transactionDB;
grant create table, create view to transactionDB;
 
create user measurementDB identified by my_password;
grant connect, resource to measurementDB;
grant ANALYZE ANY to measurementDB;
grant create table, create view to measurementDB;
 
create user messageLogDB identified by my_password;
grant connect, resource to messageLogDB;
grant ANALYZE ANY to messageLogDB;
grant create table, create view to messageLogDB;

Note:

The database schemas will be created automatically after you run the Initial Configuration wizard.

6.3 Set up the Demonstration

To set up the BTM demonstration:

Download the BTM demo from the following location:

http://docs.oracle.com/cd/E12839_01/doc.1111/e14142/toc.htm

Start the WebLogic Admin server for the domain that you created in Section 6.1, "Set up WebLogic" using the instructions from
```
http://docs.oracle.com/cd/E28280_01/install.1111/e14827/configure.htm#CACBECAG
```
Deploy and run the btmDemo.ear file that you downloaded in step 1:
1. Expand BTM_Demo_Servers_*.zip in a directory of your choosing.
2. Locate btmDemo.ear within the archives directory.
  
  This file contains the central servers and monitor.
3. Using the WebLogic Administration Console, deploy btmDemo.ear to the domain.

Navigate to the BTM configuration wizard:

http://admin_server_host:admin_server_port/btmui

Click through the configuration screens, entering the database information from Section 6.2, "Set up the Oracle Database" (not required if you are using the embedded database).
Configure observers on the servers that host the application you want to monitor. See Chapter 9, "Installing Observers Overview." for more information on observers. Note that the NANOAGENT_CONFIGURATION_URL is:
```
http://admin_server_host:admin_server_port/btmmonitor/agent/agent/
```