Use the putSetupData command to read the setup file from standard input or a supplied input file and to save it as the setup data for the specified system service.

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 putSetupData -e endpointUrl [-i inputFile] 
                    -s sphereUrl -l username:password
Name Long Name Description
-e -endpointUrl The URL of the system service.
-i -inputFile The name of the file from which to get input.
-s -sphereUrl The URL of the sphere where the service whose data you want to read is installed.


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 examples show files written as the setup file for another service at the specified endpoint.

cat myFile | btmcli putSetupData -e myServiceEndpoint

btmcli putSetupData -e myServiceEndpoint -i myInputFile