Configuring an Oracle event database

You can configure an external event database using Oracle Database on a Linux, UNIX, or Windows system.

Before you begin

Before you configure an Oracle event database, you must first create the database. The Oracle SID must already exist before you run the event database configuration command. The default SID for the event database is event.

About this task

To configure an Oracle event database:

Procedure

  1. Start the wsadmin tool.
  2. Use the AdminTask object to run the configEventServiceOracleDB administrative command in batch or interactive mode. The minimum required parameters of the configEventServiceOracleDB command are as follows:
    createDB
    Indicates whether the administrative command should create and run the database configuration scripts. Specify true or false. If this parameter is set to false, the scripts are created but are not run. You must then run the database configuration scripts to complete the database configuration.
    nodeName
    The name of the node that contains the server where the event service data source should be created. If you specify a node name, you must also specify a server name. You must specify one of the following:
    • Node name and server name
    • Cluster name
    serverName
    The name of the server where the event service data source should be created.
    clusterName
    The name of the cluster where the event service data source should be created. If you specify a cluster name, do not specify node and server names.
    jdbcClassPath
    The path to the JDBC driver. Specify only the path to the driver file; do not specify the file name.
    oracleHome
    The ORACLE_HOME directory. This parameter is required only if you specified true for the createDB parameter.
    dbPassword
    The password to use for the schema user ID created during the database configuration (the default user ID is ceiuser. This password is used to authenticate the Oracle database connection.
    sysUser
    The Oracle SYSUSER user ID. This user ID must have SYSDBA privileges.
    sysPassword
    The password for the specified SYSUSER user ID.

    Other parameters might be required for your environment. For a complete list of parameters and usage information, refer to the help for the configEventServiceOracleDB administrative command.

Results

The administrative command creates the required data source at the specified scope; if you specified true for the createDB parameter, the command also runs the generated database configuration script to create the database.

The generated database configuration scripts are stored by default in the profile_root/databases/event/node/server/dbscripts/oracle directory. (In a Network Deployment environment, these scripts are stored under the deployment manager profile directory.) If you specified a value for the optional outputScriptDir parameter, the scripts are stored in that location instead. You can use these scripts to manually configure the event database at any time.