You are on page 1of 66

Cisco UCS Platform Emulator User Guide, Release 3.

1
First Published: April 11, 2016

Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883

© 2016

Cisco Systems, Inc. All rights reserved.

CONTENTS

Preface

Preface vii
Audience vii
Conventions vii
Related Cisco UCS Documentation ix
Documentation Feedback ix

CHAPTER 1

New and Changed Information 1
New and Changed Information 1

CHAPTER 2

Overview 15
Information About Cisco UCS Platform Emulator 15
Cisco UCS Platform Emulator Control Panel 15
Navigation Pane 15
Work Pane 16
Hardware Inventory Dashboard 16
Hardware Inventory Menu and Dashboard Icons 16

CHAPTER 3

Installing and Running Cisco UCS Platform Emulator Using the VM Console 19
IP Address for Cisco UCS Platform Emulator 19
Installing and Launching Cisco UCS Platform Emulator 20
Launching Cisco UCS Platform Emulator Using Hypervisors 20
Viewing System Settings Using VM Console 22
Modifying System Settings Using VM Console 23
Modifying Network Settings Using the VM Console 23
Restarting and Rebooting Cisco UCS Platform Emulator Using the VM Console 24
Starting the Cisco UCS Manager CLI Using the VM Console 25

Cisco UCS Platform Emulator User Guide, Release 3.1
iii

Release 3.Contents CHAPTER 4 Restarting and Shutting Down Cisco UCS Platform Emulator Using the Control Panel 27 Restarting Cisco UCS Platform Emulator 27 Restarting Cisco UCS Platform Emulator and Performing a Factory Reset 27 Rebooting the Cisco UCS Platform Emulator VM 28 Shutting Down the Cisco UCS Platform Emulator VM 28 CHAPTER 5 Configuring Cisco UCS Platform Emulator 29 Viewing the Cisco UCS Platform Emulator Current Status and Settings 29 Status Summary Page 29 Modifying the Cisco UCS Manager High Availability Setting 31 Configuring Statistics in Cisco UCS Platform Emulator 32 Modifying the Fabric Interconnect Emulation Settings 32 Configuring Cisco UCS Platform Emulator Restart Settings 33 CHAPTER 6 Configuring the Hardware Inventory 35 Viewing the Hardware Catalog 35 Manually Configuring the Hardware Inventory 36 Adding a New Chassis 36 Creating a New Rack Server 36 Creating a New Fabric Extender 37 Creating a New Blade Server 37 Creating a New Modular Server 38 Modifying Hardware Components 39 Modifying Chassis Components 39 Modifying Rack. and Modular Server Components 39 Duplicating a Device 40 Inserting a Device into Cisco UCS Manager 40 Removing a Device from Cisco UCS Manager 41 Inserting or Removing a Device in Cisco UCS Platform Emulator 41 Inserting or Removing all Devices in Cisco UCS Platform Emulator 42 Deleting a Device 43 Managing Connectivity of Links Between Devices 43 Using Existing Hardware Inventory Configurations 44 Importing a Hardware Inventory Configuration File 45 Cisco UCS Platform Emulator User Guide.1 iv . Blade.

1 v .Contents Importing the Equipment from a Cisco UCS Domain 45 Importing a Saved Hardware Inventory Configuration 46 Saving the Current Hardware Inventory Configuration 46 Exporting the Hardware Inventory Configuration as an XML File 47 CHAPTER 7 Accessing Features in Cisco UCS Platform Emulator 49 Starting the Cisco UCS Manager GUI from the Cisco UCS Platform Emulator Control Panel 49 Accessing Cisco Developer Network 50 Accessing Cisco UCS PowerTool 50 Information about Cisco UCS PowerTool 50 Downloading Cisco UCS PowerTool 50 CHAPTER 8 Using the Managed Object Browser 51 Information About the Managed Object Browser 51 Managed Object Browser Page 51 Running a Query in the Managed Object Browser 53 CHAPTER 9 Accessing the Cisco UCS Manager XML API Documentation 55 Information About the Cisco UCS Manager XML API 55 Information About the Cisco UCS Manager XML API Documentation 56 Accessing the Cisco UCS Manager XML API Documentation 56 Cisco UCS Platform Emulator User Guide. Release 3.

1 vi . Release 3.Contents Cisco UCS Platform Emulator User Guide.

and field labels appear in this font. page ix • Documentation Feedback.1 vii . Release 3. page vii • Conventions. System output Terminal sessions and information that the system displays appear in this font. page vii • Related Cisco UCS Documentation.Preface • Audience. TUI elements In a Text-based User Interface. area names. Document titles Document titles appear in this font. text the system displays appears in this font. Main titles such as window. and wizard titles appear in this font. dialog box. Cisco UCS Platform Emulator User Guide. page ix Audience This guide is intended primarily for data center administrators with responsibilities and expertise in one or more of the following: • Server administration • Storage administration • Network administration • Network security Conventions Text Type Indication GUI elements GUI elements such as tab titles.

Means the following information will help you solve a problem. similar to a Timesaver. <> Nonprinting characters such as passwords are in angle brackets. You can save time by performing the action described in the paragraph. In this situation. !. Note Tip [] Elements in square brackets are optional. Caution Means reader be careful.Preface Conventions Text Type Indication CLI commands CLI command keywords appear in this font. The tips information might not be troubleshooting or even an action. Release 3. {x | y | z} Required alternative keywords are grouped in braces and separated by vertical bars. Timesaver Means the described action saves time. Variables in a CLI command appear in this font. Means reader take note. Cisco UCS Platform Emulator User Guide. [x | y | z] Optional alternative keywords are grouped in brackets and separated by vertical bars. Notes contain helpful suggestions or references to material not covered in the document. Do not use quotation marks around the string or the string will include the quotation marks.1 viii . but could be useful information. string A nonquoted set of characters. [] Default responses to system prompts are in square brackets. # An exclamation point (!) or a pound sign (#) at the beginning of a line of code indicates a comment line. you might perform an action that could result in equipment damage or loss of data.

Preface Related Cisco UCS Documentation Warning IMPORTANT SAFETY INSTRUCTIONS This warning symbol means danger. Documentation Feedback To provide technical feedback on this document.cisco. You are in a situation that could cause bodily injury. Other Documentation Resources Follow Cisco UCS Docs on Twitter to receive document update notifications. be aware of the hazards involved with electrical circuitry and be familiar with standard practices for preventing accidents. Use the statement number provided at the end of each warning to locate its translation in the translated safety warnings that accompanied this device.com/go/unifiedcomputing/c-series-doc. Release 3.com. see the Cisco UCS B-Series Servers Documentation Roadmap available at the following URL: http://www. or to report an error or omission. We appreciate your feedback. For a complete list of all C-Series documentation. Before you work on any equipment. For information on supported firmware versions and supported UCS Manager versions for the rack servers that are integrated with the UCS Manager for management. see the Cisco UCS C-Series Servers Documentation Roadmap available at the following URL: http://www. refer to Release Bundle Contents for Cisco UCS Software. please send your comments to ucs-docfeedback@cisco.1 ix . Cisco UCS Platform Emulator User Guide.cisco.com/go/unifiedcomputing/b-series-doc. SAVE THESE INSTRUCTIONS Related Cisco UCS Documentation Documentation Roadmaps For a complete list of all B-Series documentation.

Release 3.1 x .Preface Documentation Feedback Cisco UCS Platform Emulator User Guide.

page 1 New and Changed Information The following tables provide an overview of the significant new features and behavioral changes to the Cisco UCS Platform Emulator. Release 3.1 1 . The tables do not provide an exhaustive list of all changes or of the new features in each release. Release 3. 3 Unified release supporting all platforms and components such as Classic. removal and modification of components that requires no restarting of Cisco UCS Platform Emulator.1(1ePE1) New or Changed Feature Description New Features Following new features are added: 1 Emulation of full scale setup 2 Dynamic insertion. Table 1: New Features and Significant Behavioral Changes in Cisco UCS. UCS Modular Servers Cisco UCS Platform Emulator User Guide. UCS Mini.CHAPTER 1 New and Changed Information This chapter includes the following sections: • New and Changed Information.

New and Changed Information New and Changed Information New or Changed Feature Description New Graphic User Interface Features Following new GUI features are added: 1 Summarized view of configured inventory helps in viewing exhaustive settings 2 Focus view for each device with filtered catalog to configure components easily 3 New menu bar 4 Configure topology with Manage links module to configure customized and automatic connections 5 Import connectivity and cluster information from saved configuration and Live UCS 6 Easy to duplicate new devices (Chassis. Release 3.1 2 . Fex and Servers) and quickly create extensive set-ups 7 Easy to add pre-configured devices using templates 8 Inserting and removing of all devices in a single instance 9 Navigation pane for quick and easy access 10 Configure all devices to insert automatically upon restart 11 Add components for devices in bulk using range inputs Changes and limitations Customize statistics for devices with fixed/random/incrementing values Set clock and NTP server from UCSPE CLI SmartPlay Bundle Configurations are not supported Removed loading configuration from a startup URL Removed SD Card and TPM support Removed Dynamic Fault Injection feature Cisco UCS Platform Emulator User Guide.

Release 3.New and Changed Information New and Changed Information Table 2: New Features and Significant Behavioral Changes in Cisco UCS.1 3 . Cisco UCS Platform Emulator User Guide.5(2aPE1) and 2. Release 2.5(2aPE1) New or Changed Feature Description New Hardware support Following new hardware features are added: 1 Compute Modular Servers: 1 Cisco UCSME-1414 1 Socket Server 2 Cisco UCSME-2814 2 Socket Server 2 CPUs: a UCS-CPU-E31231D b UCS-CPU-E31241D c UCS-CPU-E31271D d UCS-CPU-E31281D e UCS-CPU-E52630D f UCS-CPU-E52640D g UCS-CPU-E52650D h UCS-CPU-E52660D 3 DIMMS: 1 UCS-MR-1X081RU-A 2 UCS-MR-1X162RU-A New software features Following new software features are added: 1 Templates (pre-configured cartridges with servers on the control panel) for New Modular Servers • ME1414 High • ME2814 Medium • ME2814 High 2 Added TPM/TXT support for the new modular servers UCSME-1414 and UCSME-2814 Note Cisco UCS Releases 2.5(1aPE1) support configuration only for the UCS chassis UCSME-4308 and its components.

UCS-MU-1X082RY-F 4 Storage Disks: 1 UCS-SD240G0KS2-EV 2 UCS-SD480G0KS2-EV 3 UCS-SD960G0KS2-EV 4 UCS-SD400G0KS2-EP 5 UCS-SD800G0KS2-EP 6 UCS-SD16T12S2-EP 5 CPUs: 1 UCS-CPU-E31220LD 2 UCS-CPU-E31240LD 3 UCS-CPU-E31275LD 6 Storage controller .New and Changed Information New and Changed Information Table 3: New Features and Significant Behavioral Changes in Cisco UCS.UCSME-4308 is a new chassis for modular servers which supports resource sharing such as adaptors and storage. Release 2. 2 Compute Modular Server -Cisco UCSME-142-M4 Socket Server ( UCSME-142-M4) 3 DIMM . It has a single IOM (UCSME-4308).5(1aPE1) New or Changed Feature Description New Hardware support Following new hardware features are added: 1 UCS Chassis .Cisco 12G SAS Modular Raid Controller (UCSME-MRAID12G) Changes to the Cisco UCS Platform Emulator 1 Modifications to the VM Console login VM console 2 Modifications to the VM Console Options Menu 3 Modifications to the Network Settings 4 Modifications to the System Settings 5 More details added to the Status Summary display Cisco UCS Platform Emulator User Guide. Release 3.1 4 .

New and Changed Information New and Changed Information New or Changed Feature Description New software features Following new software features are added: 1 Templates (pre-configured cartridges with servers on the control panel) for New Modular Servers • ME142 M4 Low • ME142 M4 Medium • ME142 M4 High 2 New tab for modular servers 3 Support for storage profile operations: • Creation of a Logical Unit Number (LUN) • Deletion of a LUN • Modification to a LUN • Hot Spare addition • Removal of Hot Spares Table 4: New Features and Significant Behavioral Changes in Cisco UCS. New Blade Server support Added support for the following Blade servers: • UCSB-B420-M4 • Cisco UCS Scalable M4 Blade Module for UCSB-EX-M4-2 Blade Server New network adapter support Added support for the UCSC-PCIE-Q8362 network adapter. Release 3. Scaled mode servers The UCSB-EX-M4-2 Blade Server can be added in scaled (4S) or non-scaled (2S) mode. Cisco UCS Platform Emulator User Guide. Release 2.1 5 . New Software support Added support for time zone management.2(5aPE1) New or Changed Feature Description New Hardware support Added Haswell CPUs to the catalog.

UCSC-C460-M4 . 3 Added notes on Single Wire Management and Direct Connect Rack mode regarding newly added supported UCS C-series adapters and FEX. Release 3. Release 2. Cisco UCS Platform Emulator User Guide.2(4bPE1) New or Changed Feature Description New Network Adapter support Added support for the following network adapters: • UCSC-MLOM-C10T-02 • UCSB-MEZ-BRC-02 • UCSC-PCIE-C10T-02 New Fabric Extender Support 1 Added support for N2K-C2232TM-E-10GE 2 New tab Rack Integration in the navigation pane of UCS Platform Emulator control panel.1 6 . It allows to select the desired FEX model and change the modes of Direct Connect Rack and Single Wire Management. UCSB-EX-M4-1 and UCSB-EX-M4-2 servers: 1 B420M4High 2 C460M4High 3 ExM4ScaledHigh 4 ExM4NonScaledHigh 5 ExM42ScaledHigh 6 ExM42NonScaledHigh Table 5: New Features and Significant Behavioral Changes in Cisco UCS.New and Changed Information New and Changed Information New or Changed Feature Description New templates Added the following templates for UCSB-B420-M4.

Release 3.2(3aPE1) New or Changed Feature Description New blade server support Added support for the Cisco UCSB-B200-M4 Blade Server Cisco UCS Platform Emulator User Guide. importing from XML and loading a saved hardware configuration Changes to the Cisco UCS Platform Emulator VM console 1 Modifications to the VM Console login 2 Modifications to the VM Console Options Menu 3 Modifications to the Network Settings 4 Modifications to the System Settings 5 More details added to the Status Summary display Table 6: New Features and Significant Behavioral Changes in Cisco UCS. Release 2.1 7 .New and Changed Information New and Changed Information New or Changed Feature Description New Software Features 1 Added support for the following storage profile operations: • Creation of a Logical Unit Number (LUN) • Deletion of a LUN • Modification to a LUN • Hot Spare addition • Removal of Hot Spares 2 Added notes on Storage Controller and Adapter addition. 3 Added the following new templates containing UCSC-MLOM-C10T-02 and UCSC-PCIE-C10T-02 adapters: • C220M4LMedium • C240M4LMedium 4 Added notes on templates.

New and Changed Information New and Changed Information New or Changed Feature Description New rack-mount server support Added support for the following Rack Servers: 1 Cisco UCSC-C220-M4S 2 Cisco UCSC-C220-M4L 3 Cisco UCSC-C240-M4S 4 Cisco UCSC-C240-M4L 5 Cisco UCSC-C240-M4S2 6 Cisco UCSC-C240-M4SX New network adapter support Added support for the following network adapters: 1 UCSB-MLOM-40G-03 2 UCSC-MLOM-CSC-02 3 UCSB-VIC-M83-8P Configure IOM links Provides additional flexibility to configure the connectivity between IOM and Fabric Interconnect. Cisco UCS Platform Emulator User Guide. You have to configure the port numbers.2(3aPE1) onwards allows configuration of multiple and different adapters on a rack server. the DB persistence gets automatically set to reset DB.1 8 . Change of DB persistence Whenever you perform a configuration change on the control panel. Extended direct connect Rack UCSPE from release 2. It also supports Direct Connect Rack feature. Release 3. Default Configuration Change Default Hardware configuration contains a mix of M3 and M4 blade and rack servers.

Release 3.(2cPE1) New or Changed Feature Description New blade server support Added support for the Cisco UCS Scalable M4 Blade Module for the UCSC-B260-M4 or UCSC-B460-M4 Blade Server New rack-mount server support Added support for the Cisco UCSC-C460-M4 Rack Server New storage accelerator support Supports the following storage accelerators: 1 Cisco UCS UCSB-F-LSI-400S storage accelerator 2 Cisco UCS UCSB-F-LSI-800S storage accelerator 3 Cisco UCS UCSB-F-FIO-785M storage accelerator 4 Cisco UCS UCSB-F-FIO-365M storage accelerator Scriptable vMedia Creates mounting points on the Cisco IMC. Cisco UCS Platform Emulator User Guide. You can drag and drop the storage controllers on the rack-mounted servers or blade servers. Mounts are only configured and not actually mounted.New and Changed Information New and Changed Information New or Changed Feature Description New templates Added the following new templates for UCSB-B200-M4. UCSC-C240-M4L/M4S/M4S2/M4SX. Storage controllers Added a new tab called Storage Controllers under Startup Inventory. Release 2.1 9 .2. and UCSC-C220-M4L/M4S servers: 1 B200M4Large 2 B200M4Low 3 B200M4Medium1 4 B200M4Medium2 5 B200M4Medium3 6 B200M4Medium4 7 C220M4SHigh 8 C220M4SMedium1 9 C220M4SMedium2 10 C240M4SXMedium 11 C240M4SXHigh1 12 C240M4SXHigh2 Table 7: New Features and Significant Behavioral Changes in Cisco UCS.

SmartPlay bundles Supports the following SmartPlay Bundles: 1 B200_Entry_Plus_UCS_SP7_B200EP 2 B200_Entry_UCS_SP7_B200E 3 B200_Performance_UCS_SP7_B200P 4 B200_Value_Plus_UCS_SP7_B200VP 5 B200_Value_UCS_SP7_B200V 6 B420_Value_UCS_SP7_b420v 7 SWM_C220_Value_Plus_UCS_SP7_c220VP 8 SWM_C220_Value_UCS_SP7_C220V 9 SWM_C240_Performance_UCS_SP7_C240P 10 SWM_C240_Value_UCS_SP7_C240P Random statistics generation Statistics are generated for the following component: 1 Compute servers—motherboard temperature stats.1 10 . Table 8: New Features and Significant Behavioral Changes in Cisco UCS.2. Default configuration The default configuration is changed to M3 blade and rack-mounted servers. Download from local file system Download of UCS Manager firmware from a local file system is now supported. Stripped-down firmware image From release UCS PE 2.New and Changed Information New and Changed Information New or Changed Feature Description Scaled mode servers The Cisco UCS Scalable M4 Blade Module can be added in scaled (4S) or non-scaled (2S) mode. Release 2. download of only the stripped-down version of UCS firmware is supported. The stripped-down version is approximately 50 KB in size with essential firmware upgrade information.(1bPE1) New or Changed Feature Description Direct connect rack Connecting rack servers to the switch in Direct Connect Rack mode is now supported. and processor environment stats Cisco UCS Platform Emulator User Guide. Added a new tab called Direct Connect Rack under the Navigation Pane of the UCS Platform Emulator Control Panel.2 (1bPE1) onwards. motherboard power stats. Release 3.

Cisco UCS Platform Emulator User Guide. Installation can also be done using Host Firmware Pack and Auto Install feature. and storage controller.New and Changed Information New and Changed Information New or Changed Feature Description SD card support SD card slot in Compute servers is now supported. Second-level boot order support The Second-level boot order feature is now supported.1(2aPE1) New or Changed Feature Description Auto Install feature supported Firmware download and upgrade is now supported. You can now upgrade the SD card firmware. Templates are pre-configured blade and rack servers with loaded equipments. Release 3. Cisco IMC. adapter. Single Wire Management Added new tab called Single Wire Management under the Navigation Pane of the UCS Platform Emulator Control Panel Templates Added new tab called Templates under Hardware Catalog of the Emulator Settings tab. The templates merge with the present configuration and fail only when: 1 There is an overflow of connections for FEXs 2 The template configuration is unable to occupy the slot in the chassis Adding multiple objects in a single instance Options to add multiple objects in a single drag and drop instance of equipments. user-space NIC (usNIC) The user-space NIC (usNIC) feature is now supported. You can specify this feature in the service profile of the UCS servers during association. You can specify this feature in the service profile of the UCS servers during association. Table 9: New Features and Significant Behavioral Changes in Cisco UCS.1 11 . Release 2. New firmware can be downloaded either from the Cisco Developer Network or any other source and installed on the Platform Emulator. Dynamically inducing and clearing faults Inducing and clearing faults using Command Line Interface (CLI) and observing the fault behavior in the Cisco UCS Manager GUI is now supported. Upgrade of installed firmware is supported only for B-Series and C-Series components such as bios. You can drag and drop the templates on either a rack box or chassis.

Psu input-stats 3 FEX—envstats New rack-mount server support Added support for the following rack-mount servers: 1 Cisco UCS C260 M2 Rack Server 2 Cisco UCS C460 M2 Rack Server 3 Cisco UCS C420 M3 Rack Server New blade server support Added support for Cisco UCS B-420 M3 Blade Server New network adapter support Added support for the following network adapters: 1 Cisco UCS CNA M73KR-E Emulex Adapter 2 Cisco UCS CNA M73KR-Q Qlogic Adapter SmartPlay bundles Added a new icon under the working pane of Startup Inventory page. CPU. Psu input-stats. Moved Hardware Inventory Menu Tab Moved Hardware Inventory Menu Tab from the Navigation Pane to Emulator Settings Menu Tab Table 10: New Features and Significant Behavioral Changes in Cisco UCS. Release 2. HDD.1(1aPE2) New or Changed Feature Description Cluster support Added cluster support with dual-fabric interconnects simulated on the same virtual machine. or PSU on rack servers and chassis 2 Fans on chassis Secure import of configuration supported Import of a configuration from a live-UCS system using https is supported. Network stats 2 Chassis—Fan Stats. Validation option Added a validate configuration option in the GUI. Cisco UCS Platform Emulator User Guide.New and Changed Information New and Changed Information New or Changed Feature Description Range of slot numbers Option to enter slot range while adding: 1 DIMM.1 12 .1(1aPE1) and Release 2. Random statistics generation Statistics are randomly for the following components: 1 Fabric Interconnect—envstats. Release 3. sysstats.

1 13 .New and Changed Information New and Changed Information New or Changed Feature Description Backup and Restore Added backup and restore configuration options. New rack-mount server support Added support for the following rack-mount servers: 1 Cisco UCS C200 M1 High-Density Rack-Mount Server 2 Cisco UCS C200 M2 High-Density Rack-Mount Server 3 Cisco UCS C210 M1 General-Purpose Rack-Mount Server 4 Cisco UCS C210 M2 General-Purpose Rack-Mount Server 5 Cisco UCS C250 M1 Extended-Memory Rack-Mount Server 6 Cisco UCS C250 M2 Extended-Memory Rack-Mount Server 7 Cisco UCS C220 Rack Server 8 Cisco UCS C240 Rack Server 9 Cisco UCS C22 Rack Server 10 Cisco UCS C24 Rack Server New blade server support Added support for the following blade servers: 1 Cisco UCS B-22 Blade Server 2 Cisco UCS B-250 Blade Server 3 Cisco UCS B-440 Blade Server New network adapter support Added support for the following network adapters: 1 Cisco UCS VIC M828P Virtual Interface Card 2 Cisco UCS VIC 1240 Virtual Interface Card 3 Cisco UCS VIC 1225 Virtual Interface Card 4 Emulex OCe11102-F Converged Network Adapter 5 Qlogic QLE8242 Converged Network Adapter 6 Broadcom NetXtreme II Cisco UCS Platform Emulator User Guide. Unified port support Added unified port support for the Cisco UCS 6248UP and Cisco 6296UP fabric interconnects. Release 3.

New and Changed Information
New and Changed Information

New or Changed Feature

Description

New Fabric Extender (FEX) support

Added support for the Cisco Nexus 2232PP Fabric Extender.
Added an automatic rack server to fabric extender
configuration.

VM Console

Added information to use the vm console to change network
settings and to change the cluster status.

Database Persistence Settings

Added requirement to use the Cisco UCS Platform Emulator
GUI only to change the persistent settings for the database
(to reset or to preserve the database upon a restart).

Launching UCSPE

Added information to launch UCSPE using VMplayer,
VMfusion, VMware vSphere Hypervisor (ESXi) , and
Microsoft Hyper-V - on Windows or Linux.

System Requirements

Updated requirements.

Known Issues

Removed limitation about high availability mode.

Table 11: New Features and Significant Behavioral Changes in Cisco UCS, Release 2.0(2s)

New or Changed Feature

Description

Enhanced fabric interconnect high availability Added an option to switch between standalone and cluster
support
modes for the emulated fabric interconnects.
New blade server

Added support for the Cisco UCS B200 M3.

New fabric interconnects

Added support for the Cisco UCS 6248 and 6296 fabric
interconnects.

New I/O module

Added support for the Cisco UCS 2208XP I/O module.

Enhanced connectivity between I/O modules
and fabric interconnects

Added support for 1, 2, 4, or 8 uplinks from an I/O module
to a fabric interconnect.

Cisco UCS Platform Emulator User Guide, Release 3.1
14

CHAPTER

2

Overview
This chapter includes the following sections:
• Information About Cisco UCS Platform Emulator, page 15
• Cisco UCS Platform Emulator Control Panel, page 15

Information About Cisco UCS Platform Emulator
Cisco UCS Platform Emulator is the Cisco UCS Manager application bundled into a virtual machine (VM).
The VM includes software that emulates hardware communications for the Cisco Unified Computing System
(Cisco UCS) hardware that is configured and managed by Cisco UCS Manager.
For example, you can use Cisco UCS Platform Emulator to create and test a supported Cisco UCS configuration,
or to duplicate an existing Cisco UCS environment for troubleshooting or development purposes.

Note

For the latest hardware and software feature information, prerequisites, limitations, and caveats, see the
release notes for Cisco UCS Platform Emulator.

Cisco UCS Platform Emulator Control Panel
Navigation Pane
The Navigation pane displays on the left side of the Cisco UCS Platform Emulator Control Panel. This pane
enables you to navigate to all components in the Cisco UCS Platform Emulator.
INVENTORY Menu Tab
The items in this menu tab appear in the form of Equipment hierarchy and enable you to access and configure
settings for Chassis, Fabric Extenders, Rack Servers, and Fabric Interconnects in Cisco UCS Platform Emulator.

Cisco UCS Platform Emulator User Guide, Release 3.1
15

Overview
Work Pane

Work Pane
The Work pane displays on the right side of Cisco UCS Platform Emulator Control Panel. The Work pane
includes a content area that displays information related to the menu item selected in the Navigation pane.
This comprises the Menu bar that contains the icons and the Hardware Inventory Dashboard that contains
the list of chassis, rack servers, fabric extenders, fabric interconnects, blade servers and modular servers. You
can view and modify information in the Work pane.

Hardware Inventory Dashboard
The inventory of supported hardware components is stored and displayed in the Hardware Inventory dashboard.
It contains the inventory of the supported components that you can use to build a chassis in Cisco UCS Platform
Emulator, including servers, fabric interconnects, and fabric extenders.

Hardware Inventory Menu and Dashboard Icons
The following table contains the icons above the Dashboard area and the icons used to perform functions
such as editing and removing a device, duplicating a device and adding a new device.
Icon

Function

Description

Add New Device

Adds a chassis, rack server or fabric extender.

Duplicate

Duplicates the selected device.

Edit Device

Opens the hardware inventory focus page where you can edit or
modify the device you selected.

Delete Device

Removes a device from the Emulator.

Add New Template

Adds a template to create a rack server.

Cisco UCS Platform Emulator User Guide, Release 3.1
16

this configuration overwrites and replaces the current hardware inventory. and reports the missing components of all the configured devices. Status Summary Displays the current status and a summary of the Cisco UCS Platform Emulator settings. Validate the present Configuration Validates the configuration by checking if the device (chassis. You can also perform the following using this icon: • Factory Reset — Import an XML file that contains hardware inventory configuration data from a file on the local disk. Hardware Catalog Allows you to view the hardware components supported in Cisco UCS Platform Emulator. You can also perform the following using this icon: • Load from a File — Import an XML file that contains hardware inventory configuration data from a file on the local disk. You can also perform the following using this icon: • Export Configuration as XML File — Exports the current hardware inventory configuration as an XML file then opens a new browser tab and displays the contents of the XML file. Save Configuration Saves the current hardware inventory configuration.Overview Work Pane Icon Function Description Load from a Saved XML Loads a previously saved hardware inventory configuration. Release 3. • Reboot VM— Reboot Cisco UCS Platform Emulator. Cisco UCS Platform Emulator User Guide. These settings are updated when you modify any of the Cisco UCS Platform Emulator settings.1 17 . rack/blade/modular server and so on) is fully equipped with the required components. • Import from a Live UCS— Imports the hardware inventory configuration from a live Cisco UCS Domain. fex. • Power off VM— Shut down or power off Cisco UCS Platform Emulator. Restart Cisco UCS Platform Emulator Restarts Cisco UCS Platform Emulator to enable the emulated Cisco UCS Manager to discover the new hardware inventory configuration. After you restart Cisco UCS Platform Emulator. A file with this name displays in the Load previously saved configuration list.

automate. • UCS PowerTool Download — Allows you to integrate. • Online Help — Allows you to view the online help for Cisco UCS Platform Emulator. or Visore. Open UCS Manager Opens Cisco UCS Manager. Release 3. Configure Statistics Allows you to configure statistics for component usage in Cisco UCS Platform Emulator. and support resources for developers working with Cisco UCS. • UCS CDN — Provides information.1 18 . You can also perform the following using this icon: • API Model Documentation — Allows you to access the Cisco UCS Manager XML API Documentation. documentation.Overview Work Pane Icon Function Description Managed Object Browser Displays the Managed Object Browser. Cisco UCS Platform Emulator User Guide. and orchestrate all aspects of Cisco UCS management within the data center. that you can access through Cisco UCS Platform Emulator to get a graphical view of the managed objects in the XML database. Settings Allows you to modify the UCS high availability Settings and fabric interconnect selection.

If you assign a static IP address. page 19 • Installing and Launching Cisco UCS Platform Emulator. page 24 • Starting the Cisco UCS Manager CLI Using the VM Console. Cisco UCS Platform Emulator is configured to use the local network to obtain an IP address via DHCP. you must assign a static IP address to Cisco UCS Platform Emulator. If your network does not include a DHCP server. Cisco UCS Platform Emulator displays the management IP address in the VM console. the IP address persists across VM reboots.CHAPTER 3 Installing and Running Cisco UCS Platform Emulator Using the VM Console This chapter includes the following sections: • IP Address for Cisco UCS Platform Emulator. Release 3. we recommend that you keep open a single session. Cisco UCS Platform Emulator User Guide. page 25 IP Address for Cisco UCS Platform Emulator Cisco UCS Platform Emulator supports both DHCP and static IP. page 23 • Restarting and Rebooting Cisco UCS Platform Emulator Using the VM Console. the IP address persists across VM reboots for the duration of the lease.1 19 . page 22 • Modifying System Settings Using VM Console. If the IP address was assigned by DHCP server. page 20 • Viewing System Settings Using VM Console. By default. Note When connecting to the UCS Platform Emulator VM Console through the SSH. page 20 • Launching Cisco UCS Platform Emulator Using Hypervisors. page 23 • Modifying Network Settings Using the VM Console. After the initial installation completes.

Installing and Running Cisco UCS Platform Emulator Using the VM Console Installing and Launching Cisco UCS Platform Emulator Installing and Launching Cisco UCS Platform Emulator Note The VM performs a one-time installation process the first time it starts up. enter ucspe and press Enter. g) At the Enter <Interface> Netmask prompt. do the following: a) In the VM console window. Release 5. Cisco UCS Platform Emulator User Guide.1 20 . enter the Netmask to configure and press Enter. Do not continue with the next step until the VM has finished booting.0. the network interface reinitializes with your settings and the system becomes accessible through the new IP address. one for each interface. enter y to modify connections. and g. You can download the tool from the website. Enter this IP address in a supported Mozilla-based web-browser to open the home screen of Cisco UCS Platform Emulator. Step 4 f) At the Enter <Interface> IP prompt. c) At the Select prompt. VMware vSphere Hypervisor (ESXi). Launching Cisco UCS Platform Emulator Using Hypervisors You can launch Cisco UCS Platform Emulator using VMplayer. Repeat the following steps f. Step 3 (Optional) If you have a DHCP server setup. h) At the Enter Gateway IP prompt. the Cisco UCS Platform Emulator requests for the IP addresses from the DHCP server during startup and the IP assigned is displayed on the login screen. b) At the Password prompt. enter ucspe and press Enter. enter c to configure custom network.1 from VMware. as required by the hypervisor. enter the IP address of the default gateway press Enter. enter n to change the network settings. press Ctrl+C. (Optional) If you want to assign a static IP address to Cisco UCS Platform Emulator. Release 3. d) At the Modify Connections prompt. and Microsoft Hyper-V. at the ucspe login prompt. A brief overview of current network settings is displayed. e) At the Set Network Mode prompt. enter the static IP address to configure and press Enter. Allow the installation to complete before you reboot the VM. To cancel an entry and return to the menu.0: 1 Download the VMware OVF Tool.zip file and .ova file to a folder. Procedure Step 1 Step 2 Extract the Cisco UCS Platform Emulator . three times. Release 3. Open or import the unzipped Cisco UCS Platform Emulator into a supported hypervisor. Launching Cisco UCS Platform Emulator Using Hypervisors With An . After you enter the default gateway.ova File Using VMplayer on Microsoft Windows and Linux. VMfusion.

select Convert Machine 7 Set the source type as VMware Workstation or Other Virtual Machine. Release 3.1 21 . Launching Cisco UCS Platform Emulator Using Hypervisors With a . the VMDK files must be processed with VMware Converter Standalone.zip file only. 2 Extract the . 2 Extract the . for example. navigate to where the VMware OVF Tool was installed and run the following to convert the image to a VMX file: ovftool <path_to_ova\UCSPE.Installing and Running Cisco UCS Platform Emulator Using the VM Console Launching Cisco UCS Platform Emulator Using Hypervisors 2 When the download is complete. you can use VMware player to open the converted image and launch Cisco UCS Platform Emulator. 5 Open VMware Converter Standalone. 6 In the Converter view pane. 10 Select a destination cluster resource. Select the VMX file and click Open. 11 Click on Finish 12 When the conversion completes successfuly. Each file contains the VMX and VMDK files that can be used directly with VMware Player. 1 Download the . VMware Workstation and VMware Fusion.zip. open your terminal or command prompt.zip file. VMware Workstation and VMware Fusion.zip File The .zip File Note This task applies to the . 3 From the File menu on the VMware Player menu bar. 3 Click Open a Virtual Machine and browse to the extracted files. 4 Browse to the folder where the VMX file was converted and double-click the VMX file to launch Cisco UCS Platform Emulator.zip file contains the VMX and VMDK files that can be used directly with VMware Player.1(1ePE1). Cisco_UCS_Platform_Emulator_3. 3 Download the StarWind V2V converter from www. When finished. 4 To install in vSphere.zip file to a folder. Cisco UCS Platform Emulator User Guide. and suitable datastore.com.zip file to a folder. 9 Enter the destination information for the vCenter Server. power on the VM.zip file. Install the converter in Microsoft Windows. 1 Download the . Launching Cisco UCS Platform Emulator Using Microsoft Hyper-V With a .ova> <path_to_store_converted_image\UCSPE.. Cisco UCS Platform Emulator is delivered as an . then deployed to vCenter directly.zip file.vmx> The conversion begins and a progress window is displayed. select Open a Virtual Machine. Click Next.starwindsoftware.ova file and as a . 8 Select the VMX file from the folder.

enter ucspe and press Enter.Installing and Running Cisco UCS Platform Emulator Using the VM Console Viewing System Settings Using VM Console 4 Launch the StarWind converter and convert the UCSPE.ova image file without conversion. 1 From the File menu on the VMware Fusion menu bar. select Deploy OVF Template.ova File You can directly import an .ovf or . select Open.ova file into VMware Workstation 8.ovf file. Procedure Step 1 Step 2 At the ucspe login. VMware Fusion 5 can import the . The Import Library window displays a dialog box for browsing to the location of the .ova File If you are running VMware Fusion 4 or below. and click Import. Launching Cisco UCS Platform Emulator Using VMware Workstation on Microsoft Windows and Linux With an . When the import is complete. The VM console displays the Options menu. you can use the VMware OVF Tool to convert the image to the VMware runtime file format (.1 22 . 1 From the File menu in the Vcenter or ESXi menu bar. 3 Type a name for the virtual machine. Launching Cisco UCS Platform Emulator Using VMware Fusion on Mac OS X With an .0 With an . browse to the directory for the virtual machine files. select Import. 2 Browse to the . the virtual machine appears in the virtual machine library and in a separate virtual machine window. Viewing System Settings Using VM Console You can use the Cisco UCS Platform Emulator VM console to view system status and configurations. Use the Microsoft Virtual PC growable image as the destination image format. A status bar indicates the progress of the import process.vmdk file into VHD format. 4 Click Import. Cisco UCS Platform Emulator User Guide. Release 3. 2 Browse to the . enter a to show the status and press Enter. Launching Cisco UCS Platform Emulator Using VMware vSphere ESXi 5.ova File Connect to your VMware Vcenter or VMware vSphere ESXi using the vSphere client. At the Password prompt. enter the username ucspe and press Enter.ova file and click Open. 3 Type the name for the imported virtual machine in the Save As text box and indicate where to save it.ova file and click Open. Step 3 At the Select prompt.vmx). 1 From the File menu on the VMware Workstation 8 menu bar. 2 Browse to the . 5 Power on the VM. The default destination is the Virtual Machines folder created by VMware Fusion.ova file and click Open.

Cisco UCS Platform Emulator User Guide. The current status of the High Availability Mode is displayed (Stand Alone or Clustered). press y to change the date. Step 3 Step 4 At the Select prompt.Installing and Running Cisco UCS Platform Emulator Using the VM Console Modifying System Settings Using VM Console Multiple system statuses and configurations are displayed: • The current version of Cisco UCS Platform Emulator is displayed on top. • The current Network Mode and the Network Interface Configurations are displayed. At the Password prompt. If you choose not to change the date and skip to Change Time instead. • The Cisco UCS Platform Emulator System Settings such as Cluster Mode. At the Modify System Settings. enter the username ucspe and press Enter. At the Change Date prompt. . Procedure Step 1 Step 2 At the ucspe login. press y to change the time. At the Change Time prompt.At the Set High Availability prompt. enter s to change to Stand Alone or c to change to Clustered. the Cisco UCS Platform Emulator and Cisco UCS Manager restart. b) Enter t to modify system date/time and press Enter. Enter the new time in hh:mm:ss format and press Enter. Cisco UCS Platform Emulator connects to the Time server and synchronizes its system time with the server. If you choose not to change time and exit to the main menu. enter ucspe and press Enter. and press Enter. enter the IP address of a valid Time Server running NTP. The current date and time is displayed. press n. select one of the following options: a) Enter h to modify High-Availability Mode and press Enter. enter t to modify system settings. Note If you entered invalid data in the settings. c) Enter n to modify the Network Time Protocol (NTP) server settings. At the prompt. the modification process aborts and the system reverts to the original menu options. Date and Time settings. Modifying Network Settings Using the VM Console You can use the Cisco UCS Platform Emulator VM console to change some network settings of the VM. Enter the new date in dd/mm/yyyy format and press Enter. NTP and Network settings are displayed. After modification. press n. Modifying System Settings Using VM Console You can use the Cisco UCS Platform Emulator VM console to change some of the UCS Platform Emulator configurations.1 23 . Release 3. The VM console displays the Options menu.

The Cisco UCS Platform Emulator and Cisco UCS Manager restarts and come up with the configured IP address. c) At the Enter Gateway IP prompt. the Cisco UCS Platform Emulator skips checking for available DHCP servers and directly uses the custom configuration that the user provides. type ucspe and press Enter.2] IP prompt. At the Password prompt. Complete steps a and b once if Cluster Mode is Stand Alone.Installing and Running Cisco UCS Platform Emulator Using the VM Console Restarting and Rebooting Cisco UCS Platform Emulator Using the VM Console Procedure Step 1 Step 2 At the ucspe login. Release 3. enter y and press Enter. Step 3 At the Options Select prompt. enter the default gateway IP address. netmask and hardware address of the interfaces. d for DHCP Mode and c for Custom Mode. • DHCP Mode—In this mode. At the Confirm prompt. a) Press s to restart Cisco UCS Platform Emulator processes and press Enter. enter y and press Enter. enter the username ucspe and press Enter. In this mode.1.2] Netmask prompt. type username ucspe and press Enter. enter n to modify network settings. Step 4 Step 5 At the Modify Connections prompt. enter the static IP address for the interface. A brief summary of current network settings with the IP address.1 24 . Restarting and Rebooting Cisco UCS Platform Emulator Using the VM Console You can use the Cisco UCS Platform Emulator VM console to restart and reboot UCSPE. The VM console displays the Options menu. the Cisco UCS Platform Emulator and Cisco UCS Manager restart automatically. b) At the Enter eth[0. At the Password prompt. a) At the Enter eth[0. • Custom Mode— In this mode. the Cisco UCS Platform Emulator checks for DHCP servers first as shown below. At the Set Network Mode prompt. Procedure Step 1 Step 2 At the cisco-ucspe login prompt. Upon obtaining IP addresses for all the interfaces. choose the network mode by entering a for Auto Mode. • Auto Mode—This is the default mode of the Cisco UCS Platform Emulator. the Cisco UCS Platform Emulator searches only for an available DHCP Server. This restarts all the Cisco UCS Platform Emulator processes including the Cisco UCS Cisco UCS Platform Emulator User Guide. and thrice if Cluster Mode is Clustered.1. enter ucspe and press Enter. is displayed. The VM console window displays the Options menu. enter the netmask for the interface.

(To change this. This shuts down the VM. You can access these documents through the Cisco UCS B-Series Servers Documentation Roadmap available at the following URL: http://www. which is the equivalent of the top-level scope in the Cisco UCS Manager CLI. see the Cisco UCS Manager CLI Configuration Guide and the Cisco UCS Manager CLI Command Reference. At the Confirm prompt. Press z to shutdown the VM and press Enter. Press x to logout user and press Enter. At the Confirm prompt. Press r to reboot the VM and press Enter. Release 3. enter y and press Enter. enter y and press Enter. For information about Cisco UCS Manager CLI commands. Cisco UCS Platform Emulator User Guide. At the Password prompt. This resets all configurations and settings to the original settings of the Cisco UCS Platform Emulator. At the Confirm prompt. enter y and press Enter.cisco. The console window for the Cisco UCS Platform Emulator VM supports a single CLI session. The VM console displays the Options menu.1 25 . This logs out the current Cisco UCS Platform Emulator user and takes you back to the login screen. type username ucspe and press Enter.com/ go/unifiedcomputing/b-series-doc . see the Modifying System Settings Using VM Console.Installing and Running Cisco UCS Platform Emulator Using the VM Console Starting the Cisco UCS Manager CLI Using the VM Console b) c) d) e) Manager process. Step 3 Press c to log on to the CLI console and press Enter The VM Console window now displays the ucspe# prompt. Note Cisco UCS Platform Emulator does not support Cisco UCS Manager CLI commands for unsupported features or within the connect nxos or connect local-mgmt scopes Procedure Step 1 Step 2 At the ucspe login prompt. Press f to perform a Factory Reset and press Enter. on page 23 section). enter y and press Enter. type ucspe and press Enter. Starting the Cisco UCS Manager CLI Using the VM Console You can use the supported commands from the Cisco UCS Manager CLI to configure and manage the hardware in your Cisco UCS Platform Emulator environment. The Cisco UCS Manager Database resets or is preserved based on the configuration. At the Confirm prompt. This restarts the VM.

1 26 .Installing and Running Cisco UCS Platform Emulator Using the VM Console Starting the Cisco UCS Manager CLI Using the VM Console Cisco UCS Platform Emulator User Guide. Release 3.

Restarting Cisco UCS Platform Emulator and Performing a Factory Reset By default. and all configurations and settings are returned to the factory defaults. page 28 • Shutting Down the Cisco UCS Platform Emulator VM. click Yes to restart Cisco UCS Platform Emulator with current settings or click No to cancel the action. Release 3. click the Power icon from the menu bar. when Cisco UCS Platform Emulator restarts. page 28 Restarting Cisco UCS Platform Emulator Procedure Step 1 Step 2 Step 3 Step 4 Click Restart UCS Emulator with Current Settings. In the Are you sure you want to restart UCS Emulator with Current Settings now? page. Cisco UCS Platform Emulator User Guide. page 27 • Restarting Cisco UCS Platform Emulator and Performing a Factory Reset. any hardware that you added to Cisco UCS Manager within Cisco UCS Platform Emulator is deleted. In the Work pane. page 27 • Rebooting the Cisco UCS Platform Emulator VM. the database is erased.CHAPTER 4 Restarting and Shutting Down Cisco UCS Platform Emulator Using the Control Panel This chapter includes the following sections: • Restarting Cisco UCS Platform Emulator. Select Restart UCSPE.1 27 .

Select Power off VM. click Yes to restart Cisco UCS Platform Emulator and erase all hardware. click Yes to shut down the VM. In the Are you sure you want to perform Factory Reset now? page. settings.Restarting and Shutting Down Cisco UCS Platform Emulator Using the Control Panel Rebooting the Cisco UCS Platform Emulator VM Procedure Step 1 Step 2 Step 3 In the Work pane. click the Power icon from the menu bar. Cisco UCS Platform Emulator User Guide. Select Restart UCSPE. Select Reboot VM. click the Power icon from the menu bar. or click No to cancel the action. Procedure Step 1 Step 2 Step 3 In the Work pane. or click No to cancel the action. Shutting Down the Cisco UCS Platform Emulator VM Shutting down the VM from the Cisco UCS Platform Emulator ensures a clean shutdown of the Cisco UCS Platform Emulator. Release 3. In the Are you sure you want to reboot Virtual Machine now? page. Rebooting the Cisco UCS Platform Emulator VM Rebooting the VM from the Cisco UCS Platform Emulator ensures a clean shutdown of the Cisco UCS Platform Emulator before the VM reboots. Procedure Step 1 Step 2 Step 3 In the Work pane. click the Power icon from the menu bar. Note If clustering is disabled. you must set a static IP address.1 28 . click Yes to shut down Cisco UCS Platform Emulator and reboot the VM. and configuration or click No to cancel the action. In the Are you sure you want to shut down Virtual Machine now? page.

CHAPTER 5 Configuring Cisco UCS Platform Emulator This chapter includes the following sections: • Viewing the Cisco UCS Platform Emulator Current Status and Settings. click the Status Summary icon from the menu bar. Release 3. page 32 • Modifying the Fabric Interconnect Emulation Settings.1 29 . page 32 • Configuring Cisco UCS Platform Emulator Restart Settings. page 31 • Configuring Statistics in Cisco UCS Platform Emulator. This example is for a cluster setting. These settings are updated when you modify any of the Cisco UCS Platform Emulator settings. Cisco UCS Platform Emulator User Guide. everything will be (1) and the SAM Controller will not be running. page 33 Viewing the Cisco UCS Platform Emulator Current Status and Settings Procedure Step 1 Step 2 In the Work pane. For a non-cluster (standalone setting). page 29 • Modifying the Cisco UCS Manager High Availability Setting. View the current status and settings of in the Status Summary page. Status Summary Page The Status Summary page displays the current status and a summary of the Cisco UCS Platform Emulator settings. Runtime Status Area This area provides information about the current status of Cisco UCS Platform Emulator. The number in parentheses shows the number of instances of the processes that are running.

Management IP Settings Area This area provides details of the management IP address configured for Cisco UCS Platform Emulator. Current Mgmt IP field The current management IP address. Emulator Startup Settings Area This area provides details of the fabric interconnect configuration for Cisco UCS Platform Emulator. Name Description Network Mode field Customized network mode. Netmask field Specifies the network's subnet. Release 3. Cisco UCS Platform Emulator User Guide. Default Gateway field Node that forwards packets to other networks.1 30 . Netmask field The netmask configured for Cisco UCS Platform Emulator.Configuring Cisco UCS Platform Emulator Status Summary Page Name Description Emulator field Running(1) UCS Manager field Running(2) Blade AG field Running(2) RsdAG field Running(2) PortAG field Running(2) StatsAG field Running(2) NicAG field Running(2) DcosAG field Running(2) HostagentAG field Running(2) ExtvmmAG field Running(2) SAM Controller field Running(2) Available Memory field The memory currently available to Cisco UCS Platform Emulator. IP Address field IP address of the host. Gateway field The gateway configured for Cisco UCS Platform Emulator.

Configuring Cisco UCS Platform Emulator Modifying the Cisco UCS Manager High Availability Setting Name Description High-Availability Mode field The number of fabric interconnects configured for Cisco UCS Platform Emulator. Last NTP Update Log field Record of the last NTP updates. Release 3. This could be one of the following: • Synchronized • Unsynchronized System Date/Time field Current time and date.1 31 . NTP Settings Area Name Description NTP Server field Synchronizes time stamps of the system. This can be one of the following: • On • Off Emulator Hardware Config Area Name Description Startup Config URL field The location where the startup configuration for Cisco UCS Platform Emulator is stored. Modifying the Cisco UCS Manager High Availability Setting The High Availability setting determines which of the following configurations is emulated by Cisco UCS Platform Emulator: • High availability cluster configuration with two fabric interconnects • Single standalone fabric interconnect Cisco UCS Platform Emulator User Guide.

• Random— allows you to set a random value. Modifying the Fabric Interconnect Emulation Settings This setting determines which fabric interconnect is used by Cisco UCS Platform Emulator. Cisco UCS Platform Emulator User Guide. This forcefully restarts Cisco UCS Platform Emulator for changes to take effect. Step 2 Step 3 SelectChange Cluster State. This changes the configuration for the statistics of that device.1 32 . Release 3. Step 4 Enter a value in the text box for the selected policy and click OK. select the desired device. click one of the following radio buttons: • Dual Fabric Interconnect. Configuring Statistics in Cisco UCS Platform Emulator Procedure Step 1 Step 2 On the Work pane. click the Settings icon. Click the Statistics icon from the menu bar. HA • Single Fabric Interconnect. no HA Step 4 Click Submit. Step 3 To edit the policy of a specific statistic.Configuring Cisco UCS Platform Emulator Configuring Statistics in Cisco UCS Platform Emulator Procedure Step 1 On the Work pane. Configured statistics policies are displayed. • Increment— allows you to set an incrementing factor. Step 5 Click the Reset to Default button to reset the configuration. On the Modify UCS High Availability Settings and FI selection page. Changing the mode resets all the connections. click the Edit icon and select one of the policies: • Fixed— allows you to set a fixed value. From the device hierarchy.

Modifying Insert Device Settings You can use this setting when all devices need to be inserted once the Cisco UCS Platform Emulator restarts. Click the Yes radio button to insert all devices after a restart. Procedure Step 1 Step 2 Step 3 Step 4 On the Work pane. Select UCSPE Restart Settings. If the links of any device are not connected. select the desired fabric interconnect model from the Fabric Interconnect drop-down list. they are automatically connected and then inserted into the Cisco UCS Manager. or the No radio button to cancel the action. Click Submit.1 33 . Cisco UCS Platform Emulator User Guide.Configuring Cisco UCS Platform Emulator Configuring Cisco UCS Platform Emulator Restart Settings Procedure Step 1 Step 2 Step 3 Step 4 On the Work pane. Release 3. click the Settings icon from the menu bar. Click Submit. This restarts the Cisco UCS Platform Emulator for changes to take effect. Select Fabric Interconnect. Configuring Cisco UCS Platform Emulator Restart Settings The Cisco UCS Platform Emulator Restart Settings allow you to configure settings for actions that are required whenever the Platform Emulator restarts. click the Settings icon. On the Modify UCS Fabric Interconnect Emulation Settings page.

Release 3.Configuring Cisco UCS Platform Emulator Configuring Cisco UCS Platform Emulator Restart Settings Cisco UCS Platform Emulator User Guide.1 34 .

click one or more of the following tabs to view the components supported in the current release: • Fabric Interconnect • Chassis • DIMM • IOM • FEX • Blade Servers • Rack Servers • Modular Servers • CPU • DIMM • Disks • Adaptors Cisco UCS Platform Emulator User Guide. click the Hardware Catalog icon.1 35 . page 36 • Using Existing Hardware Inventory Configurations. page 35 • Manually Configuring the Hardware Inventory. In the Work pane. page 44 Viewing the Hardware Catalog Procedure Step 1 Step 2 On the Hardware Inventory Dashboard page.CHAPTER 6 Configuring the Hardware Inventory This chapter includes the following sections: • Viewing the Hardware Catalog. Release 3.

enter a name for the chassis. click the Add Device icon next to the Rack Server heading. However. Release 3. In the Pid field. on page 43. with serial :: <serial number>. Click Add.1 36 . select a server from the drop down list. select the type of server from the drop down list. Creating a New Rack Server Procedure Step 1 On the Hardware Inventory Dashboard. Adding a New Chassis Procedure Step 1 On the Hardware Inventory Dashboard.Configuring the Hardware Inventory Manually Configuring the Hardware Inventory • Fans • PSU • Storage Controllers Manually Configuring the Hardware Inventory You can manually configure the hardware inventory in the Work pane using the options listed for hardware components on the Hardware Inventory Dashboard. enter a name for the rack server. Cisco UCS Platform Emulator adds a Chassis and the following message is displayed below the Menu icons: Successfully created chassis with serial :: <Chassis serial> Note Fabric Model UCS-FI-M-6324 is only supported with the chassis UCSB-5108-AC2 and UCSB-5108-DC2. In the Pid field. Cisco UCS Platform Emulator User Guide. see Managing Connectivity of Links Between Devices. Cisco UCS Platform Emulator adds a Rack Server and the following message is displayed below the Menu icons: Successfully created rack server :: <rack server name>. To know how to manage links between devices. Step 2 Step 3 Step 4 In the Name field. click the Add Device icon next to the Chassis heading. Click Add.. Step 2 Step 3 Step 4 In the Name field. you can connect a secondary chassis N20-C6508 to the UCS Mini chassis.

enter a name for the fabric extender. on the rack server's focus page. Creating a New Blade Server You can create a new blade server in the Chassis area of the Chassis Focus page. Step 2 Step 3 Step 4 Step 5 In the Name field. In the Pid field. see Managing Connectivity of Links Between Devices. Once you create a new blade server. Click Add. Cisco UCS Platform Emulator User Guide. adapters. you may edit the device from the Dashboard area to add the individual components. on page 43. such as DIMMs. it can directly connect to a fabric interconnect (DAS mode) or through a fabric extender (SWM and DWM modes). see Managing Connectivity of Links Between Devices. that is. or fans.Configuring the Hardware Inventory Creating a New Fabric Extender What to Do Next Add a new template to the rack server you just created or an existing rack server. a new blade server does not contain any components. However. select the rack server from a drop down list and click Add. To know how to manage links between devices. select the fabric extender model from the drop down list. In the Side field. Click the Add New Template icon next to the Rack Server heading. Cisco UCS Platform Emulator adds a Fabric Extender and the following message is displayed below the Menu icons: Successfully created Fex :: <fabric extender name>. To know how to manage links between devices. you can select the mode with which the rack server connects. select side A or B from a drop down list. on page 43. Creating a New Fabric Extender Procedure Step 1 On the Hardware Inventory Dashboard. click the Add Device icon next to the Fabric Extender heading. with serial ::<serial number>. Release 3. Note When you add a rack server.1 37 .

You can also enter a range. Missing components are displayed if the component is missing on the server. holding the mouse button down.1 38 . Complete the following steps to add the components to the modular server: a) Click the Edit Device icon in the Modular Server area of the dashboard. Procedure Step 1 Step 2 Step 3 Step 4 Step 5 On the Hardware Inventory Dashboard. such as DIMMs. enter the number of the empty slot where you want to insert the blade server and press Enter. whereas 142-M4 and 1625 have two servers per cartridge. b) From the hardware catalog table on the Focus page. enter the cartridge slot where you want to insert the modular servers. In the Enter Server Slot field. c) If prompted. these modular servers do not include any components. hold the mouse button down. drag and drop it to the Chassis area. Once you create a modular server. d) Repeat Steps a through c until you have added all desired components to the blade server. Missing components are displayed if the component is missing on the server. Complete the following steps to add the components to the blade server: a) Click the Edit Device icon in the Blade Server area of the dashboard. Release 3. click on the blade server and. enter the desired slot number for the component and press Enter. select the desired component (for instance DIMM). d) Repeat Steps a through c until you have added all desired components to the modular server. drag the component to the Server Slot area. Cisco UCS Platform Emulator User Guide. or fans. In the hardware catalog table in the Chassis Focus page. click on the modular server and. click the Edit Device icon for a chassis you select from the Chassis list area. holding the mouse button down. However. drag and drop the component to the Chassis area. click the Edit Device icon for a chassis you select from the Chassis list area. and press Enter. Note Modular servers 2814 and 1414 have one server per cartridge. From the hardware catalog table. holding the mouse button down. Creating a New Modular Server You can create a new modular server in the Chassis area of the Chassis Focus page. c) Enter the desired slot number for the component when prompted. b) From the hardware catalog table on the Blade Server Focus page. you may edit the device from the Dashboard area to add the individual components. adapters. drag and drop the component to the Server Slot area. (Optional) Click the Validate icon on the Dashboard to ensure that all necessary components for a server are added. In the Enter Cartridge Slot field.Configuring the Hardware Inventory Creating a New Modular Server Procedure Step 1 Step 2 Step 3 Step 4 Step 5 On the Hardware Inventory Dashboard. (Optional) Click the Validate icon on the Dashboard to ensure that all necessary components for a server are added. click the desired component and.

The Chassis Focus page is displayed. click the Edit Device icon for the chassis you want to modify. hold the mouse button down. and Modular Server Components Procedure Step 1 Step 2 Step 3 Step 4 Click the Edit Device icon in the Server area of the dashboard. Step 2 Click the row for the desired component. Blade. You can also enter a range. server. Release 3.Configuring the Hardware Inventory Modifying Hardware Components Modifying Hardware Components After you created a chassis. Note On a chassis with PID UCSME-4308. you can modify these components from their individual areas in a dedicated Focus page that also includes a Connectivity area and the respective Hardware Catalog table located below. You may also add PSU and FANs. drag and drop the component to the Server area. enter the desired slot and press Enter (You can also enter a range). Repeat Steps 2 and 3 until you have added all desired components to the rack server. When prompted. However. Cisco UCS Platform Emulator User Guide. storage controllers and storage disks need to be added to the chassis instead of modular servers. and drag the component to the Chassis area and drop it. Step 3 Step 4 What to Do Next Add servers to the chassis. or fabric extender. From the hardware catalog table on the Focus page. for other chassis PIDs. You can arrive at the Focus page by clicking the Edit Device icon of the individual hardware component from the hardware list on the Hardware Inventory Dashboard area. Repeat Steps 3 and 4 until you add all the desired components. When prompted. enter the desired slot number for the component and press Enter. select the desired component (for instance DIMM). hold the mouse button down. Modifying Chassis Components Procedure Step 1 On the Hardware Inventory Dashboard area. Modifying Rack. only PSU and FANs are permitted to be dropped on the chassis.1 39 .

You can remove a device from two locations: • From the Hardware Inventory Dashboard. click the Insert/Remove icon from the desired hardware device's table. You are required to click this icon to remove the device from UCS Manager. see . or chassis list areas (tables). and you can insert the device into Cisco UCS Manager. Cisco UCS Platform Emulator duplicates the device and the following message is displayed below the Menu icons: Successfully duplicated <device> ::<serial number> to new <device> ::<serial number> Note When you duplicate a device. For example. Inserting a Device into Cisco UCS Manager You can insert a configured device into Cisco UCS Manager. and you can insert the device into Cisco UCS Manager. DIMMs. On the Focus page of the device. When prompted. click the Insert/Remove icon on top of the page. Return to the Hardware Inventory Dashboard and click the Edit Device icon. For more information on how to delete a device. which results in the discovery of the device. Removal of a device might take some time. Cisco UCS Platform Emulator User Guide. click the green Check Mark icon or the Red icon to remove the device or cancel the action respectively. Release 3. click the Duplicate Device icon in the fex. disks. Blade and modular servers are removed when a chassis is removed the Cisco UCS Manager. Procedure On the Hardware Inventory Dashboard. an existing inserted device is represented through the green icon. The icons in the Insert/Remove column represent toggled status of each device. click the green Check Mark icon or the Red icon to remove the device or cancel the action respectively. Note Removing the device turns the status of the device to red. controllers and so on) and also assigns each component a unique serial number. server. fex. When prompted. We recommend you wait a few minutes before attempting to re-insert. • From the Focus page of the device. Procedure Step 1 Step 2 Step 3 Step 4 Step 5 On the Hardware Inventory Dashboard. Removing the device turns the status of the device to red.1 40 . Cisco UCS Platform Emulator duplicates all the components under it (blades. or chassis from the Hardware Inventory Dashboard or from the individual component area on the Focus page.Configuring the Hardware Inventory Duplicating a Device Duplicating a Device You can duplicate a server.

On the Focus page of the device. • From the Focus page of the device.Configuring the Hardware Inventory Removing a Device from Cisco UCS Manager Removing a Device from Cisco UCS Manager You can remove an inserted configuration from Cisco UCS Manager. Return to the Hardware Inventory Dashboard and click the Edit Device icon. Release 3. or removal of the device from Cisco UCS Manager. You can insert or remove a device from two locations: • From the Hardware Inventory Dashboard. and you can remove the device from Cisco UCS Manager. see Inserting a Device into Cisco UCS Manager. The icons in the Insert/Remove column represent the toggled status of each device. You are required to click this icon to insert the device into Cisco UCS Manager. on page 40. For more information on how to insert a device. For example. Cisco UCS Platform Emulator User Guide.1 41 . Inserting or Removing a Device in Cisco UCS Platform Emulator You can insert into or remove a configured device from Cisco UCS Manager. an removed device is represented through the red icon. You can remove a device from two locations: • From the Hardware Inventory Dashboard. Blade and modular servers are removed when a chassis is removed the Cisco UCS Manager. Inserting the device turns the status of the device to green. • From the Focus page of the device. The icons in the Insert/Remove column represent toggled status of each device. Note Inserting the device turns the status of the device to freen. Procedure Step 1 Step 2 Step 3 Step 4 Step 5 On the Hardware Inventory Dashboard. and you can remove the device from Cisco UCS Manager. You are required to click this icon to remove the device from UCS Manager. For example. click the Insert/Remove icon from the desired hardware device's table. an existing inserted device is represented through the green icon. Removal of a device might take some time. click the Insert/Remove icon on top of the page. A removed device is represented through the red icon and you are required to click this icon to insert the device into UCS Manager. click the green Check Mark icon or the Red icon to remove the device or cancel the action respectively. When prompted. We recommend you wait a few minutes before attempting to re-insert. When prompted. resulting in discovery of the device. click the green Check Mark icon or the Red icon to insert the device or cancel the action respectively.

Procedure Step 1 Step 2 Step 3 Step 4 To insert all devices.Configuring the Hardware Inventory Inserting or Removing all Devices in Cisco UCS Platform Emulator Procedure Step 1 Step 2 Step 3 Step 4 Step 5 On the Hardware Inventory Dashboard. A generic error message A few devices could not be connected is displayed if device(s) could not be connected due to various reasons. links of the devices are not deleted. Return to the Hardware Inventory Dashboard and click the Edit Device icon. click the Insert/Remove icon from the desired hardware device's table. Blade and modular servers are removed when a chassis is removed the Cisco UCS Manager. When you connect all the links of removed FEX. On the Focus page of the device. When prompted. A generic error message A few devices could not be inserted. Note You can disconnect all the configured links only after the components are removed. Note Removal of a device might take some time. However. Cisco UCS Platform Emulator User Guide. on the Hardware Inventory dashboard. Click the Disconnect all devices icon on the right corner. Rack Servers and Chassis. Removing devices take some time. Please attempt to insert them manually is displayed if device(s) could not be inserted due to various reasons. To connect all devices. To remove all devices. they are automatically connected and then inserted. Release 3. Click the Remove all devices icon on the right corner. on the Hardware Inventory dashboard. click the green Check Mark icon or the Red depending on its original status to either insert or remove the device. We recommend you wait a few minutes before attempting to re-insert. When prompted.1 42 . on the Hardware Inventory dashboard. click the green Check Mark icon or the Red icon depending on its original status to either insert or remove the device. Click the Insert all devices icon on the right corner. Click the Connect all devices icon on the right corner. To disconnect all devices. Inserting or Removing all Devices in Cisco UCS Platform Emulator From the Hardware Inventory Dashboard. it preserves the current link configuration and attempts to connect only if all the links are disconnected. click the Insert/Remove icon on top of the page. or cancel the action respectively. on the Hardware Inventory dashboard. If all the links of a device are disconnected. or cancel the action respectively. Additionally you can connect or disconnect all the links of the hardware components. you can perform operations such as inserting or removing all the devices to and from the Cisco UCS Manager.

1 43 . Release 3. You can manage links for chassis. from the following two locations: • From the Hardware Inventory Dashboard. The individual Focus page is displayed. On the Focus page of the device. Step 2 In the Links area (for instance. 6. for a chassis it displays Manage Links of Chassis). A secondary chassis is discovered only if its IOM links are connected to scalable port of FI-IOM. click the Delete Device icon on top of the page. There are two ways to connect/disconnect links: • Manually configure the links using the drop-down menu which lists compatible peer devices and unused peer ports. click Edit Port. 8. Links vary depending on the rack server mode: Cisco UCS Platform Emulator User Guide. Managing Connectivity of Links Between Devices You can manage the links between the source device and peer devices using the Links area on the individual Focus page of the hardware components in the Hardware Inventory Dashboard. click the Delete Device icon from the desired hardware device's table. rack server. Procedure Step 1 To manually edit a link. Return to the Hardware Inventory Dashboard and click the Edit Device icon. or the FEX you want to modify links for. • Allow Cisco UCS Platform Emulator to connect all links automatically using the Connect All links of this device option. Step 3 Select options from the Peer Device Type. Note You can delete a device only when it is removed from the Cisco UCS Manager. Procedure Step 1 Step 2 Step 3 On the Hardware Inventory Dashboard.Configuring the Hardware Inventory Deleting a Device Deleting a Device You can delete a device from Cisco UCS Platform Emulator. Peer Device Id/Side. 7. on the Hardware Inventory Dashboard area. rack servers and fabric extenders. Peer Slot/Peer Port drop-down lists. The break-up ports of scalable port 5 are represented as ports 5. • From the Focus page of the device. click the Edit Device icon for the chassis.

A message is displayed . from the Hardware Inventory Dashboard area click the Edit Device icon for the chassis.. Cisco UCS Platform Emulator User Guide. Using Existing Hardware Inventory Configurations You can use existing hardware inventory configurations in the Work pane using the icons on the menu bar. To automatically connect all the links. rack server. click Disconnect all Links of this Device. or the FEX you want to modify links for. return to the Hardware Inventory Dashboard area and click the Edit Device icon for the chassis..1 44 . To manually delete a link. rack server. click Delete Link. an error message is displayed and the current link configuration is preserved. Step 11 Repeat step 8. rack server. Step 10 In the Links area (for instance. • SWM mode — links (carrying both data and management traffic) are created between adapter ports of the rack server and Fex ports.Connect All Links of this Device. The individual Focus page is displayed. links are created between LOM ports of the rack server and Fex ports to carry management traffic. rack servers in the DAS and SWM mode cannot be connected to LOM ports. Note Step 4 Step 5 Step 6 In the Links area (for instance. for a chassis it displays Manage Links of Chassis). • DWM mode — links (carrying data traffic) are created between adapter ports of the rack server and Fex ports. The individual Focus page is displayed. Additionally. Appropriate success or error message is displayed on selection of Peer Port. Step 7 In the Links area (for instance. For instance. The individual Focus page is displayed. where a similar message is displayed. To automatically disconnect all links. or the FEX you want to modify links for. return to the Hardware Inventory Dashboard area and click the Edit Device icon for the chassis. In case of failure to find enough ports. click Connect All Links of this Device. The Connect All Links of this device preserves the current link configuration and attempts to connect only the remaining disconnected ports. Note Error messages are displayed for incompatible connections. for a chassis it displays Manage Links of Chassis). Peer Port drop-down shows list of unused ports on a selected peer device. or the FEX you want to modify links for. Release 3. for a chassis it displays Manage Links of Chassis).Configuring the Hardware Inventory Using Existing Hardware Inventory Configurations • DAS mode — links (carrying both data and management traffic) are created between adapter ports of the rack server and FI ports. Step 8 Step 9 Click the green check mark to connect the links or the red cross icon to cancel the action.

• Standalone configuration: UCSManager_IP represents the IP address for the management port on the fabric interconnect Cisco UCS Platform Emulator User Guide. where UCSManager_IP represents the IP address assigned to Cisco UCS Manager. If HTTPS is disabled on a Cisco UCS domain. This IP address can be one of the following: • Cluster configuration: UCSManager_IP represents the virtual or cluster IP address assigned to Cisco UCS Manager. see Importing the Equipment from a Cisco UCS Domain. If you want to import the configuration from a Cisco UCS domain.1 45 . click the Import icon from the menu bar. Release 3. Importing the Equipment from a Cisco UCS Domain Before You Begin Changes to this setting do not take effect until you restart Cisco UCS Platform Emulator. Do not use the IP addresses assigned to the management port on the fabric interconnects. Procedure Step 1 On the Hardware Inventory Dashboard page. Note Importing a configuration using HTTPS is now supported. see Restarting Cisco UCS Platform Emulator. on page 27. enter the web link for the Cisco UCS Manager GUI of the Cisco UCS domain from which you want to import the equipment. click the Load File icon on the Menu bar. Step 2 Step 3 ClickBrowse and navigate to the file that you want to load into the Cisco UCS Platform Emulator. Procedure Step 1 Step 2 Step 3 On the Work pane. Restart Cisco UCS Platform Emulator. You cannot import a backup file from a Cisco UCS domain.Configuring the Hardware Inventory Importing a Hardware Inventory Configuration File Importing a Hardware Inventory Configuration File You can import a hardware configuration file that you exported from one Cisco UCS Platform Emulator into another Cisco UCS Platform Emulator. The default web link is http://UCSManager_IP:port . enable HTTPS redirection. SelectImport From a Live UCS In the Cisco UCS Server field. For more information on restarting Platform Emulator. Before You Begin Changes to this setting do not take effect until you restart Cisco UCS Platform Emulator.

For information on restarting. Step 4 Enter a valid user name and password for the Cisco UCS domain. see Restarting Cisco UCS Platform Emulator. If the adapter and storage controller slots are same. Restart Cisco UCS Platform Emulator. Procedure Step 1 Step 2 Step 3 Step 4 On the Work pane. Step 2 In the File Name field. Step 5 Step 6 Click Load. enter a name for the configuration file. this port is 80 for HTTP access and 443 for HTTPS access. It cannot include spaces. on page 27 Saving the Current Hardware Inventory Configuration You can save the current hardware inventory configuration from the Work pane to use in another Cisco UCS Platform Emulator VM or as a backup for the current VM. click the link for the hardware inventory configuration you want to load into the Cisco UCS Platform Emulator.Configuring the Hardware Inventory Importing a Saved Hardware Inventory Configuration And where port represents the port used to access the Cisco UCS Manager GUI. Note Only a user created configuration file is shown when you try to load a configuration file. storage controllers might not be added to the rack server if the storage controller slot is same as the adapter slot. Procedure Step 1 On the Hardware Inventory Dashboard page. on page 27 Importing a Saved Hardware Inventory Configuration Note When a XML before 2. For information on restarting.1 46 .2(4bPE1) setup. dashes (-) and underscores ( _ ). Cisco UCS Platform Emulator User Guide. Step 3 Click Save.2(4bPE1) version is imported to the 2. Restart Cisco UCS Platform Emulator. see Restarting Cisco UCS Platform Emulator. The configuration is saved as an XML file. click the Save the Configuration icon on the menu bar. Select Import from a Saved XML In the menu below. Release 3. insert the storage controller manually. By default. Any user with read-only or higher privileges can access the hardware inventory configuration. The file name must include only alphanumeric chars only. click the Import icon from the menu bar.

Cisco UCS Platform Emulator User Guide.Configuring the Hardware Inventory Exporting the Hardware Inventory Configuration as an XML File The configuration file is saved in Cisco UCS Platform Emulator and added to the saved configuration list. click the Export icon from the menu bar. Release 3.1 47 . Select Export XML Cisco UCS Platform Emulator opens a new browser tab and displays the contents of the hardware inventory configuration as an XML file. Exporting the Hardware Inventory Configuration as an XML File You can save the exported XML file with the hardware inventory configuration and then import it into another Cisco UCS Platform Emulator or place it on a web server to use as a start up configuration. Procedure Step 1 Step 2 On the Work pane.

Configuring the Hardware Inventory Exporting the Hardware Inventory Configuration as an XML File Cisco UCS Platform Emulator User Guide. Release 3.1 48 .

do the following: a) (Optional) Check the check box to accept all content from the IP address for Cisco UCS Platform Emulator. For information about Cisco UCS Manager GUI commands. page 50 • Accessing Cisco UCS PowerTool. Cisco UCS Platform Emulator User Guide.CHAPTER 7 Accessing Features in Cisco UCS Platform Emulator This chapter includes the following sections: • Starting the Cisco UCS Manager GUI from the Cisco UCS Platform Emulator Control Panel.1 49 . page 50 Starting the Cisco UCS Manager GUI from the Cisco UCS Platform Emulator Control Panel You can use the Cisco UCS Manager GUI to configure and manage the hardware in your Cisco UCS Platform Emulator environment. Release 3. b) Click Yes to accept the certificate and continue. Procedure Step 1 Step 2 Step 3 On the Work pane. You can access this document through the Cisco UCS B-Series Servers Documentation Roadmap available at the following URL: http://www. see the Cisco UCS Manager GUI Configuration Guide. click the Open UCS Manager tab from the menu bar. Step 4 In the Login dialog box. enter UCSPE. Click the Launch UCS Manager tab. If a Security dialog box displays. enter UCSPE.com/go/unifiedcomputing/b-series-doc . c) Click Login. do the following: a) In the User Name field.cisco. page 49 • Accessing Cisco Developer Network . b) In the Password field.

Procedure Step 1 Step 2 Step 3 On the Work pane. Accessing Cisco UCS PowerTool Information about Cisco UCS PowerTool Cisco UCS PowerTool is a Microsoft PowerShell command line toolkit and interface to Cisco UCS. Note Internet access is required in order to access the Cisco UCS Platform Emulator. click the Help icon from the menu bar. You can also access information and documentation for the Cisco UCS Manager XML API from the Cisco Developer Network . Release 3. automate. documentation. and support resources for developers working with Cisco UCS. and orchestrate all aspects of Cisco UCS management within the data center. including network.1 50 . SelectUCS CDN. review the information and follow the instructions to download Cisco UCS PowerTool. In the Work pane. storage and hypervisor management. Downloading Cisco UCS PowerTool Note Cisco UCS Platform Emulator must have access to the internet to download Cisco UCS PowerTool. click the Help icon from the menu bar. Procedure Step 1 Step 2 On the Work pane. You can use Cisco UCS PowerTool to integrate. Select UCS PowerTool Download.Accessing Features in Cisco UCS Platform Emulator Accessing Cisco Developer Network Accessing Cisco Developer Network The Cisco Developer Network provides information. Cisco UCS Platform Emulator User Guide. Cisco UCS includes over 2400 PowerShell command-lets (“cmdlets”) that enable you to integrate and automate Cisco UCS with Microsoft products and many third party products.

or the number of CPUs. page 51 • Running a Query in the Managed Object Browser. page 53 Information About the Managed Object Browser The Managed Object Browser.1 51 . This area supports all simple Cisco UCS Manager XML API operations. such as the number of cores. it also enables you to see the query that was used to obtain the information from the database. Managed Object Browser Page Filter Area The filter form is case sensitive. You can also use the Managed Object Browser to find out what type of data Cisco UCS stores in the database for each type of managed object. Tip You can also connect to and run queries with the Managed Object Browser on a running Cisco UCS domain through the following URL: http://UCSManager_IP/visore.html. For example. You can then use that information when you design or debug a Cisco UCS domain. that you can access through Cisco UCS Platform Emulator provides you with a graphical view of the managed objects in the XML database. since the Managed Object Browser uses the Cisco UCS Manager XML API to query the runtime managed objects and display the results. page 51 • Managed Object Browser Page. or Visore. the type of adapter. You can also use it to view the type of data stored in the database about servers. you can use the Managed Object Browser to see which service profiles have been configured and the XML query that was used to access that information in the database. Release 3.CHAPTER 8 Using the Managed Object Browser This chapter includes the following sections: • Information About the Managed Object Browser. In addition. Cisco UCS Platform Emulator User Guide.

the search returns all instances of the specific class. Results Area You can bookmark any query results page in your browser to view the results again because the query is encoded in the URL.1 52 . Cisco UCS Platform Emulator User Guide. Property field The property of the managed object on which you want to filter the results. If you leave the Property field empty. The following are valid operators are: • ==—equal to • !=—not equal to • <—less than • >—greater than • ≤—less than or equal to • ≥—greater than or equal to • between • wildcard • anybit • allbits Val1 field The first value for the property on which you want to filter.Using the Managed Object Browser Managed Object Browser Page Name Description Class or DN field Object class name or full distinguished name of a managed object. Release 3. Val2 field The second value on which you want to filter. Op drop-down list Operator for the values of the property on which you want to filter the results. Name Description Pink background Separates individual managed object instances and displays the class name of the object below it. Display XML of Last Query Link The Display XML of last query link displays the full Cisco UCS Manager XML API translation of the most recent query run in the Managed Object Browser. Note Many of the managed objects are only used internally and are not generally applicable to Cisco UCS Manager program development.

For example. enter computeBlade in the Class or DN field. complete the following fields: Name Description Property field Enter a property of the managed object on which you want to filter the results of the search. Right arrow When clicked. if you want to limit the query to a specific server. takes you to the child objects of the managed object. dn property Absolute address of each managed object in the object model. For information about the available classes or DNs. Running a Query in the Managed Object Browser Procedure Step 1 Step 2 Step 3 On the Work pane. click the Help icon from the menu bar. Release 3. such as blade server 1 in chassis 1. Step 4 (Optional) If you want to filter the results of your query. Cisco UCS Platform Emulator User Guide. type the class or DN of the managed object you want to query. Example: If you want to search on all instances of the blade class in the object model. you could enter association. Select Managed Object Browser. Left arrow When clicked. In the Work pane. Yellow or beige background Indicates the value of a property name. In the Class or DN field. This is the only required field in a query. if you are querying computeBlade.Using the Managed Object Browser Running a Query in the Managed Object Browser Name Description Blue or green background Indicates the property names of the managed object. However. takes you to the parent object of the managed object. displays all managed objects of that class. see the Cisco UCS Manager XML API documentation. Class name link When clicked. Question mark Links you to the XML API documentation for the managed object. displays all managed objects with that dn. dn link When clicked.1 53 . enter sys/chassis-1/blade-1.

≤. allbits • ==—equal to • !=—not equal to • <—less than • >—greater than • ≤—less than or equal to • ≥—greater than or equal to • between • wildcard • anybit • allbits Step 5 Val1 field Enter an available value for the property entered in the Property field. Click Run Query Cisco UCS Platform Emulator User Guide. wildcard. <. Val2 field Enter an available second value for the property entered in the Property field. ≥. Release 3.1 54 . if you are filtering on the association property.Using the Managed Object Browser Running a Query in the Managed Object Browser Name Description Op drop-down list Choose the operator on which you want to filter the values for the property. between. anybit. This can be: ==. !=. For example. >. you could enter unassociated.

page 56 Information About the Cisco UCS Manager XML API The Cisco UCS Manager XML API is a programmatic interface to Cisco Unified Computing System (UCS). New properties are assigned default values.1 55 . which relieves developers from administering isolated. adapters. The API operates in forgiving mode. page 56 • Accessing the Cisco UCS Manager XML API Documentation. Missing attributes are replaced with applicable default values that are maintained in the internal data management engine (DME). An API call can initiate changes to attributes of one or more objects such as chassis. blades. In that case. individual component configurations. for example) cannot be configured. Release 3. and other configurable components. When multiple managed objects (MOs) are being configured. The API accepts XML documents through HTTP or HTTPS. The Cisco UCS Manager XML API supports operations on a single object or an object hierarchy.CHAPTER 9 Accessing the Cisco UCS Manager XML API Documentation This chapter includes the following sections: • Information About the Cisco UCS Manager XML API. The API model includes the following programmatic entities: • Classes—Define the properties and states of objects in the management information tree. policies. Developers can use any programming language to generate XML documents that contain the API methods. Updates to MOs and properties conform to the existing object model to ensure backward compatibility. Users cannot communicate directly to endpoints. Cisco UCS is responsible for all endpoint communication. the API operation stops if any of the MOs (a virtual NIC. Cisco UCS Platform Emulator User Guide. such as state updates. page 55 • Information About the Cisco UCS Manager XML API Documentation. If existing properties are changed during a product upgrade. the management information tree is rolled back to the prior state that preceded the API operation and an error is returned. Configuration and state information for Cisco UCS is stored in a hierarchical tree structure known as the management information tree. they are managed during the database load after the upgrade. Operation of the API is transactional and terminates on a single data model. which is completely accessible through the XML API. The DME ignores incorrect attributes.

Procedure Cisco UCS Platform Emulator User Guide. The transactor gets the request from the queue. Information About the Cisco UCS Manager XML API Documentation The Cisco UCS Manager XML API documentation that you can access through the Cisco UCS Platform Emulator provides information about the Cisco UCS Manager information model When you view the XML API documentation.Accessing the Cisco UCS Manager XML API Documentation Information About the Cisco UCS Manager XML API Documentation • Methods—Actions that the API performs on one or more objects. The links provide navigation through the information model. Release 3. the navigation frames on the left list the following information: • Managed objects • Methods • Types • Fault rules • Finite State Machine (FSM) rules For more information about the Cisco UCS Manager XML API. Accessing the Cisco UCS Manager XML API Documentation The XML API docs are displayed in the Work pane. any event notification is sent along with its type of state change.1 56 . the transactor updates the management information tree. After subscribing. This complete operation is done in a single transaction. A typical request comes into the DME and is placed in the transactor queue in FIFO order. equipmentPresence). • Types—Object properties that map values to the object state (for example. Full event subscription is enabled. interprets the request. After the request is confirmed. see the Cisco UCS Manager XML API Programmer's Guide. and performs an authorization check.