Using CIMC Mounted vMedia     

Document created by jeffoste on Jul 16, 2013Last modified by jeffoste on Nov 1, 2013
Version 3Show Document
  • View in full screen mode

There are many great new features that have been rolled into the CIMC 1.5 release for Standalone C-Series Servers. I presented a session at Cisco Live outlining many of these new features, but also wanted to take a few minutes to share more details and samples that I was not able to share in this session.

 

CIMC Mounted vMedia will allow customers to mount media from a remote file location and is available through all three CIMC interfaces (XML API, CLI and also WebUI). This feature supports multiple share types including NFS, CIFS, and WWW shares.

 

Some of the advantages of CIMC Mounted vMedia include:

  • Communication between mounted media and target stays local (inside datacenter)
  • Media mounts can be scripted/automated
  • No vKVM requirements for media connection
  • Multiple share types supported
  • Connections supported through all CIMC interfaces

Note: CIMC Mounted vMedia is enabled through BIOS configuration.

 

Getting started with CIMC Mounted vMedia is easy! Here are some samples on how to use this feature…

 

-----------------------------------------------------------------------------------------------------------------------

1. Scriptable vMedia Overview – WebUI:

In the WebUI, CIMC Mounted vMedia (also referred to as Network Mounted vMedia) is located in the Server Tab under the Remote Presence --> Virtual Media option.  Click on the ‘Add New Mapping’ button and provide mount details on the menu referenced above.

CIMC_vMedia.png

 

-----------------------------------------------------------------------------------------------------------------------

2. Scriptable vMedia Overview – Command Line Interface:

login as: admin

admin@10.10.10.10's password: <password>

ucs-c24-m3#

ucs-c24-m3# scope vmedia

ucs-c24-m3 /vmedia # map-nfs WIN2012 10.10.10.11:/ISOS/Windows/Windows_2012/ en_windows_server_2012_x64_dvd_915478.iso

ucs-c24-m3 /vmedia # show mappings

Volume Map-Status Drive-Type Remote-Share Remote-File Mount-Type

---------------- ------------------------ ---------- ------------------------ ------------------------ --------

WIN2012 OK CD         10.10.10.11:/ISOS/Wi... en_windows_server_201... nfs

ucs-c24-m3 /vmedia # show mappings detail

Volume WIN2012:

    Map-Status: OK

    Drive-Type: CD

    Remote-Share: 10.10.10.1:/ISOS/Windows/Windows_2012/

    Remote-File: en_windows_server_2012_x64_dvd_915478.iso

    Mount-Type: nfs

    Mount-Options: "timeo=2,retry=2,nolock,soft,noexec,rsize=3072,wsize=3072"

ucs-c24-m3 /vmedia # unmap WIN2012

ucs-c24-m3 /vmedia #

 

 

-----------------------------------------------------------------------------------------------------------------------

3. Scriptable vMedia Overview - XML API: (NFS)

Login:

curl -k -d "<aaaLogin inName='admin' inPassword='password'></aaaLogin>" http://10.10.10.10/nuova

 

 

Response:

<aaaLogin cookie="" response="yes" outCookie="1369402946/f834c550-dd76-1d76-800b-233362a70344" outRefreshPeriod="600" outPriv="admin"> </aaaLogin>

 

------------------------

Map vMedia: (In this case we are mapping a Windows 2012 ISO over NFS):

curl -d "<configConfMo cookie='1369402946/f834c550-dd76-1d76-800b-233362a70344' inHierarchical='false' dn='sys/svc-ext/vmedia-svc/vmmap-WIN12'> <inConfig> <commVMediaMap map='nfs' dn='sys/svc-ext/vmedia-svc/vmmap-WIN12' volumeName='WIN12' remoteShare='10.10.10.11:/ISOS/Windows/Windows_2012' remoteFile='en_windows_server_2012_x64_dvd_915478.iso' /> </inConfig> </configConfMo>" http://10.10.10.10/nuova

 

 

Response:

<configConfMo dn="sys/svc-ext/vmedia-svc/vmmap-WIN12" cookie="1369402946/f834c550-dd76-1d76-800b-233362a70344" response="yes">

<outConfig>

<commVMediaMap volumeName="WIN12" map="nfs" remoteShare="10.10.10.11:/ISOS/Windows/Windows_2012" remoteFile="en_windows_server_2012_x64_dvd_915478.iso" mountOptions="nolock,noexec,soft,timeo=2,retry=2,rsize=3072,wsize=3072" mappingStatus="In Progress" dn="sys/svc-ext/vmedia-svc/vmmap-WIN12" status="created" ></commVMediaMap></outConfig>

</configConfMo>

 

------------------------

Optional - Check Mapping:

curl -d "<configResolveChildren cookie='1369402946/f834c550-dd76-1d76-800b-233362a70344' inHierarchical='false' inDn='sys/svc-ext/vmedia-svc'/>" http://10.10.10.10/nuova

 

 

Response:

<configResolveChildren cookie="1369402946/f834c550-dd76-1d76-800b-233362a70344" response="yes">

<outConfigs>

<commVMediaMap volumeName="WIN12" map="nfs" remoteShare="10.10.10.11:/ISOS/Windows/Windows_2012" remoteFile="en_windows_server_2012_x64_dvd_915478.iso" mountOptions="nolock,noexec,soft,timeo=2,retry=2,rsize=3072,wsize=3072" mappingStatus="OK" dn="sys/svc-ext/vmedia-svc/vmmap-WIN12" ></commVMediaMap></outConfigs>

</configResolveChildren>

 

------------------------

Optional - Set Boot Order and reboot server:

Curl -k -d "<configConfMo cookie='1369402946/f834c550-dd76-1d76-800b-233362a70344' inHierarchical='true' dn='sys/rack-unit-1/boot-policy'> <inConfig> <lsbootDef dn='sys/rack-unit-1/boot-policy' rebootOnUpdate='yes'> <lsbootVirtualMedia access='read-only' order='1' type='virtual-media' rn='vm-read-only'/> <lsbootStorage access='read-write' order='2' type='storage' rn='storage-read-write'/>  </lsbootDef> </inConfig></configConfMo>" http://10.10.10.10/nuova

 

 

Response:

<configConfMo dn="sys/rack-unit-1/boot-policy" cookie="1369402946/f834c550-dd76-1d76-800b-233362a70344" response="yes">

<outConfig>

<lsbootDef dn="sys/rack-unit-1/boot-policy" name="boot-policy" purpose="operational" rebootOnUpdate="no" status="modified" ><lsbootVirtualMedia access="read-only" order="1" type="virtual-media" rn="vm-read-only" status="modified" ></lsbootVirtualMedia><lsbootStorage rn="storage-read-write" access="read-write" order="2" type="storage" status="modified" ><lsbootLocalStorage rn="local-storage" status="modified" ></lsbootLocalStorage></lsbootStorage></lsbootDef></outConfig>

</configConfMo>

 

------------------------

Delete vMedia Mapping:

curl -d "<configConfMo cookie='1369402946/f834c550-dd76-1d76-800b-233362a70344' inHierarchical='false' dn='sys/svc-ext/vmedia-svc/vmmap-WIN12' >   <inConfig> <commVMediaMap map='nfs' dn='sys/svc-ext/vmedia-svc/vmmap-WIN12' volumeName='WIN12' remoteShare='10.10.10.11:/ISOS/Windows/Windows_2012' remoteFile='en_windows_server_2012_x64_dvd_915478.iso' status='removed' /> </inConfig></configConfMo>" http://10.10.10.10/nuova

 

 

Response:

<configConfMo dn="sys/svc-ext/vmedia-svc/vmmap-WIN12" cookie="1369402946/f834c550-dd76-1d76-800b-233362a70344" response="yes">

<outConfig>

</outConfig>

</configConfMo>

 

------------------------

Optional - Check Mapping:

curl -d "<configResolveChildren cookie='1369402946/f834c550-dd76-1d76-800b-233362a70344' inHierarchical='false' inDn='sys/svc-ext/vmedia-svc'/>" http://10.10.10.10/nuova

 

 

Response:

<configResolveChildren cookie="1369402946/f834c550-dd76-1d76-800b-233362a70344" response="yes">

<outConfigs>

</outConfigs>

</configResolveChildren>

 

-----------------------------------------------------------------------------------------------------------------------

4. Scriptable vMedia Overview - XML API: (WWW)

 

Login:

curl -k -d "<aaaLogin inName='admin' inPassword='password'></aaaLogin>" http://10.10.10.10/nuova

 

Response:

<aaaLogin cookie="" response="yes" outCookie="1379157121/0a4e4440-e656-1656-8049-d5a4206516bc" outRefreshPeriod="600" outPriv="admin" outSessionId="155" outVersion="1.5(1.38)"> </aaaLogin>

 

------------------------

Map vMedia: (In this case we are mapping a Windows 2012 ISO over NFS) - NFS, CIFS, or WWW supported:

curl -d "<configConfMo cookie='1379157121/0a4e4440-e656-1656-8049-d5a4206516bc' dn='sys/svc-ext/vmedia-svc/vmmap-Win12' inHierarchical='false'> <inConfig><commVMediaMap dn='sys/svc-ext/vmedia-svc/vmmap-Win12' map='www' mountOptions='username=,password=' remoteFile='en_windows_server_2012_x64_dvd_915478.iso' remoteShare='http://10.29.143.50/' status='created' volumeName='Win12' /></inConfig> </configConfMo>" http://10.10.10.10/nuova

 

 

Response:

<configConfMo dn="sys/svc-ext/vmedia-svc/vmmap-Win12" cookie="1379157121/0a4e4440-e656-1656-8049-d5a4206516bc" response="yes">

<outConfig>

<commVMediaMap volumeName="Win12" map="www" remoteShare="http://10.29.143.50/" remoteFile="en_windows_server_2012_x64_dvd_915478.iso" mountOptions="noauto,username=,password=" mappingStatus="In Progress" dn="sys/svc-ext/vmedia-svc/vmmap-Win12" status="created" ></commVMediaMap></outConfig>

</configConfMo>

 

------------------------

Optional - Check Mapping:

curl -d "<configResolveChildren cookie='1379157121/0a4e4440-e656-1656-8049-d5a4206516bc' inHierarchical='false' inDn='sys/svc-ext/vmedia-svc'/>" http://10.10.10.10/nuova

 

Response:

<configResolveChildren cookie="1379157121/0a4e4440-e656-1656-8049-d5a4206516bc" response="yes">

<outConfigs>

<commVMediaMap volumeName="Win12" map="www" remoteShare="http://10.29.143.50/" remoteFile="en_windows_server_2012_x64_dvd_915478.iso" mountOptions="noauto,username=,password=" mappingStatus="OK" dn="sys/svc-ext/vmedia-svc/vmmap-Win12" ></commVMediaMap></outConfigs>

</configResolveChildren>

 

------------------------

Set Boot Order and reboot server:

Curl -k -d "<configConfMo cookie='1379157121/0a4e4440-e656-1656-8049-d5a4206516bc' inHierarchical='true' dn='sys/rack-unit-1/boot-policy'> <inConfig> <lsbootDef dn='sys/rack-unit-1/boot-policy' rebootOnUpdate='yes'> <lsbootVirtualMedia access='read-only' order='1' type='virtual-media' rn='vm-read-only'/> <lsbootStorage access='read-write' order='2' type='storage' rn='storage-read-write'/>  </lsbootDef> </inConfig></configConfMo>" http://10.10.10.10/nuova

 

Response:

<configConfMo dn="sys/rack-unit-1/boot-policy" cookie="1379157121/0a4e4440-e656-1656-8049-d5a4206516bc" response="yes">

<outConfig>

<lsbootDef dn="sys/rack-unit-1/boot-policy" name="boot-policy" purpose="operational" rebootOnUpdate="no" status="modified" ><lsbootVirtualMedia access="read-only" order="1" type="virtual-media" rn="vm-read-only" status="modified" ></lsbootVirtualMedia><lsbootStorage rn="storage-read-write" access="read-write" order="2" type="storage" status="modified" ><lsbootLocalStorage rn="local-storage" status="modified" ></lsbootLocalStorage></lsbootStorage></lsbootDef></outConfig>

</configConfMo>

 

------------------------

Delete vMedia Mapping:

curl -d "<configConfMo cookie='1379157121/0a4e4440-e656-1656-8049-d5a4206516bc' inHierarchical='false' dn='sys/svc-ext/vmedia-svc/vmmap-Win12' >   <inConfig> <commVMediaMap map='www' dn='sys/svc-ext/vmedia-svc/vmmap-Win12' volumeName='Win12' remoteShare='http://10.29.143.50:/' remoteFile='en_windows_server_2012_x64_dvd_915478.iso' status='removed' /> </inConfig></configConfMo>" http://10.10.10.10/nuova

 

Response:

<configConfMo dn="sys/svc-ext/vmedia-svc/vmmap-Win12" cookie="1379157121/0a4e4440-e656-1656-8049-d5a4206516bc" response="yes">

<outConfig>

</outConfig>

</configConfMo>

 

------------------------

Optional - Check Mapping:

curl -d "<configResolveChildren cookie='1379157121/0a4e4440-e656-1656-8049-d5a4206516bc' inHierarchical='false' inDn='sys/svc-ext/vmedia-svc'/>" http://10.10.10.10/nuova

 

Response:

<configResolveChildren cookie="1379157121/0a4e4440-e656-1656-8049-d5a4206516bc" response="yes">

<outConfigs>

</outConfigs>

</configResolveChildren>


Attachments

    Outcomes