Editing the Server Settings of a Resource Adapter 

Use

When you deploy an application on a server, you have to take into consideration the specifics of this server. Using this procedure you can prepare your application to be deployed on a Web Application Server/ J2EE Engine.

Procedure

C...

       1.      Click the Server Settings tab.

       2.      Edit the identity subject settings, additional settings and the driver settings.

Editing the Identity Subjects Settings

...

       1.      Click the Identity Subjects tab.

       2.      Select a mode used for the authentication resources from the Auth Type combo box. You can choose from:

¡        No value – this means that you will not use an authentication resource when connecting to the server.

¡        Caller Impersonation – this is used when the credentials of the caller principal are directly passed to the EIS and used for the authentication of the resource principal.

¡        Credentials Mapping – this is used when the credentials of the caller principal are replaced by the credentials that are used for authentication to the EIS. In this case, you have to specify a userstore where the EIS credentials are stored.

¡        Configured Identity – this is used when all caller principals obtain a connection to the EIS using the same pre-configured identity. You can either:

§         Specify a user store where this identity is stored, or

§         Enter the name and the password for the resource principal.

¡        Principal Mapping – this is used when particular caller principals are mapped to an EIS principal. Only authorized caller principals can obtain a connection using a specific identity. You can either:

§         Specify a user store where this identity is stored, or

§         Enter the name and the password of the resource principal.

       3.      Specify a user store configuration from the User Store combo box. You can choose from:

¡        No value – no user store will be used.

¡        Active

¡        System

       4.      Specify a name and password for the resource principal in the Principal Name and Principal Password fields.

       5.      From the available Principals on Server select the entries in the Caller Principals list.

                                                  i.       You can select the existing users and groups on the server to which you are connected. They are listed in the Existing Users tab, in the User Tree list.

                                                ii.       You can create new users and groups in the Define Users tab.

                                               iii.       Use the button with the arrows pointing to the left to add the users and groups to the Caller Principal list.

                                               iv.       Use the button with the arrows pointing to the right to remove a user or group from the Caller Principal list.

       6.      Use the Add and Remove buttons to add or remove the principals to the Identity Subjects list.

       7.      Use the Clear button to clear the fields for the resource principals.

Editing the Additional Settings

...

       1.      Click the Additional Settings tab.

If you want to deploy a standalone resource adapter component, you will also have to specify the loader references in the Loader References field.

For non-standalone resource adapter components – that is, when the RAR file is deployed within a J2EE application that also contains other components, the loader reference is set to the application level and the resource adapter is loaded with the application loader.

       2.      For the Name Space:

                                                  i.       JNDI Name field - define the name used for binding the resource adapter in the naming. This name is used when you look up the adapter.

                                                ii.       Aliases field - define an alternative name for the resource adapter. It enables you to use the resource adapter from multiple applications.

                                               iii.       Loader References field - define a reference to the classloader that is used to load the resource adapter.

       3.      For the Pool Properties:

                                                  i.       In the Max Connections Number field, set the maximum connections to the Enterprise Information System that can be stored in the connection pool.

                                                ii.       In the Time To Wait Connections field, set the time (in seconds) for the system to wait before creating a new connection if no suitable connection is returned to the pool.

                                               iii.       In the Connections Lifetime field, define how long a connection may be kept in the connection pool.

                                               iv.       In the Run Cleanup Thread field, define how often the system runs a thread that destroys all unused connection objects. The interval is specified in seconds.

       4.      In Additional Properties, set properties that can be used for additional customization after resource adapter deployment. They are key-value pairs.

¡        Set values in the Key and Value fields.

¡        Use the Add and Remove buttons to manage the list with the available additional properties.

Editing the Driver Settings

The driver element defines the driver that can be used by the connector to obtain a connection to a relational database.

The system registers that the specified driver has been deployed with the current application and loads the driver with the application loader. The information in this element includes the driver class name and the archive file name.

...

       1.      The existing drivers are listed in the Drivers list.

       2.      If you want to set a new driver:

                                                  i.       Set a value in the Driver Name field.

                                                ii.       Set a value in the Class Name field.

                                               iii.       Click the Add button.

       3.      Use the Modify, Remove and Clear buttons accordingly.