HMA Configurations

All the required configuration parameters are stored in CONFIG_FOLDER/bin/hawkhma.cfg. The following table describes various HMA configuration properties in easy-to-understand logical groups. The various groups are as follows:

HMA Configuration Properties

Logical Group

Parameters

TIBCO HMA Common

-hawk_domain <TIBCO Hawk domain name>

 

-agent_name <agent name>

 

-agent_domain <agent domain name>

TIBCO Rendezvous (RVD) Session

-rvd_session <service> <network> <daemon>

Logging Information

-logdir <directory to store HMA logs>

 

-logmaxsize <maximum size of one HMA log>

 

-logmaxnum <maximum number of HMA logs>

 

-log_format <Hawk or ActiveEnterprise format>

Timeout

-timeout <milliseconds>

Trace Level

-tracelevel <desired trace level>

UNIX Signal Handling

-ignore_sigint

 

-ignore_sigterm

 

-ignore_sigabrt

Encoding

-codepage

Each of the parameters listed above are explained in more detail, in the following table.

HMA Configuration Parameter Details

Property

Mandatory

Default Value

Description

TIBCO HMA Common

-hawk_domain

Yes

“default”

See Hawk Domain for details.

-agent_name

Yes

Host Name of the computer

Name of the agent. Ensure that the output of the '/usr/bin/hostname' UNIX command matches with the 'hostname' specified in the /etc/hosts file.

For example, if the value of hostname is linux64 then the /etc/hosts file should have the entry, such as, 192.168.1.100 linux64.

-agent_domain

Yes

“none”

An agent domain must be specified when two computers within the same TIBCO Hawk domain have the same name but reside in different network domains. For example, you might specify this option as: -agent_domain pa.tibco.com.

TIBCO Rendezvous Transport

-rvd_session

No

7474 "" tcp:7474

Comment this option if you are using TCP Transport for TIBCO Hawk or TIBCO EMS as the primary transport.

However, if you are using TCP Transport for TIBCO Hawk then uncomment this option, so that Hawk Agent can communicate with Hawk Microagent using the TCP-RV bridge. The value of this parameter must be same as the value of the -ami_rvd_session parameter in the Hawk Agent configuration file (hawkagent.cfg).

The format is -rvd_session <service> <network> <daemon>.

If you use this option, all three parameters must be present and separated by white space. Use a semicolon (;) to indicate a null value, or use an empty string, for example:

-rvd_session 7474 "" tcp:7474

Logging

-logdir

No

CONFIG_FOLDER/logs

The directory in which to store log files generated by the TIBCO Hawk HMA.

-logmaxsize

No

1024

The maximum size of a rotating log files in Kbytes.

-logmaxnum

No

5

The maximum number of rotating log files

-log_format

No

“default”

The format for trace log messages

Timeout

-timeout

No

10000

The method invocation timeout period to be used by all AMI methods. Timeout value is in milliseconds.

Trace Level

-tracelevel

No

7

Specifies the level of diagnostic trace output. The desired trace level is specified by adding the following values together:

1 - Indicates information level trace messages should be enabled.

2 - Indicates warning level trace messages should be enabled.

4 - Indicates error level trace messages should be enabled.

8 - Indicates debug level trace messages should be enabled.

16 - Indicates AMI level trace messages should be enabled.

32 - Adds source file name and line number to all messages.

A value of zero turns all tracing off

A value of -1 turns all tracing on.

Unix Signal Handling

-ignore_sigint

No

-

Ignore SIGINT signal

-ignore_sigterm

No

-

Ignore SIGTERM signal

-ignore_sigabrt

No

-

Ignore SIGABRT signal

Encoding

-codepage

No

65001 (UTF-8)

The desired code-page for multi-byte/Unicode character sets