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

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

この付録は次の項で構成されています。

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

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

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

要求:

<configResolveClass
				cookie="1357577156/9028d030-d2b5-12b5-8007-f289f4c42400"
				inHierarchical="false" 
				classId="computeRackUnit"/>

応答:

<configResolveClass
				cookie="1357577156/9028d030-d2b5-12b5-8007-f289f4c42400" 
				response="yes"
				classId="computeRackUnit"> 
			<outConfigs> 
						<computeRackUnit dn="sys/rack-unit-1" adminPower="policy" availableMemory="24576"
							lowVoltageMemory="regular-voltage" model="UCS-E160DP-M1/K9"
							memorySpeed="1334" name="E160DP" numOfAdaptors="0" numOfCores="6"
							numOfCoresEnabled="6" numOfCpus="1" numOfEthHostIfs="0" numOfFcHostIfs="0"
							numOfThreads="12" operability="operable" operPower="off" operState="ok"
							originalUuid="0024C4F4-89F2-0000-A7D1-770BCA4B8924" presence="equipped"
							serverId="1" serial="FHH16150031" totalMemory="24576" usrLbl=""
							uuid="0024C4F4-89F2-0000-A7D1-770BCA4B8924" vendor="Cisco Systems Inc">
				</computeRackUnit>
		</outConfigs> 
</configResolveClass>

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

要求:

<configResolveClass
				cookie="1357577156/9028d030-d2b5-12b5-8007-f289f4c42400"
				inHierarchical="false" 
				classId="firmwareRunning"/>

応答:

<configResolveClass
				cookie="1357577156/9028d030-d2b5-12b5-8007-f289f4c42400" 
				response="yes"
				classId="firmwareRunning"> 
		<outConfigs> 
			<firmwareRunning 
						dn="sys/rack-unit-1/bios/fw-boot-loader" deployment="boot-loader"
						type="blade-bios" version="4.6.4.9" >
		</firmwareRunning>
			<firmwareRunning
						dn="sys/rack-unit-1/mgmt/fw-boot-loader" 
						deployment="boot-loader"
						type="blade-controller" version="1.0(1.20130103121559).23">
		</firmwareRunning>
			<firmwareRunning 
						dn="sys/rack-unit-1/mgmt/fw-system">
						deployment="system" 
						type="blade-controller">	version="1.0(1.20130103121559)" >
		</firmwareRunning>
 </outConfigs> >
</configResolveClass>

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

要求:

<configResolveDn 
				cookie="1357577156/9028d030-d2b5-12b5-8007-f289f4c42400"
				inHierarchical="false" 
				dn="sys/rack-unit-1/mgmt/fw-updatable"/>

応答:

<configResolveDn 
				cookie="1357577156/9028d030-d2b5-12b5-8007-f289f4c42400"
				response="yes" 
				dn="sys/rack-unit-1/mgmt/fw-updatable"> 
		<outConfig> 
			<firmwareUpdatable 
						dn="sys/rack-unit-1/mgmt/fw-updatable"
						adminState="triggered" 
						deployment="backup" 
						operState="ready"
						version="1.0(1.20121206-pha2) #1" 
						protocol="none" 
						remoteServer=""
						remotePath="" 
						user="" 
						pwd="" 
						progress="0" 
						type="blade-controller">
		</firmwareUpdatable>
	</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="1363615849/8e4ceb60-d833-1833-8002-f289f4c42400"  
inHierarchical="false" classId="hostImage"/>

応答:

<configResolveClass cookie="1363615849/8e4ceb60-d833-1833-8002-f289f4c42400" response="yes"  
      classId="hostImage">
  <outConfig>
    <hostImage index="1" 
									name="linux.iso" 
									date="Fri, 15 Mar 2013 04:34:10 GMT" 
									size="336222208" 
								 md5sum="72869d19c2fdea60138d315156b6e7fe" 
  							dn="sys/rack-unit-1/host-image-mapping/host-image-1"/>
    </hostImage>
  </outConfig>
</configResolveClass>

サーバ電源の再投入

要求:

<configConfMo 
				cookie="1357578468/de622490-d2b5-12b5-8009-f289f4c42400"
				dn="sys/rack-unit-1">
		<inConfig>
			<computeRackUnit dn="sys/rack-unit-1"adminPower="cycle-immediate">
		</computeRackUnit>
	</inConfig>
</configConfMo>

応答:

<configConfMo 
				dn="sys/rack-unit-1"
				cookie="1357578468/de622490-d2b5-12b5-8009-f289f4c42400" 
				response="yes"> 
		<outConfig> 
	<computeRackUnit 
				dn="sys/rack-unit-1" adminPower="policy"
				availableMemory="24576" lowVoltageMemory="NOTINCP-regular-voltage"
				model="UCS-E160DP-M1/K9" memorySpeed="1334" name="E160DP"
				numOfAdaptors="0" numOfCores="6" numOfCoresEnabled="6" numOfCpus="1"
				numOfEthHostIfs="0" numOfFcHostIfs="0" numOfThreads="12"
				operability="NOTINCP-operable" operPower="on" operState="NOTINCP-ok"
				originalUuid="0024C4F4-89F2-0000-A7D1-770BCA4B8924" presence="equipped"
				serverId="1" serial="FHH16150031" totalMemory="24576" usrLbl=""
				uuid="0024C4F4-89F2-0000-A7D1-770BCA4B8924" vendor="Cisco Systems Inc"
				status="modified" >
		</computeRackUnit>
	</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>

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>

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
.
.
.