ControlTier > elements
 

TomcatSite

Centralized management for a set of Tomcat based application server instances and contexts.

Overview

TomcatSite: Centralized management for a set of Tomcat based application server instances and contexts.

This type facilitates management of a scenario where there are multiple TomcatContext objects and a TomcatServer object. The TomcatServer and TomcatContext objects will be deployed as child dependencies of a TomcatSite object. All three types will be deployed locally to the node where the TomcatServer will run. (This is contrary to the usual practice of deploying Site objects to the server where they can be used in Jobcenter. In this sense, it may help to think of TomcatSite as the replacement for a Service type; it is deployed locally and then can be added to normal Sites deployed on the server node.)

The standard service commands such as Start, Stop, or Restart can be run against objects of this type; the commands will be dispatched to its dependencies.

Design

Super Type
Site
Role Concrete. (Objects can be created.)
Instance Names Unique
Notification false
Template Directory
Data View Children, proximity: 1
Logger Name TomcatSite

Constraints

Allowed Child Dependencies

  • DefaultAllowMultiplePackageMatches1
  • DefaultDeploymentType1
  • DefaultFailIfPackageNotReplaced1
  • DefaultPackageName1
  • DefaultPackageType1
  • DispatchBaseType1
  • DispatchChangeDependencies1
  • DispatchExecutionStrategy1
  • DispatchOptions1
  • DispatchResourceName1
  • DispatchResourceType1
  • DispatchSortOrder1
  • DispatchThreadCount1
  • TomcatContext
  • TomcatServer

1: These types have a Singleton constraint. Only one instance may be added as a resource.

Allowed Parent Dependencies

  • Node
  • Site
  • Updater

Attributes

Most of these attributes are standard and can be set via the usual correspondingly-named settings. For most use cases, the defaults are sufficient.

Exported Attributes

Name Property
basedir deployment-basedir
install-root deployment-install-root

Defaults for Imported Attributes

Name Default Description
defaultAllowMultiplePackageMatches false
defaultDeploymentType Deployment
defaultFailIfPackageNotReplaced true
defaultPackageName ^$
defaultPackageType Package
dispatchBaseType (?:deployment|service|mediator)
dispatchChangeDependencies false
dispatchExecutionStrategy localdispatch This type only dispatches locally since it is meant to be deployed alongside the service types.
dispatchOptions
dispatchResourceName .*
dispatchResourceType [^\.]*
dispatchSortOrder ascending
threadCount 1 This value to avoid race conditions; if you're sure of what you're doing, you can change this in certain situations.

Commands

View the available commands in the User Reference.