removePathAlias

Use the removePathAlias command to remove an alias representing an alternative URL path that can be used to access the specified WSDL or endpoint. Any future registration or discovery will again treat the two paths as distinct.

See also removeNodeAlias for host name aliases and removeBaseAddressAlias for other aliases in the authority part of the WSDL's URL.

The removePathAlias command allows you to remove outdated aliases from the system. For instance, if a service descriptor has an alias added due to an HTTP redirect that is later disabled (WSDL URL A redirected to URL B, but now the two URLs represent different WSDLs), this command removes the alias so that WSDL A can be registered independently.

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

Command Syntax

ap removePathAlias -w wsdlUrl| -e endpointUrl -alias pathAlias
                   -s sphereUrl -l username:password
Name Long Name Description
-w -wsdlUrl The full URL or the WSDL (service descriptor) for which you want to remove an alias.
-e -endpointUrl The full URL of the endpoint(s) for which to remove the alias. If multiple endpoints are matched, the alias will be removed from all of them.
-alias -- The alternate path to remove from the service descriptor or endpoint. This should be just the path portion of the URL, starting with "/".
-s -sphereUrl The URL of the sphere.

http://hostname:port/btmcentral/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.


Example

The following example shows the removePathAlias command using an encrypted password.

btmcli removePathAlias -e http://jbujes:7001/credit/CreditService 
                       -alias /bookmart/amex/CreditSrevice 
                       -s http://localhost:8080/btmcentral/sphere/ 
                       -l admin:abracadabra