DB2 Connector Overview
A Connector implementation for an DB2 database. Uses plain JDBC calls to execute provisioning operations on DB2 resource. Tested with type4 and type2 JCC driver and with
older type2 CLI driver.
Bundle Information
- Latest stable release:
- Platform: Java
- 3rd-party libraries required: DB2 JDBC driver
- Release notes:
Version Information
Connector Version | Framework Version | Supported Resource Version(s) |
1.0 |
1.0 |
|
Note: The "Framework Version" listed is the minimum required framework version for that version of
the connector. Newer framework versions are backwards compatible and will support previous connectors.
Configuration Properties
Configuration to access DB2 database. We will support most consistent way how to connect to database.
We will support 3 ways how to connect to DB2.
- Using java.sql.DataSource when using dataSource jndi name, see datasource properties
- Using type 4 driver, when using host,port and database name, see databasename properties
- Using type 2 driver, when using local alias, see aliasname properties
- See also common properties for all drivers and final notes for all IBM db2 drivers
The above specified order is critical. This means, we will not use any combination, just one of the case in the specified order.
Getting connection from DataSource. Used when dataSource
property is set
We will support these properties when connecting to DB2 using dataSource
- dataSource : Name of jndi name of dataSource : required. It must be logical or absolute name of dataSource.
No prefix will be added when trying to do lookup
-
dsJNDIEnv : JNDI environment entries needed to lookup datasource. In most cases should be empty, needed only when lookuping datasource
from different server as server where connectors are running.
- adminAccount : Administrative account : optional, default we will get connection from DS without user/password parameters
- adminPassword : Administrative password : optional, default we will get connection from DS without user/password parameters
Getting connection from DriverManager using Type 4 driver. Used when host,port,databaseName
property are set
We will support/require these properties when connecting to db2 :
- host : Name or IP of DB2 instance host. This is required property
- port : Port db2 listener is listening to. Default to 50000
- databaseName : Name of local/remote database
- subprotocol : db2,db2iSeries. Default to db2
- jdbcDriver : Classname of jdbc driver, default to com.ibm.db2.jcc.DB2Driver
- adminAccount : Administrative account when connecting to DB2 in non user contexts. E.g listing of users.
- adminPassword : Password for admin account.
Getting connection from DriverManager using Type 2 driver. Used when databaseName - local alias
property is set
We will require these properties when connecting to db2 using local alias
- databaseName : Name of local alias created using
"db2 catalag database command"
- jdbcDriver : Classname of jdbc driver, default to com.ibm.db2.jcc.DB2Driver
- subprotocol : db2,db2iSeries. Default to db2
- adminAccount : Administrative account when connecting to DB2 in non user contexts. E.g listing of users.
- adminPassword : Password for admin account.
Properties common to all connection options
- replaceAllGrantsOnUpdate : Kept for backward compatibility instead of removeForeignGrants.
When set to true(default) , we replace value of passed grants on update. Otherwise we do addition of passed grants
to the grants user already has.
This property can be removed in future version, when IDM will properly call UpdateAttributeValuesOp operations.
Note that IBM ships two drivers for DB2. We have tested only these two drivers, no other driver was tested
- IBM DB2 Driver for JDBC and SQLJ
This driver can be used as type4 and type2 driver. In this way driver classname is same, we just need specify different properties.
DatabaseName property is used like remote database in case of type4 and like local alias in case of type2.
- Legacy based cli driver
This driver is deprecated now, although it is still included in DB2 9x version. DB2 does not develop this driver any more and it seems
it will be removed in next major version release. However this driver was recommended driver for Websphere.
IBM Net Driver was deprecated in version 8, is not included in version 9. This driver is not supported.
Schema and Supported Features
This Connector supports only ACCOUNT object class. It supports these attributes
The DB2 Connector supports the following operations:
- Authenticate
- Create
- Delete
- Update
- Search
- Schema
- Test
Documentation and Source Code
The javadoc for this bundle is included in the zip file when you download the connector. The source code can be found under the Subversion
section of the IdentityConnectors website.