Configure the WBI Monitor Initial Parameters

Now you should configure the WBI Monitor initial parameters. This is done through the WebSphere Application Assembly Tool.

To configure the WBI Monitor initial parameters:

  1. Start the WebSphere Application Assembly Tool.

  2. Click Cancel to close the welcome screen.

  3. Select File> Open from the menu. The Open dialog box appears.

  1. Select the monitor.ear file located under <Monitor>\server\server.

  2. Add the required environment entries (parameters) in the Environment Entries node under the session bean of the following modules:

The WebSphere Application Assembly Tool window.

The following table lists the required parameters that should be entered for each session bean.

Property Name / EJB Name:

ClientAgent

CleanupAgent

NotificationAgent

EventProcessor

MQWFConnector

WMQIConnector

ICSConnector

DBBridge

monitor.db.schema

P

P

P

P

P

P

P

P

monitor.db.eqSchema

 

 

 

 

P

 

 

 

monitor.db.tablespaces.adminData

P

 

 

 

 

 

 

 

monitor.db.tablespaces.adminIndexes

P

 

 

 

 

 

 

 

monitor.db.tablespaces.modelTables

P

 

 

 

 

 

 

 

monitor.db.tablespaces.modelIndexes

P

 

 

 

 

 

 

 

monitor.db.tablespaces.processInstTables

P

 

 

 

 

 

 

 

monitor.db.tablespaces.processInstIndexes

P

 

 

 

 

 

 

 

monitor.db.tablespaces.eventTables

P

 

 

 

 

 

 

 

monitor.db.tablespaces.eventIndexes

P

 

 

 

 

 

 

 

monitor.db.tablespaces.processDataTables

P

 

 

 

 

 

 

 

monitor.db.tablespaces.processDataIndexes

P

 

 

 

 

 

 

 

monitor.db.tablespaces.securityTables

P

 

 

 

 

 

 

 

monitor.db.tablespaces.securityIndexes

P

 

 

 

 

 

 

 

monitor.db.tablespaces.processModelLob

P

 

 

 

 

 

 

 

monitor.db.tablespaces.processDataLob

P

 

 

 

 

 

 

 

monitor.db.tablespaces.configValuesLob

P

 

 

 

 

 

 

 

monitor.db.tablespaces.notifyExtraDataLob

P

 

 

 

 

 

 

 

monitor.db.tablespaces.eventDataLob

P

 

 

 

 

 

 

 

monitor.db.tablespaces.delayedEventDataLob

P

 

 

 

 

 

 

 

monitor.db.tablespaces.mbDetailLob

P

 

 

 

 

 

 

 

monitor.db.tablespaces.eqTables

 

 

 

 

P

 

 

 

monitor.db.tablespaces.eqIndexes

 

 

 

 

P

 

 

 

monitor.db.tablespaces.conDetailDataLob

 

 

 

 

P

 

 

 

monitor.db.tablespaces.defaultTablespace

 

 

 

 

 

 

 

 

monitor.wics.enabled

P

 

 

P

 

 

 

 

monitor.wmqi.enabled

P

 

 

P

 

 

 

 

monitor.mqwf.enabled

P

 

 

P

 

 

 

 

monitor.security.mode

P

 

 

 

 

 

 

 

monitor.security.ldap.url

P

 

 

 

 

 

 

 

monitor.security.ldap.dn

P

 

 

 

 

 

 

 

monitor.security.ldap.password

P

 

 

 

 

 

 

 

monitor.security.ldap.naming.attr

P

 

 

 

 

 

 

 

monitor.security.ldap.root

P

 

 

 

 

 

 

 

monitor.security.ldap.dn.attr.id

P

 

 

 

 

 

 

 

monitor.mqwf.configurationID

P

 

P

 

 

 

 

 

monitor.mqwf.encoding

 

 

 

P

 

 

 

 

The following table provides the description of each parameter.

Parameter Name

Type

Value Description

monitor.db.schema

String

The Monitor Database Schema. The default value is WFM

monitor.db.eqSchema

String

The MQSeries Workflow Database (Event Queue Database) Schema. The default value is FMC

monitor.mqwf.enabled

String .

Type True if you are using MQ Workflow as your engine or False otherwise

monitor.wmqi.enabled

String .

Type True if you are using WMQI as your engine or False otherwise

monitor.wics.enabled

String

Type True if you are using WICS as your engine or False otherwise

monitor.security.mode

String

The applied security mode:

  • Type MQ for MQ Workflow security mode if you are using MQ Workflow as your engine.

  • Type LDAP for LDAP security mode or Local for  local security mode if you are only using  WMQI as your engine

monitor.security.ldap.url

String

The LDAP Server URL and port number (for example ldap://ldapsrvr:389/).

This parameter is added only if you are only using  WMQI as your engine with LDAP security mode.

monitor.security.ldap.dn

String

 A Distinguished Name (DN) for an LDAP Server authorized user that will be used for logging in to this LDAP Server, and performing the search in the LDAP users' tree.

This parameter is added only if you are only using  WMQI as your engine with LDAP security mode.

monitor.security.ldap.password

String

The password of the defined User DN.

This parameter is added only if you are only using  WMQI as your engine with LDAP security mode.

monitor.security.ldap.naming.attr

String

The name of the prefix that precedes the user ID in the LDAP Server database (i.e. CN, UID,...etc). The value of this parameter varies between the different types of LDAP Servers.

This parameter is added only if you are only using  WMQI as your engine with LDAP security mode

monitor.security.ldap.root

 

String

The starting point in the LDAP tree from which the query will start searching for the full DN of the given user ID.

This parameter is added only if you are only using  WMQI as your engine with LDAP security mode

monitor.security.ldap.dn.attr.id

String

The name of the Distinguished Name attribute ID (for example distinguishedName, entrydn ...etc. This value is case sensitive).

This parameter is added only if you are only using  WMQI as your engine with LDAP security mode

monitor.mqwf.configurationID

String

The used MQ Workflow Configuration (Default or Non-Default).

monitor.mqwf.encoding

String

The MQSeries Workflow Database encoding. (This property must be set if the MQ Workflow Database encoding is different from the Monitor Server machine encoding)

In addition to the above parameters, there are additional parameters that should be defined to hold the values of the Database TableSpaces names that you want to use for physically storing the Monitor and EventQueue database tables and indexes. You have the ability to use a number of TableSpaces that are up to 22 different TableSpaces; 19 of them are created in the Monitor Database and three of them are created in the EventQueue Database. The database tables and indexes are grouped and categorized so that each category can be assigned to a separate TableSpace. You can define different TableSpace name as the value for each system property. Alternatively, you can define the same TableSpace for more than one system properties. In the later case, this TableSpace will be used for the tables and indexes that are corresponding to these properties. You can also ignore defining any of these properties, and in this case the tables, which are supposed to be assigned to these TableSpaces, will be assigned to the default TableSpace that can be defined by the monitor.db.tablespaces.defaultTablespace property. If you did not define this property then the database user default TableSpace will be used as the default TableSpace.

Parameter Name

Type

Value Description

monitor.db.tablespaces.adminData

String

TableSpace name of the Monitor Database Administration tables.

monitor.db.tablespaces.adminIndexes

String

TableSpace name of the Monitor Database Administration indexes.

monitor.db.tablespaces.modelTables

String

TableSpace name of the Monitor Database Static model tables.

monitor.db.tablespaces.modelIndexes

String

TableSpace name of the Monitor Database Static model indexes.

monitor.db.tablespaces.processInstTables

String

First TableSpace name of the Monitor Database Dynamic tables.

monitor.db.tablespaces.processInstIndexes

String

First TableSpace name of the Monitor Database Dynamic indexes.

monitor.db.tablespaces.eventTables

String

Second TableSpace name of the Monitor Database Dynamic tables.

monitor.db.tablespaces.eventIndexes

String

Second TableSpace name of the Monitor Database Dynamic indexes.

monitor.db.tablespaces.processDataTables

String

Third TableSpace name of the Monitor Database Dynamic tables.

monitor.db.tablespaces.processDataIndexes

String

Third TableSpace name of the Monitor Database Dynamic indexes.

monitor.db.tablespaces.securityTables

String

TableSpace name of the Monitor Database Security tables.

monitor.db.tablespaces.securityIndexes

String

TableSpace name of the Monitor Database Security indexes.

monitor.db.tablespaces.processModelLob

String

TableSpace name of the Monitor Database Process Model LOB.

monitor.db.tablespaces.processDataLob

String

TableSpace name of the Monitor Database Process Data LOB.

monitor.db.tablespaces.configValuesLob

String

TableSpace name of the Monitor Database Configuration Values LOB.

monitor.db.tablespaces.notifyExtraDataLob

String

TableSpace name of the Monitor Database Notify Extra Data LOB.

monitor.db.tablespaces.eventDataLob

String

TableSpace name of the Monitor Database Event Data LOB.

monitor.db.tablespaces.delayedEventDataLob

String

TableSpace name of the Monitor Database Delayed Event Data LOB.

monitor.db.tablespaces.mbDetailLob

String

TableSpace name of the Monitor Database WBI Message Broker LOB.

monitor.db.tablespaces.eqTables

String

TableSpace name of the MQSeries Workflow Database Event Queue tables .

monitor.db.tablespaces.eqIndexes

String

TableSpace name of the MQSeries Workflow Database Event Queue indexes.

monitor.db.tablespaces.conDetailDataLob

String

TableSpace name of the MQSeries Workflow Database Configuration Detail Data LOB

monitor.db.tablespaces.defaultTablespace

String

The name of the default TableSpace that is used for any tables or indexes category that has not been assigned to a specific TableSpace.  

In case you have an existing database that belongs to a previous version and contains data, then you will need only to add the monitor.db.tablespaces.defaultTablespace parameter. All other parameters that hold the TableSpaces names should not be added.

In Oracle Database, the Event Queue database schema and the Monitor Database Schema must be the same as the Database Administrator's User Name

In MQ Workflow, a default configuration must be defined.

To add each one of these parameters, do the following:

  1. Select File > Save from the menu to save the monitor.ear.

  2. Exit the Application Assembly Tool.