Guest

Cisco UCS Management Partner Ecosystem Software

Release Notes for Cisco UCS PowerTool, Release 1.x for Cisco UCS Manager

  • Viewing Options

  • PDF (200.8 KB)
  • Feedback

Table of Contents

Release Notes for Cisco UCS PowerTool, Release 1.x for Cisco UCS Manager

Contents

Revision History

Introduction

System Requirements

Cisco UCS Manager

Windows PowerShell Requirements

Installation Requirements

New Features

New Features for Release 1.1.1

Key Features in Release 1.1.1

New Cmdlets for Release 1.1.1

New Features for Release for 1.0.1

Key Features in Release 1.0.1

New Features for Release 1.0

Key Features in Release 1.0

PowerShell Functionality

New Cmdlets

New Generated Cmdlets

New Functionality for Release 1.0

Known Issues

Resolved Caveats in Release 1.0.1

Related Documentation

Obtaining Documentation and Submitting a Service Request

Release Notes for Cisco UCS PowerTool, Release 1.x for Cisco UCS Manager

 

First Published: January 2013

Revised Date: March 2014

Part Number: OL-30249-01

Current Release: 1.x

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

Use these release notes as a supplement with the other documents listed in the documentation roadmap at http://www.cisco.com/go/unifiedcomputing/b-series-doc .

Make sure to review other available documentation on Cisco.com to obtain the most current information about Cisco UCS PowerTool, Release 1.x

Revision History

Table 1 shows the revision history:

Table 1 Online History Changes

Revision
Release
Date
Description

A0

1.0

January 2013

Created Release notes for Cisco UCS PowerTool, Release 1.0

B0

1.0.1

August 2013

Updated Release notes for Cisco UCS PowerTool, Release 1.0.1

C0

1.1.1

March 2014

Following changes were made in this revision:

  • Updated the Cisco UCS Manager section.
  • Updated the New Features section.
  • Added the Known Issues section.

Introduction

Cisco UCS PowerTool is a PowerShell module that helps automate all aspects of Cisco UCS Manager including server, network, storage, and hypervisor management. Cisco UCS PowerTool enables easy integration with existing IT management processes and tools. The PowerTool cmdlets work on the Cisco UCS Manager’s Management Information Tree (MIT). These cmdlets allow you to create, modify, or delete actions on the Managed Objects (MOs) in the tree.

System Requirements

Before installing Cisco UCS 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 later)

Cisco UCS Manager

Cisco UCS PowerTool is compatible with the following Cisco UCS Manager releases:

  • Release 2.2
  • Release 2.1
  • Release 2.0
  • Release 1.4
  • Release 1.0

Windows PowerShell Requirements

Cisco UCS PowerTool supports Windows PowerShell 2.0 and Windows PowerShell 3.0.


Note Check the Microsoft web site for specific Windows PowerShell requirements.


Installation Requirements

Before installing Cisco UCS PowerTool, you must do the following:

  • Uninstall all versions of Cisco UCS Power Tool that are older than Cisco UCS PowerTool, Release 0.9.1.0.
  • Close any instances of PowerShell running with the PowerTool module loaded.

New Features

New Features for Release 1.1.1

This section briefly describes the new features introduced in Cisco UCS PowerTool, Release 1.1.1. For detailed information about the features listed, see the documents listed in the “Related Documentation“section.

Key Features in Release 1.1.1

Cisco UCS PowerTool, Release 1.1.1, includes the following new key features:

  • Support for Cisco UCS Manager release 2.2.
  • Support for IPv6:

Allows connectivity to UCSM using IPv6 addresses.

Allows access to external facing client applications, such as scp, ftp, tftp, ntp, dns and so on, and external facing services such as sshd, httpd, snmpd and so on over IPv6 addresses.

  • Start-UcsGuiSession can now handle UcsHandle/UcsStatus as pipeline inputs. If there is no connection to the UCS, you can start the GUI by providing the UCSM IP or name as a parameter to the Start-UCSGuiSession cmdlet. If there is a connection to the UCS, no credentials are required. The cmdlet generates a token and uses it.
  • Some auto generated Managed Objects (MO) executed with errors while performing a compare or Sync on UCS MOs. The cmdlet is modified to resolve these issues in this release.
  • When multiple Set or Remove cmdlets were being used in a transaction, prompting for individual cmdlets failed to occur. This issue has been fixed and now you get prompts for each cmdlet.

New Cmdlets for Release 1.1.1

The following table lists the PowerShell functionalities and the supported actions for the Cisco UCS PowerTool, Release 1.1.1:

Managed Object (MO)
PowerShell Nouns
Get
Add
Set
Remove

equipmentAdvancedBootOrder

UcsEquipmentAdvancedBootOrder

x

 

 

equipmentSecureBoot

UcsEquipmentSecureBoot

x

 

 

equipmentTpm

UcsEquipmentTpm

x

 

 

equipmentTpmCapProvider

UcsEquipmentTpmCapProvider

x

 

 

mgmtIPv6IfConfig

UcsMgmtIPv6IfConfig

x

 

 

mgmtProfDerivedInterface

UcsMgmtProfDerivedInterface

x

 

 

storageFlexFlashCard

UcsStorageFlexFlashCard

x

 

 

storageFlexFlashController

UcsStorageFlexFlashController

x

 

 

storageFlexFlashDrive

UcsStorageFlexFlashDrive

x

 

 

storageFlexFlashVirtualDrive

UcsStorageFlexFlashVirtualDrive

x

 

 

extvmmFNDReference

UcsNetworkSiteReference

x

 

 

extvmmVMNDRef

UcsNetworkSegmentReference

x

x

 

x

ippoolIpV6Block

UcsIppoolIpV6Block

x

x

 

x

vnicUsnicConPolicyRef

UcsVnicUsnicConPolicyRef

x

x

 

x

vnicVmqConPolicyRef

UcsVnicVmqConPolicyRef

x

x

 

x

computeFwSyncAck

UcsComputeFwSyncAck

x

 

x

computeMemoryConfigPolicy

UcsComputeMemoryConfigPolicy

x

 

x

computeMemoryConfiguration

UcsComputeMemoryConfiguration

x

 

x

extmgmtNdiscTargets

UcsExtmgmtNdiscTargets

x

 

x

firmwareAutoSyncPolicy

UcsFirmwareAutoSyncPolicy

x

 

x

mgmtIPv6IfAddr

UcsMgmtIPv6IfAddr

x

 

x

mgmtInbandProfile

UcsMgmtInbandProfile

x

 

x

extvmmFabricNetwork

UcsFabricNetwork

x

x

x

x

extvmmFabricNetworkDefinition

UcsNetworkSite

x

x

x

x

extvmmUpLinkPP

UcsUpLinkPortProfile

x

x

x

x

extvmmVMNetwork

UcsVmNetwork

x

x

x

x

extvmmVMNetworkDefinition

UcsNetworkSegment

x

x

x

x

fabricUdldLinkPolicy

UcsFabricUdldLinkPolicy

x

x

x

x

ipDnsSuffix

UcsIpDnsSuffix

x

x

x

x

ipIPv4WinsServer

UcsIpIPv4WinsServer

x

x

x

x

lsbootBootSecurity

UcsLsbootBootSecurity

x

x

x

x

lsbootDefaultLocalImage

UcsLsbootDefaultLocalImage

x

x

x

x

lsbootLocalHddImage

UcsLsbootLocalHddImage

x

x

x

x

lsbootSan

UcsLsbootSan

x

x

x

x

lsbootSanCatSanImage

UcsLsbootSanCatSanImage

x

x

x

x

lsbootSanCatSanImagePath

UcsLsbootSanCatSanImagePath

x

x

x

x

lsbootUsbExternalImage

UcsLsbootUsbExternalImage

x

x

x

x

lsbootUsbFlashStorageImage

UcsLsbootUsbFlashStorageImage

x

x

x

x

lsbootUsbInternalImage

UcsLsbootUsbInternalImage

x

x

x

x

mgmtInterface

UcsMgmtInterface

x

x

x

x

mgmtVnet

UcsMgmtVnet

x

x

x

x

vnicIpV6MgmtPooledAddr

UcsVnicIpV6MgmtPooledAddr

x

x

x

x

vnicIpV6StaticAddr

UcsVnicIpV6StaticAddr

x

x

x

x

vnicUsnicConPolicy

UcsVnicUsnicConPolicy

x

x

x

x

vnicVmqConPolicy

UcsVnicVmqConPolicy

x

x

x

x

vnicIpV4MgmtPooledAddr

UcsVnicIpV4MgmtPooledAddr

x

x

x

x

New Features for Release for 1.0.1

This section briefly describes the new features introduced in Cisco UCS PowerTool, Release 1.0.1. For detailed information about the features listed, see the documents listed in the “Related Documentation“section.

Key Features in Release 1.0.1

Cisco UCS PowerTool, Release 1.0.1, includes the following new key features:

  • Support for generating PowerTool cmdlets for the configuration present in the UCS Backup.xml file. For example, ConvertTo-UcsCmdlet -UcsBackup -Path C:\backup.xml -OutputPath C:\PowerToolScript.txt.
  • Support for storing jnlp file and enable logging when using Start-UcsGuiSession cdmlets. For example, Start-UcsGuiSession -LogAllXml.

New Features for Release 1.0

This section briefly describes the new features introduced in Cisco UCS PowerTool, Release 1.0. For detailed information about the features listed, see the documents listed in the “Related Documentation“section.

Key Features in Release 1.0

Cisco UCS PowerTool, Release 1.0, includes the following new key features:

  • Stateful connection management to multiple Cisco UCS Manager systems in parallel
  • Firmware upgrade support
  • Support for creating and downloading technical support information
  • Support for backing up Cisco UCS Manager configuration
  • Support for importing Cisco UCS Manager configuration
  • Support for launching a GUI session of Cisco UCS Manager from PowerTool
  • Support for launching a KVM session of a server from PowerTool
  • Support for monitoring an event stream of Cisco UCS Manager
  • Support for comparing and synchronizing configurations within or between Cisco UCS Manager sessions
  • Support for generating PowerTool cmdlets automatically when performing the equivalent operation on Cisco UCS Manager GUI (ConvertTo-UcsCmdlet)
  • Support for transactions
  • Support for registration of Cisco UCS Manager with Cisco UCS Central
  • Service profile management (create/modify/delete/associate)
  • Log viewing and management
  • Server power management
  • Full inventory management
  • Raw XML input and output capability

PowerShell Functionality

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

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

New Cmdlets

Cisco UCS PowerTool, Release 1.0, includes the following new cmdlets:

  • Register-UcsCentral—Registers a Cisco UCS domain with Cisco UCS Central.
  • Unregister-UcsCentral—Unregisters a Cisco UCS domain with Cisco UCS Central.
  • Rename-UcsServiceProfile—Renames a service profile.
  • Export-UcsMoXml—Exports Managed Object XML.
  • Import-UcsMoXml—Imports XML and converts into objects.

New Generated Cmdlets

Cisco UCS PowerTool, Release 1.0, includes 184 new cmdlets from Cisco UCS Manager, Release 2.1 Schema.

New Functionality for Release 1.0

Cisco UCS PowerTool, Release 1.0 includes the following enhancements:

  • Added support for configConfRename in ConvertTo-UcsCmdlet.
  • Ability to fetch all naming property values from RN in case they are not available in XML in ConvertTo-UcsCmdlet.
  • Modified ConvertTo-UcsCmdlet to put properties having value null in –XtraProperties.
  • Added support for input parameter regex validation.
  • Added a missing verb set for VnicIPv4PooledIscsiAddr.

Known Issues

The following are the known issues found in release 1.1.1:

  • Fix for the Java 7 Update 45 issues with UCS Manager GUI has resulted in breaking the cmdlet generation using ConvertTo-UcsCmdlet . Downgrading the Java version to a version lower than Java 7 Update 45 will fix this issue.
  • ConvertTo-UcsCmdlet does not work when the UCS Manager GUI is launched with an IPv6 address. Use an IPv4 address to launch the UCS Manager GUI to address this issue.

Resolved Caveats in Release 1.0.1

Table 2 Resolved Caveats in Release 1.0.1

Bug ID
Description

CSCui00621

Cmdlet missing for Ethernet TX / RX threshold policies

CSCuh26843

Add missing verb for generated cmdlet (Set for ExtmgmtMiiStatus, Get/Set for FabricFcoeVsanPc, Add for lsVConAssign)

CSCuh05189

Powertool installer issue when only Powershell 3.0 is installed

CSCue49768

PowerTool 1.0.0 does not uninstall the beta versions

CSCuh63421

Send-UCSFirmware path length should accept more than 64 character

CSCug67877

Improvement in Convertto-UcsCmdlet to handle MOs with same RN

CSCud68080

Add error checking for send-ucsfirmware, should work after 1.0(1e) UCSM version.

CSCuh42325

Powertool Notes - links to middle of User Guide (and not top)

CSCuh42317

User Guide does not mention Start-UcsGuiSession

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 What’s New in Cisco Product Documentation at: http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html .

Subscribe to What’s New in Cisco Product Documentation , which lists all new and revised Cisco technical documentation, as an RSS feed and deliver content directly to your desktop using a reader application. The RSS feeds are a free service.

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