uCosminexus Application Server, Application Setup Guide

[Contents][Index][Back][Next]

1.2.2 Setup for resource adapters

This subsection describes the setup of resource adapters deployed and used as J2EE resource adapters.

Organization of this subsection
(1) Types of resource adapters
(2) Flow of resource adapter management
(3) Setup of resource adapters

(1) Types of resource adapters

The types of resource adapters deployed and used as the J2EE resource adapters are as follows:

(2) Flow of resource adapter management

The basic flow of resource adapter management is as follows:

  1. Importing the resource adapters
  2. Defining the resource adapter properties
  3. Deploying the resource adapters
  4. Testing the J2EE resource adapters for connectivity
  5. Starting and stopping the J2EE resource adapters
  6. Exporting the J2EE resource adapters

The description of above procedures is as follows:

Importing the resource adapters

You import the resource adapter.

Defining the resource adapter properties

You define the information required for connecting to a database.

Deploying the resource adapters

You deploy the imported resource adapter as a J2EE resource adapter. You can use the resource adapter deployed as the J2EE resource adapter from all the J2EE applications running on the J2EE server.

Testing the J2EE resource adapters for connectivity

You execute the connectivity test and confirm that the J2EE resource adapters are running correctly.

Starting and stopping the J2EE resource adapters

You start the J2EE resource adapters for which the setup is complete. Furthermore, stop the J2EE resource adapters according to the operations.

Exporting the J2EE resource adapters

You export the J2EE resource adapters according to the operations.

To connect to a database, you must specify the database settings.

Furthermore, if you want to use resource adapters, you must resolve the resource adapter references in J2EE applications. You resolve the resource adapter references by customizing J2EE applications. For an overview of customization of J2EE applications, see 1.3 Managing J2EE applications.

(3) Setup of resource adapters

The following table describes the functions of the setup to be used in the resource adapter management.

Table 1-2 Setup used in resource adapter management

Operations in J2EE resource management Functions Commands
Import the resource adapters Imports the resource adapters into the J2EE server. cjimportres (-type rar specified)
Define the resource adapter properties Obtains the pre-deployment resource adapter properties and generates a property file. cjgetresprop (-type rar specified)
Changes the values of the pre-deployment resource adapter properties to the values specified in the property file. cjsetresprop (-type rar specified)
Obtains the properties of the deployed J2EE resource adapters and generates the property file. cjgetrarprop
Changes the property values of the deployed J2EE resource adapters to the values specified in the property file. cjsetrarprop
Deploy the resource adapters Deploys the resource adapter. cjdeployrar
Test the J2EE resource adapters for connectivity Executes the connectivity test for the J2EE resource adapter. cjtestres (-type rar specified)
Start and stop the J2EE resource adapters Starts the J2EE resource adapter. cjstartrar
Stops the J2EE resource adapter that is running. cjstoprar
Export the J2EE resource adapters Exports the resource adapter residing on the J2EE server. cjexportrar
Display the list of resources Displays the list of the imported resource adapters. cjlistres (-type rar specified)
Displays the list of the J2EE resource adapters. cjlistrar
Delete the resources Deletes the resource adapters. cjdeleteres (-type rar specified)
Un-deploys the J2EE resource adapters. cjundeployrar
Other operations Displays the status of the resource adapter connection pool. cjlistpool#1
Deletes connections of the resource adapter connection pool. cjclearpool#1
Temporarily stops the member connection pool of the cluster connection pool. cjsuspendpool#2
Restarts the member connection pool of the cluster connection pool that is temporarily stopped. cjresumepool#2
Copies the resource adapter properties. cjcopyres (-type rar specified)

#1
If you use DB Connector to cluster the connection pool, you cannot use this command for root resource adapters. You can use the command for the member resource adapters.

#2
You can use this command only for the member resource adapters for which you use DB Connector to cluster the connection pools.