web server - Borland Technical Publications

Creating and Deploying a DAR
You deploy the DAR containing the descriptor file just as you would any other J2EE
module using either the Console or command-line utilities, or as part of an EAR. You
can deploy any number of distinctly named DARs in the same Partition or to a BES
cluster. Should two or more deployed DARs have resource object definitions with
identical JNDI names, the last deployed module overwrites any existing object binding
on the same node.
Once deployed, resource objects defined in the DAR can be examined in the Naming
Service namespace using the JNDI Browser. See Chapter 9, “Using the JNDI Browser”
for details on using the browser.
Migrating to DARs from previous versions of Borland Enterprise
Server
Previous product versions, including IAS 4.1 and BAS 4.5, did not have a DAR module
to contain the jndi-definitions.xml descriptor. If you have a customized jndidefinitions.xml
file that needs to be transferred to Borland Enterprise Server, follow
these migration steps:
1 If you want the entire contents of the default resources overridden, make a
temporary directory called META-INF and place your existing jndi-definitions.xml file
within it.
2 Open a command window and use the following jar command:
prompt>jar uvMf default-resources.dar META-INF/jndi-definitions.xml
3 Now deploy this module following the usual procedures.
If you have performed only a few customizations on your old jndi-definitions.xml file
then it may be easier to simply move the appropriate XML stanzas from the old file into
the one contained within the pre-deployed DAR.
Creating and Deploying a DAR
The DDEditor walks you through creating a new JNDI Definitions Module. Open the
DDEditor and select “File|New...” The Object Gallery appears.
Figure 21.1
Object Gallery
Select the JNDI Definitions tab and select JNDI Definitions Archive to create a new
DAR. Click OK. You may now add JDBC datasources or add JMS resources. Or, you
may do this later. When you are finished save the module by choosing “File|Save...”.
Chapter 21: Connecting to Resources with BES: using the Definitions Archive (DAR) 193