Lotus Notes Adapter 6.0 | webMethods Lotus Notes Adapter Documentation | webMethods Lotus Notes Adapter Installation and User’s Documentation | Adapter Connections | Configuring Lotus Notes Adapter Connections
 
Configuring Lotus Notes Adapter Connections
When you configure Lotus Notes Adapter connections, you specify information that Integration Server uses to connect to the Domino Server.
You create Lotus Notes Adapter connections using the Integration Server Administrator.
*To configure a connection
1. In the Adapters menu in the Integration Server Administrator navigation area, click Lotus Notes Adapter.
2. On the Connections screen, click Configure New Connection.
3. On the Connection Types screen, click Lotus Notes Adapter Connection to display the Configure Connection Type screen.
4. In the Lotus Notes Adaptersection, provide values for the following fields.
Field
Description/Action
Package
The package in which to configure the connection.You must create the package using Designer before you can specify it using this parameter. For general information about creating packages, see the webMethods Service Development Help for your release.
Note:
Configure the connection in a user-defined package rather than in the adapter's package. See Lotus Notes Adapter Package Management for other important considerations when creating packages for the Lotus Notes Adapter.
Folder Name
The folder in which to configure the connection.
Connection Name
The name you want to give the connection. Connection names cannot have spaces or use special characters reserved by Designer. For more information about the use of special characters in package, folder, and element names, see the webMethods Service Development Help for your release.
5. In theConnection Properties section, provide values for the fields noted below.
The values you enter in theConnection Properties section are not validated until run time when you execute the createSession method.
Field
Description/Action
Lotus Domino Host Name
Required. The host name or IP address of the machine on which your Domino Server is running. Optionally you can include the port number of the host. For example, any of the following values are valid:
*my.server.com
*my.server.com:81
*127.0.0.1
*127.0.0.1:81
Lotus Domino User name
The user name that you use to log into the Domino Server. If your Domino Server is configured to allow anonymous logins, you may leave this field blank.
Lotus Domino password
The password that you use to log into the Domino Server. If your Domino Server is configured to allow anonymous logins, you may leave this field blank.
Retype Lotus Domino password
Re-type the password.
HTTP/HTTPS Connection
Select the type of connection that you use to connect to the Domino Server.For HTTPS connections, you must also copy the TrustedCerts.class file to the Integration Server_directory \packages\WmLotusNotesAdapter\code\classes directory. For more information about this file, see your Domino Server documentation.Ensure that your Domino server is correctly configured to accept SSL connections. See your Domino Server documentation.
6. In the Connection Management Properties section, Software AG recommends that you set the Enable Connection Pooling parameter to false and take the default value for the remaining fields. This is because there is no connection pooling support in Lotus Notes Adapter.
The fields in this section are described as follows:
Parameter
Description/Action
Enable Connection Pooling
Enables the adapter to use connection pooling. Default: true. If set to false, Lotus Notes Adapter does not use the connection pooling feature.
Minimum Pool Size
The minimum number of connection objects that remain in the connection pool at all times. When the adapter creates the pool, it creates this number of connections. Default: 1.
Maximum Pool Size
The maximum number of connection objects that can exist in the connection pool. When the connection pool has reached its maximum number of connections, the adapter will reuse any inactive connections in the pool or, if all connections are active, it will wait for a connection to become available. Default: 10.
Pool Increment Size
If connection pooling is enabled, this field specifies the number of connections by which the pool will be incremented if connections are needed, up to the maximum pool size. Default: 1.
Block Timeout
If connection pooling is enabled, this field specifies the number of milliseconds that Integration Server will wait to obtain a connection with the Domino Server before it times out and returns an error. Default: 1000.
Expire Timeout
If connection pooling is enabled, this field specifies the number of milliseconds that an inactive connection can remain in the pool before it is closed and removed from the pool. For example, to specify 10 seconds, specify 10000. Enter 0 to specify no timeout. Default: 1000.
Note:
The adapter will never violate the Minimum Connections parameter. These connections remain in the pool regardless of how long they are inactive.
Startup Retry Count
If connection pooling is enabled, this field specifies the number of times that the system should attempt to initialize the connection pool at startup if the initial attempt fails, before issuing an AdapterConnectionException.
Startup Backoff Timeout
If connection pooling is enabled, this field specifies the number of seconds to wait between each attempt to initialize the connection pool.
7. Click Save Connection.
The connection you created appears on the adapter's Connections screen and in Designer.