Intégration Cisco UCS en environnement Microsoft - PART 2

Cisco Confidential © 2013 Cisco and/or its affiliates. All rights reserved. 1

Introduction to…

UCS Management Emulator &

PowerShell with PowerTool

19/05/2014

Franck Bonneau

Consulting Systems Engineer

fbonneau@cisco.com

Cisco Confidential 2 © 2013 Cisco and/or its affiliates. All rights reserved.

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 3

• Emulates UCSM

1. Full GUI features

2. Blades (But can’t boot them and install an OS)

3. API (PowerTool, etc.)

4. Can’t get environmentals

Everything runs cool in a virtual world !

5. Partial UCSM CLI

(NO connect nxos or connect local-mgmt)

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 4

• Cisco Developer Site

http://developer.cisco.com/web/unifiedcomputing/ucsemulatordownload

Direct Link : https://communities.cisco.com/docs/DOC-37827

Download the ZIP file and the PDF documents

***Must have a Cisco login to download***

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 5

• UCSM Emulator is provided in VMWare and OVA formats

SORRY !

• Can convert to work in Hyper-V

Documented process in Emulators User Guide

Search for - Launching Cisco UCS Platform Emulator Using Microsoft Hyper-V

Basically converting the VMWare virtual hard disk (VMDK) to a VHD and then creating a virtual machine with the appropriate settings.

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 6

• Connect to the console of the UCSM VM

• Start the VM

• WAIT

• After the emulator has fully started, login with config/config

• Select option (a) from the console menu

(a) View & Configure Network Settings Change settings? (y/n): y Use DHCP? (y/n): y or n, if ‘n’ then proceed eth0: Enter IP Address: x.x.x.x (This is the IP Address of Fabric Interconnect A) eth0: Enter netmask (255.x.x.x): x.x.x.x eth1: Enter IP Address: x.x.x.y (This is the IP Address of Fabric Interconnect B) eth1: Enter netmask (255.x.x.x): x.x.x.x eth2: Enter IP Address: x.x.x.z (This is the IP Address the management VIP) eth2: Enter netmask (255.x.x.x): x.x.x.x Enter default gateway: x.x.x.a

• WAIT till the menu is back up in the console

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 7

• Open a web browser to the IP Address of the UCSMe VIP

Or

• SSH to the IP Address of the UCSMe VIP

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 8

• Select Launch UCS Manager

• User name will be ‘admin’, password is <none or anything>

Remember: Java required on your machine

Note: Changing Emulator Settings requires Firefox browser (Sorry….Again!)

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 9

• Setting the emulator back to factory settings takes a LONG time.

• If you are going to play around with configs and then want to restore to factory quickly, do this.

Go to the Admin Tab

Set the filter to All

Highlight ‘All’

Select Backup Configuration

Select Create Backup Operation

Admin State: Enabled

Type: All Configuration

Preserve Identities: Checked

Location of the Backup File: Local File System

Browse and pick location and file name – Suggest – Emulator_Blank.xml

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 10

• Now, when you want to get back to the factory config without losing your IP addressing do this:

Go to the Admin Tab

Set the filter to All

Highlight ‘All’

Select Import Configuration

Select Create Import Operation

Admin State: Enabled

Action: Replace

Location of the Import File: Local File System

Browse and select the Emulator_Blank.xml file

Wait about 2 minutes and you are set to start playing again!

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 11

Quick run through of the UCSMe

Show default configuration

Show Emulator Settings

Cisco Confidential 12 © 2013 Cisco and/or its affiliates. All rights reserved.

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 13

• Microsoft’s goal: all GUIs in Windows should be front-end to Powershell

• Powershell is CLI-driven

scripting/programming language with access to all .NET objects

ideal for automating Windows-oriented tasks

not limited to Windows: Cisco UCS module, VMware module, etc.

• Current version is v4

Microsoft Introduced it’s first scripting option for Windows in 1998

PowerShell v1.0 introduced in 2006

Today we are at v4.0 in Windows 8.1/2012R2

Preinstalled in Windows 7 and 2008 R2

• Available for free from http://technet.microsoft.com/en-us/scriptcenter/dd742419.aspx

• Integrated Scripting Environment (ISE) an optional feature on Windows

• Everything you can do in the GUI can be automated using Powershell

We are very close to being able to do ANYTHING with Windows and Microsoft applications with PowerShell

• Two flavors: 64-bit and 32-bit

use the 64-bit version; the 32-bit is there for compatibility reasons

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 14

• Always Run as Administrator

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 15

• Powershell built-in commands (pronounced “command lets”)

3rd party modules add cmdlets to existing native library

• Find cmdlets using “get-command *your_topic*”

wildcards accepted

• Find help topics using “help *your_topic*”

• Cmdlets follow a naming convention:

verb hyphen noun [dash name space value]

• Help <cmdlet> is your friend

help <cmdlet> -full details parameter usage

help <cmdlet> -examples provides sample uses

• Help is actually a wrapper for Get-Help which automatically pipes the output to the more function

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 16

• Powershell’s ability to take output from one cmdlet and feed it to another

keep in mind that unlike a Unix shell, the output of a cmdlet isn’t necessarily just text, it can be a full-blown .NET object or an array of objects!

this is where the power of Powershell really is

• Stupid example:

Get-Process | Stop-Process

Don’t run that command … it takes each and every process and runs stop-process against them

• More realistic examples

Get-Process | ConvertTo-CSV | Out-File myProcesses.csv

Get-Process –name Notepad | Stop-Process

• You can always use the –whatif parameter to perform a dry-run

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 17

• There is only one Powershell

A vendor doesn’t give you a new version of Powershell

• Powershell can be extended using two mechanisms

Snapins

Modules

• To add a snap-in, you use add-pssnapin <name>

• to list new cmdlets: get-command –pssnapin <name>

• to view installed snap-ins, use get-pssnapin -registered

• Modules are v2 only

PS looks for them in env variable PSModulePath

Get-content env:psmodulepath to retrieve variable

Get-module –listavailable to list modules

Supposed to be more self-contained than snap-ins

Import module with import-module <module> cmdlet

List cmdlets from module with gcm –module <module> gcm is an alias for get-command

Cisco Confidential 18 © 2013 Cisco and/or its affiliates. All rights reserved.

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 19

• Comprehensive XML API, standards-based interfaces

• Bi-Directional access to physical & logical internals

Direct CLI GUI API Cisco

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 20

• PowerTool is a module for PowerShell

• Automatically generated by Cisco for each major UCSM release

99% auto generated

• ~100% of what you can do in UCSM CLI and GUI you can do in PowerTool

• Full .NET

Cisco UCS

PowerTool Module

UCS .NET Namespace

UCS XML API

cmdlets

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 21

• Cisco Connection Online

http://www.cisco.com

***Must have a Cisco login***

Select: Support, then All Downloads

Find: Cisco UCS Management Partner Ecosystem Software

Select: Unified Computing System (UCS) PowerTool

Select the latest version and download

Get the documentation

In the main search option in Cisco Connection Online enter: PowerTool

Scroll down and select the Release Notes

At the bottom of this link is also a link to the Users Guide

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 22

• Run the install and do the normal NEXT NEXT NEXT FINISHED

• You now have the module installed on your PC

• Default location is:

C:\Program Files (x86)\Cisco\Cisco UCS PowerTool\Modules\CiscoUcsPS

• A batch file is available in your start menu to open PowerShell and load the module

• Of course your machine needs to support PowerShell and have PowerShell allowed to execute….

In case PowerShell is dissabled on your PC, use the command below to enable it :

Enable: “Set-ExecutionPolicy –ExecutionPolicy Unrestricted –Force”

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 23

Demonstrate PowerTool

Connect UCS & Multi UCS NIC Rename Multi-UCS KVM Available Slots

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 24

• Wouldn’t it be nice to get help using PowerShell?

You can!

• Get into your UCSM GUI

• Launch PowerTool

Type: ConvertTo-UcsCmdlet

• Do something in UCS and hit ‘SAVE’

• Look for the output in your PowerShell window

First time takes a bit for the output to show

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 25

• Logging into a UCS

$cred = get-credential

$myucs = “x.x.x.x”

Connect-Ucs -Credential $cred -Name $myucs

• Logging into a bunch of UCS domains

$cred = get-credential

$myucs = @(“x.x.x.x”, “y.y.y.y”, “z.z.z.z”)

foreach ($myucslist in $myucs)

{

$myCon = Connect-Ucs -Credential $cred -name $myucslist

}

• Disconnect from UCSM

Disconnect-ucs

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 26

• Ajouter un vlan

Get-UcsLanCloud | add-UcsVlan -Name ESX_VMNIC_1 -Id 101

• Delete Range de VLANs

Get-UcsVlan | ? {$_.Id -ge 100 -and $_.Id -le 110 } | Remove-UcsVlan –Force

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 27

Log into UCSM

clear

$cred = Get-Credential

$myucs = "10.60.0.231"

$mycon = Connect-Ucs -Name $myucs -Credential $cred

$blades = Get-UcsBlade

Disconnect-Ucs

Log into multiple UCSM domains

clear

$multilogin = Set-UcsPowerToolConfiguration -SupportMultipleDefaultUcs $true

$cred = Get-Credential

$myucs = @(“10.60.0.231",“192.168.46.138")

$mycon = Connect-Ucs -Name $myucs -Credential $cred

#do your thing

$blades=get-ucsblade

Disconnect-Ucs

Save the Output in file

clear

$multilogin = Set-UcsPowerToolConfiguration -SupportMultipleDefaultUcs $true

$cred = Get-Credential

$myucs = @(“10.60.0.231",“192.168.46.138")

$mycon = Connect-Ucs -Name $myucs -Credential $cred

#do your thing

$blades=get-ucsblade

Write-Output "Model Cores Memory" | Out-File test.csv

ForEach ($blade in $blades){

Write-Output "$($blade.Model) $($blade.NumOfCores) $($blade.TotalMemory)" | Out-File -Append c:\Tmp\test.csv}

Disconnect-Ucs

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 28

• More PowerShell Exemples :

https://communities.cisco.com/people/joemar/content

• XML API and other tools:

https://developer.cisco.com/site/data-center/ucs-system-mgmt/ucs-dev-center/documentation/index.gsp

© 2013 Cisco and/or its affiliates. All rights reserved. Cisco Confidential 29

Merci de votre participation

Prenez connaissance de nos évènements sur

www.cisco.fr/go/evenements