BlPackage - createPackageFromSnapshot
BlPackage - createPackageFromSnapshot
Description :
Note: This command applies only to Application Release Manager.
This command creates a BLPackage based on a snapshot. The package will contain all the information collected by the snapshot. This command returns a handle to the newly created package and can be used as input to commands that need a handle to the package.
Return type : DBKey
Command Input :
Variable Name | Variable Type | Description |
|---|---|---|
packageName | String | Name of the package. |
groupId | Integer | ID of a group that should contain 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. |
snapshotKey | DBKey | Handle to the snapshot that should be packaged. |
Example
This example shows how to create a BLPackage from a snapshot. It requires the job handle (SNAP_JOB_DBKEY), job run handle (SNAP_RUN_DBKEY), and target server (TARGET_NAME) for a template-based Snapshot Job run.
Script
# Name of the package.
PACKAGE_NAME="package1"
# Get the ID of the depot group in which the package will be saved.
DEPOT_GROUP_ID=`blcli DepotGroup groupNameToId /parent/group1`
# This boolean value sets the Depot Asset Options - soft link check box. True for checked.
bSoftLinked="false"
# This boolean value sets the File Options - Collect ACL control lists check box. True for checked.
bCollectFileAcl="false"
# This boolean value sets the File Options - Collect File Attributes check box. True for checked.
bCollectFileAttributes="false"
# This boolean value sets the File Options - Copy File Contents check box. True for checked.
bCopyFileContents="true"
# This boolean value sets the Registry Options - Collect ACL check box. True for checked.
bCollectRegistryAcl="false"
# A collection of the above options.
PACKAGE_OPTIONS="$bSoftLinked $bCollectFileAcl $bCollectFileAttributes $bCopyFileContents $bCollectRegistryAcl"
# Now create new package.
# Get the template DBKey for the asset you wish to package.
TEMPLATE_NAME=template1
TEMPLATE_GROUP=/template_group
TEMPLATE_DBKEY=`blcli Template getDBKeyByGroupAndName $TEMPLATE_GROUP $TEMPLATE_NAME
# Convert the jobRun DBKey to jobRun ID.
SNAP_RUN_ID=`blcli JobRun jobRunKeyToJobRunId $SNAP_RUN_DBKEY`
#Get the snapshot DBKey.
SNAP_DBKEY=`blcli Snapshot getSnapshotKeyByJobRunId $SNAP_RUN_ID $TARGET_NAME`
PACKAGE1_DBKEY=`blcli BlPackage createPackageFromDeltaByJobKey $PACKAGE_NAME $DEPOT_GROUP_ID $PACKAGE_OPTIONS $SNAP_DBKEY`