exportPolicies

Use the exportPolicies command to export the selected policies either to stdout or to the given output file. You specify the policy to export in one of two ways:

• The name of the policy - you can further qualify this with type, sub-type and/or version.

• The type of the policy - you can further qualify this with sub-type and/or version.

  To determine the type and subtype of a policy, select Policies in the Navigator. The type and subtype for each policy is displayed in the summary pane.

After exporting policies, you can use the importPolicies command to import them to another sphere.

Not all files can be exported. Data that you cannot migrate between sphere environments includes the following items:

• Logging policy data collected by your transaction management database.

  You cannot migrate information that has been collected and written to either file or database storage through the application of logging policies on your managed services.

• Instance data for exceptional conditions that have occurred in your transactions.

  You cannot migrate information that has been collected by the transaction management component of AMS.

Command Syntax

btmcli exportPolicies 
             [[-n PName] [-t PType] [-subType PSubType] [-v Version]|[-exportAll]]
             [-o fileName]
             -s sphereUrl -l username:password

Name	Long Name	Description
-n	-name	The name of the policy to export.
-t	-type	The type of the policy to export.
-subType	--	The sub-type of the policy to export.
-v	-version	The version of the policy to export.
-exportAll	--	Specifies that all policies should be exported.
-o	-outputFile	Specifies a file into which the results of the export will be placed.
-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 command exports all policies known to the specified sphere to the file MyPolicies.

btmcli exportPolicies -exportAll -o C:\Home|MyPolicies
                      -s http://localhost:8080/btmcentral/sphere/
                      -l admin abracadabra