この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
目次
この章の例は、 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>
要求:
<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>
要求:
<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>
要求:
<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>
要求:
<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>
要求:
<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>
要求:
<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>
要求:
<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>
要求:
<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>
要求:
<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> . . .
要求:
<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>
要求:
<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 . . .