Use the registerMonitor command to register a monitor agent with the sphere.

Following installation and configuration of Business Transaction Management central services, you can deploy one or more monitor nodes to additional application servers for processing observed messages. You need to run the reigsterMonitor command for each monitor you want to add.

If the nodes hosting Business Transaction Management monitors use aliases, you can run the addNodeAlias command to register the aliases with the sphere.

Command Syntax

btmcli registerMonitor -e endpointUrl [-fn friendlyName]
                       -s sphereUrl -l username:password
Name Long Name Description
-e -endpointUrl Specifies the URL of the monitor to register with the sphere. For example,


Replace the host name and port number with appropriate values. This URL always ends with btmmonitor/agent/agent.

-fn -friendlyName The friendly name of the endpoint for the monitor agent you want to register.
-s -sphereUrl Required. The URL of the sphere with which you want to register the container.


This flag is not required if you have set the AP_SPHERE_URL environment variable for your sphere.

-l -userLogin The username and password associated with the sphere, in the format: username:password. This set of credentials must belong to a user in the btmadmin role.

See Security Options in Accessing CLI Commands for information on furnishing login credentials.

You can encrypt passwords using the encryptPassword command.


btmcli registerMonitor -e http://localhost:8080/btmmonitor/agent/agent
                       -s sphereUrl http://localhost:8080/btmcentral/sphere/
                       -l admin:abracadabra