Managing Remote Presence

This chapter includes the following sections:

Managing Cisco IMC-Mapped vMedia Volume

The examples in this section show how to use the Cisco IMC XML API to manage Cisco IMC-Mapped vMedia volumes. Each example shows the XML API request followed by the response from Cisco IMC.

This section includes the following examples:

Configuring a Cisco IMC-Mapped vMedia Volume

Request: 

<configConfMo cookie='1418471980/706e0794-180a-1a18-8007-91fabb1b0ff4' 
dn='sys/chassis-1/server-1/svc-ext/vmedia-svc/vmmap-HUU' inHierarchical='false'>
<inConfig>
<commVMediaMap dn='sys/chassis-1/server-1/svc-ext/vmedia-svc/vmmap-HUU' 
  map='www' mountOptions='username=jchambers,password=john123' 
  remoteFile='ucs-huu-2.0.2d.iso' 
  remoteShare='http://171.70.126.106/firmware-containers/colusa1/ep_mr_colusa2/' 
  status='created' volumeName='HUU' />
</inConfig>
</configConfMo>

Response: 

<configConfMo dn="sys/chassis-1/server-1/svc-ext/vmedia-svc/vmmap-HUU" 
 cookie="1418471980/706e0794-180a-1a18-8007-91fabb1b0ff4" response="yes">
<outConfig>
 <commVMediaMap volumeName="HUU" map="www" 
  remoteShare="http://171.70.126.106/firmware-containers/colusa1/ep_mr_colusa1/" 
  remoteFile="ucs-huu-2.0.2d.iso" 
  mountOptions="noauto,username=jchambers,password=*******" 
  mappingStatus="In Progress" password="" 
  dn="sys/chassis-1/server-1/svc-ext/vmedia-svc/vmmap-HUU" status="created"/>
  </outConfig>
</configConfMo>

Retrieving and Verifying Cisco IMC-Mapped vMedia Volume Configuration

Request: 

<configResolveClass cookie="1418471980/706e0794-180a-1a18-8007-91fabb1b0ff4" 
inHierarchical="false" classId="commVMediaMap"/>

Response: 

<configResolveClass cookie="1418471980/706e0794-180a-1a18-8007-91fabb1b0ff4" 
response="yes" classId="commVMediaMap">
  <outConfigs>
    <commVMediaMap volumeName="HUU" map="www" 
    remoteShare="http://171.70.126.106/firmware-containers/colusa1/ep_mr_colusa2/" 
    remoteFile="ucs-c3x60-huu-2.0.2d.iso" 
    mountOptions="noauto,username=jchambers,password=*******" 
    mappingStatus="OK" password="" 
    dn="sys/chassis-1/server-1/svc-ext/vmedia-svc/vmmap-HUU"/>
  </outConfigs>
</configResolveClass>

Unmapping Cisco IMC vMedia Mapping

Request: 


<configConfMo cookie="$COOKIE$ " dn="sys/svc-ext/vmedia-svc/vmmap-HUU">
     	<inConfig>
         		<commVMediaMap dn="sys/svc-ext/vmedia-svc/vmmap-HUU" 
											volumeName="HUU" map="nfs" status="deleted" />
     	</inConfig>
</configConfMo>

Unmapping and Saving vMedia Mapping

Request: 


<configConfMo cookie="0000013783/da92cfae-0003-1003-800a-0c0bcf506dd4" 
 dn="sys/svc-ext/vmedia-svc/vmmap-huu" inHierarchical="false"> 
<inConfig>
 <commVMediaMap dn="sys/svc-ext/vmedia-svc/vmmap-huu"  
  adminAction="save-unmapped-volume"/> 
</inConfig>
</configConfMo>

Response: 


<configConfMo dn="sys/svc-ext/vmedia-svc/vmmap-huu" 
  cookie="0000013783/da92cfae-0003-1003-800a-0c0bcf506dd4" response="yes">
<outConfig>
</outConfig>
</configConfMo>

Remapping the Saved vMedia Mapping

Request: 

<configConfMo cookie="0000017389/42642893-0004-1004-800d-0c0bcf506dd4" 
dn="sys/svc-ext/vmedia-svc/saved-vmmap-huu" inHierarchical="false"> 
<inConfig>
 <commSavedVMediaMap dn="sys/svc-ext/vmedia-svc/saved-vmmap-huu" 
  adminAction="remap-volume"/> 
</inConfig>
</configConfMo>

Response: 


<configConfMo dn="sys/svc-ext/vmedia-svc/saved-vmmap-huu" 
    cookie="0000017389/42642893-0004-1004-800d-0c0bcf506dd4" response="yes">
  <outConfig>
     <commSavedVMediaMap volumeName="huu" map="www" 
        remoteShare="https://10.104.236.99/Browse/ISO-Images/" 
        remoteFile="8GB_HDD.img" mountOptions="noauto" 
        mappingStatus="" password="" adminAction="no-op" 
        n="sys/svc-ext/vmedia-svc/saved-vmmap-huu" status="modified" >
    </commSavedVMediaMap>
  </outConfig>

Deleting Saved vMedia Mapping

Request: 


<configConfMo cookie="0000017389/42642893-0004-1004-800d-0c0bcf506dd4" 
dn="sys/svc-ext/vmedia-svc" inHierarchical="false"> 
<inConfig>
 <commVMedia dn="sys/svc-ext/vmedia-svc"  
  adminAction="delete-all-saved-mappings"/> 
</inConfig>
</configConfMo>

Response: 


<outConfig>
<commVMedia dn="sys/svc-ext/vmedia-svc" adminState="enabled" activeSessions="0" 
 encryptionState="disabled" lowPowerUsbState="enabled" adminAction="no-op" status="modified" >
 </commVMedia>
</outConfig>
</configConfMo>

Managing KVM Console

The examples in this section show how to use the Cisco IMC XML API to manage the KVM console. Each example shows the XML API request followed by the response from Cisco IMC.

This section includes the following examples:

Retrieving Authentication Tokens

Request: 


<aaaGetComputeAuthTokens cookie="1256423862/2cdc2ed8-b676-16b6-8005-aaec921b0ff4"/>

Response: 


<aaaGetComputeAuthTokens cookie="1256423862/2cdc2ed8-b676-16b6-8005-aaec921b0ff4"
  outTokens="1804289383,846930886" response="yes"> </aaaGetComputeAuthTokens>

Launching KVM Console

KVM Server 1 


javaws 
"https://10.104.255.243/kvm.jnlp?cimcAddr=10.104.255.181&cimcName=chuckrobbins&tkn1=1804289383&tkn2=846930886"

KVM Server 2 

javaws 
"https://10.104.255.243/kvm.jnlp?cimcAddr=10.104.255.183&cimcName=jchambers&tkn1=1804289383&tkn2=846930886"

Managing Serial Over LAN

The examples in this section show how to use the Cisco IMC XML API to manage retrieving and configuring serial over LAN. Each example shows the XML API request followed by the response from Cisco IMC.

This section includes the following examples:

Retrieving Serial Over LAN Details

Request: 

<configResolveClass cookie="1256429224/24b9387f-b776-16b7-8009-aaec921b0ff4" 
inHierarchical="false" classId="solIf"/>

Response: 

<configResolveClass cookie="1256429224/24b9387f-b776-16b7-8009-aaec921b0ff4" 
response="yes" classId="solIf">
  <outConfigs>
    <solIf dn="sys/chassis-1/server-1/sol-if" adminState="enable" name="SoLInterface" 
     speed="115200" comport="com0"/>
    <solIf dn="sys/chassis-1/server-2/sol-if" adminState="enable" name="SoLInterface" 
     speed="115200" comport="com0"/>
  </outConfigs>
</configResolveClass>

Retrieving Serial Over LAN Details for Server 1 Using DN

Request: 

<configResolveDn cookie="1256429224/24b9387f-b776-16b7-8009-aaec921b0ff4" 
dn="sys/chassis-1/server-1/sol-if"  inHierarchical="false"/>

Response: 

<configResolveDn cookie="1256429224/24b9387f-b776-16b7-8009-aaec921b0ff4" 
response="yes" dn="sys/chassis-1/server-1/sol-if">
  <outConfig>
    <solIf dn="sys/chassis-1/server-1/sol-if" adminState="enable" name="SoLInterface" 
    speed="115200" comport="com0"/>
  </outConfig>
</configResolveDn>

Configuring Serial Over LAN for Server 1

Request: 

<configConfMo cookie='1256429224/24b9387f-b776-16b7-8009-aaec921b0ff4' 
dn='sys/chassis-1/server-2/sol-if'>
<inConfig>
  <solIf dn='sys/chassis-1/server-2/sol-if' adminState='disable' 
   speed='38400'  comport='com0'/>
 </inConfig>
</configConfMo>

Response: 

<configConfMo dn="sys/chassis-1/server-2/sol-if" 
cookie="1256429224/24b9387f-b776-16b7-8009-aaec921b0ff4" response="yes">
 <outConfig>
   <solIf dn="sys/chassis-1/server-2/sol-if" adminState="disable" 
    name="SoLInterface" speed="38400" comport="com0" status="modified"/>
 </outConfig>
</configConfMo>