bwagent

A bwagent is a daemon process that is responsible for provisioning AppNodes and applications, performing administration commands, and synchronizing data from the datastore with the local file system.

There is one bwagent for each installation. The bwagent enables communication between agents located on different machines. When multiple bwagents are configured to communicate with each other using a common datastore, they form a bwagent network. bwagents can communicate using TIBCO FTL® for communication transport and TIBCO Enterprise Message Service for communication transport, and by using an external database for data persistence .

For information about configuring the bwagent, see Configuring bwagent.

When multiple bwagents belong to a network and one of the system fails, the failed system can be restored after a restart by using the bwadmin restore command to force the file system to be synchronized with the datastore.

There are multiple ways to access the bwagent: bwadmin, the Admin UI, or the REST API.

  • bwadmin: In enterprise mode, bwadmin sends commands to the bwagent. The bwagent dispatches the command to the targeted agent. For more information, see the "bwadmin Command Line" tasks under Administration Tasks and Reference section in the TIBCO ActiveMatrix BusinessWorks™ Administration guide.
  • Admin UI: When the bwagent is registered with the TEA server, the Admin UI can be used to create and manage runtime entities. For more information, see the "Admin UI" tasks under "Administration Tasks and Reference" section in the TIBCO ActiveMatrix BusinessWorks™ Administration guide.
  • REST API: View the bwagent REST API in the Swagger UI. For more information, see the section "Accessing the bwagent REST API with the Swagger UI" in the TIBCO ActiveMatrix BusinessWorks™ Administration guide.

bwagent supports its own set of commands. Commands are issued from the command line in the format: bwagent [options] command <arguments>

bwagent commands are listed below.

bwagent Commands
Command Description
apiserver Starts the apiserver that hosts the REST API in the Swagger UI. Open a browser and go to the following URL: http://localhost:5555
startagent Starts the bwagent. This is the same as the default command when no command is given.
stop Stops the bwagent gracefully.

The following options can be specified for bwagent:

bwagent Command Options
Option Description Example
-config Applies the configuration in the specified file to the server instance. bwagent -config bwagent.ini
-logconfig <file> Uses the specified file for logback configuration. bwagent -logconfig mylogback.xml
-x,--xtrace Echoes the command to the terminal. Given bwagent -x , the text +startagent is echoed to the console when the agent starts.