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` 



Was this page helpful? Yes No Submitting... Thank you

Comments