user manual

Chapter 21: Connecting to Resources with BES: using the Definitions Archive (DAR) 223
You can create a new DAR by simply providing a descriptor file in the directory
structure above, JARing it into a DAR, and deploying it to a Partition using the
server's tools. Or, you can run the DDEditor and select File|New|JNDI
Definitions Module and allow the DDEditor to walk you through the creation
procedure from scratch. Or, of course, you can edit the existing one.
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 jndi-definitions.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 new JNDI Definitions Module
The DDEditor walks you through creating a new JNDI Definitions Module from
scratch. Open the DDEditor and select "File|New..." The Object Gallery
appears.