Second Primary Machine - Replicate the ActiveMatrix Administrator Server

This chapter describes how to install and configure an ActiveMatrix Administrator server on a separate machine from any BPM systems. This configuration is recommended for use in a production environment.

Topics

• Overview

• Task 1: Perform Required Pre-Installation Tasks

• Task 2: Primary Machine - Install ActiveMatrix BPM Software

• Task 3: Primary Machine - Configure JDBC Drivers

• Task 4: Primary Machine - Create the Administrator Server

• Task 5: Primary Machine - Move the ActiveMatrix Administrator Server Staging Area to the Shared File System

• Task 6: Second Primary Machine - Install ActiveMatrix BPM Software

• Task 7: Second Primary Machine - Configure JDBC Drivers

• Task 8: Second Primary Machine - Replicate the ActiveMatrix Administrator Server

TIBCO ActiveMatrix BPM Installation and Configuration

|

Chapter 4 Creating an ActiveMatrix Administrator Server (Single or Replicated)

Overview

In a production environment, TIBCO recommend that the ActiveMatrix

Administrator server is hosted independently from ActiveMatrix BPM, using its own set of TIBCO Host instances.

If a high availability, fault tolerant configuration is required, the ActiveMatrix Administrator server should also be replicated.

Figure 2 shows an example configuration for a single ActiveMatrix Administrator server.

Figure 3 shows an example configuration for a replicated ActiveMatrix Administrator server.

TIBCO ActiveMatrix BPM Installation and Configuration Overview

|

⁴⁹

Figure 2 Example configuration for a single ActiveMatrix Administrator server

For details of the associated configuration for a distributed ActiveMatrix BPM system, see Figure 4.

TIBCO ActiveMatrix BPM Installation and Configuration

|

Chapter 4 Creating an ActiveMatrix Administrator Server (Single or Replicated)

Figure 3 Example configuration for a replicated ActiveMatrix Administrator server

For details of the associated configuration for a distributed ActiveMatrix BPM system, see Figure 4.

TIBCO ActiveMatrix BPM Installation and Configuration Task 1: Perform Required Pre-Installation Tasks

|

⁵¹

Task 1: Perform Required Pre-Installation Tasks

Perform the following pre-installation tasks:

1. Check For Any Late Breaking Information 2. Check the System Requirements

3. Configure TIBCO Enterprise Message Service

4. Create the External ActiveMatrix Administrator Database 5. Configure System Parameters on UNIX or Linux Platforms 6. Configure Apache Ant

7. Download Required Third-Party Software Assemblies 8. Download ActiveMatrix BPM Software

TIBCO ActiveMatrix BPM Installation and Configuration

|

Chapter 4 Creating an ActiveMatrix Administrator Server (Single or Replicated)

Task 2: Primary Machine - Install ActiveMatrix BPM Software

1. Log on to the primary machine.

2. Run TIBCOUniversalInstaller to install ActiveMatrix BPM software. (See Installing ActiveMatrix BPM Software (TIBCO Universal Installer).)

3. Make sure that you complete the following screens/fields as shown.

Screen Requirement

Installation Profile Selection

Select the Primary machine profile.

TIBCO Installation Home

Select Create a new TIBCO_HOME.

Post-Install summary Select Launch TIBCO Configuration Tool.

TIBCO ActiveMatrix BPM Installation and Configuration Task 3: Primary Machine - Configure JDBC Drivers

|

⁵³

Task 3: Primary Machine - Configure JDBC Drivers

1. Make sure that the jar files for the required JDBC drivers are available on the primary machine. (See JDBC Drivers on page 24.)

2. In TIBCO Configuration Tool, enter a local location for the TIBCO configuration folder (CONFIG_HOME), or click OK to use the default location.

3. In the Create new configurations screen, choose the Configure Third-Party Driver Wizard.

4. Configure the JDBC driver needed for the database server that will be used to host the ActiveMatrix Administrator database.

5. Return to the Create new configurations screen, but do not close TIBCO Configuration Tool.

TIBCO ActiveMatrix BPM Installation and Configuration

|

Chapter 4 Creating an ActiveMatrix Administrator Server (Single or Replicated)

Task 4: Primary Machine - Create the Administrator Server

1. In TIBCO Configuration Tool, choose the Create TIBCO ActiveMatrix Administrator Server Wizard.

2. Make sure that you complete the following screens/fields as shown.

TIBCO Configuration Tool creates the ActiveMatrix Administrator server on the primary machine.

3. Click Close to exit TIBCO Configuration Tool.

Screen Requirement

1. Clear Use Default In-Process Database.

2. Enter the details of the database server that hosts the Administrator database, making sure that the Database URL field contains a DNS name. (See Create the External ActiveMatrix Administrator

Database.) Administrator Server

Configuration:

Credential Server Details

Ensure that Bind to Network Adapter is set to 0.0.0.0.

Administrator Server Configuration:

Summary

Select Create TIBCO ActiveMatrix Administrator server then click Configure.

See Create TIBCO ActiveMatrix Administrator Server Wizardfor full details of the information that you need to enter in this wizard.

If you want to replicate the ActiveMatrix Administrator server, perform the remaining tasks (5 to 8) in this chapter.

TIBCO ActiveMatrix BPM Installation and Configuration Task 5: Primary Machine - Move the ActiveMatrix Administrator Server Staging Area to the Shared File System

|

⁵⁵

Task 5: Primary Machine - Move the ActiveMatrix Administrator Server Staging Area to the Shared File System

1. Copy the folder CONFIG_HOME^\admin\enterpriseName^\shared to a location on the shared file system (see Shared File System). For example:

SHARED_DIR\admin\enterpriseName^\shared 2. Open a command window in the

TIBCO_HOME\administrator\n^.n^\scripts folder.

3. Run the following command to update the ActiveMatrix Administrator server with the new staging area location:

ant -f sharedWorkFolder_build.xml

-Dadmin.shared.folder="sharedFileSystemLocation^"

-Dconfig.home="CONFIG_HOME^"

-Denterprise.name="enterpriseName^"

where sharedFileSystemLocation is the location on the shared file system from step 1 above.

4. Open a command window in the

CONFIG_HOME\tibcohost\Admin-enterpriseName-hostName\host\bin

folder.

5. Run the following commands to stop and restart the system node (thereby restarting the ActiveMatrix Administrator server:

tibcohost.exe stopNodes -nodeName SystemNode tibcohost.exe startNodes -nodeName SystemNode

TIBCO ActiveMatrix BPM Installation and Configuration

|

Chapter 4 Creating an ActiveMatrix Administrator Server (Single or Replicated)

Task 6: Second Primary Machine - Install ActiveMatrix BPM Software

1. Log on to the second primary machine.

2. Run TIBCOUniversalInstaller to install ActiveMatrix BPM software. (See Installing ActiveMatrix BPM Software (TIBCO Universal Installer).)

3. Make sure that you complete the following screens/fields as shown.

Screen Requirement

Installation Profile Selection

Select the Primary machine profile.

TIBCO Installation

Home 1. Select Create a new TIBCO_HOME.

2. Enter a location that is identical to the value of TIBCO_HOME on the primary machine. For example, if the location of TIBCO_HOME on the primary machine is C:\tibco\amx-admin, the location of TIBCO_HOME on the second primary machine must also be C:\tibco\amx-admin. Post-Install summary Select Launch TIBCO Configuration Tool.

TIBCO ActiveMatrix BPM Installation and Configuration Task 7: Second Primary Machine - Configure JDBC Drivers

|

⁵⁷

Task 7: Second Primary Machine - Configure JDBC Drivers

1. Make sure that the jar files for the required JDBC drivers are available on the remote machine. (See JDBC Drivers on page 24.)

2. In TIBCO Configuration Tool, enter an identical location for the TIBCO configuration folder (CONFIG_HOME) to the one that you used on the primary machine. (See Task 3: Primary Machine - Configure JDBC Drivers.) 3. In the Create new configurations screen, run the Configure Third-Party

Driver Wizard.

4. Configure the JDBC driver needed for the database server that was used to host the ActiveMatrix Administrator database on the primary machine. (See Task 3: Primary Machine - Configure JDBC Drivers.)

5. Return to the Create new configurations screen, but do not close TIBCO Configuration Tool.

TIBCO ActiveMatrix BPM Installation and Configuration

|

Chapter 4 Creating an ActiveMatrix Administrator Server (Single or Replicated)

Task 8: Second Primary Machine - Replicate the ActiveMatrix Administrator Server

1. Copy the content of the CONFIG_HOME\tct\keystore folder from the primary machine to the same location on the second primary machine. (Create this folder on the second primary machine if it does not already exist.)

2. In TIBCO Configuration Tool, run the Replicate TIBCO ActiveMatrix Administrator Server Wizard.

3. Make sure that you complete the following screens/fields as shown.

TIBCO Configuration Tool:

— creates the specified SystemHost instance and SystemNode.

— replicates the ActiveMatrix Administrator server. The replicated server runs on the specified SystemNode.

For example, in Figure 3, a TIBCO Host instance named SystemHostReplica is created and started. A node named SystemNodeReplica is created in the

Screen Requirement

Remote Administrator Server Details

Specify the details of the Administrator server that you created on the primary machine.

Administrator Server

Configuration Details 1. Enter a unique Host Name for the SystemHost instance that will be associated with the replicated ActiveMatrix Administrator server (SystemHostReplica in Figure 3).

2. Enter a unique Node Name for the SystemNode instance that will be associated with the

replicated ActiveMatrix Administrator server (SystemNodeReplica in Figure 3).

Administrator Server Configuration Summary

1. Select Replicate TIBCO ActiveMatrix Administrator server.

2. Click Configure.

See Replicate TIBCO ActiveMatrix Administrator Server Wizardfor full details of the information that you need to enter in this wizard.

TIBCO ActiveMatrix BPM Installation and Configuration Task 8: Second Primary Machine - Replicate the ActiveMatrix Administrator Server

|

⁵⁹

environment named SystemEnvironment and started. The replicated Administrator server runs on SystemNodeReplica.

3. Return to the Create new configurations screen, then close TIBCO Configuration Tool.

When you log in to either of the Administrator servers there will be two hosts in the Infrastructure > Hosts screen and two nodes in the

SystemEnvironment environment in the Infrastructure > Nodes screen.

Requests can be processed by either Administrator server. If one node is unavailable, the other can process requests.

TIBCO ActiveMatrix BPM Installation and Configuration

|

Chapter 4 Creating an ActiveMatrix Administrator Server (Single or Replicated)

TIBCO ActiveMatrix BPM Installation and Configuration

|

⁶¹

Chapter 5 Creating a Distributed ActiveMatrix BPM

In document TIBCO ActiveMatrix BPM Installation and Configuration (Page 63-77)