The Monitor Server component can be deployed automatically on WebSphere Application Server using the BI Monitor Installation Wizard by selecting the Automatic Deployment as the deployment type.
The wizard will lead you through a set of steps to gather the required information for the Monitor Server deployment, and then the wizard will deploy the Monitor Server automatically.
When you are deploying the Monitor using the Deployment Manager to a node that exists in a remote machine other than the Deployment Manager machine, then the following fields must be entered with the values of the remote node environment:
Database JDBC driver
Monitor database name/Alias
Monitor database User Name and Password
IBM MQSeries Workflow library path and file name
MQ Workflow database name/Alias
MQ Workflow database User Name and Password
In case of network deployment, you must disable the wizard validation that checks and validates the above items. This is done by editing the runwizard.sh or the runwizard.bat by which you run the installation wizard and adding the following switch -Dmonitor.wizard.validators=false to the Run command as follows:
In the runwizard.bat:
"%WAS_HOME%\java\bin\java" "%CLIENTSAS%" -Dmonitor.wizard.validators=false "-Dwas.install.root=%WAS_HOME%" "-Dwas.repository.root=%CONFIG_ROOT%" -Dcom.ibm.CORBA.BootstrapHost=%COMPUTERNAME% -cp "%WAS_HOME%\classes";"%WAS_HOME%\lib\xerces.jar";"%WAS_HOME%\l ib\j2ee.jar";"%WAS_HOME%\lib\admin.jar";"%WAS_HOME%\lib\wsexception.j ar";"%WAS_HOME%\lib\wasjmx.jar";"%WAS_HOME%\lib\management.jar";"% WAS_HOME%\lib\sas.jar";"%WAS_HOME%\lib\utils.jar";"%WAS_HOME%\lib\ wssec.jar";"%WAS_HOME%\lib\ras.jar";"%WAS_HOME%\lib\bootstrap.jar";"% WAS_HOME%\lib\emf.jar";"%WAS_HOME%\lib\ffdc.jar";"%WAS_HOME%\lib\s oap.jar";"%WAS_HOME%\lib\classloader.jar";"%WAS_HOME%\lib\wasproduct .jar";WBIMonitor424-FixPack4.jar -Djava.ext.dirs="%WAS_HOME%\java\jre\lib\ext";"%WAS_EXT_DIRS%" run
In the runwizard.sh:
${WAS_HOME}/java/bin/java "${CLIENTSAS}" -Dmonitor.wizard.validators=false "-Dwas.install.root=${WAS_HOME}" "-Dwas.repository.root=${CONFIG_ROOT}" -Dcom.ibm.CORBA.BootstrapHost=${COMPUTERNAME} -cp ${WAS_HOME}/ classes:${WAS_HOME}/lib/xerces.jar:${WAS_HOME}/lib/ j2ee.jar:${WAS_HOME}/lib/admin.jar:${WAS_HOME}/lib/ wsexception.jar:${WAS_HOME}/lib/wasjmx.jar:${WAS_HOME}/lib/ management.jar:${WAS_HOME}/lib/sas.jar:${WAS_HOME}/lib/ utils.jar:${WAS_HOME}/lib/wssec.jar:${WAS_HOME}/lib/ ras.jar:${WAS_HOME}/lib/bootstrap.jar:${WAS_HOME}/lib/ emf.jar:${WAS_HOME}/lib/ffdc.jar:${WAS_HOME}/lib/soap.jar:${WAS_HOME}/ lib/classloader.jar:${WAS_HOME}/lib/wasproduct.jar:WBIMonitor424-FixPack4.jar -Djava.ext.dirs=${WAS_HOME}/java/jre/lib/ ext:${WAS_EXT_DIRS} run
In case you choose to install and deploy the BI Monitor on a Network deployment environment, then the Deployment Manager must be started and run at installation time.
You must un-deploy Monitor Sever that exists on WAS, in case there is a previous one.
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.
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.
In the next screen read the displayed instructions, and then click Next.
The next screen is the Deployment Type where you can select one of the following deployment types:
Automatic Deployment: Selecting this option will let this installation wizard perform all needed steps for installing the BI Monitor Components and perform the BI Monitor Server deployment automatically.
Manual Deployment: 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 Automatic Deployment option and then click Next to continue.
The next screen of the BI Monitor Installation Wizard appears if you select the Automatic Deployment option as the deployment type. In this screen, you should select one or more of the BI Monitor components to be installed. Select the Monitor Server option to install and deploy the Monitor Server component and then click Next to continue.
In the next wizard screen you will be asked to enter the path and the type of the Database JDBC driver file. For IBM DB2 database, this driver file is named db2java.zip and is located in the <DB2>\Java folder. For Oracle database, this driver file is named classes12.zip and is located in the <Oracle>\jdbc\lib folder. Enter the required path or click Browse to select the path. Then select the driver type from DB Driver Type combo box. If the entered path is not correct, then you will be informed by a message, and the wizard will not continue until you enter the correct path. Then, you can click Next to continue.
In the next screen you will be asked to enter the following information for the Monitor database:
In the Name/URL field, enter the Monitor database name (or the database URL).
If you are using Oracle database server, you can type one of the following for the Monitor database URL:
jdbc:oracle:thin:@<Oracle_Server_Name>:<Oracle_Server_Port_Number>:WFMDB or,
jdbc:oracle:oci:@WFMDB (for Oracle 9i and Oracle 10g) or jdbc:oracle:oci8:@WFMDB (for Oracle 8i)
Where <Oracle_Server_Name> is the name or the IP address of the Oracle Database Server machine, and <Oracle_Server_Port_Number> is the Oracle Server Port Number (the default port is 1521)
In the User Name and Password fields, enter the user name and password of the Monitor database administrator.
In the Schema field, enter the Monitor database schema (The default value is WFM).
In Oracle Database, the Monitor database schema must be the same as the Database Administrator's User Name.
The wizard will check the connection with the database using the entered database name (or URL), user name and password. If one or more of the entered parameters are not correct, then you will be informed by a message, and the wizard will not continue until you enter the correct parameters. Then click Next to continue.
The wizard will also check this database to verify if it is a newly created database or a database of an earlier version of the BI Monitor that requires to be upgraded to the recent version's modifications. If the specified database belongs to the previous version of BI Monitor, then a message will appear to tell you that the specified database belongs to a previous version of BI Monitor, and it needs to be upgraded using the Database Migration Utility before starting this Installation Wizard. Then the wizard will be terminated.
Please refer to the section entitled BI Monitor Database Migration in Chapter 6: Upgrading your Existing Version of BI Monitor to the Recent Version in this guide for detailed information about the Database upgrade.
In the next step you should specify the names of the required TableSpaces for each group of tables and indexes in the Monitor database as follows:
In the Default TableSpace field, type the name of the TableSpace that you want to set as the default TableSpace. This TableSpace will be used as the TableSpace of any tables or indexes group for which you have not specified a TableSpace.
If you leave this field empty, then the database default TableSpace will be considered and used as the default TableSpace.
In the Administration section, type a TableSpace name for each of the following:
Administration Tables.
Administration Indexes.
In the Static Model Data section, type a TableSpace name for each of the following:
Static Model Data Tables.
Static Model Data Indexes.
In the Runtime Data section, type a TableSpace name for each of the following:
Runtime Data Tables.
Runtime Data Indexes.
In the Events Data section, type a TableSpace name for each of the following: (These TableSpaces are used for the Event Queue (MQ Workflow) database):
Events Data Tables.
Events Data Indexes.
In the Process Data section, type a TableSpace name for each of the following:
Process Data Tables.
Process Data Indexes.
In the Security section, type a TableSpace name for each of the following:
Security Tables.
Security Indexes.
In the Large Objects TableSpaces section, type a TableSpace name for each of the following:
Static Model Lob.
Process Data Lob.
Configuration Data Lob.
Notify Extra Data Lob.
WBI Message Broker Lob.
You can specify a different TableSpace name for each group of tables or indexes. Alternatively, you can specify the same TableSpace for more than one group of tables or indexes. In the later case these groups of tables and/or indexes will use the same TableSpace for storing the data physically on the hard drive.
If you leave a blank field without specifying a TableSpace name, then the default TableSpace will be used for the corresponding group of tables or indexes.
The specified TableSpace should have been previously created in the Database server. Otherwise, the deployment will not be performed properly and you will not be able to create the database tables.
In case you have an existing database that belongs to a previous version and contains data, then you will only be able to enter the default TableSpace. All other fields that can hold the multiple TableSpaces Names will be disabled.
Click Next to continue.
In the next screen you will be asked to select the workflow engine(s) that the BI Monitor will monitor their run-time data. There are two workflow engines that can be selected:
MQSeries Workflow / WebSphere MQ Workflow
WebSphere MQ Integrator (WMQI) / WBI Message Broker
WebSphere InterChange Server (WICS)
You can select one of these options or you can select a combination of them. According to your selection, the wizard steps will vary to let you enter the required information for the selected option as will be described in the following sections.
If the specified BI Monitor database belongs to a previous version of BI Monitor, then the MQWF option will be selected by default and its check box will be disabled so that you cannot de-select it.