White Papers

Remote NIC Configuration Management
Read NIC attributes and settings
The enumerate operation is used to get a list of all the attributes of a given class. A Get operation is
used to get a specific attribute of a given class. All NIC attribute instances carry base properties like
„AttributeName‟, „CurrentValue’, PendingValue‟, etc. In addition to this, each attribute also carries
metadata such as MinLength, MaxLength, LowerBound, UpperBound, ValueExpression, PossibleValues,
and etc., as appropriate to the attribute type. Attributes that are writable or settable have
„IsReadOnly‟ property set to “false”.
DCIM_NICEnumeration class represents all attributes that contain enumeration type values:
AttributeName = LinkStatus, CurrentValue = Connected
PossibleValues = (Disconnected, Connected)
DCIM_NICInteger class represents all attributes that contain integer type value:
AttributeName=LnkUpDelayTime, CurrentValue=0, UpperBound=255,
LowerBound=0
DCIM_NICString class represents all attributes that contain string type value:
AttributeName=VirtMacAddr, CurrentValue=” 78:2B:CB:54:57:23”,
MinLength=17, MaxLength=17
Refer to the “Simple NIC Profile” section of this paper for more details.
Configure NIC attributes and settings
NIC configuration uses the Set (pending values) and Apply (Commit) methodology for configuration.
This methodology allows the user to schedule a configuration by staging changes and applying them
(pending values) now or at a future time convenient to the user depending on the method parameters
stipulated. The following steps are required for configuration:
1. Set one or more NIC attributes using DCIM_NICService.SetAttribute() or
DCIM_NICService.SetAttributes()
2. Read the pending changes using enumeration commands
3. Schedule a job to apply the configuration using DCIM_NICService.CreateTargetedConfigJob()
4. Read the status of the job until it completes
5. Read again the updated values using enumeration commands