<orion-application auto-alter-tables="true|false" auto-create-tables="true|false" auto-delete-tables="true|false" default-data-source="jdbc/MyDS" deployment-version="x.x.x" treat-zero-as-null="true|false">
An orion-ejb-jar.xml file contains the deploy-time info for an application. It is located in ORION_HOME/application-deployments/deploymentName/orion-application.xml after deployment and META-INF/orion-application.xml below the application root if bundled with the application or if no deployment-directory is specified in server.xml. If using deployment-directory (which is the default) the bundled version will be copied to the deployment location if and only if no file exists at that location. It is used to specify initial (first time) deployment properties. After each deployment the deployment file is reformatted/augmented/altered by the server to add any new/missing info to it.

auto-alter-tables - Whether or not to automatically alter old database tables to add new columns for CMP beans when redeploying in this application. The default is false, reason being increased deployment time for most databases.
auto-create-tables - Whether or not to automatically create database tables for CMP beans in this application. The default is true.
auto-delete-tables - Whether or not to automatically delete old database tables for CMP beans when redeploying in this application. The default is false.
default-data-source - The default data-source to use if other than server default. This must point to a valid CMT (ejb-location) data-source for this application if specified.
deployment-version - The version of Orion this jar was deployed with, if it's not matching the current version then it will be redeployed. (internal server value, do not edit)
treat-zero-as-null - Whether or not to treat read zero's as null's when they represent primary keys. The default is false.


<ejb-module path="myEjbs.jar" remote="true|false" />
A ejb-jar module of the application.

path - The path (relative to the enterprise archive or absolute) to the ejb-jar.
remote - true/false value stating whether or not to activate the EJB instances on this node or to look them up remotely from another server (remote or inside a cluster).


<web-module id="myWebApp" path="myWebApp.war" />
A web-application module of the application. Each web-application can be installed on any site and in any context on those sites (for instance http://www.myserver.com/myapp/).

id - The name used to reference this web-application when used in web-sites etc.
path - The path (relative to the enterprise archive or absolute) to the web-application.


<client-module auto-start="true|false" deployment-time="073fc2ab513bc3ce" path="myappclient.jar" user="theUser">
An application-client module of the application. An app-client is a GUI or console-based standalone client that interracts with the server.

auto-start - Whether or not to auto-start the client (in-process) at server startup. The default is false.
deployment-time - Last deploy-time attribute. Internal to Orion, do not edit.
path - The path (relative to the enterprise archive or absolute) to the application-client.
user - User to run the client as if run in-crocess (autostart="true"). Must be specified if auto-start is activated.


<arguments>
A list of arguments to used when invoking the app-client if starting it in-process (auto-start="true").

<argument value="theValue" />
An argument used when invoking the client.

value - The value of the argument.


 
 
<connector-module default-location="myConnector/" name="MyConnector" path="myconnector.rar" />
An connector module of the application. A connector is an interface to an underlying business system.

default-location - The base for resource adapter JNDI names.
name - The connector archive deployment name.
path - The path (relative to the enterprise archive or absolute) to the connector-archive.


<security-role-mapping impliesAll="true|false" name="theRole">
The runtime mapping (to groups and users) of a role. Maps to a security-role of the same name in the assembly descriptor.

impliesAll - Whether or not this mapping implies all users. The default is false.
name - The name of the role


<group name="theGroup" />
A group that this security-role-mapping implies. Ie all the members of the specified group are included in this role.

name - The name of the group.


<user name="theUser" />
A user that this security-role-mapping implies.

name - The name of the user.


 
<persistence path="./persistence" />
A relative (to the application root) or absolute path to a directory where application state should be stored across restarts.

path - The path (relative to the enterprise archive or absolute) to the persistence directory.


<library path="../lib/" />
A relative/absolute path/URL to a directory or a .jar/.zip to add as a library-path for this server. Directories are scanned for jars/zips to include at startup.

path - The path.


<resource-provider class="com.co.MyProvider" name="myProvider">
A relative/absolute path/URL to a directory or a .jar/.zip to add as a library-path for this server. Directories are scanned for jars/zips to include at startup.

class - The class of the resource provider implementation.
name - The name of the resource provider. This determines JNDI namespace location.


<property name="theName" value="theValue" />
Contains a name/value pair initialization param.

name - The name of the parameter.
value - The value of the parameter.


 
<principals path="principals.xml" />
A relative (to the application root) or absolute path to a principals XML-file containing the users/groups for this application.

path - The path (relative to the enterprise archive or absolute) to the principals file.


<mail-session location="mail/TheSession" smtp-host="smtp.server.com">
The session SMTP-server host (if using SMTP).

location - The location in the namespace to store the session at.
smtp-host - The session SMTP-server host (if using SMTP).


<description>A short description</description>
A short description of this component.

<property name="theName" value="theValue" />
Contains a name/value pair initialization param.

name - The name of the parameter.
value - The value of the parameter.


 
<user-manager class="com.name.of.TheUserManager" display-name="Friendly UserManager name">
Specifies an optional user-manager to use, example user-managers are com.evermind.sql.DataSourceUserManager, com.evermind.ejb.EJBUserManager, etc... Used to integrate existing systems and provide custom user-managers for web-applications.

class - The fully qualified classname of the user-manager.
display-name - A descriptive name for this UserManager instance.


<description>A short description</description>
A short description of this component.

<property name="theName" value="theValue" />
Contains a name/value pair initialization param.

name - The name of the parameter.
value - The value of the parameter.


 
<log>
Logging settings.

<file path="../log/server.log" />
A relative/absolute path to log events to.

path - The path.


<mail address="my@mail.address" />
A e-mail address to log events to. A valid mail-session also needs to be specified if this option is used.

address - The mail-address.


<logger class="com.co.MyLogger">
A custom logger of application events

class - A class implementing com.evermind.util.Logger that will be sent application events


<property name="theName" value="theValue" />
Contains a name/value pair initialization param.

name - The name of the parameter.
value - The value of the parameter.


 
 
<data-sources path="./data-sources.xml" />
Defines the relative/absolute path to a data-sources XML-file containing the installed datasources on this server.

path - The path.


<namespace-access>
Namespace (naming context) security policy for RMI clients.

<read-access>
The read-access policy.

<namespace-resource root="the/path">
A resource with a specific security setting.

root - The root of the part of the namespaec that this rule applies to.


<security-role-mapping impliesAll="true|false" name="theRole">
The runtime mapping (to groups and users) of a role. Maps to a security-role of the same name in the assembly descriptor.

impliesAll - Whether or not this mapping implies all users. The default is false.
name - The name of the role


<group name="theGroup" />
A group that this security-role-mapping implies. Ie all the members of the specified group are included in this role.

name - The name of the group.


<user name="theUser" />
A user that this security-role-mapping implies.

name - The name of the user.


 
 
 
<write-access>
The write-access policy.

<namespace-resource root="the/path">
A resource with a specific security setting.

root - The root of the part of the namespaec that this rule applies to.


<security-role-mapping impliesAll="true|false" name="theRole">
The runtime mapping (to groups and users) of a role. Maps to a security-role of the same name in the assembly descriptor.

impliesAll - Whether or not this mapping implies all users. The default is false.
name - The name of the role


<group name="theGroup" />
A group that this security-role-mapping implies. Ie all the members of the specified group are included in this role.

name - The name of the group.


<user name="theUser" />
A user that this security-role-mapping implies.

name - The name of the user.