InfoCenter Home >
6: Administer applications >
6.6: Tools and resources quick reference >
6.6.42: Administering J2C related administrative resources (overview)
6.6.42: Administering J2C related administrative resources (overview)
To deploy and assemble your application, you use a combination of the:
In general, the flow looks like this:
- Convert the EJB 1.0 jar file (.ser) to EJB 1.1 jar (.xml) and generate the deployment code.
- Assemble the EJB JAR file and application client JAR file into a J2C application (.ear).
- Define the J2C Resource Adapters and Connection Factories.
- Install the application and resolve any References.
- Run the application.
Convert the EJB JAR file and generate the deployment code
During this step, you will convert the EJB 1.0 JAR file (.ser) to an EJB 1.1 JAR file (.xml),
and generate the deployment code.
- Open a system command prompt.
- Change directory to the product_installation_root/bin directory.
- Execute the command:
ejbdeploy YourFilename.jar tmp YourFilenameDep.jar
where YourFilename.jar is the fully-qualified EJB 1.0 JAR file to
be converted, tmp is a directory for temporary files, and YourFilenameDep.jar
is the fully-qualified name of the new file for the converted EJB 1.1 JAR.
Assemble the EJB JAR file and application client JAR file into a J2EE application
- Open the Application Assembly Tool.
- Using the the AAT instructions, create an application:
- Under File -> New -> Application, provide properties
and change the Display name: to (for example) YourApp.ear.
- Import the EJB 1.1 jar (the deployed .jar file you created in the
previous step (Convert the EJB JAR file and generate the deployment code).
- Use File -> SaveAs to save the .ear (enterprise application archive) file in the sought location.
- Exit the Application Assembly Tool.
Define the J2C Resource Adapters and Connection Factories
Use the administrative console to define the J2C Resource Adapters and Connection Factories.
To define the J2C Resource Adapter, complete the following steps:
- Open the administrative console.
- Expand the tree view to Resources -> J2C Resource Adapters.
- Right click the J2C Resource Adapter folder and click New....
- Enter the resource adapter properties.
Use the Browse [...] button located next to the Archive file name on the
properties dialog to browse for the .rar file that you downloaded from the Web site
in Installing the J2C (Beta) Resource Adapters, such
as cicseci.rar.
- Click OK. If you look on the Node tab you should now see your Resource
Adapter installed and configured on your node.
Notes:
-
After finding and loading the .rar file, the Connections and Advanced
tabs should contain the read-only contents of the ra.xml descriptor within
the .rar file. These values will be propagated to the Connection
Factory when you create it.
- By default, the Resource Adapter is created on the current node. Another
tabbed page in J2C Resource Adapter properties enables you to create
the Resource Adapter on additional nodes.
To define the Connection Factory, complete the following steps:
- Open the administrative console.
- Expand the tree view to Resources -> J2C Resource Adapters -> adapter_name -> J2C Connection Factories.
- Right click the J2C Connection Factories folder and click New....
- Enter the resource adapter properties.
- Click OK. You should now see your Connection Factory created
and associated with your Resource Adapter.
For another way to define J2C Resource Adapters and Connection
Factories, see Specifying a J2C connection
factory.
Install the application and resolve any References
Here, the procedure is outlined for installing the application, with links
to detailed instructions for each step. Depending on the complexity of the .ear
file that you are installing, you might need to specify values for fields that
are not discussed here. See the enterprise application properties.
- Open the administrative console.
- Create a new application server if you do not have one already.
- Install the enterprise application (.ear file).
Notes:
-
When you get to the Mapping Resource References to Resources panel, the resource-ref
entries as defined by your bean should be listed on the left side.
For each resource-ref, click Select Resource and select the
defined (J2C Connection Factory) resource that you
previously configured.
- On the Deploy window, click No when asked whether the application
should be redeployed.
Run the application
To run the application, you start and use a configured application server
just as you would for any other IBM WebSphere enterprise application. For
more information, see the administrative overview of
application servers.
|