Managing Chassis

This chapter includes the following sections:

Chassis Inventory Tasks

The examples in this section show how to use the Cisco IMC XML API to retrieve chassis inventory details. Each example shows the XML API request followed by the response from Cisco IMC.

This section includes the following examples:

Retrieving Power Supply Properties

Request: 


<configResolveClass cookie="1256511180/f78548f2-ca76-16ca-8004-aaec921b0ff4"
inHierarchical="false" classId="equipmentPsu"/>

Response: 


<configResolveClass cookie="1473455878/95c48a0a-1a3c-1c1a-8003-be18652a6ca4" 
 response="yes" classId="equipmentPsu">
  <outConfigs>
    <equipmentPsu id="1" pid="UCSC-PSU1-1050W" model="PS-2112-9S-LF" 
     operability="operable" power="on" presence="equipped" serial="LIT18520J9K" 
     thermal="ok" vendor="Cisco Systems Inc" voltage="ok" input="0" maxOutput="0" 
     fwVersion="10062013" dn="sys/chassis-1/psu-1"/>
    <equipmentPsu id="2" pid="UCSC-PSU1-1050W" model="PS-2112-9S-LF" operability="operable" 
     power="on" presence="equipped" serial="LIT18520JCA" thermal="ok" vendor="Cisco Systems Inc" 
     voltage="ok" input="0" maxOutput="0" fwVersion="10062013" dn="sys/chassis-1/psu-2"/>
    <equipmentPsu id="3" pid="UCSC-PSU1-1050W" model="PS-2112-9S-LF" operability="operable" 
     power="on" presence="equipped" serial="LIT18520JBZ" thermal="ok" vendor="Cisco Systems Inc" 
     voltage="ok" input="0" maxOutput="0" fwVersion="10062013" dn="sys/chassis-1/psu-3"/>
    <equipmentPsu id="4" pid="UCSC-PSU1-1050W" model="PS-2112-9S-LF" operability="operable" 
     power="on" presence="equipped" serial="LIT18520JC1" thermal="ok" vendor="Cisco Systems Inc" 
     voltage="ok" input="452" maxOutput="404" fwVersion="10062013" dn="sys/chassis-1/psu-4"/>
  </outConfigs>
</configResolveClass>

Retrieving Power Supply Properties Using DN

Request: 


<configResolveDn cookie="1256511180/f78548f2-ca76-16ca-8004-aaec921b0ff4" 
inHierarchical="true" dn='sys/chassis-1/psu-1'/>

Response: 


<configResolveDn cookie="1473455878/95c48a0a-1a3c-1c1a-8003-be18652a6ca4" 
response="yes" dn="sys/chassis-1/psu-1">
  <outConfig>
   <equipmentPsu id="1" pid="UCSC-PSU1-1050W" model="PS-2112-9S-LF" operability="operable" 
    power="on" presence="equipped" serial="LIT18520J9K" thermal="ok" vendor="Cisco Systems Inc" 
    voltage="ok" input="0" maxOutput="0" fwVersion="10062013" dn="sys/chassis-1/psu-1"/>
  </outConfig>
</configResolveDn>

Retrieving Fan Properties

Request: 


<configResolveClass cookie="1256511180/f78548f2-ca76-16ca-8004-aaec921b0ff4" 
inHierarchical="true" classId="equipmentFanModule"/>

Response: 


<configResolveClass cookie="1256511180/f78548f2-ca76-16ca-8004-aaec921b0ff4"
     response="yes" classId="equipmentFanModule">
  <outConfigs>
     <equipmentFanModule id="1" model="" operability="unknown" power="on" 
          presence="equipped" serial="" thermal="not-supported" tray="1" vendor="" 
          voltage="not-supported" dn="sys/chassis-1/fan-module-1-1">
     <equipmentFan id="1" model="" module="1" operability="unknown" power="on"
          presence="equipped" serial="" thermal="not-supported" tray="1" vendor="" 
          voltage="not-supported" rn="fan-1"/>
     <equipmentFan id="2" model="" module="1" operability="unknown" 
      power="on" presence="equipped" serial="" thermal="not-supported"
          tray="1" vendor="" voltage="not-supported" rn="fan-2"/>
    </equipmentFanModule>
     <equipmentFanModule id="2" model="" operability="unknown" 
      power="on" presence="equipped" serial="" thermal="not-supported" 
          tray="1" vendor="" voltage="not-supported" dn="sys/chassis-1/fan-module-1-2">
     <equipmentFan id="1" model="" module="2" operability="unknown" 
      power="on" presence="equipped" serial="" thermal="not-supported" 
          tray="1" vendor="" voltage="not-supported" rn="fan-1"/>
     <equipmentFan id="2" model="" module="2" operability="unknown" 
      power="on" presence="equipped" serial="" thermal="not-supported" 
          tray="1" vendor="" voltage="not-supported" rn="fan-2"/>
    </equipmentFanModule>
     <equipmentFanModule id="3" model="" operability="unknown" power="on" 
          presence="equipped" serial="" thermal="not-supported" tray="1" 
          vendor="" voltage="not-supported" dn="sys/chassis-1/fan-module-1-3">
     <equipmentFan id="1" model="" module="3" operability="unknown"  power="on" 
          presence="equipped" serial="" thermal="not-supported" tray="1" 
          vendor="" voltage="not-supported" rn="fan-1"/>
     <equipmentFan id="2" model="" module="3" operability="unknown" power="on" 
          presence="equipped" serial="" thermal="not-supported" tray="1" 
          vendor="" voltage="not-supported" rn="fan-2"/>
    </equipmentFanModule>
     <equipmentFanModule id="4" model="" operability="unknown" power="on" 
          presence="equipped" serial="" thermal="not-supported" tray="1" 
          vendor="" voltage="not-supported" dn="sys/chassis-1/fan-module-1-4">
     <equipmentFan id="1" model="" module="4" operability="unknown" power="on" 
          presence="equipped" serial="" thermal="not-supported" tray="1" vendor="" 
          voltage="not-supported" rn="fan-1"/>
     <equipmentFan id="2" model="" module="4" operability="unknown" power="on" 
          presence="equipped" serial="" thermal="not-supported" tray="1" vendor="" 
          voltage="not-supported" rn="fan-2"/>
    </equipmentFanModule>
  </outConfigs>
</configResolveClass>

Retrieving Fan Properties Using DN

Request: 


<configResolveDn cookie="1256514416/cc6493cf-cb76-16cb-8005-aaec921b0ff4" 
inHierarchical="false" dn='sys/chassis-1/fan-module-1-3/fan-2'/>

Response: 


<configResolveDn cookie="1256514416/cc6493cf-cb76-16cb-8005-aaec921b0ff4" 
response="yes" dn="sys/chassis-1/fan-module-1-3/fan-2">
  <outConfig>
    <equipmentFan id="2" model="" module="3" operability="unknown" 
     power="on" presence="equipped" serial="" thermal="not-supported" 
         tray="1" vendor="" voltage="not-supported" 
         dn="sys/chassis-1/fan-module-1-3/fan-2"/>
  </outConfig>
</configResolveDn>

Retrieving Indicator LED Status

Request: 


<configResolveClass cookie="1256514920/8c2af8ff-cb76-16cb-8006-aaec921b0ff4" 
  inHierarchical="true" classId="equipmentIndicatorLed"/>

Response: 


<configResolveClass cookie="1256514920/8c2af8ff-cb76-16cb-8006-aaec921b0ff4" 
     response="yes" classId="equipmentIndicatorLed">
  <outConfigs>
    <equipmentIndicatorLed color="green" id="1" name="LED_HLTH_STATUS" 
      operState="off" dn="sys/chassis-1/indicator-led-1"/>
    <equipmentIndicatorLed color="green" id="2" name="LED_PSU_STATUS" 
      operState="on" dn="sys/chassis-1/indicator-led-2"/>
    <equipmentIndicatorLed color="green" id="3" name="LED_TEMP_STATUS" 
      operState="on" dn="sys/chassis-1/indicator-led-3"/>
    <equipmentIndicatorLed color="green" id="4" name="LED_FAN_STATUS" 
      operState="on" dn="sys/chassis-1/indicator-led-4"/>
  </outConfigs>
</configResolveClass>

Retrieving Indicator LED Status using DN

Request: 


<configResolveDn cookie="1256515596/c4969312-cc76-16cc-8007-aaec921b0ff4" 
     inHierarchical="true" dn='sys/chassis-1/indicator-led-3'/>

Response: 


<configResolveDn cookie="1256515596/c4969312-cc76-16cc-8007-aaec921b0ff4" 
    response="yes" dn="sys/chassis-1/indicator-led-3">
  <outConfig>
    <equipmentIndicatorLed color="green" id="3" name="LED_TEMP_STATUS" 
      operState="on" dn="sys/chassis-1/indicator-led-3"/>
  </outConfig>
</configResolveDn>

Retrieving System Input Output Controller Properties

Request: 


<configResolveClass cookie="1256515596/c4969312-cc76-16cc-8007-aaec921b0ff4"
     inHierarchical="true" classId="equipmentIOCard"/>

Response: 


<configResolveClass cookie="1256515596/c4969312-cc76-16cc-8007-aaec921b0ff4" 
     response="yes" classId="equipmentIOCard">
  <outConfigs>
    <equipmentIOCard id="1" description="SIOC - System Input Output Controller"
      dn="sys/chassis-1/slot-1">
    <mgmtController rn="mgmt" model="NA" serial="NA" subject="sioc"
      vendor="Cisco Systems Inc">
    <firmwareRunning rn="fw-system" 
      description="System IO Controller currently running firmware version" 
      deployment="system" type="sioc" version="0.0(4.r202233)"/>
    <firmwareUpdatable rn="fw-updatable" 
      description="System IO Controller backup firmware version" 
      adminState="triggered" deployment="backup" operState="ready" 
      version="2.0(6.11)" protocol="none" remoteServer="" remotePath="" user="" 
      pwd="" progress="Success" type="sioc"/>
    <firmwareBootDefinition rn="fw-boot-def" type="sioc">
     <firmwareBootUnit rn="bootunit-combined" 
      description="System Input Out Controller startup firmware version" 
      adminState="triggered" image="running" resetOnActivate="no" 
      type="combined" version="0.0(4.r202233)"/>
    </firmwareBootDefinition>
        <mgmtIf rn="if-1" description="Chassis Management Interface Network Settings" 
         id="1" extEnabled="yes" extIp="10.106.145.78" extMask="255.255.255.0" 
         extGw="10.106.145.1" ifType="physical" mac="F4:0F:1B:92:EC:AA" 
         hostname="UCS-server-name1" dhcpEnable="yes" dnsUsingDhcp="yes" ddnsEnable="yes" 
         ddnsDomain="" dnsPreferred="171.70.168.183" dnsAlternate="0.0.0.0" 
         nicMode="dedicated" vicSlot="1" nicRedundancy="none" 
         vlanEnable="no" vlanId="1" vlanPriority="0" portProfile="" 
         v6extEnabled="no" v6extIp="::" v6extGw="::" v6prefix="64" 
         v6linkLocal="::" v6SlaacIp="::" v6dhcpEnable="no" v6dnsUsingDhcp="no" 
         v6dnsPreferred="::" v6dnsAlternate="::" subject="blade"/>
      </mgmtController>
    </equipmentIOCard>
    <equipmentIOCard id="2" description="SIOC - System Input Output Controller" 
     dn="sys/chassis-1/slot-2">
      <mgmtController rn="mgmt" model="NA" serial="NA" subject="sioc" 
       vendor="Cisco Systems Inc">
        <firmwareRunning rn="fw-system" 
         description="System IO Controller currently running firmware version" 
         deployment="system" type="sioc" version="0.0(4.r202233)"/>
        <firmwareUpdatable rn="fw-updatable" 
         description="System IO Controller backup firmware version" 
         adminState="triggered" deployment="backup" operState="ready" 
         version="0.0(4.r202050)" protocol="none" remoteServer="" 
         remotePath="" user="" pwd="" progress="Success" type="sioc"/>
        <firmwareBootDefinition rn="fw-boot-def" type="sioc">
           <firmwareBootUnit rn="bootunit-combined" 
            description="System Input Out Controller startup firmware version"
            adminState="triggered" image="running" resetOnActivate="no" 
            type="combined" version="0.0(4.r202233)"/>
        </firmwareBootDefinition>
        <mgmtIf rn="if-1" description="Chassis Management Interface Network Settings" 
         id="1" extEnabled="yes" extIp="10.106.145.253" extMask="255.255.255.0" 
         extGw="10.106.145.1" ifType="physical" mac="F4:0F:1B:92:7A:C4" 
         hostname="UCS-server-name2" dhcpEnable="yes" dnsUsingDhcp="yes" 
         ddnsEnable="yes" ddnsDomain="" dnsPreferred="171.70.168.183" 
         dnsAlternate="0.0.0.0" nicMode="dedicated" vicSlot="1" nicRedundancy="none" 
         vlanEnable="no" vlanId="1" vlanPriority="0" portProfile="" v6extEnabled="no" 
         v6extIp="::" v6extGw="::" v6prefix="64" v6linkLocal="::" v6SlaacIp="::" 
         v6dhcpEnable="no" v6dnsUsingDhcp="no" v6dnsPreferred="::" 
         v6dnsAlternate="::" subject="blade"/>
      </mgmtController>
    </equipmentIOCard>
  </outConfigs>
</configResolveClass>

Retrieving System Input Output Controller Properties using DN

Request: 


<configResolveDn cookie="1256516771/c56962d3-cb76-16cb-8008-aaec921b0ff4" 
      inHierarchical="true" dn='sys/chassis-1/slot-2'/>

Response: 


<configResolveDn cookie="1256516771/c56962d3-cb76-16cb-8008-aaec921b0ff4" 
response="yes" dn="sys/chassis-1/slot-2">
  <outConfig>
    <equipmentIOCard id="2" description="SIOC - System Input Output Controller" 
     dn="sys/chassis-1/slot-2">
      <mgmtController rn="mgmt" model="NA" serial="NA" 
       subject="sioc" vendor="Cisco Systems Inc">
        <firmwareRunning rn="fw-system" 
         description="System IO Controller currently running firmware version" 
         deployment="system" type="sioc" version="0.0(4.r202233)"/>
        <firmwareUpdatable rn="fw-updatable" 
         description="System IO Controller backup firmware version" 
         adminState="triggered" deployment="backup" operState="ready" 
         version="0.0(4.r202050)" protocol="none" remoteServer="" 
         remotePath="" user="" pwd="" progress="Success" type="sioc"/>
        <firmwareBootDefinition rn="fw-boot-def" type="sioc">
          <firmwareBootUnit rn="bootunit-combined" 
           description="System Input Out Controller startup firmware version" 
           adminState="triggered" image="running" resetOnActivate="no" 
           type="combined" version="0.0(4.r202233)"/>
        </firmwareBootDefinition>
        <mgmtIf rn="if-1" description="Chassis Management Interface Network Settings"
         id="1" extEnabled="yes" extIp="10.106.145.253" extMask="255.255.255.0" 
         extGw="10.106.145.1" ifType="physical" mac="F4:0F:1B:92:7A:C4" 
         hostname="UCS-server-name2" dhcpEnable="yes" dnsUsingDhcp="yes" 
         ddnsEnable="yes" ddnsDomain="" dnsPreferred="171.70.168.183" 
         dnsAlternate="0.0.0.0" nicMode="dedicated" vicSlot="1" 
         nicRedundancy="none" vlanEnable="no" vlanId="1" 
         vlanPriority="0" portProfile="" v6extEnabled="no" 
         v6extIp="::" v6extGw="::" v6prefix="64" v6linkLocal="::" 
         v6SlaacIp="::" v6dhcpEnable="no" v6dnsUsingDhcp="no" v6dnsPreferred="::" 
         v6dnsAlternate="::" subject="blade"/>
      </mgmtController>
    </equipmentIOCard>
  </outConfig>
</configResolveDn>

Configuring Single Server Dual SIOC or Single Server Single SIOC

Request: 


<configConfMo dn='sys/chassis-1' 
cookie='1485323787/b1213d94-e546-16e5-8004-f22a145daae4' inHierarchical='false'>
 <inConfig>
 <equipmentChassis dn='sys/chassis-1' 
 serverSIOCConnectivity ='single-server-single-sioc'
 rebootHost='yes' />
 </inConfig>
</configConfMo>

Response: 


<configConfMo dn='sys/chassis-1'
cookie='1485323787/b1213d94-e546-16e5-8004-f22a145daae4' response="yes">
  <outConfig>
   <equipmentChassis dn='sys/chassis-1 name="UCS S3260" 
   serial="FCH18207WEB" model="UCSS-S3260-BASE" usrLbl="" 
   assetTag="Unknown" serverSIOCConnectivity="single-server-single-sioc" 
   rebootHost="yes" status="modified"/>
 </outConfig>
</configConfMo>

Note

  • To configure single server dual SIOC, use serverSIOCConnectivity ='single-server-dual-sioc' in the command.

  • To enable the single or dual SIOC without rebooting the host, use rebootHost="no" in the command.

Dynamic Storage Tasks

The examples in this section show how to use the Cisco IMC XML API to retrieve and perform dynamic storage tasks. Each example shows the XML API request followed by the response from Cisco IMC.

This section includes the following examples:

Retrieving SAS Expander Properties

Request: 


<configResolveClass cookie="0960329953/d2022d82-6a69-196a-8002-82f92a02b884"
 inHierarchical="true" classId="chassisStorage"/>

Response: 


<configResolveClass cookie="0960329953/d2022d82-6a69-196a-8002-82f92a02b884" res
ponse="yes" classId="chassisStorage">
 <outConfigs>
  <chassisStorage dn="sys/chassis-1/storage" description="Chassis scope dynamic storage management">
   <storageChassisDisk slot="1" diskstate="done" vendor="WD" productId="WD400
    1FYYG-01SL3" revision="VR07" serial="WMC1F1927484" blocksize="512" blockcount="7
    814037168" size="3.63 TB" expander1linkspeed="6.0 Gb" expander2linkspeed="6.0 Gb
    " sasaddress1="50000c0f01e85d26" sasaddress2="50000c0f01e85d27" ownership="none"
    health="good" rn="disk-1"/>
  <storageChassisDisk slot="2" diskstate="done" vendor="WD" productId="WD400
   1FYYG-01SL3" revision="VR07" serial="WMC1F1930758" blocksize="512" blockcount="7
   814037168" size="3.63 TB" expander1linkspeed="6.0 Gb" expander2linkspeed="6.0 Gb
   " sasaddress1="50000c0f01e85bd6" sasaddress2="50000c0f01e85bd7" ownership="none"
   health="good" rn="disk-2"/>
  <storageChassisDisk slot="3" diskstate="done" 
   vendor="WD" productId="WD4001FYYG-01SL3" revision="VR07" 
   serial="WMC1F1930961" blocksize="512" blockcount="7814037168" 
   size="3.63 TB" expander1linkspeed="6.0 Gb" expander2linkspeed="6.0 Gb" 
   sasaddress1="50000c0f01e85a0a" sasaddress2="50000c0f01e85a0b" 
   ownership="none" health="good" rn="disk-3"/>

...
...
...

     <storageChassisDisk slot="60" diskstate="done" 
      vendor="WD" productId="WD4001FYYG-01SL3" revision="VR07" 
      serial="WMC1F1926558" blocksize="512" blockcount="7814037168" 
      size="3.63 TB" expander1linkspeed="6.0 Gb" expander2linkspeed="6.0 Gb" 
      sasaddress1="50000c0f012eb1f6" sasaddress2="50000c0f012eb1f7" 
      ownership="server1" health="good" rn="disk-60"/>
      <storageChassisDiskSlotEp slot="1" health="good" presence="done" rn="diskslot-1">
       <computeServerRef slot="1" diskstate="done" 
       ownership="none" rn="server-ref-none"/>
      </storageChassisDiskSlotEp>
      <storageChassisDiskSlotEp slot="2"
       health="good" presence="done" rn="diskslot-2">
       <computeServerRef slot="2" diskstate="done" 
        ownership="none" rn="server-ref-none"/>
      </storageChassisDiskSlotEp>
      <storageChassisDiskSlotEp slot="54" health="fault" 
        presence="Drive Discovery Error" rn="diskslot-54">
        <computeServerRef slot="54" diskstate="Drive Discovery Error" 
         ownership="none" rn="server-ref-none"/>
        <faultInst ack="yes" cause="equipment-inoperable" 
         code="F0181" created="2000-06-06T07:51:39" 
         descr="Storage Local disk 54 is inoperable: reseat or replace the storage drive 54"
         affectedDN="sys/chassis-1/storage/diskslot-54"
         highestSeverity="critical" id="3506451968" 
         lastTransition="2000-06-06T07:51:28" lc="flapping" 
         occur="4" origSeverity="cleared" prevSeverity="cleared" 
         rule="fltStorageLocalDiskInoperable" 
         severity="major" tags="storage" type="server" rn="fault-F0181"/>
         </storageChassisDiskSlotEp>
....
....
....

    </chassisStorage>
  </outConfigs>
</configResolveClass>

Retrieving Chassis Storage Disk Slot

Request: 


<configResolveClass cookie="0960331076/16b9fadd-6a69-196a-8003-82f92a02b884" 
 inHierarchical="true" classId="storageChassisDiskSlotEp"/>

Response: 


<configResolveClass cookie="0960331076/16b9fadd-6a69-196a-8003-82f92a02b884"
 response="yes" classId="storageChassisDiskSlotEp">
  <outConfigs>
    <storageChassisDiskSlotEp slot="1" health="good" 
     presence="done" dn="sys/chassis-1/storage/diskslot-1">
      <computeServerRef slot="1" diskstate="done" 
       ownership="none" rn="server-ref-none"/>
    </storageChassisDiskSlotEp>
    <storageChassisDiskSlotEp slot="2" health="good" 
     presence="done" dn="sys/chassis-1/storage/diskslot-2">
      <computeServerRef slot="2" diskstate="done" 
       ownership="none" rn="server-ref-none"/>
    </storageChassisDiskSlotEp>
...
...
...
    <storageChassisDiskSlotEp slot="54" health="fault" presence="Drive Discovery
     Error" dn="sys/chassis-1/storage/diskslot-54">
      <computeServerRef slot="54" diskstate="Drive Discovery Error" 
        ownership="none" rn="server-ref-none"/>
      <faultInst ack="yes" cause="equipment-inoperable" 
       code="F0181" created="2000-06-06T07:51:39" 
       descr="Storage Local disk 54 is inoperable: reseat or replace the storage drive 54"
       affectedDN="sys/chassis-1/storage/diskslot-54" 
       highestSeverity="critical" id="3506451968" 
       lastTransition="2000-06-06T07:51:28" lc="flapping" 
       occur="4" origSeverity="cleared" prevSeverity="cleared" 
       rule="fltStorageLocalDiskInoperable" severity="major" 
       tags="storage" type="server" rn="fault-F0181"/>
    </storageChassisDiskSlotEp>
...
...
...
  </outConfigs>
</configResolveClass>

Retrieving Chassis Storage Disk Slot Using DN

Request: 


<configResolveDn cookie="0960344358/94c74f08-6e69-196e-8005-82f92a02b884"
 inHierarchical="true" dn='sys/chassis-1/storage/diskslot-12'/>

Response: 


<configResolveDn cookie="0960344358/94c74f08-6e69-196e-8005-82f92a02b884"
 response="yes" dn="sys/chassis-1/storage/diskslot-12">
  <outConfig>
    <storageChassisDiskSlotEp slot="12" health="good" 
     presence="done" dn="sys/chassis-1/storage/diskslot-12">
      <computeServerRef slot="12" diskstate="done" 
       ownership="server1" rn="server-ref-server1"/>
    </storageChassisDiskSlotEp>
  </outConfig>
</configResolveDn>
>

Retrieving Chassis Storage Disk

Request: 


<configResolveClass cookie="0960344358/94c74f08-6e69-196e-8005-82f92a02b884"
 inHierarchical="true" classId="storageChassisDisk"/>

Response: 


<configResolveClass cookie="0960344358/94c74f08-6e69-196e-8005-82f92a02b884"
  response="yes" classId="storageChassisDisk">
  <outConfigs>
    <storageChassisDisk slot="1" diskstate="done" vendor="WD"
      productId="WD4001FYYG-01SL3" revision="VR07" 
      serial="WMC1F1927484" blocksize="512" blockcount="7814037168" 
      size="3.63 TB" expander1linkspeed="6.0 Gb" expander2linkspeed="6.0 Gb"
      sasaddress1="50000c0f01e85d26" sasaddress2="50000c0f01e85d27" 
      ownership="none" health="good" dn="sys/chassis-1/storage/disk-1"/>
    <storageChassisDisk slot="2" diskstate="done" 
     vendor="WD" productId="WD4001FYYG-01SL3" revision="VR07" 
     serial="WMC1F1930758" blocksize="512" blockcount="7814037168" 
     size="3.63 TB" expander1linkspeed="6.0 Gb" expander2linkspeed="6.0 Gb"
     sasaddress1="50000c0f01e85bd6" sasaddress2="50000c0f01e85bd7" ownership="none" 
     health="good" dn="sys/chassis-1/storage/disk-2"/>

...
...
...

     <storageChassisDisk slot="59" diskstate="done" vendor="WD" 
      productId="WD4001FYYG-01SL3" revision="VR07" 
      serial="WMC1F1928804" blocksize="512" blockcount="7814037168" 
      size="3.63 TB" expander1linkspeed="6.0 Gb" expander2linkspeed="6.0 Gb" 
      sasaddress1="50000c0f01e85532" sasaddress2="50000c0f01e85533" 
      ownership="server1" health="good" dn="sys/chassis-1/storage/disk-59"/>
    <storageChassisDisk slot="60" diskstate="done" vendor="WD" 
      productId="WD4001FYYG-01SL3" revision="VR07" 
      serial="WMC1F1926558" blocksize="512" blockcount="7814037168" 
      size="3.63 TB" expander1linkspeed="6.0 Gb" expander2linkspeed="6.0 Gb" 
      sasaddress1="50000c0f012eb1f6" sasaddress2="50000c0f012eb1f7" 
      ownership="server1" health="good" dn="sys/chassis-1/storage/disk-60"/>
  </outConfigs>
</configResolveClass>

Retrieving Chassis Storage Disk Using DN

Request: 


<configResolveDn cookie="0955686332/993f316f-3165-1531-8002-a35a6a1b0ff4" 
inHierarchical="false" dn='sys/chassis-1/storage/disk-1'/>

Response: 


<configResolveDn cookie="0960347338/0cad041e-6f69-196f-8007-82f92a02b884"
 response="yes" dn="sys/chassis-1/storage/disk-23">
  <outConfig>
    <storageChassisDisk slot="23" diskstate="done" 
     vendor="TOSHIBA" productId="MG03SCA400" revision="5702" 
     serial="14O0A082FVU4" blocksize="512" blockcount="7814037168" 
     size="3.63 TB" expander1linkspeed="6.0 Gb" expander2linkspeed="6.0 Gb"
     sasaddress1="5000039548e05956" sasaddress2="5000039548e05957" 
     ownership="server1" health="good" dn="sys/chassis-1/storage/disk-23"/>
  </outConfig>
</configResolveDn>

Assigning Physical Drives to Servers

Request: 


<configConfMo cookie='0955691347/295e610a-3365-1533-8002-a35a6a1b0ff4'
 dn='sys/chassis-1/storage/zone-drive'>
<inConfig>
        <storageChassisDiskSlotZoneHelper 
         dn='sys/chassis-1/storage/zone-drive' slotList="1,2,3"
         ownership="server2" adminState="trigger"/>
</inConfig>
</configConfMo>

Response: 


<configConfMo dn="sys/chassis-1/storage/zone-drive" 
    cookie="0955692275/224d31b6-3265-1532-8002-a35a6a1b0ff4" response="yes">
  <outConfig>
    <storageChassisDiskSlotZoneHelper dn="sys/chassis-1/storage/zone-drive" 
    adminState="triggered" status="modified"/>
  </outConfig>
</configConfMo>

Unassigning Physical Drives

Request: 


<configConfMo cookie='0955692275/224d31b6-3265-1532-8002-a35a6a1b0ff4'
 dn='sys/chassis-1/storage/zone-drive'>
<inConfig>
        <storageChassisDiskSlotZoneHelper 
         dn='sys/chassis-1/storage/zone-drive' slotList="1,2,3" 
        ownership="none" adminState="trigger"/>
</inConfig>
</configConfMo>

Response: 


<configConfMo cookie="0955692275/224d31b6-3265-1532-8002-a35a6a1b0ff4"
 response="yes" dn="sys/chassis-1/storage/zone-drive">
  <outConfig>
    <storageChassisDiskSlotZoneHelper 
     dn="sys/chassis-1/storage/zone-drive" 
     adminState="triggered" status="modified"/>
  </outConfig>
</configConfMo>

Enabling or Disabling the 6G or 12G Mixed Mode Speed on SAS Expander

Request: 


<configConfMo dn='sys/chassis-1/sas-expander-1'
cookie="1484806041/908bffd4-6c46-166c-807c-67f2642a6ca4" inHierarchical="false" > 
 <inConfig>
 <storageSasExpander dn='sys/chassis-1/sas-expander-1' mixed6G12GDriveSupport='Enabled'/> 
 </inConfig>
</configConfMo>

Response: 


<configConfMo dn='sys/chassis-1/sas-expander-1'
 cookie='1484806041/908bffd4-6c46-166c-807c-67f2642a6ca4' response="yes"
 <outConfig>
  <storageSasExpander id="1" name="SASEXP1" currentFwVersion="04.08.01_B075" 
  sasAddress="N/A" description="Storage controller - SAS Expander" 
  mixed6G12GDriveSupport="Pending" status="modified" >
  </storageSasExpander>
 </outConfig> 
</configConfMo>

Note

To disable the 6G or 12G Mixed Mode Speed, use the "mixed6G12GDriveSupport=disabled" attribute in the command.

Managing PID Catalog

The examples in this section show how to use the Cisco IMC XML API to retrieve and upload PID catalog. Each example shows the XML API request followed by the response from Cisco IMC.

This section includes the following examples:

Uploading PID Catalog

Request: 


<configConfMo cookie="1470041969/37207236-ff38-18ff-8003-4d32145daae4" 
dn="sys/chassis-1/pid/upload-catalog" inHierarchical="false">
<inConfig>
 <uploadPIDCatalog protocol="tftp"  remoteServer="10.104.236.99" 
  remoteFile="latestpid.tar.gz" dn="sys/chassis-1/pid/upload-catalog"/>
  </inConfig>
</configConfMo>

TFTP used in the preceding example is the default protocol. You can also download the LDAP CA certificate using the other available protocols such as the FTP, SFTP, SCP and HTTP.

Response: 


<configConfMo dn="sys/chassis-1/pid/upload-catalog" 
cookie="1470041969/37207236-ff38-18ff-8003-4d32145daae4" response="yes">
<outConfig>
 <uploadPIDCatalog dn="sys/chassis-1/pid/upload-catalog" protocol="none" remoteServer="" 
  remoteFile="" user="" pwd="" pidUploadStatus="Upload in Progress" status="modified" >
 </uploadPIDCatalog>
 </outConfig>
</configConfMo>

Activating PID Catalog on Server Node 1

Request: 


<configConfMo cookie="1462971767/5e320cff-9032-1290-8009-b1f9cc1a3500" 
  dn="sys/chassis-1/server-1/board/pid/activate-catalog" inHierarchical="false"> 
 <inConfig> 
  <activatePIDCatalog  adminState="trigger" 
   dn="sys/chassis-1/server-1/board/pid/activate-catalog"/>
  </inConfig>
 </configConfMo>

Response: 


<configConfMo dn="sys/chassis-1/server-1/board/pid/activate-catalog" 
 cookie="1470739643/d6acc6cc-a139-19a1-8002-5a45145daae4" response="yes">
<outConfig>
 <activatePIDCatalog dn="sys/chassis-1/server-1/board/pid/activate-catalog" 
  adminState="triggered" pidActivationStatus="Activation Successful" status="modified">
 </activatePIDCatalog>
</outConfig>
</configConfMo>

Activating PID Catalog on Server Node 2

Request: 


<configConfMo cookie="1462971767/5e320cff-9032-1290-8009-b1f9cc1a3500" 
  dn="sys/chassis-1/server-2/board/pid/activate-catalog" inHierarchical="false"> 
 <inConfig> 
  <activatePIDCatalog  adminState="trigger" 
   dn="sys/chassis-1/server-2/board/pid/activate-catalog"/>
  </inConfig>
 </configConfMo>

Response: 


<configConfMo dn="sys/chassis-1/server-2/board/pid/activate-catalog" 
 cookie="1470739643/d6acc6cc-a139-19a1-8002-5a45145daae4" response="yes">
<outConfig>
 <activatePIDCatalog dn="sys/chassis-1/server-2/board/pid/activate-catalog" 
  adminState="triggered" pidActivationStatus="Activation Successful" status="modified">
 </activatePIDCatalog>
</outConfig>
</configConfMo>

Viewing PID Catalog

Request: 


<configResolveClass cookie="1473455878/95c48a0a-1a3c-1c1a-8003-be18652a6ca4" 
inHierarchical="false" classId="pidCatalog”/>

Response: 


<configResolveClass cookie="1473455878/95c48a0a-1a3c-1c1a-8003-be18652a6ca4" 
 response="yes" classId="pidCatalog">
  <outConfigs>
    <pidCatalog dn="sys/chassis-1/server-1/board/pid" name="Cisco 
     Product Identifiers (PID)" version="2.0(13a)09"/>
    <pidCatalog dn="sys/chassis-1/server-2/board/pid" name="Cisco 
     Product Identifiers (PID)" version="2.0(13a)09"/>
  </outConfigs>
</configResolveClass>

Retrieving PID Catalog of CPUs

Request: 


<configResolveClass cookie='1282522267/f91bd068-8e72-1e72-8002-7e573e8f835c' 
inHierarchical='false' classId='pidCatalogCpu'/>

Response: 


<configResolveClass cookie="1470739643/d6acc6cc-a139-19a1-8002-5a45145daae4" 
response="yes" classId="pidCatalogCpu">
	<outConfigs>
		<pidCatalogCpu id="1" socketdesignation="CPU1" description="Intel(R) 
			Xeon(R) CPU E5-2620 v4 @ 2.10GHz/85W 8C/20MB Cache/DDR4 2133MHz" 
			pid="UCS-CPU-E52620E" model="Intel(R) Xeon(R) CPU E5-2620 v4 @ 2.10GHz" 
			signature="Type 0, Family 6, Model 79, Stepping 1" currentspeed="2100" 
			operState="Enabled" dn="sys/chassis-1/server-1/board/pid/pid-cpu-1" >
		</pidCatalogCpu>
		<pidCatalogCpu id="2" socketdesignation="CPU2" description="Intel(R) 
			Xeon(R) CPU E5-2620 v4 @ 2.10GHz/85W 8C/20MB Cache/DDR4 2133MHz" 
			pid="UCS-CPU-E52620E" model="Intel(R) Xeon(R) CPU E5-2620 v4 @ 2.10GHz" 
			signature="Type 0, Family 6, Model 79, Stepping 1" currentspeed="2100" 
			operState="Enabled" dn="sys/chassis-1/server-1/board/pid/pid-cpu-2" >
		</pidCatalogCpu>
		<pidCatalogCpu id="1" socketdesignation="CPU1" description="Intel(R) 
			Xeon(R) CPU E5-2695 v4 @ 2.10GHz/120W 18C/45MB Cache/DDR4 2400MHz" 
			pid="UCS-CPU-E52695E" model="Intel(R) Xeon(R) CPU E5-2695 v4 @ 2.10GHz" 
			signature="Type 0, Family 6, Model 79, Stepping 1" currentspeed="2100" 
			operState="Enabled" dn="sys/chassis-1/server-2/board/pid/pid-cpu-1" >
		</pidCatalogCpu>
		<pidCatalogCpu id="2" socketdesignation="CPU2" description="Intel(R) 
			Xeon(R) CPU E5-2695 v4 @ 2.10GHz/120W 18C/45MB Cache/DDR4 2400MHz" 
			pid="UCS-CPU-E52695E" model="Intel(R) Xeon(R) CPU E5-2695 v4 @ 2.10GHz" 
			signature="Type 0, Family 6, Model 79, Stepping 1" currentspeed="2100" 
			operState="Enabled" dn="sys/chassis-1/server-2/board/pid/pid-cpu-2" >
		</pidCatalogCpu>
	</outConfigs>
</configResolveClass>

Retrieving PID Catalog of DIMMs

Request: 


<configResolveClass cookie='1282522267/f91bd068-8e72-1e72-8002-7e573e8f835c' 
inHierarchical='false' classId='pidCatalogDimm'/>

Response: 

<configResolveClass cookie="1470739643/d6acc6cc-a139-19a1-8002-5a45145daae4" 
response="yes" classId="pidCatalogDimm"> 
<outConfigs>
	</pidCatalogDimm>
	<pidCatalogDimm name="DIMM_G2" description="32GB DDR4-2400-MHz RDIMM/PC4-19200/dual rank/x4/1.2v" 
		pid="UCS-MR-1X322RV-A" mfgid="0xCE00" manufacturer="Samsung" serialnumber="02EB3481" 
		model="M393A4K40BB1-CRC" capacity="32768 MB" speed="2400" datawidth="64 bits" 
  operability="Operable" dn="sys/chassis-1/server-2/board/pid/pid-dimm-DIMM_G2" >
	</pidCatalogDimm>
			.
			.
			.
			.
  <pidCatalogDimm name="DIMM_G2" description="32GB DDR4-2400-MHz RDIMM/PC4-19200/dual rank/x4/1.2v"
			pid="UCS-MR-1X322RV-A" mfgid="0xCE00" manufacturer="Samsung" serialnumber="02EB33FD" 
   model="M393A4K40BB1-CRC" capacity="32768 MB" speed="2400" datawidth="64 bits" 
   operability="Operable" dn="sys/chassis-1/server-2/board/pid/pid-dimm-DIMM_G1" >
		</pidCatalogDimm>
		<pidCatalogDimm name="DIMM_G2" description="32GB DDR4-2400-MHz RDIMM/PC4-19200/dual rank/x4/1.2v" 
			pid="UCS-MR-1X322RV-A" mfgid="0xCE00" manufacturer="Samsung" serialnumber="02EB3481" 
			model="M393A4K40BB1-CRC" capacity="32768 MB" speed="2400" datawidth="64 bits" 
   operability="Operable" dn="sys/chassis-1/server-2/board/pid/pid-dimm-DIMM_G2" >
		</pidCatalogDimm>
	</outConfigs>
</configResolveClass>

Retrieving PID Catalog of HDDs

Request: 


<configResolveClass cookie='1282522267/f91bd068-8e72-1e72-8002-7e573e8f835c' 
inHierarchical='false' classId='pidCatalogHdd'/>

Response: 


<configResolveClass cookie="1470739643/d6acc6cc-a139-19a1-8002-5a45145daae4" 
response="yes" classId="pidCatalogHdd">
	<outConfigs>
		<pidCatalogHdd disk="8" controller="SBMezz1" description="4TB 6Gb SAS 7.2K RPM 3.5" 
			pid="UCSC-C3X60-HD4TB" vendor="WD" model="WD4001FYYG-01SL3" 
   serialnumber="WMC1F1927555" 			dn="sys/chassis-1/server-1/board/pid/pid-hdd-8" >
		</pidCatalogHdd>
		<pidCatalogHdd disk="9" controller="SBMezz1" description="4TB 6Gb SAS 7.2K RPM 3.5" 
   pid="UCSC-C3X60-HD4TB" vendor="WD" model="WD4001FYYG-01SL3" 
   serialnumber="WMC1F1930050" dn="sys/chassis-1/server-1/board/pid/pid-hdd-9" >
		</pidCatalogHdd>
		<pidCatalogHdd disk="6" controller="SBMezz1" description="4TB 6Gb SAS 7.2K RPM 3.5" 
   pid="UCSC-C3X60-HD4TB" vendor="WD" model="WD4001FYYG-01SL3" 
   serialnumber="WMC1F1927672" dn="sys/chassis-1/server-2/board/pid/pid-hdd-6" >
		</pidCatalogHdd>
		<pidCatalogHdd disk="7" controller="SBMezz1" description="4TB 6Gb SAS 7.2K RPM 3.5" 
			pid="UCSC-C3X60-HD4TB" vendor="WD" model="WD4001FYYG-01SL3" serialnumber="WMC1F1928331" 
			dn="sys/chassis-1/server-2/board/pid/pid-hdd-7" >
  </pidCatalogHdd>
  <pidCatalogHdd disk="10" controller="SBMezz1" description="4TB 6Gb SAS 7.2K RPM 3.5" 
   pid="UCSC-C3X60-HD4TB" vendor="WD" model="WD4001FYYG-01SL3" serialnumber="WMC1F1928305" 
		dn="sys/chassis-1/server-2/board/pid/pid-hdd-10" >
		</pidCatalogHdd>
 <pidCatalogHdd disk="11" controller="SBMezz1" description="4TB 6Gb SAS 7.2K RPM 3.5" 
  pid="UCSC-C3X60-HD4TB" vendor="TOSHIBA" model="MG03SCA400" serialnumber="14P0A0E8FVU4" 
   dn="sys/chassis-1/server-2/board/pid/pid-hdd-11" >
		</pidCatalogHdd>
		<pidCatalogHdd disk="12" controller="SBMezz1" description="4TB 6Gb SAS 7.2K RPM 3.5" 
			pid="UCSC-C3X60-HD4TB" vendor="TOSHIBA" model="MG03SCA400" serialnumber="14P0A069FVU4" 
			dn="sys/chassis-1/server-2/board/pid/pid-hdd-12" >
		</pidCatalogHdd>
		<pidCatalogHdd disk="13" controller="SBMezz1" description="4TB 6Gb SAS 7.2K RPM 3.5" 
			pid="UCSC-C3X60-HD4TB" vendor="TOSHIBA" model="MG03SCA400" serialnumber="14P0A07BFVU4" 
			dn="sys/chassis-1/server-2/board/pid/pid-hdd-13" >
		</pidCatalogHdd>
		<pidCatalogHdd disk="14" controller="SBMezz1" description="4TB 6Gb SAS 7.2K RPM 3.5" 
			pid="UCSC-C3X60-HD4TB" vendor="TOSHIBA" model="MG03SCA400" serialnumber="14O0A06EFVU4" 
			dn="sys/chassis-1/server-2/board/pid/pid-hdd-14" >
		</pidCatalogHdd>
		<pidCatalogHdd disk="28" controller="SBMezz1" description="4TB 6Gb SAS 7.2K RPM 3.5" 
   pid="UCSC-C3X60-HD4TB" vendor="TOSHIBA" model="MG03SCA400" serialnumber="14O0A08MFVU4" 
  dn="sys/chassis-1/server-2/board/pid/pid-hdd-28" >
		</pidCatalogHdd>
	</outConfigs>
</configResolveClass>

Retrieving PID Catalog of PCI Adapters

Request: 

<configResolveClass cookie='1282522267/f91bd068-8e72-1e72-8002-7e573e8f835c' 
inHierarchical='false' classId='pidCatalogPCIAdapter'/>

Response: 


<configResolveClass cookie="1470739643/d6acc6cc-a139-19a1-8002-5a45145daae4" 
response="yes" classId="pidCatalogPCIAdapter">
<outConfigs>
	<pidCatalogPCIAdapter slot="SBNVMe1" description="800GB 2.5in NVMe based 
  PCIe SSD drive" pid="UCSC-C3K-NV8" vendor="0x1c58" device="0x0003" subvendor="0x1137" 
  subdevice="0x019e" dn="sys/chassis-1/server-1/board/pid/pid-pciadapter-SBNVMe1" >
	</pidCatalogPCIAdapter>
	<pidCatalogPCIAdapter slot="SIOC1" description="Cisco UCS 40Gb Ethernet" 
  pid="UCSC-C3260-SIOC" vendor="0x1137" device="0x0042" subvendor="0x1137" 
  subdevice="0x0157" dn="sys/chassis-1/server-1/board/pid/pid-pciadapter-SIOC1" >
	</pidCatalogPCIAdapter>
	<pidCatalogPCIAdapter slot="SBMezz1" description="Cisco UCS C3000 RAID controller 
  for M4 Server Blade with 4G RAID Cache" pid="UCS-C3K-M4RAID" vendor="0x1000" 
  device="0x00ce" subvendor="0x1137" subdevice="0x0197" 
 dn="sys/chassis-1/server-1/board/pid/pid-pciadapter-SBMezz1" >
 </pidCatalogPCIAdapter>
	<pidCatalogPCIAdapter slot="SIOC2" description="Cisco UCS 40Gb Ethernet" pid="N/A" 
	 vendor="0x1137"	device="0x0042" subvendor="0x1137" subdevice="0x0157" 
	dn="sys/chassis-1/server-2/board/pid/pid-pciadapter-SIOC2" >
 </pidCatalogPCIAdapter>
<pidCatalogPCIAdapter slot="SBMezz1" description="Cisco UCS C3000 RAID controller 
 for M4 Server Blade with 4G RAID Cache" pid="UCSC-C3K-M4RAID" vendor="0x1000" 
 device="0x00ce" subvendor="0x1137" subdevice="0x0197" 
 dn="sys/chassis-1/server-2/board/pid/pid-pciadapter-SBMezz1" >
	</pidCatalogPCIAdapter>
</outConfigs>
</configResolveClass>