getSetupData

Use the getSetupData command to write the setup file for a system service to standard output.

You can redirect output to a file, modify the file, and then use that file as input to the putSetupData command to save the service setup data.

You can also get the setup data from one service and transfer it to another. This command does not verify that the target service has been initially configured.

See Backing up and Restoring Business Transaction Management, for a discussion of the use of this command in backing up the system.

Command Syntax

btmcli getSetupData -e endpointUrl -s sphereUrl -l username:password

Name Long Name Description

-e -endpointUrl The location (URL) for the system service.

-s

-sphereUrl

Name	Long Name	Description
-e	-endpointUrl	The location (URL) for the system service.
-s	-sphereUrl	The URL of the sphere where the service whose setup data you want to get is registered. http://hostname:port/btmcentral/sphere/ This flag is not required if you have set the AP_SPHERE_URLenvironment 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 URL of the sphere where the service whose setup data you want to get is registered. http://hostname:port/btmcentral/sphere/

This flag is not required if you have set the AP_SPHERE_URLenvironment 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 getSetupData command.

btmcli getSetupData -e http://localhost:8080/apcentral/policyManager
                    -s http://localhost:8080/btmcentral/sphere/
                    -l admin:abracadabra