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.
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.
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
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:
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.