Configure BAM

To configure BAM, create a BAM database service endpoint:

  1. In the left pane of the Process Administrator, click Service Endpoints.

  2. On the Service Endpoints page, click Add.

  3. On the Service Endpoints | Add Service Endpoint page, enter a Name for the BAM database, such as BAMdb.

  4. In the Type drop-down list, select SQL Database.

  5. In the Subtype drop-down list, select the JDBC connector type for the BAM database. The JDBC selected must be installed the computer that hosts the SQL database where the BAM database will be created.

  6. Click Next.

  7. On the Service Endpoints | Add Service Endpoint | Edit Service Endpoint page, enter the configuration Properties for the BAM database. The configuration properties will vary based on the type of JDBC selected. For an explanation of the properties required for each type of JDBC, refer to the Required Parameters for SQL Database JDBC Configuration.

  8. Configure the Runtime options or accept the default settings.

  9. Click Save.

Then configure the BAM settings:

  1. In the left pane of Process Administrator, select Process Monitoring.

  2. On the Process Data Mart page, BAM tab, configure the BAM Properties:

Property

Description

Enable Automatic Update

Sets the BAM updater to run automatically based on the Update Frequency time setting. If this option is not selected, a manual update can be performed from the ptprocess\1.5\bin folder using fuegowarehouse.bat.

Runtime Database Configuration

The BAM database. The BAM database must be configured as a SQL Database business end point before it will appear in this drop-down list.

Update Frequency (in minutes)

The frequency with which the BAM updater will run and migrate events from the process execution engines to the BAM database.

Data Availability Time (in hours)

The length of time the BAM data will remain in the BAM database. The data will be disposed of after the number of hours set in this field and will then only be accessible from the data mart database.

Note: The BAM log is created in the same directory as the process data mart log and cannot be configured separately. The process data mart Log Directory configuration setting must be saved before the BAM updater log file can be created. Log messages from the BAM updater will be written to the bam-dwupdater-service.log file in this directory. This directory must exist in order for the log file to be created by the BAM updater. The verbosity level can be set by configuring the wrapper.logfile.loglevel property in \conf\WarehouseService.conf. Acceptable values are: NONE, INFO, and DEBUG.

  1. Click Save.

  2. Click the BAM tab.

  3. Click Manage Database.

  4. On the BAM | Manage Database page, select the Create Database checkbox.

  5. Select the Create Data Structure checkbox.

  6. Enter a User Name and User Password with administrative write privileges for the host engine.

  7. Click OK.

  8. At the top of the Process Data Mart page, the Message(s) section should contain the following confirmation messages:

    1. To verify the creation of the database and data structure, check the host engine to see if the new database is there.

Then install the data warehouse Process Monitoring service on the host computer for Process or BPM:

  1. In the command prompt, change to the directory containing the albpmwarehouse.bat file that was included during installation.

  1.  In the correct directory, type:

albpmwarehouse.bat install

Note that the JAVA_HOME environment variable must be set.

  1. In the Windows Services utility, start the data warehouse Process Monitoring service.

Note: Changes to the Process Data Mart and BAM configurations will only take effect if you stop and re-start the data warehouse Process Monitoring service.

Note: Installation of this service is not required for Unix. Start the service to use the Process Data Mart and BAM configurations. The Unix parameters for this service are: ./albpmwarehouse.sh { start | stop | dump }

Related Topics: