Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 2 Installation and Basic Configuration : Configuration

Configuration
After installing TIBCO Hawk and the Admin Agent, you must do the following:
Configure the Hawk domain and transport to be used in the <CONFIG_FOLDER>\tibco\cfgmgmt\hawkteaagent\config\hawk-domain-transport-cfg.xml file. See Hawk Domain and Transport Configuration.
Transport Installation Location Configuration
The following transport modes are available to be configured as a means of communication between Hawk Agent and Admin Agent:
At least one transport mode should be configured in the <CONFIG_HOME>/tibco/cfgmgmt/hawkteaagent/config/hawk-domain-transport-cfg.xml file of Admin Agent to enable message or event communication among various Hawk Agent and Admin Agent.
TIBCO Hawk installation has TIBCO Rendezvous configured as the default mode of message and event transport between Hawk Agent and HMA, as well as between Hawk Agent and Hawk WebConsole.
For details on configuration for all transport modes, refer to the ’Configuring Transport Modes’ section in the TIBCO Hawk Installation, Configuration, and Administration guide.
TIBCO Rendezvous and TIBCO Enterprise Message Service are two independent products that need to be installed separately. Additional configurations need to be performed manually based on whether they are installed before or after installing TIBCO Hawk, and whether any of them share the same <TIBCO_HOME> installation folder.
If you install TIBCO Rendezvous and TIBCO Enterprise Message Service before you install TIBCO Hawk and you install all three in the same TIBCO_HOME, the installers will automatically configure their values in the tibhawkteaagent.tra configuration file and you need not do it manually. Update the <TIBCO_HOME>/tea/agents/hawk/<version>/bin/tibhawkteaagent.tra file for <EMS_HOME> and <RV_HOME> if any of the following is true:
If you currently use or are planning to use a different TIBCO_HOME for each of the TIBCO Rendezvous, TIBCO Enterprise Message Service , and TIBCO Hawk components.
Hawk Domain and Transport Configuration
The Admin Agent can monitor multiple domains configured with different or same transports.
The Admin Agent can monitor multiple transports at the same time. Each of those transports supports multiple domain configurations.
Domain Transport Configuration File (hawk-domain-transport-cfg.xml)
Configure the domains in <CONFIG_FOLDER>\tibco\cfgmgmt\hawkteaagent\config\hawk-domain-transport-cfg.xml directory. It follows the DomainTransportCfg.xsd XML schema.
Refer to the examples in the hawk-domain-transport-cfg.xml file on how to configure Hawk Domains and their respective transports. You can configure the Hawk domain and their respective transport for the Admin Agent. One or more Hawk domains can be monitored. You require one DomainTransport section per monitored domain. You must uncomment and configure the code for the DomainTransport section for the transport that you want to use and comment all other DomainTransport sections.
For example, the configuration for the TIBCO Rendezvous transport domain (default) is as follows:

 
<!-- RV transport domain-->
<hk:DomainTransport>
<hk:HawkDomainName>default</hk:HawkDomainName>
<hk:Transport>
<hk:RVTransportCfg>
<hk:service>7474</hk:service>
<hk:network></hk:network>
<hk:daemon>tcp:7474</hk:daemon>
</hk:RVTransportCfg>
</hk:Transport>
<hk:SecurityPolicy></hk:SecurityPolicy>
</hk:DomainTransport>

 
Admin Agent Configurations
All the required configuration parameters are stored in the following files:
These files are located in the <CONFIG_FOLDER>/hawkteaagent/config directory. The following options can be configured:
Log Files Location Configuration
The Admin Agent uses logback for application logging. By default, the logs are generated under CONFIG_FOLDER/hawkteaagent/config/logback-config.xml. You can modify va’];rious configuration parameters and change the default settings.
For example, the default configuration is as follows:

 
<configuration scan="true">
<!-- Configure log location and filename. -->
<property name="LOG_HOME" value=
"<CONFIG_HOME>/tibco/cfgmgmt/hawkteaagent/logs" />
<property name="LOG_FILE_NAME" value="hawk-tea-agent" />
<appender name="STDOUT" class=
"ch.qos.logback.core.ConsoleAppender">
<!-- encoders are assigned the type         ch.qos.logback.classic.encoder.PatternLayoutEncoder
        by default -->
          <encoder>
            <pattern>%date{dd MMM yyyy;HH:mm:ss.SSS} [%thread]              %-5level %logger{36} - %msg%n</pattern>
          </encoder>
</appender>
 
<appender name="FILE"
          class="ch.qos.logback.core.rolling.RollingFileAppender">
          <file>${LOG_HOME}/${LOG_FILE_NAME}.log</file>
          <append>true</append>
          <rollingPolicy            class="ch.qos.logback.core.rolling.FixedWindowRollingPo                                                            licy">
          <fileNamePattern>${LOG_HOME}/${LOG_FILE_NAME}.%i.log</fi                                                    leNamePattern>
          <minIndex>1</minIndex>
          <maxIndex>10</maxIndex>
          </rollingPolicy>
          <triggeringPolicy
            class="ch.qos.logback.core.rolling.SizeBasedTriggering                                                          Policy">
            <maxFileSize>10MB</maxFileSize>
          </triggeringPolicy>
          <encoder>
            <pattern>%date{dd MMM yyyy;HH:mm:ss.SSS} [%thread]               %-5level %logger{35} - %msg%n</pattern>
          </encoder>
</appender>
<!-- Define log levels for individual category -->
        <logger name="com.tibco.tea.agent.hawk" level="INFO" />
        <logger name="com.tibco.hawk" level="WARN" />
      <logger name="com.tibco.tea.agent.internal" level="ERROR" />
        <logger name="org.eclipse.jetty" level="ERROR" />
<!-- Root logger -->
         <root level="INFO">
           <appender-ref ref="FILE" />
           <!-- <appender-ref ref="STDOUT" />-->
          </root>
</configuration>

 

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved