BlPackage - importComponentToPackage_2

BlPackage - importComponentToPackage

Description :

This command adds a component to a BLPackage. When you add a component to a package, you add all the assets (server objects) specified in the component. This command also lets you specify the single-user mode, reboot, and local property name conflict resolution settings.

You can set singleUserMode to one of the following strings:

NotRequired: Not Required
RevertTo: Use single-user mode without reboot
RebootAs: Reboot into single-user mode

You can set rebootMode to one of the following strings:

NotRequired: Not required
AfterDeploy: After item deployment
AfterDeployWithReconfiguration: After item deployment with reconfiguration (Solaris ONLY)
OutOfBand: Out-of-band
AtJobEnd: By end of job
AtJobEndWithReconfigration: By end of job with reconfiguration (Solaris ONLY)

You can set localPropertyNameConflictResolution to one of the following strings:

IssueNewPropertyName: Import the new property, but give it a new name (a modification of the conflicting name like 'OLDNAME (2)')
KeepPreExistingValue: Discard the the value of the new property even though the property name is the same. An exception is thrown if the types of the conflicting properties are different.
FailIfValuesDontMatch: If the value and type of the new property matches the existing value, do nothing and stay silent. Otherwise fail. This is the default.
This command returns a handle to the newly created package. This handle can be used as input to commands that need a handle to the package.
Return type : DBKey

Command Input :

Variable Name	Variable Type	Description
groupName	String	Name of a group that contains the package.
packageName	String	Name of the package.
bSoftLinked	Boolean	True to create a package soft linked to the depot object resources, false otherwise.
bCollectFileAcl	Boolean	True to package the file ACLs, false otherwise.
bCollectFileAttributes	Boolean	True to package the file attributes, false otherwise.
bCopyFileContents	Boolean	True to package the file contents, false otherwise.
bCollectRegistryAcl	Boolean	True to package the registry ACLs, false otherwise.
componentKey	DBKey	Handle to the component that you want to package.
propNames	String	Names of the component item properties whose values you want to set. These are the property names that appear in the BLPackage editor in the BMC BladeLogic GUI. If you want to set more than one property, use a comma to separate multiple property names.
propValues	String	The values you want to assign to the properties listed in propNames. Note that you can use parameters here, as well as explicit values. Separate multiple values/parameters with commas. The first value corresponds to the first property, the second value corresponds to the second property, and so on.
singleUserMode	String	The single-user mode.
rebootMode	String	The reboot mode.
localPropertyNameConflictResolution	String	The conflict resolution method to use when one or more of the local properties of the imported component conflicts with the name of an existing property of the package.

Example

This example shows how to import a component containing file assets to a BLPackage. In this example, the importComponentToPackage command replaces the existing owner of every file with the value specified by the ??OWNER?? parameter. Similarly, it replaces each file's permissions with the value specified by the ??PERMISSIONS?? parameter.

Script

PACKAGE1_DBKEY=`blcli BlPackage importComponentToPackage "/pkgDepotGrp1" "pkgName1" true true true true true "DBKey:SComponentKey:18-1" "Owner,Permissions" "??OWNER??,??PERMISSIONS??" RevertTo AtJobEnd IssueNewPropertyName`