Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 5 TIBCO BusinessEvents Monitoring and Management Tutorial : Configure the Site Topology File

Configure the Site Topology File
The topology file contains deploytime information such as what processing units to deploy to specific machines in your environment. You need to know information about the machines that will host the agents you plan to deploy, for example information about the machines’ operating system, IP address, and login credentials.
Instructions in this section are for the tutorial scenario: all components running on one Windows machine.
Learning Points
What is a processing unit configuration?  You define processing units in the CDD file. One PU deploys as one engine. In the site topology file you select processing units and add deploy-time configuration settings to them. They are then known as processing unit configurations (PUCs).
What is a deployment unit  A deployment unit deploys as one or more engines. It consists of one or more processing unit configurations. It also specifies the location of the deployed EAR file and CDD file, generated by MM at deploy time. A DU can be re-used for different machines, unless it has machine-specific settings.
What is a predefined engine?  A predefined engine is one that is configured in the site topology file. You can deploy predefined engines and monitor and manage them using MM. Unpredefined engines can be monitored if they are running but cannot be started or deployed if they are not running.
Can I edit the site topology file in a text editor?  Editing in TIBCO BusinessEvents Studio is always preferable because it can validate the file, and the graphical editor maintains the correct structure. However, when you cannot use the graphical editor, you can use the template file to help you work with the settings in a text editor:
BE_HOME/mm/config/site_topology_template.st
More Information
See these sections in TIBCO BusinessEvents Administration:
Task D Configure the Site Topology in TIBCO BusinessEvents Studio
1.
Begin with the project you configured in Chapter 3, Cache OM Tutorial. Or, as needed, import the FraudDetection Cache project into your workspace. See Importing Existing Projects into Your Workspace for guidelines on working with example projects.
2.
Right-click the project name, FraudDetectionCache, and select New > Other > TIBCO BusinessEvents > Site Topology.
The Fraud Detection Cache example project ships with a configured site topology file, so give yours a different name.
Do not change the FraudDetectionCache.st file in the example location. It is referenced by the MM CDD file as shipped.
3.
a.
Enter the name fdcacheSt. As desired, enter a description.
b.
In the Cluster Deployment Descriptor field, browse to and select fdcache.cdd. Only CDD files within the studio project you are configuring are available for selection.
c.
Click Finish. You see the site topology editor, showing the cluster bar icon and site globe icon, ready for you to build the site topology diagram:
Cluster
4.
C:\tibco\be\5.1\examples\standard\FraudDetectionCache\fdcache.ear
The project CDD is used at design time to provide information about the processing units.
The MM server reads the master files at deploy time and copies them to the remote deployment locations specified in the deployment units.
If the TIBCO BusinessEvents Version field appears in red, edit it to show the current version.
Deployment Units
5.
A connection arrow appears automatically, connecting the deployment unit to the cluster. For the tutorial you need only one DU. For a production system, you would need more, of course.
6.
Processing Unit Configurations
7.
In the DU property sheet, Click Add two times. Two processing unit configuration (PUC) entries appear:
8.
Replace the default name with the more descriptive name InferenceAgent because this engine will run one inference agent.
Select the default processing unit. (The list displays the PUs defined in the CDD.)
9.
Replace the default name with CacheServer, because this engine will run one cache agent.
Select the cache processing unit.
Host
10.
Add one host. In the Site Topology section of the palette, click the Host icon, and then click the canvas. A host icon appears on the canvas. Right-click in the canvas area to stop adding hosts.
11.
In the General tab, configure the host name as your actual machine name. Do not use localhost. In the Host IP field, enter the actual IP address of the machine.
As desired enter the Openssh username and password you activated in Task A. If you leave these fields blank you are prompted for the credentials at deploy time, for every action, such as deploy, start, and so on.
If the TIBCO BusinessEvents Version field appears in red, edit it to show the current version. (This happens only when an older ST file is copied to a later version’s project.)
12.
Right-click to stop connecting.
13.
Summary and Next Steps
Now for MM to parse and load the site topology file, you must put the site topology file under BE_HOME/mm/config. By default, the property be.mm.topology.file points to the absolute path of the site topology file of the Fraud Detection Cache example. When TIBCO BusinessEvents Express is installed, the property points to the absolute path of the site topology file of the Fraud Detection example instead.
For MM to monitor other projects, you must remove this property from the MM.cdd file or set its value to ""(empty string).

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved