Job Control Profile Document Number: DCIM1034 Document Type: Specification Document Status: Published Document Language: E Date: 2011-03-22 Version: 1.1.
THIS PROFILE IS FOR INFORMATIONAL PURPOSES ONLY, AND MAY CONTAIN TYPOGRAPHICAL ERRORS AND TECHNICAL INACCURACIES. THE CONTENT IS PROVIDED AS IS, WITHOUT EXPRESS OR IMPLIED WARRANTIES OF ANY KIND. ABSENT A SEPARATE AGREEMENT BETWEEN YOU AND DELL™ WITH REGARD TO FEEDBACK TO DELL ON THIS PROFILE SPECIFICATION, YOU AGREE ANY FEEDBACK YOU PROVIDE TO DELL REGARDING THIS PROFILE SPECIFICATION WILL BE OWNED AND CAN BE FREELY USED BY DELL. © 2010 Dell Inc. All rights reserved.
CONTENTS 1 2 Scope .................................................................................................................................................... 5 Normative References ........................................................................................................................... 5 2.1 Approved References ................................................................................................................. 5 2.2 Other References .................................
Figures Figure 1 – Job Control Profile: Class Diagram.............................................................................................. 8 Tables Table 1 – Related Profiles ............................................................................................................................. 7 Table 2 – Job Types .................................................................................................................................... 11 Table 3 – JobStatus Property Values .......
Job Control Profile 1 Scope The Job Control Profile extends the management capabilities of referencing profiles by adding the capability to create, schedule, track, and otherwise manage jobs that represent platform management actions. This profile is intended to align with the SNIA SMIS Job Control subprofile and the DMTF Job Control Profile that is currently being worked on in the DMTF. 2 Normative References The following referenced documents are indispensable for the application of this document.
3.3 conditional indicates requirements to be followed strictly in order to conform to the document when the specified conditions are met 3.4 mandatory indicates requirements to be followed strictly in order to conform to the document and from which no deviation is permitted 3.5 may indicates a course of action permissible within the limits of the document 3.6 need not indicates a course of action permissible within the limits of the document 3.
Refers to WS-MAN GET operation as defined in Section 7.3 of DSP00226_V1.1 and Section 7.1 of DSP0227_V1.0 4 Symbols and Abbreviated Terms 4.1 CIM Common Information Model 4.2 iDRAC integrated Dell Remote Access Controller – management controller for blades and monolithic servers 4.3 CMC Chassis Managementr Controller – management controller for the modular chassis 4.
6 Description The Job Control Profile describes the job control service, the job types, their behavior, and state transitions and results representations. The profile also describes the relationship of the job service to the profile version information. Figure 1 represents the class schema for the Job Control Profile. The job service in a managed system is represented by the instance of DCIM_JobService class. The jobs names, status, and error messages are represented by the DCIM_LifeCycleJob class.
6.2 Creating Jobs Platform management jobs are created as the result of invoking an extrinsic method for performing a specific task. Jobs that are created as the result of an extrinsic method invocation are initially created without a start time defined and require a management client script or application to subsequently set the scheduled start time by specifying job(s) and start time in a job queue. 6.
To accomplish these offline platform management actions, several specific job types are defined to represent types of remote enablement actions: 7.2.1 Image Update Image Rollback Reboot Name The DCIM_LifeCycleJob.Name property represents the job type and is formulated as follows: 10 Version 1.1.
Table 2 – Job Types JobType Description Value Update The flashing of FW into the target device . update:DCIM:InstanceID of SoftwareIdentity Rollback The flashing of Available FW into the device.
Backup Image Backup Life Cycle Controller and iDRAC to a file from the system BackupImage Restore Image Restore Lifecycle Controller and iDRAC from an image to the system RestoreImage 7.2.2 JobStatus The value of DCIM_LifeCycleJob.
Failed Job has been failed Job Type = “NIC Configuration” New New Job has been created Ready For Execution Job is ready for execution Scheduled Job has been scheduled Completed Job has been completed. Completed with Errors Job has been completed with one or more errors. Failed Job has been Failed Job Type = “BIOS Configuration” New New Job has been created Ready For Execution Job is ready for execution Scheduled Job has been scheduled Completed Job has been completed.
7.2.6 MessageID An identifier for the error message that can be used to index into Dell Lifecycle Controller Message Registry xml files. The Message Registry files are available in localized versions for English, French, Spanish, German, Japanese and Chinese. They also contain more detailed descriptions of the error condition and recommended response actions. 7.2.7 MessageArguments An error message may contain substitution variables that are filled in dynamically at runtime.
8 Methods This section details the requirements for supporting intrinsic operations and extrinsic methods for the CIM elements defined by this profile. 8.1 DCIM_JobControlService.SetupJobQueue() The SetupJobQueue() method is used for creating a job queue that will contain one or more DCIM_LyfecycleJobs with a specified order of execution within the queue. Table 4 – DCIM_JobControlService.SetupJobQueue() Method: Return Code Values Value Description 0 Request was successfully executed.
When the number of jobs in the JobQueue reach the maximum limit, jobs in the “Completed” state will be deleted automatically. However, jobs in the “Failed” state will not automatically be deleted and must be manually removed one at a time or using the keyword JID_CLEARALL, as mentioned above. Table 6 – DCIM_JobControlService.DeleteJobQueue() Method: Return Code Values Value Description 0 Request was successfully executed. 1 Method is unsupported. 2 Error occurred Table 7 – DCIM_JobControlService.
Table 8 – DCIM_JobControlService.CreateRebootJob() Method: Return Code Values Value Description 0 Request was successfully executed. 1 Method is unsupported. 2 Error occurred Table 9 – DCIM_JobControlService.
DCIM_LCRegisteredProfile AdvertiseTypeDescriptions = WS-Identify, Interop Namespace AdvertiseTypes = 1, 1 InstanceID = DCIM:JobControl:1.0.0 OtherRegisteredOrganization = DCIM RegisteredName = Job Control RegisteredOrganization = 1 RegisteredVersion = 1.0.0 B) ENUMERATE the CIM_RegisteredProfile class. See section 3.13 for a definition of ENUMERATE . Class URI: http://schemas.dmtf.
Class URI: http://schemas.dmtf.org/wbem/wscim/1/cimschema/2/root/dcim/DCIM_JobService?CreationClassName=DCIM_JobService+Name=J obService+SystemName=Idrac+SystemCreationClassName=DCIM_ComputerSystem 9.5 C) Examine output parameters per Table 4 D) Repeat 9.
10.1 DCIM_JobService The DCIM_LCElementConformsToProfile association(s)’ ManagedElement property shall reference the DCIM_JobService instance(s). 10.1.1 WBEM URIs for WinRM® The class WBEM URI shall be “http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_JobService?__cimnamespace=” The key properties shall be the SystemCreationClassName, CreationClassName, SystemName, and Name. The instance WBEM URI for DCIM_JobService instance shall be: “http://schemas.dell.
The instance WBEM URI for DCIM_LifecycleJob instance shall be: “http://schemas.dell.com/wbem/wscim/1/cimschema/2/DCIM_LifecycleJob?__cimnamespace=+InstanceID=” 10.2.2 Operations The following table details the implemented operations on DCIM_LifecycleJob. Table 13 – DCIM_LifecycleJob - Operations Operation Name Get Enumerate Requirements Mandatory Mandatory Required Input Instance URI Class URI 10.2.
Table 15 – DCIM_LCRegisteredProfile - Operations Operation Name Get Enumerate Requirements Mandatory Mandatory Required Input Instance URI Class URI 10.3.3 Properties Table 16 – Class: DCIM_LCRegisteredProfile Properties Requirement Description InstanceID Mandatory This property shall have a value of DCIM:JobControl:1.0.0 RegisteredName Mandatory This property shall have a value of “Job Control”. RegisteredVersion Mandatory This property shall have a value of “1.0.0”.
ANNEX A: Related MOF Files Dell Tech Center MOF Library: http://www.delltechcenter.com/page/DCIM.Library.MOF Related Managed Object Format (MOF) files: DCIM_JobService.mof DCIM_LifeCycleJob.mof DCIM_LCElementConformsToProfile.mof DCIM_LCRegisteredProfile.mof Version 1.1.
