Before you configure your applications to use EIM, you will need
to import an external connector resource archive (RAR) file into your workspace.
- From the IDE, select .
- Select J2EE > RAR file and click Next.
- In the Connector Import dialog,
click Browse and navigate to C:\Program Files\IBM\SDP70Shared\plugins\com.ibm.etools.iseries.webtools.ae_<ver>\lib, where C:\IBM\SDP70Shared is
the shared resources directory as specified in Installation Manager, and <ver> is
the latest build identifier.
- Two versions of the JCA connector are shipped with Rational® Developer
for System
i™, version 7.1:
- JCA version 1.5 connector should be used for connecting to WebSphere® Application
Server, version 6.0 or later.
- JCA version 1.0 connector can be used for WebSphere Application Server, versions
5.1 and 6.0. This connector has also been updated.
Select the eimIdTokenRA.rar file (for JCA
version 1.0) or the eimIdTokenRA.JCA15.rar file (for
JCA version 1.5) and click Open to add it to the Connector
Import dialog.
- Select your EAR project from the list.
Note: Four RAR files are provided. eimIdTokenRA.JCA15.rar (or eimIdTokenRA.rar for
JCA version 1.0) encapsulates eim.jar and facilitates deployment. idTokenRA.rar and idTokenRA.JCA15.rar do
not contain eim.jar, and require the user to add it and configure the Server
classpath.
- Click Finish to import the RAR file.
Now configure the resource adapter to use the EIM domain created
previously.
- Activate the Navigator view. (If the Navigator view is not visible,
you can display it by selecting .) Expand the EAR folder for
your project. Expand the META-INF directory, and double-click
the EAR Deployment Descriptor file (application.xml).
- At the bottom of the editor area, click the Deployment tab
and expand the Authentication section.
- Click Add to configure JAAS authentication
for the LDAP administrator. Enter the user ID and password for this administrator
and click OK.
- Expand the External J2C Options section.
- Click Add next to J2C Resource
Adapters. The Create Resource Adapter dialog
is displayed with the resource adapter name eimIdTokenRA (or emIdTokenRA.JCA15)
in the Resource Adapter Name field. Click OK to
close the dialog.
- Click Add next to J2C Connection
Factories. The Create Connection Factory dialog
is displayed.
- Enter a name for the connection factory.
- Enter a JNDI name for this connection factory in the JNDI
name field (for example, eis/idTokenRoot).
- Set Max connections to 10.
- All other values in this dialog should remain at their default
settings. Click OK to close the dialog.
- Click the newly created connection factory in the J2C connection
factories list, and click Config Property. The
Modify Configuration Property dialog opens.
- Under Resource Properties, enter the appropriate
information to configure the connection factory. Some default settings are
suggested below:
- KeyTimeoutSeconds: Specifies a value, in seconds, before the key
times out. Set this value to 1200.
- KeySize: Indicates the size of the key, in bytes. Set this value
to 512.
- LdapHostName: The host name or IP address of the remote System i.
- LdapHostPort: The port that the LDAP service runs on. Set this
value to 389.
- SourceRegistryName: The name for the source registry.
- EimDomainName: The EIM domain name.
- ParentDomain: The fully-qualified domain name for the parent domain,
in pair=value separated format. For example, if the domain name for your parent
domain is torasbcc.torolab.ibm.com, then the ParentDomain value
would be dc=torasbcc,dc=torolab,dc=ibm,dc=com.
- TrustStoreName: The path to the trust store file.
- TrustStorePassword: The password for the trust store file.
- KeyStoreName: The path to the key store file.
- KeyStorePassword: The password for the key store file.
Additional information on these settings is available in
the WebSphere Application
Server for i5/OS® documentation.
- Save and close the server configuration.
- In the Servers view, right-click the test
server and select Restart to start it.