Font size:
AtgDasServer
An ATG DAS application server
Overview
AtgDasServer :
An ATG DAS application server
Design
Super Type
AtgAppServer
Role
Abstract . (Objects cannot be created.)
Instance Names
Unique
Notification
false
Template Directory
${modules.dir}/AtgAppServer/templates
Data View
Children,
proximity:
1
Logger Name
AtgAppServer
Constraints
Allowed Child Dependencies
AtgAppServername1
AtgDirlist1
AtgRmiPort1
AtgSwitchingDataStore1
1 : These types have a Singleton constraint. Only one instance may be added as a resource.
Allowed Parent Dependencies
Allowed Property Values
Property
Allowed Values
Default
Enforced
deployment-install-root
/opt/Dynamo7/ATG2006.3
/opt/Dynamo7/ATG7.0
false
deployment-basedir
/opt/Dynamo7/ATG2006.3/home
/opt/Dynamo7/ATG7.0/home
false
Attributes
Exported Attributes
Name
Property
dynamo_home
deployment-basedir
dynamo_root
deployment-install-root
Defaults for Imported Attributes
Name
Default
dirlist
data,j2ee/runtime,localconfig/atg,localconfig/atg/dynamo,logs/archives,pagebuild,sessionswap
Commands
Note
Commandline options displayed in square brackets "[]" are optional. If an option expects arguments, then angle brackets are shown after the option "<>". Any default value is shown within the brackets.
retryIsDownService
checks status repeatedly up to status_retrymax sleeping status_waitinterval
Usage
retryIsDownService [-dynamo_home <>] [-dynamo_root <>] [-name <>] [-status_retrymax <5>] [-status_waitinterval <60>]
Execution
bash
Arguments
${antdepo.home}/bin/ad-sh -M ${modules.dir}/AtgAppServer/lib/ad-sh -m init -c down -- -pidfile ${opts.dynamo_home}/servers/${opts.name}/logs/dynamo.pid && { exit 0; } || { cnt=1; while [ "$cnt" -le "${opts.status_retrymax}" ]; do echo "${opts.name} not down. Will recheck in ${opts.status_waitinterval} seconds (retries: $cnt of ${opts.status_retrymax}) ..."; sleep ${opts.status_waitinterval}; ${antdepo.home}/bin/ad-sh -M ${modules.dir}/AtgAppServer/lib/ad-sh -m init -c down -- -pidfile ${opts.dynamo_home}/servers/${opts.name}/logs/dynamo.pid && { echo "dynamo DOWN"; exit 0; } || { [ "$cnt" = "${opts.status_retrymax}" ] && { echo "${opts.name} still not down after $cnt retries. returning with exitcode 1"; exit 1; }; }; cnt=`expr $cnt + 1`; done; exit 1; }
Options
Option
Description
dynamo_home
the DYNAMO_HOME setting
dynamo_root
the DYNAMO_ROOT setting
name
the dynamo server name
status_retrymax
max times to retry check
status_waitinterval
seconds to wait before next check
assertServiceIsUp
Checks if dynamo is running
Usage
assertServiceIsUp [-basedir <>] [-name <>]
Execution
bash
Arguments
${antdepo.home}/bin/ad-sh -M ${modules.dir}/AtgAppServer/lib/ad-sh -m init -c up -- -pidfile ${opts.basedir}/logs/dynamo.pid
Options
Option
Description
basedir
server base dir
name
server to check
maybeKillService
calls retryIsDownService and if that fails calls killService
Usage
maybeKillService
Workflow
retryIsDownService
Error Handler
invalidateCache
tells server to invalidate its cache
Usage
invalidateCache [-rmiport <>]
Options
Option
Description
rmiport
rmi control port
isNucleusRunning
searches dynamo.log for "Nucleus running" text
Usage
isNucleusRunning [-name <>]
Execution
bash
Arguments
grep "Nucleus running" ${user.home}/atg/server/${opts.name}/logs/dynamo.log || { echo not running ; exit 1 ; }
Options
Option
Description
name
atg instance name
runStopDynamo
stop the service process
Usage
runStopDynamo [-dynamo_root <>] [-name <>]
Execution
bash
Arguments
${opts.dynamo_root}/home/bin/stopDynamo ${opts.name} -user admin -password admin
Options
Option
Description
dynamo_root
the DYNAMO_ROOT setting
name
the dynamo server name
mkdirStructure
creates directories and makes necessary symlinks
Usage
mkdirStructure [-dirlist <>] [-dynamo_root <>] [-name <>]
Execution
bash
Arguments
mkdir -p ${user.home}/atg/server/${opts.name}; [ -h ${opts.dynamo_root}/home/servers/${opts.name} ] || { ln -s ${user.home}/atg/server/${opts.name} ${opts.dynamo_root}/home/servers/${opts.name}; }; IFS=, for subdir in ${opts.dirlist}; do mkdir -p ${user.home}/atg/server/${opts.name}/$subdir; done
Options
Option
Description
dirlist
relative sub directory list
dynamo_root
dynamo install root
name
atg server name
stopService
stops the dynamo instance
Usage
stopService [-dynamo_root <>] [-name <>]
Workflow
stopAcceptingNewSessions
stopService
Error Handler
Options
Option
Description
dynamo_root
the dynamo install dir
name
server name
startService
starts the dynamo instance
Usage
startService [-dynamo_root <>] [-java_home </usr/java>] [-name <>]
Execution
bash
Arguments
export JAVA_HOME=${opts.java_home}; ${antdepo.home}/bin/ad-sh -M ${modules.dir}/AtgAppServer/lib/ad-sh -m init -c nohupStart -- -x ${opts.dynamo_root}/home/bin/startDynamo ${opts.name}
Options
Option
Description
dynamo_root
Dynamo install root
java_home
Defines JAVA_HOME environment variable
name
server name
assertServiceIsDown
Checks if dynamo is down
Usage
assertServiceIsDown [-basedir <>] [-name <>]
Execution
bash
Arguments
${antdepo.home}/bin/ad-sh -M ${modules.dir}/AtgAppServer/lib/ad-sh -m init -c down -- -pidfile ${opts.basedir}/logs/dynamo.pid
Options
Option
Description
basedir
deployment basedir
name
server to check
killService
kills the service process
Usage
killService [-dynamo_root <>] [-name <>]
Execution
bash
Arguments
${opts.dynamo_root}/home/bin/stopDynamo ${opts.name} -user admin -password admin -kill
Options
Option
Description
dynamo_root
the DYNAMO_ROOT setting
name
the dyanamo server name
AtgDasServer:
An ATG DAS application server