To improve the security and scalability of the IBM® Content
Navigator web client, configure WebSphere® Application
Server connection pooling on the
servers in your IBM Content
Navigator environment.
About this task
The IBM Content
Manager connector has a feature to enable WebSphere Application
Server JDBC connection pooling.
To share library server database connections from the WebSphere Application
Server JDBC connection pool, you
must enable the feature.
Without WebSphere Application
Server connection pooling, each
database handles its own database connection. When you enable WebSphere Application
Server connection pooling, IBM Content
Navigator shares library server
database connections from the WebSphere Application
Server JDBC connection pool. Connection pooling improves performance
by reducing the quantity of resources that are required for a set
of databases.
Connection pooling has other benefits:
- Users can connect to IBM Content
Manager Enterprise Edition, Version 8.4.3 from a single instance of WebSphere Application
Server.
- It reduces the logon time and memory usage.
- It increases the security of deployed web applications.
Procedure
To enable WebSphere Application
Server connection pooling:
- Modify the cmbpool.ini file to use
indirect lookup by adding the values:
- JavaPool=DKPoolWAS
- JDBCPrefix=jdbc/
By default, the cmbpool.ini file is in
the same directory that the cmbicmsrvs.ini and cmbicmenv.ini files are located.
The cmbicmsrvs.ini and cmbicmenv.ini files
are required files. They must exist in the same directory as the cmbpool.ini file. Do not remove or rename these files.
- Set the JDBC driver path in your WebSphere Application
Server administrative console:
- Navigate to .
- From Scope, select Node=YourSystemNode.
- From the list of resources, select the JDBC
driver path for your database type.
- Set the value for the JDBC driver path to the location
of the JDBC JAR files on your system. Then, save your changes to the
master configuration.
- Create a JDBC resource reference for your IBM Content
Manager library
server in your WebSphere Application
Server administrative console:
- Navigate to and click New.
- From Scope, select Node=YourSystemNode.
- Set the database and provider types.
- Set the implementation type to Connection
pool data source.
- Verify that the class path is correct. Then, save your
changes to the master configuration.
- Create a data source in your WebSphere Application
Server administrative console:
- Navigate to and select the reference that you created.
- Click Data sources. Then, click New.
- In the JNDI name field, enter jdbc/ICMNLSDB where ICMNLSDB is
the library server database name, then click OK. This value is case-sensitive.
- In the Database name field, enter
the library server database name. This value is case-sensitive.
- In the Server name field, enter
the host name of the database. Click Next.
Then, save your changes to the master configuration.
- Edit the JAAS – J2C authentication data properties in the WebSphere Application
Server administrative console:
- Select the data source that you created.
- Under Related Items, click JAAS – J2C authentication data. Then, click New.
- In the Alias field, enter a value,
such as nodename/userID.
- In the User ID field, enter ICMCONCT.
- In the Password field, enter
the password of the ICMCONCT user. Then, click OK. This password was specified during the IBM Content
Manager installation.
Tip: You can create a temporary password with your icmconct user ID. Do not manually edit the password to
generate the temporary password. You must generate the temporary password
by generating the password for the icmconct user
ID in the cmbicmenv.ini file in IBM Content
Navigator.
- Select the alias in Component-managed authentication
alias and in Container-managed authentication
alias. Then, save your changes to the master configuration.
What to do next
Set the following optional connection pooling parameters
that are based on your performance requirements and system resources:
- Connection timeout
- Maximum connections
- Minimum connections
- Reap time
- Unused timeout
- Aged timeout
- Purge