Sun Java System Application Server Enterprise Edition 8.1 2005Q2 High Availability Administration Guide

Customizing Management Agent Configuration

HADB includes a configuration file that you can use to customize the management agent settings. When you start the management agent without specifying a configuration file, it uses default values. If you specify a configuration file, the management agent will use the settings in that file. You can re-use the configuration file on all hosts in a domain.

ProcedureTo customize the management agent configuration on each HADB host

  1. Edit the management agent configuration file and set the values as desired.

  2. Start the management agent, specifying the customized configuration file as the argument.

Configuration File

With Java Enterprise System, all the entries in the configuration file are commented out. No changes are required to use the default configuration. To customize the management agent configuration, remove the comments from the file, change the values as desired, then start the management agent specifying the configuration file as an argument.

The management agent configuration file is installed to:

With the standalone installer, the management agent configuration file is installed to:

The following table describes the settings in the configuration file.

Table 3–3 Configuration File Settings

Setting Name 

Description 

Default 

console.loglevel

Console log level. Valid values are SEVERE, ERROR, WARNING, INFO, FINE, FINER, FINEST 

WARNING 

logfile.loglevel

Log file log level. Valid values are SEVERE, ERROR, WARNING, INFO, FINE, FINER, FINEST 

INFO 

logfile.name

Name and location of log file. Must be a valid path with read/write access. 

Solaris and Linux:/var/opt/SUNWhadb/ma/ma.log

Windows: HADB_install_dir\ma.log

ma.server.type

Client protocol. Only JMXMP is supported. 

jmxmp 

ma.server.
jmxmp.port

Port number for internal (UDP) and external (TCP) communication. Must be a positive integer. Recommended range is 1024-49151. 

1862 

ma.server.
mainternal.interfaces

Interfaces for internal communication for machines with multiple interfaces. Must be a valid IPv4 address mask. All management agents in a domain must use the same subnet 

For example, if a host has two interfaces, 10.10.116.61 and 10.10.124.61, use 10.10.116.0/24 to use the first interface. The number after the slash indicates the number of bits in the subnet mask. 

None 

ma.server.
dbdevicepath

Path to store HADB device information. 

Solaris and Linux: /var/opt/SUNWhadb/4

Windows: HADB_install_dir \device

ma.server.
dbhistorypath

Path to store HADB history files. 

Solaris and Linux: /var/opt/SUNWhadb

Windows: REPLACEDIR (replaced by the actual URL at runtime.) 

ma.server.
dbconfigpath

Path to store node configuration data. 

Solaris and Linux: /var/opt/SUNWhadb/dbdef

Windows: C:\Sun\SUNWhadb\dbdef

repository.dr.path

Path to domain repository files. 

Solaris and Linux: /var/opt/SUNWhadb/repository

Windows: C:\Sun\SUNWhadb\repository