Using the startDynamoOnJBOSS Script

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:

  1. Calls runAssembler with a destination EAR file called ATG.ear in the <JBdir>/server/atg/deploy directory. This directory is created by the ATG installer.

  2. 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.

  3. Assembles the EAR in exploded format in development mode (rather than packed format or standalone mode).

  4. 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).

  5. 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 JBOSS_HOME environment variable set

You can specify a JBOSS_HOME when running the startDynamoOnJBOSS script:

bin\startDynamoOnJBOSS -j c:\jboss

You want to use a specific ATG server

bin\startDynamoOnJBOSS [servername]

You want to use more modules than just DSS (the default)

bin\startDynamoOnJBOSS -m module-list

You want to use a JBoss server other than the \atg server created by the ATG installer

You can pass in a different server name using the -c flag:

bin\startDynamoOnJBOSS -c someOtherServer

You want to use a different name for the EAR file

Pass in the new EAR file name using the -ear flag:

bin\startDynamoOnJBOSS -ear ServiceKnowledge.ear

You want to pass additional flags to runAssembler.

Pass in additional flags using the –f flag:

startDynamoOnJBOSS -f -run-in-place

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 runAssembler–prependJars flag, use the following syntax:

-f C:\\myclasses.jar -f -prependJars

To see all syntax options for the startDynamoOnJBOSS script, run the script with the -help flag. Also see the ATG Programming Guide.

Note that if you are using runAssembler alone, the –layer switch must precede the –m switch, however, this it may come after –m when using startDynamoOnJBOSS.

 
loading table of contents...