Configuring ActiveMatrix BusinessWorks for Hawk

To use Hawk with ActiveMatrix BusinessWorks, configure the AppSpace to enable the Hawk Microagent for TIBCO ActiveMatrix BusinessWorks 6.

Prerequisites

  • (Optional) To use TIBCO Rendezvous as the transport, download and install TIBCO Rendezvous®. For details, see TIBCO Rendezvous® documentation.
  • Download and install TIBCO ActiveMatrix BusinessWorksTM in the same TIBCO_HOME where you have installed TIBCO Rendezvous. For details, see TIBCO ActiveMatrix BusinessWorksTM documentation.
    Note: Ensure that TIBCO Rendezvous and ActiveMatrix BusinessWorks are in the same TIBCO_HOME and RV_HOME
  • Existing ActiveMatrix BusinessWorks application archive (EAR) file. For details about creating an application, see TIBCO ActiveMatrix BusinessWorksTM documentation.
  • Download and install TIBCO Hawk®. For details, see TIBCO Hawk® documentation.
  • Download and install TIBCO Hawk® Microagent for TIBCO ActiveMatrix BusinessWorksTM 6 in the same TIBCO_HOME where you have installed ActiveMatrix BusinessWorks. For details, see Installation.
Note: For information about the supported versions of the prerequisite software, see the Readme file for TIBCO Hawk® Microagent for TIBCO ActiveMatrix BusinessWorksTM 6.

Procedure

  1. Navigate to the configuration folder in the ActiveMatrix BusinessWorks installation at BW_HOME/config.
  2. Copy the AppSpace configuration template (appspace_config.ini_template) file to a temporary location and rename the file to config.ini.
  3. Open the config.ini file for editing and configure the following properties based on the transport used.
    Configuration Properties
    Enable Hawk microagents for ActiveMatrix BusinessWorks bw.hawk.hma.enabled=true
    (Optional) Enable TIBCO Rendezvous transport

    bw.hawk.hma.transport=tibrv

    bw.hawk.hma.rv.service=<port>

    bw.hawk.hma.rv.network=

    bw.hawk.hma.rv.daemon=tcp:<port>

    (Optional) Enable TCP Transport for TIBCO Hawk

    bw.hawk.hma.transport=tibtcp

    bw.hawk.hma.tcp.self.url=<host_IP>:<port>

    Note: Multiple AppNodes running on the same machine must bind to separate ports. For example: AppNode1 binds to port 2571 then AppNode2 can use port 2572 (other than 2571).

    bw.hawk.hma.tcp.agent.ami.url=<hawk_agent_IP>:<AMI_session_port>

    (Optional) Enable TLS or SSL for TCP Transport bw.hawk.hma.tcp.key.store Key store file name
    bw.hawk.hma.tcp.trust.store Trust store file name
    bw.hawk.hma.tcp.key.store.password Password for the key store file
    bw.hawk.hma.tcp.key.password Encrypted key password
    bw.hawk.hma.tcp.trust.store.password Password for the trust store file
    Note: You can use the tibhawkpassword utility at <HAWK_HOME>/bin to encrypt the password. Use the password without double quotes for above parameters. For more information, see TIBCO Hawk Installation, Configuration, and Administration Guide.
    bw.hawk.hma.tcp.ssl.protocol Protocol for a secure connection.

    Default value: TLSv1.2

    bw.hawk.hma.tcp.enabled.algorithms Algorithm to be used for the security protocol

    Default value: TLS_RSA_WITH_AES_128_CBC_SHA

    (Optional) Prefix for the microagent name bw.hawk.hma.microagent.prefix

    Specifies the prefix for the microagent name. The default value is used if no value is specified.

    Default value: AppNode name

  4. Save the file.
  5. Stop the AppNodes if running.
  6. Use the bwadmin config command to push the configuration to the AppSpace: 
    bwadmin config -d <domain_name> -a <AppSpace_name> -cf <temporaryLocation>/config.ini
  7. If you are running ActiveMatrix BusinessWorks in Enterprise mode, start the bwagent if it is not running.
    For more information about starting bwagent, see TIBCO ActiveMatrix BusinessWorksTM documentation.
  8. Start the Hawk Agent if it is not running. For more information about starting the Hawk Agent, see TIBCO Hawk® documentation.
  9. Restart the AppNode instances.
  10. Upload and deploy the application archive (EAR) file to the AppSpace. Start the application.

Result

Hawk Microagent for TIBCO ActiveMatrix BusinessWorks 6 and its methods are listed on the Microagents tab for the bwagent in Hawk Console. For more information about viewing microagents in Hawk Console, see TIBCO Hawk® documentation.