Use the configEventServiceInformixDB command
to configure the Common Event Infrastructure using an Informix® database.
Purpose
The
configEventServiceInformixDB command
is a
Common Event Infrastructure administrative
command is available for the AdminTask object. Use this command to
create the event service database and data sources for Informix on a server or cluster. For more
information about the AdminTask object, see the
WebSphere® Application Server
Network Deployment, version 6.1 documentation.
Note: The product uses a Jython version that does not support Microsoft® Windows® 2003 or Windows Vista operating systems.
Parameters
- - createDB
- The command generates the DDL database scripts and creates the
database when this parameter is set to true. The
command only generates the DDL database scripts when this parameter
is set to false. To create the database, the current
server must be already configured to run the database commands. The
default value is false if not specified.
- - overrideDataSource
- Optional database script output directory. When this parameter
is specified, the command generates the event service database scripts
in the specified directory. If the specified directory does not contain
a full path, the command creates the specified directory in profile_root/bin.
The default database script output directory is profile_root/databases/event/node/server/dbscripts/dbtype if
this parameter is not specified.
- - nodeName
- The name of the node that contains the server where the event
service data source should be created. If this parameter is specified,
then the serverName parameter must be set. You
must not specify this parameter if the clusterName parameter
is specified.
- - serverName
- The name of the server where the event service data source should
be created. If this parameters is specified without the nodeName parameter,
the command will use the node name of the current WebSphere profile. You must not specify
this parameter if the clusterName parameter is
specified.
- - clusterName
- The name of the cluster where the event service data source should
be created. If this parameter is specified, then the serverName and nodeName parameters
must not be set. You must not specify this parameter if the serverName and nodeName parameters
are specified.
- - jdbcClassPath
- The path to the JDBC driver. Specify only the path to the driver
file; do not include the file name in the path. This parameter is
required.
- - dbInformixDir
- The directory where the Informix database
is installed. This parameter must be specified when the parameter createDB is
set to true. This parameter is required.
- - dbHostName
- The host name of the server where the database is installed. This
parameter is required.
- - dbServerName
- Informix server name
(for example, ol_servername). This parameter is required.
- - dbPort
- Informix instance port.
The default value is 1526 if not specified.
- - dbName
- The database name to be created. The default value is event if
not specified.
- - dbUser
- The Informix database
schema user ID that will own the event service database tables. The WebSphere data source uses
this user ID to authenticate the Informix database
connection. This parameter is required.
- - dbPassword
- The password of the schema user ID that owns the event service Informix tables. The WebSphere data source uses
this password to authenticate the Informix database
connection. This parameter is required.
- - ceiInstancePrefix
- The command uses the event service instance name to group the
database files in a directory with unique names. The default value
is ceiinst1 if not specified.
- - outputScriptDir
- Optional database script output directory. When this parameter
is specified, the command generates the event service database scripts
in the specified directory. If the specified directory does not contain
a full path, the command creates the specified directory in profile_root/bin.
The default database script output directory is profile_root/databases/event/node/server/dbscripts/informix
if this parameter is not specified.
Sample
Batch mode example usage:
Using Jacl:
$AdminTask configEventServiceInformixDB {-createDB true
-overrideDataSource true -nodeName nodename -serverName servername
-jdbcClassPath "c:\program files\ibm\informix\jdbc\lib"
-dbInformixDir "c:\program files\ibm\informix" -dbUser informix
-dbPassword dbpassword -dbHostName host_name -dbPort 1526
-dbServerName ol_server }
Using Jython string:
AdminTask.configEventServiceInformixDB('[-createDB true
-overrideDataSource true
-nodeName nodename
-serverName servername
-jdbcClassPath "c:\program files\ibm\informix\jdbc\lib"
-dbInformixDir "c:\program files\ibm\informix"
-dbUser informix
-dbPassword dbpassword
-dbHostName host_name
-dbPort 1526
-dbServerName ol_server]')
Using Jython list:
AdminTask.configEventServiceInformixDB(['-createDB', 'true',
'-overrideDataSource', 'true', '-nodeName', 'nodename',
'-serverName', 'servername', '-jdbcClassPath',
'c:\program files\ibm\informix\jdbc\lib', '-dbInformixDir',
'c:\program files\ibm\informix', '-dbUser', 'informix ',
'-dbPassword', 'dbpassword', '-dbHostName', 'host_name',
'-dbPort', '1526', '-dbServerName', 'ol_server'])
Interactive mode example usage:
Using Jacl:
$AdminTask configEventServiceInformixDB -interactive
Using Jython string:
AdminTask.configEventServiceInformixDB('[-interactive]')
Using Jython list:
AdminTask.configEventServiceInformixDB(['-interactive'])