The startDynamoOnJBOSS
script makes it easy to run ATG applications on the JBoss application server. It combines the manual steps of assembling the EAR file, copying over the SOLID data source definitions required by the demo applications, and starting the JBoss server, into one step. See the Assembling Applications section of the ATG Programming Guide for information on these manual steps and on runAssembler
options.
This script is intended to be used by developers who need to rapidly and iteratively build, deploy, and run applications to see their changes. You should not use this script on a production site, or under any circumstances where it is important to closely watch the deployment process, such as when deploying to multiple servers. Instead, deploy your application manually.
If you already have JBOSS_HOME set in your dasEnv
file (this is set by the installer if you installed ATG for use with JBoss), then go to <ATG9>\home\bin
and type:
startDynamoOnJBOSS –m module-list
Note: If you are including the Dynamo Administration UI in this EAR file, the DafEar.Admin
module must precede any custom modules in the module list.
The script performs the following actions:
Calls
runAssembler
with a destination EAR file calledATG.ear
in the<JBdir>/server/atg/deploy
directory. This directory is created by the ATG installer.Includes the modules you specify and their dependent modules in the EAR file. If none are specified, the script includes
DSS
,DAS-UI
and all of their dependent modules.Assembles the EAR in exploded format in development mode (rather than packed format or standalone mode).
Copies data source XML files into the
<JBdir>/server/atg/deploy
directory to ensure that there are valid data sources for standard logins such as admin, motorprise, publishing, svcss, and svcshared (see the Configuring Data Sources for JBoss section of this guide).Calls the JBoss
run.sh/bat
script.
ATG starts up on JBoss with the specified modules.
The following table describes the syntax to use if you do not want the default settings to apply:
Intended Result | Syntax |
---|---|
You don’t have a | You can specify a
|
You want to use a specific ATG server |
|
You want to use more modules than just DSS (the default) |
|
You want to use a JBoss server other than the | You can pass in a different server name using the
|
You want to use a different name for the EAR file | Pass in the new EAR file name using the
|
You want to pass additional flags to | Pass in additional flags using the
Note that for flags that pass in additional information, those additional arguments have to go before the flag itself. For example, if you want to pass in the
To see all syntax options for the Note that if you are using |