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

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

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.1 v . Release 3.

Contents Cisco UCS Platform Emulator User Guide. Release 3.1 vi .

page vii • Related Cisco UCS Documentation.1 vii . System output Terminal sessions and information that the system displays appear in this font. text the system displays appears in this font. Release 3. TUI elements In a Text-based User Interface. 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.Preface • Audience. page vii • Conventions. page ix • Documentation Feedback. Document titles Document titles appear in this font. dialog box. area names. and wizard titles appear in this font. and field labels appear in this font. Main titles such as window. Cisco UCS Platform Emulator User Guide.

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

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

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

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

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.1 2 .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.

New and Changed Information New and Changed Information Table 2: New Features and Significant Behavioral Changes in Cisco UCS.5(1aPE1) support configuration only for the UCS chassis UCSME-4308 and its components. Release 3. Release 2.1 3 . Cisco UCS Platform Emulator User Guide.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(2aPE1) and 2.

Release 2. Release 3.1 4 . 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. 2 Compute Modular Server -Cisco UCSME-142-M4 Socket Server ( UCSME-142-M4) 3 DIMM .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.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 .

Scaled mode servers The UCSB-EX-M4-2 Blade Server can be added in scaled (4S) or non-scaled (2S) mode. 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. New Software support Added support for time zone management. Release 3.2(5aPE1) New or Changed Feature Description New Hardware support Added Haswell CPUs to the catalog.1 5 .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. Cisco UCS Platform Emulator User Guide. Release 2.

Release 3. 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.1 6 . 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. Cisco UCS Platform Emulator User Guide.New and Changed Information New and Changed Information New or Changed Feature Description New templates Added the following templates for UCSB-B420-M4. Release 2. It allows to select the desired FEX model and change the modes of Direct Connect Rack and Single Wire Management.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.

3 Added the following new templates containing UCSC-MLOM-C10T-02 and UCSC-PCIE-C10T-02 adapters: • C220M4LMedium • C240M4LMedium 4 Added notes on templates. 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.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.1 7 . Release 2.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. Release 3.

It also supports Direct Connect Rack feature. Release 3. the DB persistence gets automatically set to reset DB.1 8 . Default Configuration Change Default Hardware configuration contains a mix of M3 and M4 blade and rack servers. Cisco UCS Platform Emulator User Guide. Extended direct connect Rack UCSPE from release 2. Change of DB persistence Whenever you perform a configuration change on the control panel. You have to configure the port numbers.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.2(3aPE1) onwards allows configuration of multiple and different adapters on a rack server.

(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.New and Changed Information New and Changed Information New or Changed Feature Description New templates Added the following new templates for UCSB-B200-M4.1 9 . Release 2. You can drag and drop the storage controllers on the rack-mounted servers or blade servers. Mounts are only configured and not actually mounted. Storage controllers Added a new tab called Storage Controllers under Startup Inventory.2. UCSC-C240-M4L/M4S/M4S2/M4SX. Cisco UCS Platform Emulator User Guide. Release 3. 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.

Download from local file system Download of UCS Manager firmware from a local file system is now supported.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.1 10 . Table 8: New Features and Significant Behavioral Changes in Cisco UCS. motherboard power stats. Release 3. Stripped-down firmware image From release UCS PE 2.(1bPE1) New or Changed Feature Description Direct connect rack Connecting rack servers to the switch in Direct Connect Rack mode is now supported. The stripped-down version is approximately 50 KB in size with essential firmware upgrade information. Release 2. Added a new tab called Direct Connect Rack under the Navigation Pane of the UCS Platform Emulator Control Panel. Default configuration The default configuration is changed to M3 blade and rack-mounted servers. and processor environment stats Cisco UCS Platform Emulator User Guide. download of only the stripped-down version of UCS firmware is supported.2 (1bPE1) onwards.2. 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(2aPE1) New or Changed Feature Description Auto Install feature supported Firmware download and upgrade is now supported. Second-level boot order support The Second-level boot order feature is now supported. You can drag and drop the templates on either a rack box or chassis. Installation can also be done using Host Firmware Pack and Auto Install feature.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. Release 2. Release 3. Table 9: New Features and Significant Behavioral Changes in Cisco UCS. user-space NIC (usNIC) The user-space NIC (usNIC) feature is now supported.1 11 . Templates are pre-configured blade and rack servers with loaded equipments. 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. New firmware can be downloaded either from the Cisco Developer Network or any other source and installed on the Platform Emulator. and storage controller. 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. You can now upgrade the SD card firmware. Cisco IMC. 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. 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. adapter. Upgrade of installed firmware is supported only for B-Series and C-Series components such as bios. Cisco UCS Platform Emulator User Guide.

Network stats 2 Chassis—Fan 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. Random statistics generation Statistics are randomly for the following components: 1 Fabric Interconnect—envstats. Validation option Added a validate configuration option in the GUI. Psu input-stats. HDD. Cisco UCS Platform Emulator User Guide. 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. 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. Release 3.1(1aPE2) New or Changed Feature Description Cluster support Added cluster support with dual-fabric interconnects simulated on the same virtual machine.1 12 . Release 2.1(1aPE1) and Release 2.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. CPU. sysstats.

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. Release 3. Unified port support Added unified port support for the Cisco UCS 6248UP and Cisco 6296UP fabric interconnects.1 13 .

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. Hardware Catalog Allows you to view the hardware components supported in Cisco UCS Platform Emulator. Validate the present Configuration Validates the configuration by checking if the device (chassis. Cisco UCS Platform Emulator User Guide. After you restart Cisco UCS Platform Emulator.1 17 . fex. Status Summary Displays the current status and a summary of the Cisco UCS Platform Emulator settings.Overview Work Pane Icon Function Description Load from a Saved XML Loads a previously saved hardware inventory configuration. 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. • Reboot VM— Reboot Cisco UCS Platform Emulator. and reports the missing components of all the configured devices. A file with this name displays in the Load previously saved configuration list. • Import from a Live UCS— Imports the hardware inventory configuration from a live Cisco UCS Domain. These settings are updated when you modify any of the Cisco UCS Platform Emulator settings. Save Configuration Saves the current hardware inventory configuration. Restart Cisco UCS Platform Emulator Restarts Cisco UCS Platform Emulator to enable the emulated Cisco UCS Manager to discover the new hardware inventory configuration. rack/blade/modular server and so on) is fully equipped with the required components. • Power off VM— Shut down or power off Cisco UCS Platform Emulator. Release 3. 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. 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.

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

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

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

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

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

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

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

see the Cisco UCS Manager CLI Configuration Guide and the Cisco UCS Manager CLI Command Reference. type ucspe and press Enter. (To change this. At the Confirm prompt. Press r to reboot the VM and press Enter. 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. This resets all configurations and settings to the original settings of the Cisco UCS Platform Emulator. type username ucspe and press Enter. At the Confirm prompt. The VM console displays the Options menu. For information about Cisco UCS Manager CLI commands. 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. enter y and press Enter. Cisco UCS Platform Emulator User Guide. You can access these documents through the Cisco UCS B-Series Servers Documentation Roadmap available at the following URL: http://www. At the Confirm prompt.cisco. Release 3. This restarts the VM.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. This logs out the current Cisco UCS Platform Emulator user and takes you back to the login screen. At the Password prompt. Step 3 Press c to log on to the CLI console and press Enter The VM Console window now displays the ucspe# prompt. enter y and press Enter. see the Modifying System Settings Using VM Console.1 25 . Press z to shutdown the VM and press Enter. The console window for the Cisco UCS Platform Emulator VM supports a single CLI session. enter y and press Enter. The Cisco UCS Manager Database resets or is preserved based on the configuration. which is the equivalent of the top-level scope in the Cisco UCS Manager CLI. Press f to perform a Factory Reset and press Enter. This shuts down the VM.com/ go/unifiedcomputing/b-series-doc . on page 23 section). enter y and press Enter. Press x to logout user and press Enter. At the Confirm prompt.

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.1 26 .

1 27 . In the Work pane. click the Power icon from the menu bar. click Yes to restart Cisco UCS Platform Emulator with current settings or click No to cancel the action. Cisco UCS Platform Emulator User Guide. page 27 • Rebooting the Cisco UCS Platform Emulator VM. when Cisco UCS Platform Emulator restarts. any hardware that you added to Cisco UCS Manager within Cisco UCS Platform Emulator is deleted. page 28 Restarting Cisco UCS Platform Emulator Procedure Step 1 Step 2 Step 3 Step 4 Click Restart UCS Emulator with Current Settings. the database is erased. Release 3.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. page 27 • Restarting Cisco UCS Platform Emulator and Performing a Factory Reset. page 28 • Shutting Down the Cisco UCS Platform Emulator VM. In the Are you sure you want to restart UCS Emulator with Current Settings now? page. Restarting Cisco UCS Platform Emulator and Performing a Factory Reset By default. and all configurations and settings are returned to the factory defaults.

you must set a static IP address. click the Power icon from the menu bar. Procedure Step 1 Step 2 Step 3 In the Work pane. click the Power icon from the menu bar. Select Power off VM. click the Power icon from the menu bar. or click No to cancel the action. Select Restart UCSPE. In the Are you sure you want to reboot Virtual Machine now? page. In the Are you sure you want to perform Factory Reset 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. and configuration or click No to cancel the action. click Yes to shut down the VM. Procedure Step 1 Step 2 Step 3 In the Work pane. click Yes to shut down Cisco UCS Platform Emulator and reboot the VM. settings.1 28 . click Yes to restart Cisco UCS Platform Emulator and erase all hardware.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. In the Are you sure you want to shut down Virtual Machine now? page. Cisco UCS Platform Emulator User Guide. 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. Select Reboot VM. Release 3. or click No to cancel the action. Note If clustering is disabled.

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

Netmask field Specifies the network's subnet. IP Address field IP address of the host.1 30 . Emulator Startup Settings Area This area provides details of the fabric interconnect configuration for Cisco UCS Platform Emulator. Current Mgmt IP field The current management IP address. Name Description Network Mode field Customized network mode. Management IP Settings Area This area provides details of the management IP address configured for Cisco UCS Platform Emulator. Netmask field The netmask configured for Cisco UCS Platform Emulator. Release 3. Cisco UCS Platform Emulator User Guide. Gateway field The gateway 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. Default Gateway field Node that forwards packets to other networks.

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. 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. This could be one of the following: • Synchronized • Unsynchronized System Date/Time field Current time and date. Last NTP Update Log field Record of the last NTP updates. Release 3. 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. NTP Settings Area Name Description NTP Server field Synchronizes time stamps of the system.1 31 .

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

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

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

page 36 • Using Existing Hardware Inventory Configurations. click the Hardware Catalog icon. In the Work pane.CHAPTER 6 Configuring the Hardware Inventory This chapter includes the following sections: • Viewing the Hardware Catalog.1 35 . page 35 • Manually Configuring the Hardware Inventory. 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. Release 3. page 44 Viewing the Hardware Catalog Procedure Step 1 Step 2 On the Hardware Inventory Dashboard page.

enter a name for the chassis. on page 43. However. see Managing Connectivity of Links Between Devices. In the Pid field. select the type of server from the drop down list. Click Add. click the Add Device icon next to the Rack Server heading. with serial :: <serial number>.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. Click Add. Creating a New Rack Server Procedure Step 1 On the Hardware Inventory Dashboard. 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. 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>.1 36 . Release 3. To know how to manage links between devices. enter a name for the rack server. Adding a New Chassis Procedure Step 1 On the Hardware Inventory Dashboard. Step 2 Step 3 Step 4 In the Name field. Step 2 Step 3 Step 4 In the Name field. select a server from the drop down list. you can connect a secondary chassis N20-C6508 to the UCS Mini chassis. Cisco UCS Platform Emulator User Guide. In the Pid field.. click the Add Device icon next to the Chassis heading.

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

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

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

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

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

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

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

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

Procedure Step 1 Step 2 Step 3 On the Work pane. Restart Cisco UCS Platform Emulator. The default web link is http://UCSManager_IP:port . If you want to import the configuration from a Cisco UCS domain. Do not use the IP addresses assigned to the management port on the fabric interconnects. If HTTPS is disabled on a Cisco UCS domain. Procedure Step 1 On the Hardware Inventory Dashboard page. click the Load File icon on the Menu bar. • Standalone configuration: UCSManager_IP represents the IP address for the management port on the fabric interconnect Cisco UCS Platform Emulator User Guide. click the Import icon from the menu bar.1 45 . where UCSManager_IP represents the IP address assigned to Cisco UCS Manager. You cannot import a backup file from a Cisco UCS domain. see Importing the Equipment from a Cisco UCS Domain. on page 27. see Restarting Cisco UCS Platform Emulator. enter the web link for the Cisco UCS Manager GUI of the Cisco UCS domain from which you want to import the equipment. Release 3. enable HTTPS redirection. For more information on restarting Platform Emulator.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. 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. Before You Begin Changes to this setting do not take effect until you restart Cisco UCS Platform Emulator. Note Importing a configuration using HTTPS is now supported. Step 2 Step 3 ClickBrowse and navigate to the file that you want to load into the Cisco UCS Platform Emulator. SelectImport From a Live UCS In the Cisco UCS Server field. 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 Restarting Cisco UCS Platform Emulator. Select Import from a Saved XML In the menu below. For information on restarting. click the Save the Configuration icon on the menu bar. enter a name for the configuration file. Procedure Step 1 On the Hardware Inventory Dashboard page. see Restarting Cisco UCS Platform Emulator. click the link for the hardware inventory configuration you want to load into the Cisco UCS Platform Emulator. By default. on page 27 Importing a Saved Hardware Inventory Configuration Note When a XML before 2. It cannot include spaces.Configuring the Hardware Inventory Importing a Saved Hardware Inventory Configuration And where port represents the port used to access the Cisco UCS Manager GUI. this port is 80 for HTTP access and 443 for HTTPS access. click the Import icon from the menu bar. 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. Step 4 Enter a valid user name and password for the Cisco UCS domain. Restart Cisco UCS Platform Emulator. Note Only a user created configuration file is shown when you try to load a configuration file. Any user with read-only or higher privileges can access the hardware inventory configuration.2(4bPE1) version is imported to the 2.2(4bPE1) setup. Release 3. For information on restarting. storage controllers might not be added to the rack server if the storage controller slot is same as the adapter slot. Restart Cisco UCS Platform Emulator. insert the storage controller manually. dashes (-) and underscores ( _ ). The configuration is saved as an XML file. Cisco UCS Platform Emulator User Guide.1 46 . Step 5 Step 6 Click Load. Procedure Step 1 Step 2 Step 3 Step 4 On the Work pane. If the adapter and storage controller slots are same. The file name must include only alphanumeric chars only. Step 2 In the File Name field. Step 3 Click Save.

click the Export icon from the menu bar. 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. Release 3.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.1 47 . Cisco UCS Platform Emulator User Guide. 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. 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.1 48 . Release 3.

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

automate. click the Help icon from the menu bar. 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. storage and hypervisor management. Cisco UCS Platform Emulator User Guide. documentation. and orchestrate all aspects of Cisco UCS management within the data center. Accessing Cisco UCS PowerTool Information about Cisco UCS PowerTool Cisco UCS PowerTool is a Microsoft PowerShell command line toolkit and interface to Cisco UCS. SelectUCS CDN. Procedure Step 1 Step 2 On the Work pane. You can use Cisco UCS PowerTool to integrate. Select UCS PowerTool Download.1 50 . Release 3. Procedure Step 1 Step 2 Step 3 On the Work pane. In the Work pane. Note Internet access is required in order to access the Cisco UCS Platform Emulator.Accessing Features in Cisco UCS Platform Emulator Accessing Cisco Developer Network Accessing Cisco Developer Network The Cisco Developer Network provides information. review the information and follow the instructions to download Cisco UCS PowerTool. and support resources for developers working with Cisco UCS. including network. 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. You can also access information and documentation for the Cisco UCS Manager XML API from the Cisco Developer Network .

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. or Visore. or the number of CPUs. page 53 Information About the Managed Object Browser The Managed Object Browser. In addition. that you can access through Cisco UCS Platform Emulator provides you with a graphical view of the managed objects in the XML database. 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. Managed Object Browser Page Filter Area The filter form is case sensitive. page 51 • Managed Object Browser Page.CHAPTER 8 Using the Managed Object Browser This chapter includes the following sections: • Information About the Managed Object Browser. You can then use that information when you design or debug a Cisco UCS domain. You can also use it to view the type of data stored in the database about servers. the type of adapter. such as the number of cores. Release 3. This area supports all simple Cisco UCS Manager XML API operations.1 51 . Cisco UCS Platform Emulator User Guide. it also enables you to see the query that was used to obtain the information from the database.html. page 51 • Running a Query in the Managed Object Browser. For example. 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. since the Managed Object Browser uses the Cisco UCS Manager XML API to query the runtime managed objects and display the results.

Name Description Pink background Separates individual managed object instances and displays the class name of the object below it.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. 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. Release 3. 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. Cisco UCS Platform Emulator User Guide. Property field The property of the managed object on which you want to filter the results. the search returns all instances of the specific class.1 52 . Op drop-down list Operator for the values of the property on which you want to filter the results. Val2 field The second value on which you want to filter. 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.

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

Release 3. Click Run Query Cisco UCS Platform Emulator User Guide. ≤. between. you could enter unassociated. wildcard. For example. ≥. <. !=. 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. This can be: ==. anybit. Val2 field Enter an available second value for the property entered in the Property field.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.

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

A typical request comes into the DME and is placed in the transactor queue in FIFO order. After the request is confirmed. and performs an authorization check. any event notification is sent along with its type of state change. Accessing the Cisco UCS Manager XML API Documentation The XML API docs are displayed in the Work pane. equipmentPresence). 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. 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.1 56 .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. Full event subscription is enabled. see the Cisco UCS Manager XML API Programmer's Guide. After subscribing. The transactor gets the request from the queue. Procedure Cisco UCS Platform Emulator User Guide. interprets the request. the transactor updates the management information tree. • Types—Object properties that map values to the object state (for example. This complete operation is done in a single transaction. Release 3. The links provide navigation through the information model.