Managing UCS environments with UCS PowerTool...

Managing UCS environments with UCS PowerTool (PowerShell)

LTRCOM-2005

Jason Shaw and Eric Williams

Technical Marketing Engineers

Agenda

• Introduction

• What resources are available to get started automating UCS Infrastructure?

• Cisco UCSM’s Programmatic Infrastructure – Cisco UCS PowerTool for UCS Manager

– DEMO / LAB: Using UCS PowerTool for UCSM

• Cisco IMC’s Programmatic Infrastructure – Cisco UCS PowerTool for IMC

– DEMO / LAB: Using UCS PowerTool for IMC

• UCS PowerTool Free-form Coding as a Group

• Conclusion

What resources are available to get started automating UCS Infrastructure?

Cisco UCS User Community

• Web Based End User Community

• Tools, Downloads, Examples • UCS Platform Emulator (UCSPE)

• goUCS Automation Tool

• XML API, PowerShell code Examples

• Cisco UCS PowerTool (PowerShell Module)

• Microsoft SCOM Management Pack for Cisco UCS

• Microsoft SCVMM UI Extension for Cisco UCS

• Microsoft SCO Integration Pack for Cisco UCS

• Documentation • Programming & Developer Guides

• Whitepapers

• Reference Guides (XML Model, Faults)

• Collaboration • Blogs

• Peer to peer forums

• Videos

• Access to Cisco Subject Matter Experts

http://communities.cisco.com/ucs

UCS Platform Emulator (UCSPE)

• No UCS Hardware Needed for API integration Development

• Full featured emulator for the UCS Manager

• Installs as a Virtual Machine

• Provides complete support for all XML API calls

• Object Browser to peruse the UCSM model

• Import & replicate existing live UCS Manager physical inventory

• Share saved physical inventories among UCS Platform Emulators

• Drag-n-drop hardware builder to create custom physical inventory

http://communities.cisco.com/ucspe

What is Cisco UCS Manager’s Programmatic Infrastructure?

Cisco Unified Computing System

Cisco UCS™ Manager (Read / Write Configuration Interfaces)

UCS Manager GUI and CLI

Cisco UCS Fabric Interconnects (Read Only / Cut Through Interfaces)

SNMP, Syslog, SMTP, SMASH CLP, CIM XML, Smart Call Home

20, 40, 48, and 96 ports Cisco UCS I/O modules

Cisco UCS Blade Server Chassis

Cisco UCS Blade / Rack Servers (Cut through Interfaces to CIMC)

Serial over LAN, KVM, IPMI

Cisco UCS I/O Adapters

UCS Manager Programmatic Infrastructure

• Comprehensive XML API, standards-based interfaces

• Bi-Directional access to physical & logical internals

XML API

Direct UCS CLI UCS GUI 3rd Party Customer

Self Serve portals

Management Tools

Auditing Tools

System Status

Physical Inventory

Logical Inventory

Broad 3rd party integration support

Faster custom integration for customer use cases

Consistent data and views across ALL interfaces

Cisco UCS PowerTool for UCS Manager

Cisco UCS PowerTool for UCS Manager Programmatic control over UCS hardware

• Architected for Flexibility and coverage • PowerShell Wrapper

– Cmdlet definition and structure

– Get-help support

• .NET UCS Namespace Library

– XML API call construction

– Class Definition

– Validation

• PowerShell Design • In-line get-help support

• Full Pipelining support

• Fully classed object definition

• All ‘legal’ verbs

• .NET Namespace provides common base for all Microsoft focused integration

• Targeted to support full manageability of UCS across multiple releases

Cisco UCS

PowerTool Module

UCS .NET Namespace

UCS XML API

cmdlets

UCS XML

Schema

Processor

UCSM-IN.xsd

UCSM-OUT.xsd

Augment

Schema

XML Method

& MO Meta

Information

PowerShell

Generator

Microsoft SCO IP

Generator

Cisco UCS

PowerTool

(1850+ cmdlets)

Microsoft SCO

Integration Pack

Cisco UCS PowerTool Automated Code Creation

Automated Activity Generation from UCS XML Schema

Cisco UCS PowerTool for UCS Manager Most Commonly Used Objects and Assets

• Chassis – Hardware – Power Supply / Fan

Modules / IO Modules

– Environmental statistical data (Power, cooling, network)

– Config and Hardware Faults

• Fabric Interconnect – Hardware – Power Supply / Fan

Modules / Network Expansion Modules

– Power / cooling / network/ environmental statistical data

– Network Elements (VLAN, VSAN, QoS, Port Profiles)

– Config and Hardware Faults

• Config. Operations – Pools (WWN, UUID, MAC, IP)

– Policy creation, manipulation, deletion, and consumption

– vNIC / vHBA Templates

– Service profile template creation, cloning, deletion, and consumption

• Simplistic service profile creation (with a limited scope of what is available to configure)

• Expert SP creation (use variabilized XML w/ config file)

– Compare Managed Objects across orgs and/or domains

– Sync Managed Objects across orgs and/or domains

• Service Profiles – Policies (Firmware, Boot Order,

vNIC / vHBA config, Storage, IPMI, SoL, BIOS)

– Pools (WWN, UUID, MAC, IP)

– Configuration Faults

– Launch UCS KVM for SP

• Servers – Hardware - CPU, Memory,

Adaptors, CIMC

– Power Operations

– Power / cooling / network /environmental statistical data

– Hardware Faults

sys org-root

UCS Manager XML Hierarchy Overview Managed Object to UCS PowerTool Command Reference

switch-A chassis-1

fabric

ls-bob

org-prod

blade-1 slot-2

ether fc

port-5 port-1

adaptor-1

compute board

fc0 temp stats

power stats

macPool

mac pool

lsPower lsBinding

boot policy

bios policy

LAN cloud

SAN cloud

bob vsan10

Legend

equipment network logical

sys org-root

switch-A

fabric

ls-bob

org-prod

slot-2

ether fc

port-5 port-1

compute board

fc0 temp stats

power stats

macPool

mac pool

lsPower lsBinding

boot policy

bios policy

LAN cloud

SAN cloud

bob vsan10

Legend

Get-UcsChassis -Id 1 | Get-UcsBlade -SlotId 1 | Get-UcsAdaptorUnit -Id 1 | Get-UcsAdaptorHostEthIf

adaptor-1

blade-1

chassis-1

sys org-root

switch-A chassis-1

fabric

ls-bob

org-prod

blade-1 slot-2

ether fc

port-5 port-1

adaptor-1

compute board

fc0 temp stats

power stats

macPool

mac pool

lsPower lsBinding

boot policy

bios policy

SAN cloud

vsan10

Legend

Get-UcsLanCloud | Add-UcsVlan -name bob -id 222

LAN cloud

Get-UcsOrg -name root | Add-UcsMacPool -Name bob123 | Add-UcsMacMemberBlock –From 20:00:00:11:22:00 -To 20:00:00:11:22:10

switch-A chassis-1

fabric

ls-bob

org-prod

blade-1 slot-2

ether fc

port-5 port-1

adaptor-1

compute board

fc0 temp stats

power stats

lsPower lsBinding

boot policy

bios policy

LAN cloud

SAN cloud

bob vsan10

Legend

org-root

macPool

mac pool

CiscoUcsPS Module Overview

ConvertTo-UcsCmdlet -UcsBackup -

LiteralPath c:\ucs\backup.xml -OutputPath

c:\ucs\output.ps1

Getting Started: ConvertTo-UcsCmdlet

• The best way to discover usage of PowerTool cmdlets and usage

• Usage: Option #1

• Launch UCS GUI & Login

• C:\> ConvertTo-UcsCmdlet

• C:\> Connect-Ucs 1.2.3.4

• C:\> Start-UcsGuiSession -LogAllXml

• C:\> ConvertTo-UcsCmdlet

• Create a ‘config-all’ XML backup from UCS Manager

• C:\> ConvertTo-UcsCmdlet -UcsBackup -LiteralPath backup.xml -OutputPath output.ps1

Getting Started: UCS Connections

• Connect-Ucs returns a UcsHandle on a successful connection

– Connect to 1 UCS, by Name/IP

– Connect to ‘n’ UCS, by Name/IP, with the same credentials

– Connect to ‘n’ UCS with information from a file, protected by a key

• If -NotDefault isn`t specified, handles go to a Default UcsHandle list

• By default, not more than 1 UcsHandle is allowed in the Default UcsHandle list

– Override with:

Set-UcsPowerToolConfiguration -SupportMultipleDefaultUcs $true

• Refresh of the connection happens in the background

• Get-UcsPSSession to see the Default UcsHandle list

• Export-UcsPSSession to save a set of UcsHandles to file

Getting Started: Get-UcsCmdletMeta Another Great way to learn about the PowerTool cmdlets

Transactions in UCS PowerTool for UCS Manager • A set of XML requests can be sent to UCS in a single transaction.

• Only Add-* or Set-* cmdlets can be used in a transaction

• Example of requests without transaction • Get-UcsServiceProfile Server1 | Set-UcsServiceProfile -Descr Description1

– <configConfMos cookie="" inHierarchical="false"><inConfigs><pair key="org-root/ls-Server1"><lsServer

descr="Description1" dn="org-root/ls-Server1" status="modified" /></pair></inConfigs></configConfMos>

• Get-UcsServiceProfile Server2 | Set-UcsServiceProfile -Descr Description2 – <configConfMos cookie="" inHierarchical="false"><inConfigs><pair key="org-root/ls-Server2"><lsServer

descr="Description2" dn="org-root/ls-Server2" status="modified" /></pair></inConfigs></configConfMos>

• Example of same requests within transaction • $sp1 = Get-UcsServiceProfile Server1

• $sp2 = Get-UcsServiceProfile Server2

• Start-UcsTransaction

• $sp1 | Set-UcsServiceProfile -Descr Description1 -Force

• $sp2 | Set-UcsServiceProfile -Descr Description2 –Force

• Complete-UcsTransaction –Xml

– <configConfMos cookie="" inHierarchical="false"><inConfigs><pair key="org-root/ls-Server1"><lsServer

descr="Description1" dn="org-root/ls-Server1" status="modified" /></pair><pair key="org-root/ls-

Server2"><lsServer descr="Description2" dn="org-root/ls-Server2" status="modified"

/></pair></inConfigs></configConfMos>

• Pending transactions can be undone using Undo-UcsTransaction

Transactions in UCS PowerTool for UCS Manager

UCS PowerTool Parameter Validations

• PowerShell has native support for parameter validation.

• PowerTool uses this feature to ensure parameter validations before sending XML requests.

• A validation in PowerTool generally falls in one or more of the categories below:

• Length: minimum and maximum length of a string

• Range: minimum and maximum value of an integral type

• Value set: set of all possible values for a parameter

• Pattern: regular expression based validation

• Hybrid: A combination of the above.

UCS PowerTool Parallelism

• When connected to multiple UCS, any request is sent to all systems in parallel.

Get-UcsChassis Get-UcsChassis Parallel Not Parallel

Connected to Multiple UCS Domains

UCS PowerTool Parallelism Connected to Multiple UCS Domains

Managed Object (MO) Versioning

• MO Versioning Information is required to be able to inter-operate between versions of UCS

• Assuming a MO with Properties A,B,C,D

• Field A

• Field B

• Field C

• Field D

Version 1

Managed Object (MO) Versioning

• MO Versioning Information is required to be able to inter-operate between versions of UCS Schema

• Assuming a field E which was not present in version 1 and was added in version 2.

• Compare-UcsMo method will skip this field while doing a MO comparison

• Sync-UcsMo will also skip this field while sending the diff to Version 1 UCS

• As a generic rule, Sync-UcsMo will skip operational properties, unknown properties and operational MOs, unknown MOs

• Field A

• Field B

• Field C

• Field D

Version 1

• Field A

• Field B

• Field C

• Field D

• Field E

Version 2

Compare & Sync Managed Objects (MO)

• Compare-UcsManagedObject & Sync-UcsManagedObject work on a set of MOs, in a generic manner.

• The usage scenarios are many .. esp. when considered with -XlateOrg, - XlateMap, -DeleteNotPresent

• The snippet below shows an unassociated SP from one org to another without losing any identifiers, etc. (done in 2 back to back transactions).

DEMO: Using UCS PowerTool for UCS Manager

LAB: Using UCS PowerTool for UCS Manager

What is Cisco IMC’s Programmatic Infrastructure?

Events {xml}

HTTP(S) {xml}

Syslog Server

Events {SNMP Traps}

Polls {SNMP GET}

SNMP-based NMS

Events {Syslog

Messages}

Syslog

XML API

Memory CPU

PCI Adaptors

System Board

Fault Engine

Cisco UCS C-Series Server

Storage Daemon

Inventory Sensor Data

Config

Faults

Storage Controller

Disk Disk Disk

Disk Disk Disk Disk

Architecture of Cisco UCS C-Series IMC UCS PowerTool

Cisco UCS PowerTool for IMC

Cisco UCS PowerTool for IMC Most Commonly Used Objects and Assets

• Server Inventory – Hardware Inventory

• CPU

• Memory

• Motherboard

• Power Supplies

• Hard Disk Drives

• Fans

– Environmental statistical data (Power / Temperature)

– Hardware Faults

• Equipment Operations – Server Power State Change

– Enable / Disable LED

– KVM GUI Launch

– CIMC User Interface Launch

• CIMC Admin Config Operations – Monitoring (SNMP, Syslog, NTP)

– Authentication (Local Users, LDAP, LDAP Group to Role Mapping)

– Firmware Management via Host Update Utility Non-Interactive

– Import / Export CIMC Configuration

• Server Config Operations – BIOS Settings

– Boot Order (Legacy and Precision Boot Config)

– Local Storage Configuration

– Virtual Interface Card Adaptor Configuration

– Compare / Sync Objects across IMC’s

• Adaptors

– Storage Controller

– Virtual Interface Card

– LOM’s

– Other PCI devices

Cisco IMC XML Hierarchy Overview Managed Object to UCS PowerTool Command Reference

rack-unit-1

adaptor-1

biosUnit

bios settings

bios defaults

compute board

temp stats

power stats

fan module

memory array

definition

LAN storage virt media

local hyper

threading turbo boost

cpu cores enabled

supply

processor unit-1 memory

unit-1

rack-unit-1

biosUnit

bios settings

bios defaults

temp stats

power stats

fan module

definition

local hyper

cpu cores enabled

Get-ImcAdaptorUnit | Get-ImcAdaptorHostEthIf

memory array

adaptor-1

eth0 fan0

supply

processor unit-1

compute board

memory unit-1

rack-unit-1

adaptor-1

biosUnit

bios settings

bios defaults

temp stats

power stats

fan module

definition

local hyper

cpu cores enabled

Get-ImcComputeBoard | Get-ImcMemoryArray | Get-ImcMemoryUnit

supply

processor unit-1

compute board

memory array

memory unit-1

CiscoImcPS Module Overview

Getting Started: ConvertTo-ImcCmdlet

• The best way to discover the UCS PowerTool cmdlets and usage

• Launch IMC GUI, login, and make changes In CIMC GUI (Example: Configure BIOS Settings)

• Connect via UCS PowerTool for IMC and run:

• C:\> Connect-Imc 1.2.3.4

• C:\> $BiosSettings = Get-ImcBiosSettings -Hierarchy

• C:\> $BiosSettings | ConvertTo-ImcCmdlet

Getting Started: IMC Connections

• Connect-Imc returns a ImcHandle on a successful connection

– Connect to 1 IMC, by Name/IP

– Connect to ‘n’ IMC, by Name/IP, with the same credentials

– Connect to ‘n’ IMC with information from a file, protected by a key

• If -NotDefault isn`t specified, handles go to a Default ImcHandle list

• By default, not more than 1 ImcHandle is allowed in the Default ImcHandle list

– Override with: • Set-ImcPowerToolConfiguration -SupportMultipleDefaultImc $true

• Refresh of the connection happens in the background

• Get-ImcPSSession to see the Default ImcHandle list

• Export-ImcPSSession to save a set of ImcHandles to file

Transactions in UCS PowerTool for IMC • A set of XML requests that can be sent and applied to IMC in an

optimized fashion, in as few XML transmissions as possible.

– IMC supports full sub-tree manipulation in a single XML transmission for:

• BIOS Settings

• Boot Order

• LDAP authentication settings

• Only Add-* or Set-* cmdlets can be used in a transaction

• Pending transactions can be undone using Undo-ImcTransaction

Transactions in UCS PowerTool for IMC • Example of requests without transaction

– $HyperT = Get-ImcBiosSettings | Get-ImcBiosHyperThreading

– $HyperT | Set-ImcBiosHyperThreading -VpIntelHyperThreadingTech enabled • <configConfMo cookie="" dn="sys/rack-unit-1/bios/bios-settings/Intel-HyperThreading-Tech"

inHierarchical="false"><inConfig><biosVfIntelHyperThreadingTech dn="sys/rack-unit-1/bios/bios-settings/Intel-

HyperThreading-Tech" status="modified" vpIntelHyperThreadingTech="enabled" /> </inConfig></configConfMo>

– $Turbo = Get-ImcBiosSettings | Get-ImcBiosTurboBoost

– $Turbo | Set-ImcBiosTurboBoost -VpIntelTurboBoostTech enabled • <configConfMo cookie="" dn="sys/rack-unit-1/bios/bios-settings/Intel-Turbo-Boost-Tech"

inHierarchical="false"><inConfig><biosVfIntelTurboBoostTech dn="sys/rack-unit-1/bios/bios-settings/Intel-Turbo-Boost-

Tech" status="modified" vpIntelTurboBoostTech="enabled" /></inConfig></configConfMo>

• Example of same requests within transaction – $HyperT = Get-ImcBiosSettings | Get-ImcBiosHyperThreading

– $Turbo = Get-ImcBiosSettings | Get-ImcBiosTurboBoost

– Start-ImcTransaction

– $HyperT | Set-ImcBiosHyperThreading -VpIntelHyperThreadingTech enabled

– $Turbo | Set-ImcBiosTurboBoost -VpIntelTurboBoostTech enabled

– Complete-ImcTransaction –Xml

• <configConfMo cookie="" dn="sys/rack-unit-1/bios/bios-settings" inHierarchical="false"><inConfig><biosSettings

dn="sys/rack-unit-1/bios/bios-settings" status="modified"><biosVfIntelHyperThreadingTech dn="sys/rack-unit-

1/bios/bios-settings/Intel-HyperThreading-Tech" status="modified" vpIntelHyperThreadingTech="enabled"

/><biosVfIntelTurboBoostTech dn="sys/rack-unit-1/bios/bios-settings/Intel-Turbo-Boost-Tech" status="modified"

vpIntelTurboBoostTech="enabled"/> </biosSettings></inConfig></configConfMo>

UCS C-Series Server

Transactions in UCS PowerTool for IMC

CIMC XMLAPI

Transaction #1:

Create Local User “user14”

Transaction #2:

Create Local User “user15”

Transaction #3:

Configure Three BIOS Settings

DEMO: Using UCS PowerTool for Cisco IMC

LAB: Using UCS PowerTool for Cisco IMC

UCS PowerTool Free-form Coding

Participate in the “My Favorite Speaker” Contest

• Promote your favorite speaker through Twitter and you could win $200 of Cisco Press products (@CiscoPress)

• Send a tweet and include

– Your favorite speaker’s Twitter handle @aeroic78

– Two hashtags: #CLUS #MyFavoriteSpeaker

• You can submit an entry for more than one of your “favorite” speakers

• Don’t forget to follow @CiscoLive and @CiscoPress

• View the official rules at http://bit.ly/CLUSwin

Promote Your Favorite Speaker and You Could be a Winner

Complete Your Online Session Evaluation

• Give us your feedback and you could win fabulous prizes. Winners announced daily.

• Complete your session evaluation through the Cisco Live mobile app or visit one of the interactive kiosks located throughout the convention center.

Don’t forget: Cisco Live sessions will be available for viewing on-demand after the event at CiscoLive.com/Online

Continue Your Education

• Demos in the Cisco Campus

• Walk-in Self-Paced Labs

• Table Topics

• Meet the Engineer 1:1 meetings

Managing UCS environments with UCS PowerTool...

Documents

Transcript of Managing UCS environments with UCS PowerTool...

PowerShell Security Settings and Configurations · PowerShell Security Settings and Configurations. Table of Contents . PowerShell Security Settings ...

Automation Azure with PowerShell - files.informatandm.comfiles.informatandm.com/...with_PowerShell_Beyond_the_Azure_PowerShell... · #ITDEVCONNECTIONS | ITDEVCONNECTIONS.COM PowerShell

PowerShell Saturday #009 (Singapore) - Azure + PowerShell

Introduction to PowerShell - Be a PowerShell Hero - SPFest workshop

Guida operativa di Comandi PowerShell per CA … ARCserve...Concetti relativi a PowerShell Capitolo 1: Introduzione 11 Concetti relativi a PowerShell Cmdlet di PowerShell Windows PowerShell

PowerShell DSC PowerShell - static.fnac-static.com · PowerShell DSC Simplifiez et accélérez vos configurations système PowerShell DSC Simplifiez et accélérez vos configurations

PIPELINE CORROSION POWERTOOL - … · Technical Toolboxes' new Pipeline Corrosion PowerTool is a steady-state ... analysis of oil and gas production systems ... transmission or distribution

Cisco UCS Manager PowerTool, Release 1.x User Guide · Now, when a service profile instance refers to a service profile template (by name), the name is looked up hierarchically from

Dell Command | PowerShell Provider Version 1.0 …topics-cdn.dell.com/pdf/dell-command-powershell-provider-v1.0_User... · 1 Introduction Dell Command | PowerShell Provider is a PowerShell

Managing UCS environments with UCS PowerTool …files.meetup.com/11636312/RDU-PoSh UG PowerTool.pdf• Web Based End User Community • Tools, Downloads, Examples • UCS Platform

Automation Using PowerShell - cdn.ttgtmedia.com · 328 CHAPTER 8 AUTOMATION USING POWERSHELL Installing the VMM PowerShell Cmdlets Even though the VMM PowerShell interface does not

CK Powertool Accessories

© 2010 Cisco and/or its affiliates. All rights reserved. 1 Managing Microsoft Applications with Cisco UCS Manager & PowerTool.

PS405: Windows PowerShell Tool Making for … Jones’ book on PowerShell Toolmaking. ... Windows PowerShell Tool Making for Administrators PowerShell Scripting and Tool Making is

Introduction to PowerShell€¦ · Title: Introduction to PowerShell Author: Peter McEldowney Subject: PowerShell, Active Directory Keywords: powershell, power shell, active directory,

Windows Powershell 3 - Netz-Weise€¢Powershell-ISE •Integration in ... Windows PowerShell •Workflows bestehen aus den Elementen ... • Don Jones –PowerShell Workflow: When

Hand PowerTool

POWERSHELL SHENANIGANS LATERAL MOVEMENT WITH POWERSHELL KIERAN JACOBSEN READIFY.

Fast Innovation requires Fast IT UCS Session · UCS Is Redefining Server Management 10,000 UCS Servers: Monitor and Manage Seamlessly UCS CLI + UCS Manager + UCS Central + UCS Third

Best of Fine Woodworking Powertool Basics