Open topic with navigation

TIBCO® Enterprise Administrator 2.4.2

# 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.

Before you begin
Enable Hawk Management
By default, the Hawk Domains option is not visible in the UI unless you opted for the TIBCO Hawk Agent component during installation. To ensure that the Hawk Domains 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 the Hawk Domains icon in the left navigation bar. 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 must be running.

ResultThe Hawk Domains 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 Domains 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.

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO® Enterprise Administrator

Copyright © 1996-2025. Cloud Software Group, Inc. All Rights Reserved.