Using the startDynamoOnJBOSS Script

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:

  1. Calls runAssembler with a destination EAR file called ATG.ear in the <JBOSS_HOME>/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 <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).

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

You can specify a JBOSS_HOME when running the startDynamoOnJBOSS script:

bin\startDynamoOnJBOSS -j c:\workstuff\jboss-4.0.3SP1

You want to use a specific Dynamo 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 default server

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

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

 
loading table of contents...