Use the addNodeAlias command to add the specified alias to the network node identified by the canonical name. If the node does not exist, the alias is not added unless you also specify the -force option, in which case the node is created as well.

Use the removeNodeAlias command to delete an alias created with the addNodeAlias command.

See Resolving Discovery Issues for a discussion of the use of this command in resolving discovery issues.

Command Syntax

btmcli addNodeAlias -n nodeName -alias aliasName [-f]
                    -s sphereURL -l username:password
Name Long Name Description
-n -name The canonical name of the network node. Typically a fully-qualified domain name. For example,
-alias -alias An alias for the network node. This can be a domain name or a static IP address.
-f -- Force the alias to be created (as well as its canonical network node) even if the network node is unknown.
-s -sphereUrl The URL of the sphere.


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 example shows the addNodeAlias command.

btmcli addNodeAlias -n -alias Athena         -s http://localhost:8080/btmcentral/sphere/ -l admin:abracadabra