Creating and configuring an Oracle database for recording data

To record data to an Oracle database, create the database tables and configure an ODBC definition. Configure your integration server so that it can connect to the database.

Before you begin

Read the following topics:
Note: Choosing V2 or legacy schema for the DataCaptureStore tables.

Most users of IBM® App Connect Enterprise must use the schemas that are defined in DataCaptureSchema_V2.sql file.

It contains up-to-date schemas that use the integration server hostname and integration node hostname to distinguish records inserted on behalf of other processes. In IBM Integration Bus 10.0 and earlier, integration nodes and integration servers use universally unique identifiers (UUIDs) to identify other processes and the DataCaptureSchema.sql file contains table schemas that include these elements for compatibility reasons.

Since IBM App Connect Enterprise does not use UUIDs, records originating from IBM App Connect Enterprise contain null values for these fields.

About this task

Procedure

  1. Use the script that is provided with IBM App Connect Enterprise to create and configure the Oracle database tables in the default table space, which is where your recorded data will be stored. The script creates some tables that are not currently used, and are reserved for future use, such as WMB_EVENT_FIELDS and WMB_EVENT_TYPES.
    1. Locate the script for your operating system:
      • Windows: install_dir\server\ddl\oracle\DataCaptureSchema_V2.sql
      • Linux® or UNIX: install_dir/server/ddl/oracle/DataCaptureSchema_V2.sql
      install_dir is the location of your IBM App Connect Enterprise installation.
    2. On Oracle, enter the following command to run the script: 
      sqlplus user/password @DataCaptureSchema_V2.sql
  2. Create an ODBC definition for the database.

    If you used the supplied script to create your database without modifications, create an ODBC definition for the database called MBRECORD, with MBRECORD as the data source name (DSN). For more information, see Enabling ODBC connections to the databases.

  3. Use the mqsicredentials or ibmint command to set a user identifier and password for the integration server for connecting to the database; for example: 
    mqsicredentials --create --work-dir workDir --vault-key vaultPassword --credential-type odbc --credential-name dataSourceName --username userID --password password
    ibmint set credential --work-dir workDir --vault-key vaultPassword --credential-type odbc --credential-name dataSourceName --username userID --password password
    • workDir is the name of the work directory for your integration server.
    • vaultPassword is the vault key that is used to access the vault where the credential is stored.
    • dataSourceName identifies the database to which you want to record data.
    • userID and password specify the user identifier and the password that the integration server uses to connect to the database.
  4. To make sure that the changes to the credentials take effect, restart the integration server.
    For more information, see Starting an integration server.
  5. Test the connection to your database by using the mqsicvp command.
    For more information, see mqsicvp command.

What to do next

Continue to follow the steps for recording data. For more information, see Recording data.