UCSProvisioning - provisionProfile
UCSProvisioning - provisionProfile
Description :
This command provisions a blade, using a UCS template. As input, use the templateKey argument to specify the DBKey of the UCS template. You can get the DBKey of the template by using the DepotObject : getDBKeyByTypeStringGroupAndName command.
Use the propsFileURL argument to specify a property file. This property input file URL must be a valid java.net.URL pointing to a text file conforming to the java.util.Properties format.
There are two types of property entries in this file:
-- Basic provisioning entries for bare metal provisioning. For a complete list of these entries, see Provision : provisionDevice .
-- Entries specific to UCS.
The UCS-specific entries are:
Profile and Org setting for the UCS template:
- UCSTemplate.ProfileName=[valid profile name] (Required)
- UCSTemplate.ProfileOrg=[valid org] (Required)
Action to be taken if target blade is already associated.Valid values are : [0-Provisioning Job fails, 1-Disassocoate the existing profile, 2-Delete the existing profile]
- Blade.ExistingProfileAction=[Valid value between 0 to 2] (Required)
Required entries for UCS Provisioning Job (includes basic provisioning entries and UCS-specific entries):
- UCSTemplate.ProfileName=[Valid Profile Name]
- UCSTemplate.ProfileOrg=[Valid Org]
- Blade.ExistingProfileAction=[Valid value between 0 to 2]
- Job.Provision.JOB_FOLDER_ID=[JOB_FOLDER_ID Value]
- Job.Provision.JOB_NAME=[JOB_NAME Value]
- Device.BootImage=[Valid Boot Image ID]
Sample UCS Provisioning Job properties file:
UCSTemplate.ProfileName=Win2k8_x86_73
UCSTemplate.ProfileOrg=org-root
Blade.ExistingProfileAction=1
Job.Provision.JOB_FOLDER_ID=2000001
Job.Provision.JOB_NAME=Win2k8_x86_74
Device.BootImage=200
Here are some commands related to running a UCS provisioning job:
JobManagement : getRunningJobsStatus
ProvisionJob : getAllProvisionJobsRunStatus
Provision : getProvisionJobStatus
Provision : cancelProvisionJob
Return type : DBKey
Command Input :
Variable Name | Variable Type | Description |
|---|---|---|
templateKey | com.bladelogic.om.infra.model.base.keys.SDepotObjectKey | The DBKey of the UCS template that you want to use for provisioning. |
systemPackageId | Integer | Depot Object ID of the system package. |
aclTemplateId | Integer | ACL template to apply to the server that will be added to Configuration Manager, once it is provisioned. If you want to use default ACLs, set this variable to 0. |
propsFileURL | String | URL to the input file containing device properties. |
Example
The following example shows how to provision a device using a UCS template . This example uses a UCS template with the key DBKey:SDepotObjectKey:2000001-1 and a system package with the depot ID 2000000 and an ACL template with the ID 1. The file propfile.txt, residing in the root directory of the local machine, is the input file for the device properties.
Script
blcli UCSProvisioning provisionProfile DBKey:SDepotObjectKey:2000001-1 2000000 1 file:///c:/profile.txt