In order to configure an ATG server instance to participate in a configuration group, the following properties must be set before startup in Configuration.properties, in one of the following locations:

<ATG9dir>/home/localconfig/atg/dynamo/service/groupconfig/
<ATG9dir>/home/servers/serverName/localconfig/atg/dynamo/
service/groupconfig
/

Property

Type

Description

groupName

String

A unique string that defines the group. All group members must set this property to the same value.

defaultMasterServer

boolean

Set to true for one ATG instance in the group, designates this configuration server to serve as the primary master. If set to true, the property serverEnabled must also be set to true. All other configuration servers in the group should set this property to false.

serverEnabled

boolean

Set to true for all primary and backup configuration server instances in the group.

clientEnabled

boolean

Set to true on every configuration client, enables an ATG instance to participate in a configuration group.

clientNodeType

String

Required for all enabled configuration client instances, associates a configuration client with settings that are specific to that node type. All configuration clients of the same node type must set this property to the same value.

For example, you might configure a master configuration server as follows:

groupName=myUniqueGroupName
defaultMasterServer=true
serverEnabled=true
clientEnabled=true
clientNodeType=generic
Optional Properties

You can also set the following properties in Configuration.properties:

Property

Type

Description

autoDiscoveryEnabled

boolean

Specifies whether auto-discovery is enabled.

httpPort

int

The HTTP port for this ATG instance.

httpsPort

int

The HTTPS port for this ATG instance.

startingServerUrls

URL[]

The array of starting servers. This property is required if your configuration group spans network subnets, or Auto-Discovery is disabled.

Configuration Server and Configuration Client Properties

You can set all required group configuration properties in Configuration.properties, as described earlier. If desired, you can fine-tune the behavior of configuration servers and configuration clients by setting their properties directly. For example, after detecting the failure of the master configuration server, by default a backup configuration server immediately assumes the master role or looks for another backup configuration server to assume that role. If desired, you can specify a latency period for a given configuration server by setting its WaitBeforeBecomingServerTimeout property.

Viewing Group Properties

At runtime, you can use the Dynamo Administration Component Browser to view the properties of all configuration client and configuration server components, in this Nucleus directory:

/atg/dynamo/service/groupconfig/

After the master configuration server collects all configuration properties from configuration clients in its group, you can review configuration errors by pointing the Component Browser at the master configuration server component. You can also review the settings that are currently in effect for the group.

 
loading table of contents...