Cisco UCS ラックマウント サーバ CIMC XML API プログラマ ガイド
共通サーバ管理タスクの例
共通サーバ管理タスクの例
発行日;2013/01/24   |   ドキュメントご利用ガイド   |   ダウンロード ;   この章 pdf   ,   ドキュメント全体 pdf    |   フィードバック

共通サーバ管理タスクの例

この章の例は、 Cisco CIMC XML API を使用して共通サーバ管理タスクを実行する方法を示します。 各例は、XML API 要求に続いて CIMC からの応答を示しています。

この章には、次の例があります。

サーバの要約情報とホストの電源状態の取得

要求:

<configResolveClass cookie="1313086522/c7c08988-aa3e-1a3e-8005-5e61c2e14388" 
inHierarchical="false" classId="computeRackUnit"/>

応答:

<configResolveClass cookie="1313086522/c7c08988-aa3e-1a3e-8005-5e61c2e14388" 
response="yes" classId="computeRackUnit">
  <outConfig>
    <computeRackUnit dn="sys/rack-unit-1" adminPower="policy" availableMemory="49152" 
     model="R250-2480805W" memorySpeed="1067" name="UCS C250 M2" numOfAdaptors="1" 
     numOfCores="8" numOfCoresEnabled="8" numOfCpus="2" numOfEthHostIfs="8" 
     numOfFcHostIfs="2" numOfThreads="16" operPower="on" 
     originalUuid="100DC440-0EBC-11DF-3B97-8843E1C2615E" presence="equipped" serverId="1" 
     serial="PGS140601CS" totalMemory="49152" usrLbl="Cisco C250 Server" 
     uuid="100DC440-0EBC-11DF-3B97-8843E1C2615E" vendor="Cisco Systems Inc"/>
  </outConfig>
</configResolveClass>

サーバ コンポーネントの現在実行中のファームウェア バージョンの取得

要求:

<configResolveClass cookie="1313086522/c7c08988-aa3e-1a3e-8005-5e61c2e14388" 
inHierarchical="false" classId="firmwareRunning"/>

応答:

<configResolveClass cookie="1313086522/c7c08988-aa3e-1a3e-8005-5e61c2e14388" response="yes" 
classId="firmwareRunning">
  <outConfig>
    <firmwareRunning dn="sys/rack-unit-1/bios/fw-boot-loader" deployment="boot-loader" 
        type="blade-bios" version="C250.1.4.0.2 (Build Date: 05/20/2011)"/>
    <firmwareRunning dn="sys/rack-unit-1/mgmt/fw-boot-loader" deployment="boot-loader" 
        type="blade-controller" version="66.77(67.1305573810).16"/>
    <firmwareRunning dn="sys/rack-unit-1/mgmt/fw-system" deployment="system" 
        type="blade-controller" version="1.4(0.22)"/>
    <firmwareRunning dn="sys/rack-unit-1/adaptor-4/mgmt/fw-boot-loader" 
        deployment="boot-loader" type="adaptor" version="1.0(0.152)"/>
    <firmwareRunning dn="sys/rack-unit-1/adaptor-4/mgmt/fw-system" 
        deployment="system" type="adaptor" version="1.6(0.11)"/>
  </outConfig>
</configResolveClass>

CIMC にインストールされているバックアップ ファームウェア バージョンの取得

要求:

<configResolveDn cookie="1313086522/c7c08988-aa3e-1a3e-8005-5e61c2e14388" 
inHierarchical="false" dn="sys/rack-unit-1/mgmt/fw-updatable"/>

応答:

<configResolveDn cookie="1313086522/c7c08988-aa3e-1a3e-8005-5e61c2e14388" response="yes" 
        dn="sys/rack-unit-1/mgmt/fw-updatable">
  <outConfig>
    <firmwareUpdatable dn="sys/rack-unit-1/mgmt/fw-updatable" adminState="triggered" 
        deployment="backup" version="1.4(0.21)"/>
  </outConfig>
</configResolveDn>

inHierarchical オプションを使用した、設定済みブート順テーブルの取得

要求:

<configResolveClass cookie="1313086522/c7c08988-aa3e-1a3e-8005-5e61c2e14388" 
inHierarchical="true" classId="lsbootDef"/>

応答:

<configResolveClass cookie="1313086522/c7c08988-aa3e-1a3e-8005-5e61c2e14388" response="yes" 
      classId="lsbootDef">
  <outConfig>
    <lsbootDef dn="sys/rack-unit-1/boot-policy" name="boot-policy" 
          purpose="operational" rebootOnUpdate="no" childAction="deleteNonPresent">
      <lsbootVirtualMedia access="read-only" order="3" 
          type="virtual-media" rn="vm-read-only" childAction="deleteNonPresent"/>
      <lsbootVirtualMedia access="read-write" order="5" 
          type="virtual-media" rn="vm-read-write" childAction="deleteNonPresent"/>
      <lsbootLan rn="lan-read-only" access="read-only" order="2" 
          prot="pxe" type="lan" childAction="deleteNonPresent"/>
      <lsbootStorage rn="storage-read-write" access="read-write" order="1" 
          type="storage" childAction="deleteNonPresent">
         <lsbootLocalStorage rn="local-storage" childAction="deleteNonPresent"/>
      </lsbootStorage>
      <lsbootEfi rn="efi-read-only" access="read-only" order="4" 
          type="efi" childAction="deleteNonPresent"/>
    </lsbootDef>
  </outConfig>
</configResolveClass>

サーバのすべての電源装置ユニットに関する詳細の取得

要求:

<configResolveClass cookie="1313086522/c7c08988-aa3e-1a3e-8005-5e61c2e14388" 
inHierarchical="false" classId="equipmentPsu"/>

応答:

<configResolveClass cookie="1313086522/c7c08988-aa3e-1a3e-8005-5e61c2e14388" response="yes" 
      classId="equipmentPsu">
  <outConfig>
    <equipmentPsu id="0" model="R250-PSU2-750W" operability="operable" power="on" 
      presence="equipped" serial="ART1348S039" thermal="unknown" vendor="Cisco Systems Inc" 
      voltage="unknown" dn="sys/rack-unit-1/psu-0" childAction="deleteNonPresent"/>
    <equipmentPsu id="1" model="" operability="unknown" power="off" presence="missing" 
      serial="" thermal="unknown" vendor="" voltage="unknown" dn="sys/rack-unit-1/psu-1" 
      childAction="deleteNonPresent"/>
  </outConfig>
</configResolveClass>

DN によって識別されるファン オブジェクトに関する詳細の取得

要求:

<configResolveDn cookie="1313086522/c7c08988-aa3e-1a3e-8005-5e61c2e14388" 
inHierarchical="false" dn="sys/rack-unit-1/fan-module-1-2/fan-2"/>

応答:

<configResolveDn cookie="1313086522/c7c08988-aa3e-1a3e-8005-5e61c2e14388" response="yes" 
     dn="sys/rack-unit-1/fan-module-1-2/fan-2">
  <outConfig>
    <equipmentFan id="2" model="" module="2" operability="operable" power="on" 
      presence="equipped" serial="" thermal="not-supported" tray="1" vendor="" 
      voltage="not-supported" dn="sys/rack-unit-1/fan-module-1-2/fan-2"/>
  </outConfig>
</configResolveDn>

SNMP 設定の詳細の取得

要求:

<configResolveClass cookie="1313086522/c7c08988-aa3e-1a3e-8005-5e61c2e14388" 
inHierarchical="false" classId="commSnmp"/>

応答:

<configResolveClass cookie="1313086522/c7c08988-aa3e-1a3e-8005-5e61c2e14388" 
    response="yes" classId="commSnmp">
  <outConfig>
    <commSnmp dn="sys/svc-ext/snmp-svc" adminState="enabled" community="topSecret" 
      descr="SNMP Service" name="snmp" port="161" proto="udp" sysContact="demo@demo.com" 
      sysLocation="San Jose"/>
  </outConfig>
</configResolveClass>

サーバのローカル ハード ディスクの状態の取得

要求:

<configResolveDn cookie="1313146313/b38e04a0-aa4c-1a4c-8008-cdac38e14388" 
inHierarchical="false" dn="sys/rack-unit-1/board/disk-4"/>

応答:

<configResolveDn cookie="1313146313/b38e04a0-aa4c-1a4c-8008-cdac38e14388" response="yes" 
     dn="sys/rack-unit-1/board/disk-4">
  <outConfig>
    <storageLocalDiskSlotEp id="4" operability="operable" presence="equipped" 
      dn="sys/rack-unit-1/board/disk-4"/>
  </outConfig>
</configResolveDn>

サーバ電源の再投入

要求:

<configConfMo cookie="1313084260/40ea8058-aa3e-1a3e-8004-5e61c2e14388" dn="sys/rack-unit-1" 
     inHierarchical="false">
  <inConfig>
    <computeRackUnit adminPower="cycle-immediate" dn="sys/rack-unit-1">
    </computeRackUnit>
  </inConfig>
</configConfMo>

応答:

<configConfMo dn="sys/rack-unit-1" cookie="1313084260/40ea8058-aa3e-1a3e-8004-5e61c2e14388" 
     response="yes">
  <outConfig>
    <computeRackUnit dn="sys/rack-unit-1" adminPower="policy" availableMemory="49152" 
     model="R250-2480805W" memorySpeed="1067" name="UCS C250 M2" numOfAdaptors="1" 
     numOfCores="8" numOfCoresEnabled="8" numOfCpus="2" numOfEthHostIfs="0" 
     numOfFcHostIfs="0" numOfThreads="16" operPower="off" 
     originalUuid="100DC440-0EBC-11DF-3B97-8843E1C2615E" presence="equipped" serverId="1" 
     serial="PGS140601CS" totalMemory="49152" usrLbl="Cisco C210 Server" 
     uuid="100DC440-0EBC-11DF-3B97-8843E1C2615E" vendor="Cisco Systems Inc" 
     status="modified"/>
  </outConfig>
</configConfMo>

ブート順テーブルのセカンダリ ブート デバイスとしての EFI の設定

要求:

<configConfMo cookie="1313090863/ca79ef88-aa3f-1a3f-8006-5e61c2e14388" 
     dn="sys/rack-unit-1/boot-policy/efi-read-only" inHierarchical="false">
  <inConfig>
    <lsbootEfi order="2" status="modified" dn="sys/rack-unit-1/boot-policy/efi-read-only"/>
  </inConfig>
</configConfMo>

応答:

<configConfMo dn="sys/rack-unit-1/boot-policy/efi-read-only" 
      cookie="1313090863/ca79ef88-aa3f-1a3f-8006-5e61c2e14388" response="yes">
  <outConfig>
    <lsbootEfi dn="sys/rack-unit-1/boot-policy/efi-read-only" access="read-only" order="2" 
      type="efi" status="modified"/>
  </outConfig>
</configConfMo>

フロッピーディスク ドライブのブート デバイスとしてのブート順リストからの削除

要求:

<configConfMo cookie="1313092854/412183f8-aa40-1a40-8007-5e61c2e14388" 
     dn="sys/rack-unit-1/boot-policy/vm-read-write" inHierarchical="true">
  <inConfig>
    <lsbootVirtualMedia order="5" access="read-write" status="deleted" 
        dn="sys/rack-unit-1/boot-policy/vm-read-write"/>
  </inConfig>
</configConfMo>

応答:

<configConfMo dn="sys/rack-unit-1/boot-policy/vm-read-write" 
      cookie="1313092854/412183f8-aa40-1a40-8007-5e61c2e14388" response="yes">
   <outConfig>
   </outConfig>
</configConfMo>

inHierarchical オプションを使用した SNMP 設定の変更と設定済み SNMP トラップ レシーバの取得

要求:

<configConfMo cookie="1313090863/ca79ef88-aa3f-1a3f-8006-5e61c2e14388" 
      inHierarchical="true" dn="sys/svc-ext/snmp-svc">
 <inConfig>
     <commSnmp dn="sys/svc-ext/snmp-svc" sysContact="TheAdmin@ITDept.com" 
        community="demoPrivate" sysLocation="SanJoseCalifornia"/>
  </inConfig>
</configConfMo>

応答:

<configConfMo dn="sys/svc-ext/snmp-svc" 
     cookie="1313090863/ca79ef88-aa3f-1a3f-8006-5e61c2e14388" response="yes">
  <outConfig>
    <commSnmp dn="sys/svc-ext/snmp-svc" adminState="enabled" community="demoPrivate" 
         descr="SNMP Service" name="snmp" port="161" proto="udp" 
         sysContact="TheAdmin@ITDept.com" sysLocation="SanJoseCalifornia" status="modified" 
         childAction="deleteNonPresent">
      <commSnmpTrap adminState="disabled" community="demoPublic" hostname="11.22.33.44" 
         id="1" notificationType="informs" version="v1" rn="snmp-trap-1" status="modified" 
         childAction="deleteNonPresent"/>
      <commSnmpTrap adminState="disabled" community="demoPublic" hostname="50.60.70.80" 
         id="2" notificationType="informs" version="v1" rn="snmp-trap-2" status="modified" 
         childAction="deleteNonPresent"/>
      <commSnmpTrap adminState="disabled" community="demoPublic" hostname="0.0.0.0" id="3" 
         notificationType="informs" version="v1" rn="snmp-trap-3" status="modified" 
         childAction="deleteNonPresent"/>
      <commSnmpTrap adminState="enabled" community="demoPublic" hostname="138.148.198.218" 
         id="4" notificationType="informs" version="v1" rn="snmp-trap-4" status="modified" 
         childAction="deleteNonPresent"/>
    </commSnmp>
  </outConfig>
</configConfMo>

「Select Memory RAS」BIOS トークンの取得

要求:

<configResolveClass cookie="1313092854/412183f8-aa40-1a40-8007-5e61c2e14388" 
inHierarchical="false" classId="biosVfSelectMemoryRASConfiguration"/>

応答:

<configResolveClass cookie="1313092854/412183f8-aa40-1a40-8007-5e61c2e14388" 
    response="yes" classId="biosVfSelectMemoryRASConfiguration">
  <outConfig>
    <biosVfSelectMemoryRASConfiguration 
       dn="sys/rack-unit-1/bios/bios-settings/SelectMemory-RAS-configuration" 
       vpSelectMemoryRASConfiguration="maximum-performance" >
    </biosVfSelectMemoryRASConfiguration>
  </outConfig>
</configResolveClass>

ミラーリング モードの「Select Memory RAS」BIOS トークンの設定

要求:

<configConfMo cookie="1313092854/412183f8-aa40-1a40-8007-5e61c2e14388" 
     inHierarchical="false" 
     dn="sys/rack-unit-1/bios/bios-settings/SelectMemory-RAS-configuration">
  <inConfig>
    <biosVfSelectMemoryRASConfiguration 
       dn="sys/rack-unit-1/bios/bios-settings/SelectMemory-RAS-configuration" 
       vpSelectMemoryRASConfiguration="mirroring">
    </biosVfSelectMemoryRASConfiguration>
  </inConfig>
</configConfMo>

応答:

<configConfMo dn="sys/rack-unit-1/bios/bios-settings/SelectMemory-RAS-configuration" 
     cookie="1313092854/412183f8-aa40-1a40-8007-5e61c2e14388" response="yes">
  <outConfig>
    <biosVfSelectMemoryRASConfiguration 
       dn="sys/rack-unit-1/bios/bios-settings/SelectMemory-RAS-configuration" 
       vpSelectMemoryRASConfiguration="mirroring" status="modified"/>
  </outConfig>
</configConfMo>

TFTP を使用した CIMC 設定のエクスポート

要求:

<configConfMo dn="sys/export-config" 
      cookie="1313118253/2b07f100-aa46-1a46-8008-5e61c2e14388" inHierarchical="false">
  <inConfig>
    <mgmtBackup dn="sys/export-config" adminState="enabled" hostname="198.29.210.14" 
       remoteFile="/tftpserver/c250_config_export.cfg"/>
  </inConfig>
</configConfMo>

応答:

<configConfMo dn="sys/export-config" 
     cookie="1313118253/2b07f100-aa46-1a46-8008-5e61c2e14388" response="yes">
  <outConfig>
    <mgmtBackup dn="sys/export-config" adminState="disabled" 
       fsmStageDescr="Completed successfully" fsmRmtInvErrCode="" 
       fsmRmtInvErrDescr="NONE" 
       fsmDescr="export-config" proto="tftp" hostname="" remoteFile="" 
       status="modified"/>
  </outConfig>
</configConfMo>

上の要求がエクスポート操作を起動し、バックグラウンド タスクとして実行されます。 次の要求を送信することで、完了ステータスを定期的に照会できます。

ステータス要求:

<configResolveClass cookie="1313118253/2b07f100-aa46-1a46-8008-5e61c2e14388" 
inHierarchical="false" classId=" mgmtBackup"/>

完了後のステータス応答:

<configResolveClass cookie="1313122298/1c207238-aa47-1a47-8009-5e61c2e14388" response="yes" 
      classId="mgmtBackup">
  <outConfig>
     <mgmtBackup dn="sys/export-config" adminState="disabled" 
        fsmStageDescr="Completed successfully" fsmRmtInvErrCode="" fsmRmtInvErrDescr="NONE" 
        fsmDescr="export-config" proto="tftp" hostname="" remoteFile=""/>
  </outConfig>
</configResolveClass>

エクスポートされたコンフィギュレーション ファイルは、次の例のようになります。

[root]# cat /tftpserver/c250_config_export.cfg
<root><cimc>
<version>1.4(0.22)</version>
<network>
<hostname>ucs-c250-M2</hostname>
<mode>dedicated</mode>
<redundancy>active-standby</redundancy>
<dns-use-dhcp>no</dns-use-dhcp>
<preferred-dns-server>0.0.0.0</preferred-dns-server>
<alternate-dns-server>0.0.0.0</alternate-dns-server>
<vlan-enabled>no</vlan-enabled>
.
.
.

TFTP を使用した CIMC 設定のインポート

要求:

<configConfMo dn="sys/import-config" 
     cookie="1313118253/2b07f100-aa46-1a46-8008-5e61c2e14388" 
     inHierarchical="false">
  <inConfig>
     <mgmtImporter dn="sys/import-config" adminState="enabled" 
         hostname="198.29.210.14" remoteFile="/tftpserver/c250_config_export.cfg"/>
  </inConfig>
</configConfMo>

応答:

<configConfMo dn="sys/import-config" 
     cookie="1313118253/2b07f100-aa46-1a46-8008-5e61c2e14388" response="yes">
  <outConfig>
      <mgmtImporter dn="sys/import-config" adminState="disabled" 
          fsmStageDescr="Error" fsmRmtInvErrCode="" fsmRmtInvErrDescr="NONE" 
          fsmDescr="import-config" proto="tftp" hostname="" remoteFile="" 
          status="modified"/>
  </outConfig>
</configConfMo>

上の要求がインポート操作を起動し、バックグラウンド タスクとして実行されます。 次の要求を送信することで、完了ステータスを定期的に照会できます。

ステータス要求:

<configResolveClass cookie="1313118253/2b07f100-aa46-1a46-8008-5e61c2e14388" 
inHierarchical="false" classId="mgmtImporter"/>

完了前のステータス応答:

<configResolveClass cookie="1313118253/2b07f100-aa46-1a46-8008-5e61c2e14388" response="yes" 
     classId="mgmtImporter">
  <outConfig>
    <mgmtImporter dn="sys/import-config" adminState="enabled" 
       fsmStageDescr="Applying configuration" fsmRmtInvErrCode="" 
       fsmRmtInvErrDescr="NONE" fsmDescr="import-config" proto="tftp" hostname="" 
       remoteFile=""/>
  </outConfig>
</configResolveClass>

繰り返しのステータス要求:

<configResolveClass cookie="1313118253/2b07f100-aa46-1a46-8008-5e61c2e14388" 
inHierarchical="false" classId="mgmtImporter"/>

完了後のステータス応答:

<configResolveClass cookie="1313118253/2b07f100-aa46-1a46-8008-5e61c2e14388" response="yes" 
      classId="mgmtImporter">
  <outConfig>
     <mgmtImporter dn="sys/import-config" adminState="disabled" 
        fsmStageDescr="Completed successfully" fsmRmtInvErrCode="" 
        fsmRmtInvErrDescr="NONE" fsmDescr="import-config" proto="tftp" hostname="" 
        remoteFile=""/>
  </outConfig>
</configResolveClass>

TFTP を使用した CIMC テクニカル サポート データのエクスポート

要求:

<configConfMo dn="sys/rack-unit-1/tech-support" 
      cookie="1313118253/2b07f100-aa46-1a46-8008-5e61c2e14388" inHierarchical="false">
  <inConfig>
     <sysdebugTechSupportExport dn="sys/rack-unit-1/tech-support" adminState="enabled" 
        remoteFile="/tftpserver/c250_techsupport_archive.tgz" hostname="198.29.210.14"/>
  </inConfig>
</configConfMo>

応答:

<configConfMo dn="sys/rack-unit-1/tech-support" 
      cookie="1313118253/2b07f100-aa46-1a46-8008-5e61c2e14388" response="yes">
  <outConfig>
     <sysdebugTechSupportExport dn="sys/rack-unit-1/tech-support" adminState="disabled" 
         hostname="198.29.210.14" proto="tftp" 
         remoteFile="/tftpserver/c250_techsupport_archive.tgz" fsmStageDescr="none" 
         fsmProgr="0" fsmStatus="nop" status="modified"/>
  </outConfig>
</configConfMo>

上の要求がエクスポート操作を起動し、バックグラウンド タスクとして実行されます。 次の要求を送信することで、完了ステータスを定期的に照会できます。

ステータス要求:

<configResolveClass cookie="1313118253/2b07f100-aa46-1a46-8008-5e61c2e14388" 
inHierarchical="false" classId="sysdebugTechSupportExport"/>

完了前のステータス応答:

<configResolveClass cookie="1313118253/2b07f100-aa46-1a46-8008-5e61c2e14388" 
      response="yes" classId="sysdebugTechSupportExport">
  <outConfig>
     <sysdebugTechSupportExport dn="sys/rack-unit-1/tech-support" adminState="enabled" 
        hostname="198.29.210.14" proto="tftp" 
        remoteFile="/tftpserver/c250_techsupport_archive.tgz" 
        fsmStageDescr="collecting" fsmProgr="0" fsmStatus="exporting"/>
  </outConfig>
</configResolveClass>

繰り返しのステータス要求:

<configResolveClass cookie="1313118253/2b07f100-aa46-1a46-8008-5e61c2e14388" 
inHierarchical="false" classId="sysdebugTechSupportExport"/>

完了後のステータス応答:

<configResolveClass cookie="1313118253/2b07f100-aa46-1a46-8008-5e61c2e14388" 
      response="yes" classId="sysdebugTechSupportExport">
  <outConfig>
     <sysdebugTechSupportExport dn="sys/rack-unit-1/tech-support" adminState="disabled" 
         hostname="198.29.210.14" proto="tftp" 
         remoteFile="/tftpserver/c250_techsupport_archive.tgz" 
         fsmStageDescr="completed" fsmProgr="100" fsmStatus="success"/>
  </outConfig>
</configResolveClass>

エクスポートされたテクニカル サポート ファイルは、次の例のようになります。

[root]# tar tvfz /tftpserver/c250_techsupport_archive.tgz | more
drwxr-xr-x root/root         0 2011-08-11 13:01:10 obfl/
-rw-r--r-- root/root     76910 2011-08-11 13:00:56 obfl/obfl-log.1
-rw-r--r-- root/root     76835 1970-01-01 09:38:26 obfl/obfl-log.2
-rw-r--r-- root/root     76881 2011-08-08 21:20:55 obfl/obfl-log.3
-rw-r--r-- root/root     76916 1969-12-31 16:07:28 obfl/obfl-log.4
-rw-r--r-- root/root     76846 2011-08-03 21:38:49 obfl/obfl-log.5
-rw-r--r-- root/root     14598 2011-08-11 20:49:57 obfl/obfl-log
.
.
.