Release Notes for Cisco IMC PowerTool, Release 1.x

Available Languages

Download Options

  • PDF     (219.8 KB)
    View with Adobe Reader on a variety of devices
Updated:November 8, 2015

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Table of Contents

Release Notes for Cisco IMC PowerTool, Release 1.x

Contents

Revision History

Introduction

System Requirements

Cisco IMC

Windows PowerShell Requirements

Installation Requirements

New Features

New Features in PowerTool 1.4.2

New Features in PowerTool 1.4.1

New Cmdlets for Release 1.4.1

New Features in PowerTool 1.3.1

New Cmdlets for Release 1.3.1

New Features in PowerTool 1.2.1

New Cmdlets for Release 1.2.1

New Features in PowerTool 1.1.1

New Cmdlets for Release 1.1.1

New Features in PowerTool 1.0

PowerShell Functionality

Resolved Caveats

Open Caveats

Cisco UCS Communities

Related Documentation

Obtaining Documentation and Submitting a Service Request

Release Notes for Cisco IMC PowerTool, Release 1.x

First Published: December 2013

Current Release: 1.x

This document describes the system requirements, new features information about known caveats, and workarounds in Cisco IMC PowerTool, Release 1.x. This document also includes current information that became available after the technical documentation was published.

Use this release notes as a supplement with the other documents listed in the documentation roadmap at Cisco UCS C-Series Servers Documentation Roadmap and Documentation Guide for Cisco UCS E-Series Servers.

Make sure to review other available documentation on Cisco.com to obtain the most current information about Cisco IMC PowerTool.

Contents

This document includes the following sections:

Revision History

Table 1 shows the revision history:

Table 1 Online History Changes

Revision
Release
Date
Description

A0

1.0

December 2013

Created Release notes for Cisco UCS C-Series PowerTool, Release 1.0

B0

1.1.1

March 2014

Following changes were made in this revision:

  • Renamed Cisco UCS C-Series PowerTool to Cisco IMC PowerTool as it supports both C-Series and E-Series servers this release onwards
  • Updated the New Features section
  • Added the Known Issues section

C0

1.2.1

August 2014

Following changes were made in this revision:

  • Updated the New Features section
  • Added the Known Issues section

D0

1.3.1

October 2014

Following change is made in this revision:

  • Updated the New Features section

E0

1.4.1

July 2015

Following change is made in this revision:

  • Updated the New Features section

F0

1.4.2

November 2015

Following change is made in this revision:

  • Updated the New Features section

Introduction

Cisco IMC PowerTool is a PowerShell module which helps automate aspects of Cisco UCS C-Series Stand-alone Rack Mount servers and Cisco UCS E-Series servers using XML APIs. Cisco IMC PowerTool enables easy integration with existing IT management processes and tools.

Cisco IMC PowerTool cmdlets work on the Cisco IMC Management Information Tree (MIT). The cmdlets allows you to perform create, modify, or delete actions on the Managed Objects (MOs) in the MIT.

Note Cisco IMC PowerTool can coexist with Cisco UCS Manager PowerTool enabling management of the entire UCS environment.

System Requirements

Before installing Cisco IMC PowerTool, ensure that the system meets the following requirements:

  • Windows PowerShell 2.0 or above must be installed on the system
  • .NET Framework Version 2.0 SP1 or higher

Cisco IMC

Cisco IMC PowerTool is compatible with the following Cisco IMC releases:

  • Release 1.5 and above for the C-Series servers
  • Release 2.2(1) and above for the E-Series servers

Windows PowerShell Requirements

Cisco IMC PowerTool requires Windows PowerShell v2.0 or higher version to be installed on the system.

Note Check the Microsoft website for specific Windows PowerShell requirements.

Installation Requirements

Before installing Cisco IMC PowerTool, perform the following:

  • Close any instances of PowerShell running with the PowerTool module loaded.
  • Uninstall the beta versions of the Cisco IMC PowerTool

New Features

New Features in PowerTool 1.4.2

Following new feature is added in this release:

  • Support for Cisco IMC C-Series release 2.0(8d)

New Features in PowerTool 1.4.1

Following new features are added for Cisco IMC PowerTool, Release 1.4.1:

  • Added new cmdlets for features in Cisco IMC C-Series release 2.0(4c). For more information, see New Cmdlets for Release 1.4.1
  • Support for all BIOS MOs to accept values in Pascal and Camel casing
  • Set-ImcBiosPassword cmdlets to change BIOS password for E-Series servers
  • Added the following aliases for Cisco IMC server actions:
Aliases
Cisco IMC Server Actions

Start-ImcServer

Power On Server

Stop-ImcServer

Shut Down Server

Restart-ImcServer

Power Cycle Server

Reset-ImcServer

Hard Reset Server

Enable-ImcLocatorLed

Turn On Locator LED

Disable-ImcLocatorLed

Turn Off Locator LED

New Cmdlets for Release 1.4.1

Managed Object (MO)
PowerShell Nouns
Get
Add
Set
Remove

adaptorConnectorInfo

AdaptorConnectorInfo

x

 

 

 

adaptorLinkTraining

AdaptorLinkTraining

x

 

x

 

biosVfCDNEnable

BiosVfCDNEnable

x

 

x

 

biosPassword

BiosPassword

x

 

x

 

biosVfPciRomClp

BiosVfPciRomClp

x

 

x

 

biosVfPwrPerfTuning

BiosVfPwrPerfTuning

x

 

x

 

biosVfQpiSnoopMode

BiosVfQpiSnoopMode

x

 

x

 

biosVfWorkLoadConfig

BiosVfWorkLoadConfig

x

 

x

 

equipmentPsuColdRedundancy

EquipmentPsuColdRedundancy

x

 

x

 

New Features in PowerTool 1.3.1

Following new features are added for the Cisco IMC PowerTool, Release 1.3.1:

  • Support for Cisco IMC C-Series release 2.0(2c) and 2.0(3d)
  • Support for Storage Enhancements in C-Series release 2.0(2c)1 and 2.0(3d)
  • Support for Set-ImcTopSystem added to update time zone
  • Enhanced Set-ImcLsbootPxe, Set-ImcLsbootSan, Set-ImcLsbootIscsi, Add-ImcLsbootPxe, Add-ImcLsbootSan, Add-ImcLsbootIscsi, Set-ImcLsbootHdd and Add-ImcLsbootHdd cmdlets
  • Enhanced Set-ImcBiosVfMemoryInterleave cmdlet
  • Enhanced Set-ImcBiosVfPCISlotOptionROMEnable cmdlet
  • Enhanced Set-ImcAdaptorEthGenProfile cmdlet
  • Enhanced Set-ImcEthAdapterReceiveQueueProfile cmdlet
  • Enhanced Set-ImcFirmwareUpdatable c mdlet
  • Enhanced Set-ImcLdapGroupMap and Clear-ImcLdapGroupMap cmdlets
  • Enhanced Bios cmdlets
  • Support added for Set-ImcBiosUnit cmdlet
  • Enhanced Set-ImcSysdebugMEpLog cmdlet
  • Enhanced ConvertTo-ImcCmdlet cmdlet

New Cmdlets for Release 1.3.1

Managed Object (MO)
PowerShell Nouns
Get
Add
Set
Remove

advancedPowerProfile

AdvancedPowerProfile

x

 

x

 

biosVfPchUsb30Mode

BiosVfPchUsb30Mode

x

 

x

 

biosVfSataModeSelect

BiosVfSataModeSelect

x

 

x

 

equipmentPsuFan

EquipmentPsuFan

x

 

 

 

powerMonitor

PowerMonitor

x

 

 

 

serverUtilization

ServerUtilization

x

 

 

 

standardPowerProfile

StandardPowerProfile

x

 

x

 

storageFlexFlashController

StorageFlexFlashController

x

 

x

 

storageFlexFlashControllerProps

StorageFlexFlashControllerProps

x

 

 

 

storageFlexFlashOperationalProfile

StorageFlexFlashOperationalProfile

x

 

x

 

storageFlexFlashPhysicalDrive

StorageFlexFlashPhysicalDrive

x

 

 

 

storageFlexFlashVirtualDrive

StorageFlexFlashVirtualDrive

x

 

x

 

storageFlexFlashVirtualDriveImageMap

StorageFlexFlashVirtualDriveImageMap

x

 

x

 

systemIOController

SystemIOController

x

 

 

 

New Cmdlets for Existing MOs

 

 

 

 

biosUnit

BiosUnit

 

 

x

 

topSystem

TopSystem

 

 

x

 

New Features in PowerTool 1.2.1

Following new features are added for the Cisco IMC PowerTool, Release 1.2.1:

  • Support for Cisco IMC C-Series release 2.0(1b)
  • Support for Storage Enhancements in C-Series release 2.0(1b)
  • IPv6 support
  • Support for second-level boot order in C-Series release 2.0(1b)
  • Support for event subscription
  • Enhanced Get-ImcCcoImageList cmdlet
  • Enhanced Import-ImcMoXml cmdlet
  • Added Add, Set, and Remove verbs support for adaptorFcBootTable
  • Enhanced Compare-ImcManagedObject and Sync-ImcManagedObject cmdlet
  • Enhanced Transaction Support
  • Support for Get-ImcPowerToolCommunity cmdlet added
  • Enhanced Import-ImcConfiguration and Export-ImcConfiguration cmdlets
  • Enhanced Set-ImcHuuFirmwareUpdater and Set-ImcFirmwareUpdatable
  • Enhanced Set-ImcSnmp, Set-ImcSnmpTrap, Add-ImcSnmpTrap, Set-ImcSyslogClient and Add-ImcSyslogClient cmdlets.

New Cmdlets for Release 1.2.1

Managed Object (MO)
PowerShell Nouns
Get
Add
Set
Remove

biosBootDevPrecision

BiosBootDevPrecision

x

 

 

 

biosBootMode

BiosBootMode

x

 

 

 

biosVfCDNSupport

BiosVfCDNSupport

x

 

x

 

biosVfExtendedAPIC

BiosVfExtendedAPIC

x

 

x

 

biosVfMMCFGBase

BiosVfMMCFGBase

x

 

x

 

equipmentTpm

EquipmentTpm

x

 

 

 

lsbootBootSecurity

LsbootBootSecurity

x

 

x

 

lsbootDevPrecision

LsbootDevPrecision

x

 

x

 

lsbootHdd

LsbootHdd

x

x

x

x

lsbootIscsi

LsbootIscsi

x

x

x

x

lsbootPchStorage

LsbootPchStorage

x

x

x

x

lsBootPxe

LsbootPxe

x

x

x

x

lsbootSan

LsbootSan

x

x

x

x

lsbootSd

LsbootSd

x

x

x

x

lsbootUefiShell

LsbootUefiShell

x

x

x

x

lsbootUsb

LsbootUsb

x

x

x

x

lsbootVMedia

LsbootVMedia

x

x

x

x

storageControllerSettings

StorageControllerSettings

x

 

 

 

storageOperation

StorageOperation

x

 

 

 

storageUnusedLocalDisk

StorageUnusedLocalDisk

x

 

 

 

storageVirtualDriveCreatorUsingUnusedPhysicalDrive

StorageVirtualDriveCreatorUsingUnusedPhysicalDrive

x

 

x

 

storageVirtualDriveCreatorUsingVirtualDriveGroup

StorageVirtualDriveCreatorUsingVirtualDriveGroup

x

 

x

 

storageVirtualDriveWithDriveGroupSpace

StorageVirtualDriveWithDriveGroupSpace

x

 

 

 

New Cmdlets for Existing MOs

 

 

 

 

adaptorEthCompQueueProfile

AdaptorEthCompQueueProfile

 

 

x

 

adaptorEthGenProfile

AdaptorEthGenProfile

 

 

x

 

adaptorEthInterruptProfile

EthAdapterInterruptProfile

 

 

x

 

adaptorEthOffloadProfile

EthAdapterOffloadProfile

 

 

x

 

adaptorEthRecvQueueProfile

EthAdapterReceiveQueueProfile

 

 

x

 

adaptorEthWorkQueueProfile

EthAdapterTransmitQueueProfile

 

 

x

 

adaptorExtIpV6RssHashProfile

AdaptorExtIpV6RssHashProfile

 

 

x

 

adaptorFcCdbWorkQueueProfile

AdaptorFcCdbWorkQueueProfile

 

 

x

 

adaptorFcErrorRecoveryProfile

AdaptorFcErrorRecoveryProfile

 

 

x

 

adaptorFcGenProfile

AdaptorFcGenProfile

 

 

x

 

adaptorFcInterruptProfile

AdaptorFcInterruptProfile

 

 

x

 

adaptorFcPortFLogiProfile

AdaptorFcPortFLogiProfile

 

 

x

 

adaptorFcPortPLogiProfile

AdaptorFcPortPLogiProfile

 

 

x

 

adaptorFcPortProfile

AdaptorFcPortProfile

 

 

x

 

adaptorFcRecvQueueProfile

AdaptorFcRecvQueueProfile

 

 

x

 

adaptorFcWorkQueueProfile

AdaptorFcWorkQueueProfile

 

 

x

 

adaptorIpV4RssHashProfile

adaptorIpV4RssHashProfile

 

 

x

 

adaptorIpV6RssHashProfile

AadaptorIpV6RssHashProfile

 

 

x

 

adaptorRssProfile

EthAdapterRssProfile

 

 

x

 

biosVfPCISlotOptionROMEnable

BiosVfPCISlotOptionROMEnable

 

 

x

 

memoryArray

MemoryArray

 

 

x

 

storageController

StorageController

 

 

x

 

storageLocalDisk

StorageLocalDisk

 

 

x

 

storageRaidBattery

StorageRaidBattery

 

 

x

 

storageVirtualDrive

StorageVirtualDrive

 

 

x

 

adaptorFcBootTable

AdaptorFcBootTable

 

x

x

x

New Features in PowerTool 1.1.1

Cisco IMC PowerTool, Release 1.1.1, includes extensive list of cmdlets to perform the following functions:

  • Support for Cisco IMC C-Series release 1.5(4).
  • Support for Cisco IMC E-Series release 2.2(1).
  • Added ConvertTo-ImcCmdlet cmdlet.
  • Enhanced KVM launch support for translated IMC IP addresses.
  • Enhanced transaction support.

Cisco IMC PowerTool can coexist with Cisco UCSM PowerTool enabling management of the entire UCS environment.

New Cmdlets for Release 1.1.1

  • Get-ImcBiosVfOutOfBandMgmtPort
  • Set-ImcBiosVfOutOfBandMgmtPort
  • ConvertTo-ImcCmdlet

New Features in PowerTool 1.0

Cisco IMC PowerTool, Release 1.0, includes extensive list of cmdlets to perform the following functions:

  • Stateful connection management to multiple Cisco IMC entities.
  • Cisco IMC Configuration and Fault Management
  • Power and inventory management
  • HUU based firmware upgrade support
  • Fetch Cisco IMC technical support information
  • Export and Import of Cisco IMC configuration
  • Launch a GUI session of Cisco IMC from PowerTool
  • Launch a KVM session of a server from PowerTool
  • Compare and synchronize configurations within or between Cisco IMC entities.
  • Transaction support for enabling requests to be sent optimally to Cisco IMC.
  • Import and Export of XML requests.

Cisco IMC PowerTool can coexist with Cisco UCSM PowerTool enabling management of the entire UCS environment.

PowerShell Functionality

Cisco IMC PowerTool, Release 1.0 includes the following PowerShell functionality:

  • Fully object based
  • Command pipelining support
  • Inline help (get-help) support
  • Standard verb implementation:

Resolved Caveats

This section lists the resolved caveats for Cisco IMC PowerTool.

Table 2 Resolved Caveats

Bug ID
Description
First Release Affected
Resolved in Release

CSCup93780

Clear-ImcSnmpTrap and Clear-ImcSyslogclient disable only the AdminState for C-Series rack servers with versions 2.0(1b) and above.

1.2(1)

1.4(2)

CSCun09151

ConvertTo-ImcCmdlet does not generate proper out file for Get-ImcTopSystem.

1.2(1)

1.4(2)

CSCup43709

Clear-ImcLdapGroupMap does not work for C-Series rack servers with versions 2.0(1b) and above.

1.2(1)

1.3(1)

CSCun45036

The Start-ImcIodSnapshot fails with a pipeline input parameter.

1.1(1)

1.2(1)

CSCuh40913

Set-UcsRackBiosIntelDirectedIO -vpIntelVTDInterruptRemapping not allowed

1.1(1)

1.2(1)

Open Caveats

Open caveats may be listed in association with the release in which they were first noticed or in the release identified as the first affected. We recommend to review open caveats in all releases to avoid overlooking a defect that may impact the release.

The following caveats are open in Cisco IMC PowerTool:

Table 3 Open Caveats in Cisco IMC PowerTool

Bug ID
Symptom
Workaround
First Bundle Affected

CSCux63164

On some operating systems Cisco IMC PowerTool fails to launch and throws the following error:

“The Module '%ImcInstallPath%CiscoImcPS%' could not be loaded"

Reboot or Log-off after installing Cisco IMC PowerTool to update the environment variables.

1.4(1)

CSCum26147

Cisco UCS E-Series GUI does not allow local user password fewer than seven characters. But the PowerTool cmdlets allows setting of one-character one-character password.

Set minimum of seven character passwords, so that you can use the same password with the Cisco UCS E-Series GUI too.

1.1(1)

Cisco UCS Communities

Cisco UCS Communities is a platform to discuss, share, and learn about the Cisco Products and Technologies. For blogs, discussion forums and documents related to UCS integrations with partner ecosystem, visit Cisco UCS Integrations.

Related Documentation

For more information, you can access related documents from the following links:

Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What’s New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation:

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

Subscribe to the What’s New in Cisco Product Documentation as an RSS feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service. Cisco currently supports RSS Version 2.0.

This document is to be used with the documents listed in the “Related Documentation” section.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

© 2015 Cisco Systems, Inc. All rights reserved.

Was this Document Helpful?

FeedbackFeedback

Contact Cisco

This Document Applies to These Products