Configuring the adapter on the server

Once the project enterprise application archive (EAR) file for the adapter project has been installed on the application server, if you want you can reconfigure properties that the adapter uses to set up a communication channel to a specific database application. Then you can start the configured adapter application.

Why and when to perform this task

Normally, the configuration properties are set using the enterprise service discovery wizard when you create your adapter project. You can reset the properties using the WebSphere(R) Process Server administrative console, or you can just note whether the properties are populated according to the values you set in the enterprise service discovery wizard.

Steps for this task

  1. Open the adapter project

    In the WebSphere Process Server administrative console, in the Configuration pane, the name of your adapter project appears. Under the Related Items heading, select Connector Modules. The project RAR file name is displayed. Click the check box next to the file name.

    Under Additional Properties, select Resource Adapter.

  2. Reconfigure properties
    1. Edit J2C connection factory property values

      In the administrative console, your adapter project is displayed under General Properties > Name. On the right side of the window under Additional Properties, click J2C connection factories.

      The adapter project name is displayed along with the JNDI name specified in the EJB project. Click the check box next to your adapter’s factory connection.

      The J2C connection factory properties and values appear. Edit the values for the properties as needed. For details about these properties see "J2C connection factory properties."

    2. Set values for J2C activation specification properties
      If you have not already set these values, follow Step 2a to set the values for the J2C activation specification properties, as needed.
      Important: If you already specified the J2C activation specification properties using the enterprise service discovery wizard, you cannot change the property settings now. After you deploy the project as a new application on the application server, you cannot update the J2C activation specification properties using the WebSphere Process Server administrative console. If you try to update the settings, the adapter will not recognize the updated values. If you did not set the J2C activation specification properties before installing the project on the application server, you can set these property values now.

      To set these properties, under Additional Properties click J2C activation specifications. For details about these properties see "J2C activation specification properties."

    3. Edit the Resource adapter property values
      Under Additional Properties, click Custom properties. A list of the Resource adapter properties and their values is displayed. Edit the property values as needed. See the properties and their descriptions in "Resource adapter properties."
      Note: In the Custom properties list, at the adapter level, find the DatabaseVendor property. This property is required for starting the application. Enter a value for this property if it is blank, and save it.
  3. Start the adapter application

    In the administrative console, in the panel on the left side, click Applications > Enterprise Applications. In the Enterprise Applications pane, click the check box next to your application’s name and click Start. A message will indicate that the application started successfully. If problems occur when you try to start the application, check the adapter log file for error descriptions.

    For information on specific messages, see Messages in the IBM WebSphere Adapters Information Center. For details on logging and tracing, see "Troubleshooting."

Related tasks
Troubleshooting
Related reference
J2C connection factory properties
J2C activation specification properties
Resource adapter properties

Terms of use |

Last updated: Thu Mar 23 13:24:31 2006

(c) Copyright IBM Corporation 2005.
This information center is powered by Eclipse technology (http://www.eclipse.org)