The following are the wizard steps for installing and deploying Monitor Server:
The BI Monitor Installation Wizard starts on the Welcome screen. For all wizard steps, to go forward to the next step, click Next. To go back to the previous step click Back. You can exit the wizard at any time by clicking Cancel.
Read the displayed instructions, and then click Next.
In the next screen you should enter the Monitor installation directory (<Monitor>) where the necessary folders and files will be extracted. This directory also will be the BI Monitor Working Directory. You can accept the default path or change this path to a new folder. Then, you can click Next to continue.
Select the Manual Deployment radio button, and then click Next.
Selecting this option will extract all necessary folders and files that are required for deploying all BI Monitor components into the destination folder. In this case you will need to perform the deployment of each component manually. If you choose this option, two Wizard pages representing the two required steps will be displayed to help you edit the BI Monitor .ear file with the required initial parameters. Refer to the appropriate appendix for details on these two steps.
Select the one or more engines that the BI Monitor will monitor their run-time data, and then click Next to continue.
The following table displays the Engine(s) that the WBI Monitor will monitor and their parameters names
Display Name |
Parameter Name |
MQSeries Workflow / WebSphere MQ Workflow |
monitor.mqwf.enabled |
WebSphere MQ Integrator (WMQI) / WBI Message Broker |
monitor.wmqi.enabled |
WebSphere InterChange Server (ICS) |
monitor.wics.enabled |
For each engine that you select, the parameter value will be set to True.
(Optional) Define the BI Monitor initial parameters, and then click Next to continue.
The following table lists the required parameters that should be entered for each session bean.
Display Name |
Parameter Name |
Monitor Database Schema Name |
monitor.db.schema |
MQWF Database Schema Name |
monitor.db.eqSchema |
Administration Tables Tablespace |
monitor.db.tablespaces.adminTables |
Administration Indexes Tablespace |
monitor.db.tablespaces.adminIndexes |
Static Model Data Tables Tablespace |
monitor.db.tablespaces.modelTables |
Static Model Data Indexes Tablespace |
monitor.db.tablespaces.modelIndexes |
Runtime Data Tables Tablespace |
monitor.db.tablespaces.processInstTables |
Runtime Data Indexes Tablespace |
monitor.db.tablespaces.processInstIndexes |
Events Data Tables Tablespace |
monitor.db.tablespaces.eventTables |
Events Data Indexes Tablespace |
monitor.db.tablespaces.eventIndexes |
Process Data Tables Tablespace |
monitor.db.tablespaces.processDataTables |
Process Data Indexes Tablespace |
monitor.db.tablespaces.processDataIndexes |
Security Tables Tablespace |
monitor.db.tablespaces.securityTables |
Security Indexes Tablespace |
monitor.db.tablespaces.securityIndexes |
Process Model LOB Tablespace |
monitor.db.tablespaces.processModelLob |
Process Data LOB Tablespace |
monitor.db.tablespaces.processDataLob |
Configuration Data LOB Tablespace |
monitor.db.tablespaces.configValuesLob |
Notify Extra Data LOB Tablespace |
monitor.db.tablespaces.notifyExtraDataLob |
WBI Message Broker LOB Tablespace |
monitor.db.tablespaces.mbDetailLob |
MQWF Database Event Queue Tables Tablespace |
monitor.db.tablespaces.eqTables |
MQWF Database Event Queue Indexes Tablespace |
monitor.db.tablespaces.eqIndexes |
MQWF Database Container Detail Data LOB Tablespace (Oracle Only) |
monitor.db.tablespaces.conDetailDataLob |
Default Tablespace |
monitor.db.tablespaces.defaultTablespace |
Monitor Security Mode |
monitor.security.mode |
LDAP Server URL |
monitor.security.ldap.url |
LDAP Server authorized user DN |
monitor.security.ldap.dn |
LDAP Server authorized user Password |
monitor.security.ldap.password |
LDAP Naming attribute holding login ID |
monitor.security.ldap.naming.attr |
LDAP Base Point of Search |
monitor.security.ldap.root |
LDAP DN Attribute ID Name |
monitor.security.ldap.dn.attr.id |
MQ Workflow Configuration ID |
monitor.mqwf.configurationID |
MQ Workflow Encoding |
monitor.mqwf.encoding |
The following table provides the description of each parameter.
Display Name |
Parameter Name |
Monitor Database Schema Name |
The Monitor Database Schema. The default value is WFM |
MQWF Database Schema Name |
The MQSeries Workflow Database (Event Queue Database) Schema. The default value is FMC |
Administration Tables Tablespace |
TableSpace name of the Monitor Database Administration tables. |
Administration Indexes Tablespace |
TableSpace name of the Monitor Database Administration indexes. |
Static Model Data Tables Tablespace |
TableSpace name of the Monitor Database Static model tables. |
Static Model Data Indexes Tablespace |
TableSpace name of the Monitor Database Static model indexes. |
Runtime Data Tables Tablespace |
TableSpace name of the Monitor Database Dynamic tables (processes, activities and work items). |
Runtime Data Indexes Tablespace |
TableSpace name of the Monitor Database Dynamic indexes (processes, activities and work items). |
Events Data Tables Tablespace |
TableSpace name of the Monitor Database Event Bus tables. |
Events Data Indexes Tablespace |
TableSpace name of the Monitor Database Event Bus indexes. |
Process Data Tables Tablespace |
TableSpace name of the Monitor Database Process Data tables. |
Process Data Indexes Tablespace |
TableSpace name of the Monitor Database Process Data indexes. |
Security Tables Tablespace |
TableSpace name of the Monitor Database Security tables. |
Security Indexes Tablespace |
TableSpace name of the Monitor Database Security indexes. |
Process Model LOB Tablespace |
TableSpace name of the Monitor Database Process Model LOB. |
Process Data LOB Tablespace |
TableSpace name of the Monitor Database Process Data LOB. |
Configuration Data LOB Tablespace |
TableSpace name of the Monitor Database Configuration Values LOB. |
Notify Extra Data LOB Tablespace |
TableSpace name of the Monitor Database Notify Extra Data LOB. |
WBI Message Broker LOB Tablespace |
TableSpace name of the Monitor Database WBI Message Broker LOB. |
MQWF Database Event Queue Tables Tablespace |
TableSpace name of the MQSeries Workflow Database Event Queue tables . |
MQWF Database Event Queue Indexes Tablespace |
TableSpace name of the MQSeries Workflow Database Event Queue indexes. |
MQWF Database Container Detail Data LOB Tablespace (Oracle Only) |
TableSpace name of the MQSeries Workflow Database Container Detail Data LOB |
Default Tablespace |
The name of the default TableSpace that is used for any tables or indexes category that has not been assigned to a specific TableSpace. |
Monitor Security Mode |
"If you choose 'MQWF Security' option, MQ Workflow security will be used. In this case, the parameter value will be set to MQ. If you choose 'LDAP Security' option, LDAP security will be used. In this case, the parameter value will be set to LDAP. If you choose 'Local Security' option, local security will be used. In this case, the parameter value will be set to Local." |
LDAP Server URL |
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. |
LDAP Server authorized user DN |
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. |
LDAP Server authorized user Password |
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. |
LDAP Naming attribute holding login ID |
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. |
LDAP Base Point of Search |
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. |
LDAP DN Attribute ID Name |
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. |
MQ Workflow Configuration ID |
The monitored MQ Workflow Configuration name (Default or Non-Default). |
MQ Workflow Encoding |
The MQSeries Workflow Server machine encoding. (This property must be set if the MQ Workflow Server machine encoding is different from the Monitor Server machine encoding) |
In the above parameters, there are ones 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.
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.
Important Note: In Oracle Database, the Event Queue database schema and the Monitor Database Schema must be the same as the Database Administrator's User Name.
Important Note: If the property MQ Workflow Configuration ID is not defined, a default configuration must be defined.
The next screen displays the location, features, and the total size of the WBI Monitor. Click Next to continue.
Click Finish to end the BI Monitor manual installation.