Use the unregisterContainer command to unregister a container previously registered with Business Transaction Management. Use this command after the container has been taken offline permanently. It is faster to use this command to unregister the container than to unregister each endpoint in it.

Physical containers must be offline long enough for the system to mark them down before you can unregister them.

This command also unregisters all the system services, service descriptors, and endpoints in the container. Any monitored endpoints in the container are no longer monitored, and measurements for these endpoints are deleted.

Command Syntax

btmcli unregisterContainer -baseAddress baseAddress | -fn friendlyName 
                           -s sphereURL -l username:password
Name Long Name Description
-i -baseAddress The base address of an existing entry point in the sphere.

Base address format: scheme://host:port/

-fn -friendlyName Friendly name of the container to unregister. If the friendly name is not unique, you must use the baseAddress option instead.
-s -sphereUrl Required. The URL of the sphere residing in the container you want to unregister.


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.


The following command unregisters the container with the friendly name MyApps.

btmcli unregisterContainer -fn MyApps 
                           -s http://localhost:8080/btmcentral/sphere/ 
                           -l admin:abracadabra