The startDynamoOnJBOSS
script simplifies the process of assembling, deploying, and starting a Dynamo application on JBoss.
Note: 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, use the manual deployment methods described previously in this chapter.
This script makes it easy to run Dynamo applications on the JBoss application server. It combines the manual steps of assembling the EAR file, copying over any needed data source definitions, and starting the JBoss server, into one step. See the Assembling Applications section of the ATG Programming Guide for information on these manual steps.
If you already have JBOSS_HOME set in your dasEnv
file (this is set by the installer if you installed Dynamo for use with JBoss), then go to <DYNAMO_HOME>\home\bin
and type:
startDynamoOnJBOSS –m module-list
The script performs the following actions:
Calls
runAssembler
with a destination EAR file calledATG.ear
in the<JBOSS_HOME>/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
<JBOSS_HOME>/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.
Dynamo 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 | You can specify a
|
You want to use a specific Dynamo server |
|
You want to use more modules than just DSS (the default) |
|
You want to use a JBoss server other than the default server | 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
|
To see all syntax options for the startDynamoOnJBOSS
script, run the script with the -help
flag.