Host Image Mapping with Cisco UCS Director IMC Connector Pack,Release 6.6.0.1
This document describes the host image mapping changes and enhancements introduced in the Cisco UCS Director IMC Connector, Release 6.6.0.1 release.
Host Image Mapping
Host Image Mapping is a commonly used feature for the E-Series servers which allows you to download a firmware file to Cisco IMC, and upgrade the firmware. Using Cisco UCS Director, you can create a host image mapping profile to download and upgrade either one of the following:
-
ISO firmware image
-
CIMC image or
-
BIOS image
You can download the firmware image on Cisco IMC in one of the following methods:
-
Provide a location on the network (an FTP, FTPS, HTTP or HTTPS server) where the firmware file is currently available.
For more information, see Adding a Network Host Image Mapping Profile
-
Choose the firmware file from a location on your system.
For more information, see Creating an Upload Profile for Host Image Mapping
-
Download the firmware image from www.cisco.com.
For more information, see Creating a Cisco.com Profile for Host Image Mapping
Important |
To perform these tasks, Cisco IMC version 3.2.4 must be installed on the E-series servers. This feature does not work with prior versions of Cisco IMC. |
For information on creating a profile to upgrade the firmware, see Adding a Network Host Image Mapping Profile.
Adding a Network Host Image Mapping Profile
Before you begin
You should have created rack accounts for UCS E-series servers in the system.
Procedure
Step 1 |
Choose . |
||||||||||||||||||||||||||||||||||||
Step 2 |
On the Physical Accounts page, click Host Image Mapping. |
||||||||||||||||||||||||||||||||||||
Step 3 |
Choose Network Profile. Click this button if you have downloaded the firmware image from a location on the network. |
||||||||||||||||||||||||||||||||||||
Step 4 |
On the Create Host Image Mapping Profile - Network screen, complete the required fields, including the following:
|
||||||||||||||||||||||||||||||||||||
Step 5 |
Click Submit. |
What to do next
After creating a profile, you must select a server on which this profile must run on. For more information, see Applying a Host Image Profile.
Following are some of the other actions you can perform after creating a profile:
-
Edit or delete a profile
-
View status information for a profile
-
Initiate the upgrade process if not previously indicated while creating the profile.
Creating an Upload Profile for Host Image Mapping
Follow this procedure to upload a firmware file from your system to Cisco IMC.
Before you begin
You should have created rack accounts for UCS E-series servers in the system.
Procedure
Step 1 |
Choose . |
||||||||||||||||||||||
Step 2 |
On the Physical Accounts page, click Host Image Mapping. |
||||||||||||||||||||||
Step 3 |
Choose Upload Profile. |
||||||||||||||||||||||
Step 4 |
In the Create Host Image Mapping Profile – Upload screen, complete the required fields including the following:
|
||||||||||||||||||||||
Step 5 |
Click Submit. |
What to do next
After creating a profile, you must select a server on which this profile must run on. For more information, see Applying a Host Image Profile.
Following are some of the other actions you can perform after creating a profile:
-
Edit or delete a profile
-
View status information for a profile
-
Initiate the upgrade process if not previously indicated while creating the profile.
Creating a Cisco.com Profile for Host Image Mapping
Complete this procedure to create a profile to download an image from www.cisco.com.
Before you begin
-
You should have configured the Cisco.com user credentials. For more information, see Configuring Cisco.com User
-
You should enabled proxy configuration on the system. For more information, see Configuring Proxy Settings
Procedure
Step 1 |
Choose . |
||||||||||||||||||||||||
Step 2 |
On the Physical Accounts page, click Host Image Mapping. |
||||||||||||||||||||||||
Step 3 |
Choose CCO Profile. |
||||||||||||||||||||||||
Step 4 |
In the Create Host Image Mapping Profile - CCO screen, complete the required fields, including the following:
|
||||||||||||||||||||||||
Step 5 |
Click Submit. |
What to do next
After creating a profile, you must select a server on which this profile must run on. For more information, see Applying a Host Image Profile.
Following are some of the other actions you can perform after creating a profile:
-
Edit or delete a profile
-
View status information for a profile
-
Initiate the upgrade process if not previously indicated while creating the profile.
-
Download an image if not previously downloaded while creating the profile.
-
Delete a downloaded image.
Applying a Host Image Profile
After creating a host image mapping profile, you can select a server on which:
-
A profile can be run to download the image to Cisco IMC or
-
firmware upgrade must be initiated immediately, provided you selected the Run Upgrade After Download check box while creating the profile.
Note |
If you do not apply a host image profile, then blank reports are generated when you choose the View Status option. Also, you cannot initiate a firmware upgrade without applying a profile, or when the Apply Host Image Profile action is in progress. |
Before you begin
You should have created a host image mapping profile in the system.
Procedure
Step 1 |
Choose . |
Step 2 |
On the Physical Accounts page, click Host Image Mapping. |
Step 3 |
Select a profile from the table and click Apply. Alternatively, you can select and profile, and choose Apply from the More Actions drop-down list. |
Step 4 |
In the Apply Profile screen, click Select to select the servers on which this firmware image must be applied on. You can select multiple servers. The list of servers is populated based on the server platforms you selected while creating the profile. |
Step 5 |
Click Select to return to the Apply Profile screen. |
Step 6 |
Click Submit. |
Downloading a Firmware Image
Complete this procedure to download a firmware image on the Cisco IMC of the server.
Before you begin
-
You have created a Cisco.com profile for downloading the firmware image.
-
While creating the profile, you have not checked the Download Now check box.
Procedure
Step 1 |
Choose . |
Step 2 |
On the Physical Accounts page, click Host Image Mapping. |
Step 3 |
Choose a CCO profile from the list of profiles. |
Step 4 |
From the More Actions drop-down list, choose Download Image. |
Step 5 |
In the Download Image screen, review the information displayed and click Download. The firmware image specified in the profile is downloaded from Cisco.com using the Cisco.com credentials that you configured. |
What to do next
At a later point in time, you can delete the image that you have downloaded. For more information, see Deleting a Downloaded Image.
Running a Host Image Upgrade Manually
While creating a host image mapping profile, if you did not check the Run Upgrade After Download check box, then you manually initiate the upgrade process by completing the following procedure.
Before you begin
You should have created a host image mapping profile in the system.
Procedure
Step 1 |
Choose . |
||||||||
Step 2 |
On the Physical Accounts page, click Host Image Mapping. |
||||||||
Step 3 |
Choose Run Upgrade. |
||||||||
Step 4 |
In the Upgrade Host Image screen, complete the required fields, including the following:
|
||||||||
Step 5 |
Click Submit. |
Deleting a Downloaded Image
While creating a Cisco.com profile, you can choose to download the firmware image immediately after creating the profile, or you can download it at a later point in time. After an image is downloaded, you can delete it from the Cisco UCS Director. This option is only available for images downloaded with the Cisco.com profile.
Procedure
Step 1 |
Choose . |
Step 2 |
On the Physical Accounts page, click Host Image Mapping. |
Step 3 |
Choose the CCO profile from the list of created profiles. |
Step 4 |
From the More Actions drop-down list, choose Delete Image. |
Step 5 |
In the Delete Image(s) screen, click Delete. |
Mapping and Unmapping a Host Image
Complete this procedure to map or unmap a host image on a specific Cisco IMC server. You can map and unmap only an ISO host image. For other host images such as BIOS and CIMC, you can only delete them from this screen.
Before you begin
You should have created a host image mapping profile in the system.
Procedure
Step 1 |
Choose . |
Step 2 |
On the Compute page, choose the pod. |
Step 3 |
Choose the Rack Servers tab. |
Step 4 |
Double-click the server in the list to view the details, or select View Details from the More Actions drop-down list. |
Step 5 |
Choose the Host Images tab. The screen lists all the images that are available on the Cisco IMC server. |
Step 6 |
Choose an ISO host image and select Map Image or Unmap Image or Delete Image. From this screen, you can only select Delete Image for BIOS and CIMC images. |
Viewing Status Details of a Host Image Profile
Before you begin
You should have created a host image mapping profile in the system.
Procedure
Step 1 |
Choose . |
||
Step 2 |
On the Physical Accounts page, click Host Image Mapping. |
||
Step 3 |
Select a profile from the table and choose View Status Details from the More Actions drop-down list. You can also select a profile from the table and right-click to choose View Status Details. The View Host Image Mapping Profile Status screen displays the following information:
|
Deleting a Host Image Mapping Profile
Procedure
Step 1 |
Choose . |
Step 2 |
On the Physical Accounts page, click Host Image Mapping. |
Step 3 |
Select a profile from the table and click Delete Profile. |
Step 4 |
In the Delete Profile screen, click Delete. The profile is deleted from the system. |
Configuring Proxy Settings
Perform this procedure when you want to configure proxy settings.
Procedure
Step 1 |
Choose . |
||||||
Step 2 |
On the System page, click Proxy Configuration. |
||||||
Step 3 |
Complete the required fields, including the following, to configure proxy on the system:
|
||||||
Step 4 |
Click Save. |
Configuring Cisco.com User
Perform this procedure when you want to configure your Cisco.com user name and password.
Procedure
Step 1 |
Choose . |
||||||
Step 2 |
On the System page, click Cisco.com User Configuration. |
||||||
Step 3 |
Complete the following fields for configuring the Cisco.com user:
|
||||||
Step 4 |
Click Save. |
REST API Changes
Creating a Host Image Profile
- Objective
-
Create a Host Image in a Network Location.
- Prerequisites
-
The Host Image must be present in the network location.
- REST URL
-
/cloupia/api-v2/HostImageNetworkImage
- Components
-
The parameters of the HostImageNetworkImage API are:
-
String Profile Name—The unique name of the profile.
-
String Platform—The platform that manages the server.
-
String Option Download Image From—The location from where the image must be downloaded from.
-
String Server—The IP address of the server.
-
String File Path Name—The file path
-
String File Type—The file type.
-
String File Name—The name of the file.
-
String User Name—The user name.
-
String Password—The password
-
Boolean Map After Download—Map the .iso image after download
-
Boolean Delete All Images—Deletes all images on the server.
-
Boolean Run Upgrade After Download—Run upgrade immediately after downloading the image.
-
- Sample Input XML
-
<cuicOperationRequest> <operationType>CREATE_HOST_IMAGE_PROFILE</operationType> <payload> <![CDATA[ <HostImageNetworkImage> <profileName>sample</profileName> <platform>EN120S M2</platform> <option>FTP Server</option> <server>100.10.10.10</server> <pathFileName>/var/www/test</pathFileName> <fileType>ISO</fileType> <fileName>sample</fileName> <!-- Set this value only when option not equals to any of {HTTP Server,HTTPS Server,} --> <username>admin</username> <!-- Set this value only when option not equals to any of {HTTP Server,HTTPS Server,} -> <password>YWRtaW4=</password> <!-- Set this value only when fileType not equals to any of {CIMC,BIOS,} --> <mapAfterDownload>true</mapAfterDownload> <deleteAllImages>true</deleteAllImages> <upgradeNow>true</upgradeNow> </HostImageNetworkImage> ]]> </payload> </cuicOperationRequest>
- Implementation
-
Profile is a mandatory field and it must be unique. Platform, Download Image From, Server IP Address, File Path and File Name are also mandatory fields.
Applying a Host Image Profile
- Objective
-
Apply a host image profile on an E-Series server.
- Prerequisites
-
One or more E -series servers must be configured as Rack Accounts.
- REST URL
-
/cloupia/api-v2/ApplyHostImageMap
- Components
-
The parameters of the ApplyHostImageMap API are:
-
String Server—The server on which the host image map must be applied
-
String Profile Name—The unique name of the profile.
-
- Sample Input XML
-
<cuicOperationRequest> <operationType>APPLY_HOST_IMAGE_PROFILE</operationType> <payload> <![CDATA[ <ApplyHostImageMap> <serverIdKey>100.100.xx.xxx;100.2x.4x.xxx</serverIdKey> <profileName>sample</profileName> </ApplyHostImageMap> ]]> </payload> </cuicOperationRequest>
- Implementation
-
ServerIdKey is comma(,) separated value. ServerIdKey is of the format: {AccountName};{ServerIPAddress} and it is a mandatory field. Profile Name is mandatory field.
Creating a Cisco.Com Image Profile
- Objective
-
This task allows the user to create a CCO Image Profile that stores the downloaded file (from cisco.com) in a local location inside the appliance.
- Prerequisites
-
The user must have a valid set of credentials to login to cisco.com and have access privileges for BIN, SPA and ISO Images.
- REST URL
-
/cloupia/api-v2/CIMCHIMCCOImage
- Components
-
The parameters of the CIMCHIMCCOImage API are:
-
String Profile Name—The unique name of the profile.
-
String Platform—The platform that manages the server.
-
Boolean Download Now—Download the image immediately after adding a profile.
-
String Available Image—The available image.
-
Boolean Map After Download—Map the .iso image after download
-
Boolean Delete All Images—Deletes all images on the server.
-
Boolean Run Upgrade After Download—Run upgrade immediately after downloading the image.
-
String License Text—License text.
-
- Sample Input XML
-
<cuicOperationRequest> <operationType>CCO_IMAGE_CREATE</operationType> <payload> <![CDATA[ <CIMCHIMCCOImage> <profileName>sample</profileName> <platform>EN120S M2</platform> <downloadNow>true</downloadNow> <availableImage>sample.iso</availableImage> <!-- Set this value only when fileType not equals to any of {CIMC,BIOS,} --> <mapAfterDownload>true</mapAfterDownload> <deleteAllImages>true</deleteAllImages> <upgradeNow>true</upgradeNow> <licenseText></licenseText> </CIMCHIMCCOImage> ]]> </payload> </cuicOperationRequest>
- Implementation
-
Profile Name is mandatory, must be unique. Platform are mandatory. The platform must be that of a server already added into the system.
Downloading a Cisco.Com Image
- Objective
-
This task allows the user to download a CCO Image from cisco.com into a local location inside the appliance.
- Prerequisites
-
The CCO Image Profile must be already configured.
- REST URL
-
/cloupia/api-v2/CIMCHIMCCOImage
- Components
-
The parameter of the CIMCHIMCCOImage API is:
-
String Profile Name—The unique name of the profile.
-
- Sample Input XML
-
<cuicOperationRequest> <operationType>CCO_IMAGE_DOWNLOAD</operationType> <payload> <![CDATA[ <CIMCHIMDownloadCCOImage> <profileName>sampleCCOProfile</profileName> </CIMCHIMDownloadCCOImage> ]]> </payload> </cuicOperationRequest>
- Implementation
-
Profile Name is mandatory, must be a valid existing profile for a Local Image. The image should not be already downloading.
Finding a Cisco.com Image
- Objective
-
This task allows the user to find a CCO Image (BIN,SPA or ISO Image) on cisco.com for only E-Series server platforms.
- Prerequisites
-
The user must have a valid set of credentials to login to cisco.com and have access privileges for BIN, SPA and ISO Images.
- REST URL
-
/cloupia/api-v2/CIMCHIMCCOImage
- Components
-
The parameter of the CIMCHIMCCOImage API is:
-
String Platform—The platform that manages the server.
-
- Sample Input XML
-
<cuicOperationRequest> <operationType>CCO_IMAGE_FIND</operationType> <payload> <![CDATA[ <CIMCHIMCCOImage> <platform>EN120S M2</platform> </CIMCHIMCCOImage> ]]> </payload> </cuicOperationRequest>
- Implementation
-
Platform is mandatory field. The Platform must be that of a server already added into the system.
Deleting a Host Image Mapping Profile
- Objective
-
Delete one or more existing Host Image Mapping Profiles.
- Prerequisites
-
None
- REST URL
-
/cloupia/api-v2/DeleteHostImageProfile
- Components
-
The parameter of the DeleteHostImageProfile API is:
-
String Profile Name—One or more firmware image profiles to delete.
-
- Sample Input XML
-
<cuicOperationRequest> <operationType>DELETE_HOST_IMAGE_PROFILE</operationType> <payload> <![CDATA[ <DeleteHostImageProfile> <profileNames>sample_profile_name</profileNames> </DeleteHostImageProfile> ]]> </payload> </cuicOperationRequest>
- Implementation
-
Comma separated list of profile names, all of which must be of valid existing profiles.
Reading Firmware Image by a Profile Name
- Objective
-
Get Firmware Image By Profile Name
- Prerequisites
-
None
- REST URL
-
/cloupia/api-v2/CIMCFirmwareUpgradeConfig/{CIMCFirmwareUpgradeConfigId}
- Implementation
-
This task allows the user to query the firmware image details based on the profile name The CIMCFirmwareUpgradeConfigId argument must be a valid profile name. If no argument is specified, all firmware images configured in the system will be returned.