Creating an Agent Network

This topic shows how to configure bwagents so they can be members of the same agent network.

When using multiple machines, the runtime status of the bwagents and AppNodes cannot be computed reliably if the machine clocks in the agent network are not in sync with each other. Make sure that the clocks for machines in the network are synchronized.
Note: All agents in a network should be of same 4 part version.

For example, If there is one agent with version 6.4.2_HF009, all the other agents should be of the version 6.4.2_HF009 only.

Complete the following steps for each bwagent that is to join the agent network.

Procedure

  1. Stop bwagent.
  2. For each bwagent, open the JSON configuration file, located in BW_HOME\config (Windows) or ${BW_HOME}/config (Unix). Use the configuration file specific to the technology type used by the bwagents in the network.
    1. Edit parameters in this file as follows:
      Parameter Property in bwagent.ini File Setting
      bwagentnetworkname bw.agent.network.name The name of the network. Must be the same setting for each bwagent in the network.
      bw.agent.technology.dbems.ems.serverUrl/bw.agent.technology.dbftl.ftl.realmserver Use Same transport layer URL
      bw.agent.technology.dbems.db.connectionURL and bw.agent.technology.dbftl.db.connectionURL Same database
    2. Set other parameters in the JSON file. For more information about parameters, see Configuring bwagent.
    3. Save the file and use the bwadmin config command to push the changes from the JSON file to the bwagent.ini file.
      Use the bwagent_db.json or bwagent_ftl.json file as follows: 
      BW_HOME\bin>bwadmin config -cf ../config/bwagent_db.json agent
      BW_HOME\bin>bwadmin config -cf ../config/bwagent_ftl.json agent
  3. Restart bwagent.

Result

Use the show agents command to show all discovered bwagents. Agents in a network can be managed by any other bwagent.