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, page 2
•
Introduction, page 2
•
New Features, page 3
•
Resolved Caveats, page 8
•
Open Caveats, page 9
•
Cisco UCS Communities, page 9
•
Related Documentation, page 10
Americas Headquarters:
Cisco Systems, Inc., 170 West Tasman Drive, San Jose, CA 95134-1706 USA
Revision History
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:
C0
1.2.1
D0
1.3.1
August 2014
October 2014
•
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
Following changes were made in this
revision:
•
Updated the New Features section
•
Added the Known Issues section
Following change is made in this
revision:
•
E0
1.4.1
July 2015
Following change is made in this
revision:
•
F0
1.4.2
November 2015
Updated the New Features section
Updated the New Features section
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.
Release Notes for Cisco IMC PowerTool, Release 1.x
2
OL-31226-01
New Features
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:
Release Notes for Cisco IMC PowerTool, Release 1.x
OL-31226-01
New Features
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
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
Remove
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 cmdlet
•
Enhanced Set-ImcLdapGroupMap and Clear-ImcLdapGroupMap cmdlets
•
Enhanced Bios cmdlets
•
Support added for Set-ImcBiosUnit cmdlet
Release Notes for Cisco IMC PowerTool, Release 1.x
4
OL-31226-01
New Features
•
Enhanced Set-ImcSysdebugMEpLog cmdlet
•
Enhanced ConvertTo-ImcCmdlet cmdlet
New Cmdlets for Release 1.3.1
Managed Object (MO)
PowerShell Nouns
Get
Add
Set
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
StorageFlexFlashControllerPro
ps
x
storageFlexFlashOperationalProfi
le
StorageFlexFlashOperationalPr
ofile
x
storageFlexFlashPhysicalDrive
StorageFlexFlashPhysicalDrive
x
storageFlexFlashVirtualDrive
StorageFlexFlashVirtualDrive
x
x
storageFlexFlashVirtualDriveIma
geMap
StorageFlexFlashVirtualDriveI
mageMap
x
x
systemIOController
SystemIOController
x
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
Release Notes for Cisco IMC PowerTool, Release 1.x
OL-31226-01
Remove
New Features
•
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
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
storageVirtualDriveCreatorUsi StorageVirtualDriveCreatorUsi
ngUnusedPhysicalDrive
ngUnusedPhysicalDrive
x
x
storageVirtualDriveCreatorUsi StorageVirtualDriveCreatorUsi
ngVirtualDriveGroup
ngVirtualDriveGroup
x
x
storageVirtualDriveWithDrive
GroupSpace
x
StorageVirtualDriveWithDrive
GroupSpace
Remove
New Cmdlets for Existing MOs
Release Notes for Cisco IMC PowerTool, Release 1.x
6
OL-31226-01
New Features
adaptorEthCompQueueProfile
AdaptorEthCompQueueProfile
x
adaptorEthGenProfile
AdaptorEthGenProfile
x
adaptorEthInterruptProfile
EthAdapterInterruptProfile
x
adaptorEthOffloadProfile
EthAdapterOffloadProfile
x
adaptorEthRecvQueueProfile
EthAdapterReceiveQueueProfil
e
x
adaptorEthWorkQueueProfile
EthAdapterTransmitQueueProfi
le
x
adaptorExtIpV6RssHashProfil
e
AdaptorExtIpV6RssHashProfile
x
adaptorFcCdbWorkQueueProfi AdaptorFcCdbWorkQueueProfi
le
le
x
adaptorFcErrorRecoveryProfil
e
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
biosVfPCISlotOptionROMEna BiosVfPCISlotOptionROMEna
ble
ble
x
memoryArray
MemoryArray
x
storageController
StorageController
x
storageLocalDisk
StorageLocalDisk
x
storageRaidBattery
StorageRaidBattery
x
storageVirtualDrive
StorageVirtualDrive
x
adaptorFcBootTable
AdaptorFcBootTable
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.
Release Notes for Cisco IMC PowerTool, Release 1.x
OL-31226-01
x
Resolved Caveats
•
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.
Release Notes for Cisco IMC PowerTool, Release 1.x
8
OL-31226-01
Open Caveats
Table 2
Resolved Caveats
First Release
Affected
Resolved in Release
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 1.2(1)
for C-Series rack servers with versions
2.0(1b) and above.
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)
Bug ID
Description
CSCup93780
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
Workaround
First Bundle
Affected
Bug ID
Symptom
CSCux63164
On some operating systems Cisco IMC Reboot or Log-off after 1.4(1)
PowerTool fails to launch and throws the installing Cisco IMC
following error:
PowerTool to update the
environment variables.
“The Module
'%ImcInstallPath%CiscoImcPS%' could
not be loaded"
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 1.1(1)
character passwords, so
that you can use the
same password with the
Cisco UCS E-Series
GUI too.
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.
Release Notes for Cisco IMC PowerTool, Release 1.x
OL-31226-01
Related Documentation
Related Documentation
For more information, you can access related documents from the following links:
•
Cisco IMC PowerTool, Release 1.x User Guide
•
Cisco UCS C-Series Documentation Roadmap
•
Cisco UCS E-Series Documentation Roadmap
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.
Release Notes for Cisco IMC PowerTool, Release 1.x
1
OL-31226-01