Registering a Hawk Domain

You can configure Hawk domains using the TIBCO Enterprise Administrator server. When you configure the Hawk domain, the server detects machines in the domain that has a Hawk Agent installed and running on it.

Prerequisites

Enable Hawk Management
By default, the Hawk Management option is not visible in the UI unless you opted for the TIBCO Hawk Agent component during installation. To ensure that the Hawk Management option is visible, set the tea.ext.hawk.enabled property to true in the <TIBCO_CONFIG_HOME>\tibco\cfgmgmt\tea\conf. file and restart the server.
Change the Hawk Properties in the tea.tra file
Refer to the Configuring Properties to Enable Hawk Integration section of the TIBCO Enterprise Administrator Installation guide to configure the Hawk properties. Ensure that the tibco.env.HAWK_HOME specified in the <TIBCO_HOME>\tea\<version>\bin\tea.tra file points to the HAWK_HOME location. By default, if no transport type is specified, the default transport type is set to TIBCO ActiveSpaces. Depending on the transport type used, ensure that you specify one of the following:
Transport Type Property in The tea.tra File Points to
TIBCO ActiveSpaces tibco.env.AS_HOME TIBCO_ACTIVESPACES_HOME
TIBCO Enterprise Message Service tibco.env.EMS_HOME TIBCO_EMS_HOME
TIBCO Rendezvous tibco.env.RV_HOME TIBCO_RV_HOME
For example, if the transport type is TIBCO Enterprise Message Service, ensure that the tibco.env.EMS_HOME points to TIBCO_EMS_HOME.
Add the Hawk Domain Configuration Properties
Create a Hawk domain configuration properties file to configure the Hawk Domain. You can either use the Hawk properties file available to you or create a new one and specify it while creating a Hawk domain in TIBCO Enterprise Administrator server. You can use one of the following transport types: TIBCO Rendezvous (hawk_transport=tibrv), TIBCO Enterprise Message Service (hawk_transport=tibems), and TIBCO ActiveSpaces (hawk_transport=tibas). By default, the transport type used by TIBCO Hawk infrastructure is TIBCO ActiveSpaces.
The properties file shown in the example lists the properties to be specified for each transport type.
Specify the properties for the transport type you are using in the hawkdomainconfiguration.properties file: 
# Default hawk domain
hawk_domain=default

# Default transport uses ActiveSpaces
hawk_transport=tibas

#Default properties when transport is "tibas"
# ActiveSpaces discover parameter
as_discover_url=tibpgm://8989/

#ActiveSpaces listen parameter
#as_listen_url=

#
# Properties to use to configure Rendezvous as the Hawk Transport
#
#hawk_transport=tibrv
# RV transport parameters
#rv_service=7474
#rv_network=;
#rv_daemon=tcp:7474

#
# Properties to use when using EMS transport (between Agent and Console only)
#
#hawk_transport=tibems
#ems_server_url=tcp://localhost:7222
#ems_username=
#ems_password=
Note: To use the hawkdomainconfiguration.properties file from TIBCO Enterprise Administrator Shell, you must first upload the file to the TIBCO Enterprise Administrator server using the sftp/scp commands. For help, use the command, registerhawkdomain --help

Running Instances
Ensure that the TIBCO Hawk Agent and Hawk Microagent (HMA) instances are running. The executable that is used to run the HMA is platform specific. Refer to the TIBCO Hawk Installation, Configuration, and Administration guide.

Procedure

  1. Click and select Hawk Management. The Hawk Domains are displayed.
  2. Click Register.
  3. In the Register Hawk Domain window, provide the following details:
    • Name: the name of the Hawk domain.
    • Description: the description of the Hawk domain.
    • Properties: choose the Hawk Domain configuration properties file that you created with the new properties.
  4. Click Register Hawk Domain.
    Caution: If you are using Enterprise Message Service as the transport type, ensure that the Hawk agent and the TIBCO Enterprise Administrator server points to the same Enterprise Message Service server. To successfully create the Hawk domain, the Enterprise Message Service server should be running.

Result

The Hawk Management pane displays all the Hawk domains configured on the server. After configuring the Hawk domain on the server, the server detects the agents in the Hawk domain and displays entries per machine on which a Hawk agent was discovered, in the Machines view. You can register or unregister domains from the Hawk Management pane.
Note: If the Enterprise Message Service server restarts and the Hawk domain is already added, the TIBCO Enterprise Administrator server automatically reconnects with the Enterprise Message Service server. Similarly, if the Hawk agent is not running, but comes up later, it gets discovered automatically.
Contents
Search Results