80
Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) 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 Text Part Number: OL-21105-01

Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

  • Upload
    others

  • View
    15

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Cisco UCS C-Series Servers Integrated Management ControllerCLI Configuration Guide, Release 1.0(1)

Americas HeadquartersCisco Systems, Inc.170 West Tasman DriveSan Jose, CA 95134-1706USAhttp://www.cisco.comTel: 408 526-4000 800 553-NETS (6387)Fax: 408 527-0883

Text Part Number: OL-21105-01

Page 2: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS,INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITEDWARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITHTHE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain versionof the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDINGANYOTHERWARRANTYHEREIN, ALL DOCUMENT FILES AND SOFTWAREOF THESE SUPPLIERS ARE PROVIDED “AS IS”WITHALL FAULTS.CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OFMERCHANTABILITY, FITNESS FORA PARTICULAR PURPOSEANDNONINFRINGEMENTORARISING FROMACOURSEOFDEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUTLIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERSHAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco IronPort, the Cisco logo, Cisco Nurse Connect, Cisco Pulse, Cisco SensorBase, Cisco StackPower, Cisco StadiumVision,Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good, Flip Mino, Flipshare (Design), Flip Ultra, Flip Video, Flip Video (Design),Instant Broadband, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn, Cisco Capital, Cisco Capital (Design), Cisco:Financed(Stylized), Cisco Store, Flip Gift Card, and One Million Acts of Green are service marks; and Access Registrar, Aironet, AllTouch, AsyncOS, Bringing the Meeting To You, Catalyst,CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Lumin, Cisco Nexus, Cisco Press, Cisco Systems, CiscoSystems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, Continuum, EtherFast, EtherSwitch, Event Center, Explorer, Follow Me Browsing, GainMaker,iLYNX, IOS, iPhone, IronPort, the IronPort logo, Laser Link, LightStream, Linksys, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, PCNow, PIX,PowerKEY, PowerPanels, PowerTV, PowerTV (Design), PowerVu, Prisma, ProConnect, ROSA, SenderBase, SMARTnet, Spectrum Expert, StackWise, WebEx, and the WebEx logo areregistered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.

All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Ciscoand any other company. (0910R)

Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shownfor illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.

© 2009 Cisco Systems, Inc. All rights reserved.

Page 3: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

C O N T E N T S

Preface vii

Audience vii

Organization vii

Conventions viii

Related Documentation x

Documentation Feedback x

Obtaining Documentation and Submitting a Service Request x

Overview 1

Overview of the Cisco UCS C-Series Rack-Mount Servers 1

Cisco Integrated Management Controller 1

CIMC CLI 3

Command Modes 3

Command Mode Table 3

Complete a Command 4

Command History 5

Committing, Discarding, and Viewing Pending Commands 5

Command Output Formats 5

Online Help for the CLI 6

Managing the Server 7

Toggling the Locator LED 7

Resetting the Server Boot Order 8

Powering On the Server 8

Powering Off the Server 9

Power Cycling the Server 9

Resetting the Server 10

Shutting Down the Server 10

Viewing Server Properties 11

Viewing CPU Properties 11

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 iii

Page 4: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Viewing Memory Properties 12

Viewing Power Supply Properties 12

Viewing Storage Properties 13

Viewing Server Sensors 15

Viewing Power Supply Sensors 15

Viewing Fan Sensors 16

Viewing Temperature Sensors 16

Viewing Voltage Sensors 17

Managing Remote Presence 19

Managing the Virtual KVM 19

KVM Console 19

Enabling the Virtual KVM 19

Disabling the Virtual KVM 20

Configuring the Virtual KVM 21

Configuring Virtual Media 22

Managing Serial over LAN 22

Serial Over LAN 22

Guidelines and Restrictions for Serial Over LAN 23

Configuring Serial Over LAN 23

Launching Serial Over LAN 24

Managing User Accounts 25

Configuring Local Users 25

Configuring Active Directory 26

Active Directory 26

Configuring the Active Directory Server 26

Configuring Active Directory in the CIMC 28

Viewing User Sessions 29

Terminating a User Session 30

Configuring Network-Related Settings 31

Server NIC Configuration 31

Server NICs 31

Configuring NICs 32

Configuring Common Properties 33

Configuring IPv4 33

Configuring the Server VLAN 35

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)iv OL-21105-01

Contents

Page 5: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Network Security Configuration 36

Network Security 36

Configuring Network Security 36

Configuring Communication Services 39

Configuring HTTP 39

Configuring SSH 40

IPMI Over LAN Configuration 41

IPMI Over LAN 41

Configuring IPMI over LAN 41

Managing Certificates 43

Managing the Server Certificate 43

Generating a Certificate Signing Request 44

Creating a Self-Signed Certificate 45

Uploading a Server Certificate 47

Configuring Platform Event Filters 49

Platform Event Filters 49

Enabling Platform Event Alerts 49

Disabling Platform Event Alerts 50

Configuring Platform Event Filters 50

Configuring SNMP Trap Settings 52

CIMC Firmware Management 55

Overview of Firmware 55

Obtaining CIMC Firmware from Cisco 56

Installing CIMC Firmware from the TFTP Server 56

Activating Installed Firmware 57

Viewing Logs 59

CIMC Log 59

Viewing the CIMC Log 59

Clearing the CIMC Log 60

System Event Log 60

Viewing the System Event Log 60

Clearing the System Event Log 61

Server Utilities 63

Exporting Technical Support Data 63

Resetting the CIMC to Factory Defaults 64

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 v

Contents

Page 6: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Rebooting the CIMC 64

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)vi OL-21105-01

Contents

Page 7: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Preface

This preface includes the following sections:

• Audience, page vii

• Organization, page vii

• Conventions, page viii

• Related Documentation, page x

• Documentation Feedback , page x

• Obtaining Documentation and Submitting a Service Request , page x

AudienceThis guide is intended primarily for data center administrators with responsibilities and expertise in one ormore of the following:

• Server administration

• Storage administration

• Network administration

• Network security

OrganizationThis document includes the following parts:

DescriptionTitlePart

Contains chapters that describe the Cisco UCS C-SeriesRack-Mount Servers and the CIMC CLI.

OverviewPart 1

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 vii

Page 8: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

DescriptionTitlePart

Contains chapters that describe how to configure the boot deviceorder, how to control power to the server, and how to reset theserver.

Managing the ServerPart 2

Contains chapters that describe how to view the CPU, memory,power supply, and storage properties of the server.

Viewing ServerProperties

Part 3

Contains chapters that describe how to view the power supply,fan, temperature, and voltage sensors.

Viewing ServerSensors

Part 4

Contains chapters that describe how to configure and manage thevirtual KVM, virtual media, and the serial over LAN connection.

Managing RemotePresence

Part 5

Contains chapters that describe how to add, delete, andauthenticate users, and how to manage user sessions.

Managing UserAccounts

Part 6

Contains chapters that describe how to configure networkinterfaces, network settings, and network security.

ConfiguringNetwork-RelatedSettings

Part 7

Contains chapters that describe how to configure servermanagement communication by HTTP, SSH, and IPMI.

ConfiguringCommunicationServices

Part 8

Contains chapters that describe how to generate, upload, andmanage server certificates.

ManagingCertificates

Part 9

Contains chapters that describe how to configure and manageplatform event filters and SNMP settings.

ConfiguringPlatform EventFilters

Part 10

Contains chapters that describe how to obtain, install, and activatefirmware images.

CIMC FirmwareManagement

Part 11

Contains chapters that describe how to view and clear logmessages.

Viewing LogsPart 12

Contains chapters that describe how to export support data, howto reset the server configuration to factory defaults, and how toreboot the management interface.

Server UtilitiesPart 13

ConventionsThis document uses the following conventions:

IndicationConvention

Commands, keywords, GUI elements, and user-entered textappear in bold font.

bold font

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)viii OL-21105-01

PrefaceConventions

Page 9: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

IndicationConvention

Document titles, new or emphasized terms, and arguments forwhich you supply values are in italic font.

italic font

Elements in square brackets are optional.[ ]

Required alternative keywords are grouped in braces andseparated by vertical bars.

{x | y | z}

Optional alternative keywords are grouped in brackets andseparated by vertical bars.

[x | y | z]

A nonquoted set of characters. Do not use quotation marksaround the string or the string will include the quotation marks.

string

Terminal sessions and information the system displays appearin courier font.

courier font

Nonprinting characters such as passwords are in angle brackets.< >

Default responses to system prompts are in square brackets.[ ]

An exclamation point (!) or a pound sign (#) at the beginning ofa line of code indicates a comment line.

!, #

Means reader take note.Note

Means the following information will help you solve a problem.Tip

Means reader be careful. In this situation, you might perform an action that could result in equipmentdamage or loss of data.

Caution

Means the described action saves time. You can save time by performing the action described in theparagraph.

Timesaver

Means reader be warned. In this situation, you might perform an action that could result in bodily injury.Warning

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 ix

PrefaceConventions

Page 10: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Related DocumentationDocumentation for Cisco Unified Computing System (Cisco UCS) is available at the following URL:

http://www.cisco.com

The following are related Cisco UCS documents:

• Cisco UCS Documentation Roadmap

• Cisco UCS C-Series Rack-Mount Servers Configuration Guide

• Cisco UCS Manager CLI Configuration Guide

• Cisco UCS Manager XML API Programmer's Guide

• Cisco UCS Manager Troubleshooting Guide

• Cisco UCS Site Preparation Guide

• Cisco UCS 6100 Series Fabric Interconnect Hardware Installation Guide

• Cisco UCS 5108 Server Chassis Hardware Installation Guide

• Regulatory Compliance and Safety Information for Cisco UCS

• Release Notes for Cisco UCS

Documentation FeedbackTo provide technical feedback on this document, or to report an error or omission, please send your commentsto [email protected]. We appreciate your feedback.

Obtaining Documentation and Submitting a Service RequestFor information on obtaining documentation, submitting a service request, and gathering additional information,see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Ciscotechnical documentation, at:

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

Subscribe to theWhat's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feedand set content to be delivered directly to your desktop using a reader application. The RSS feeds are a freeservice and Cisco currently supports RSS version 2.0.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)x OL-21105-01

PrefaceRelated Documentation

Page 11: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

C H A P T E R 1Overview

This chapter includes the following sections:

• Overview of the Cisco UCS C-Series Rack-Mount Servers, page 1

• Cisco Integrated Management Controller, page 1

• CIMC CLI, page 3

Overview of the Cisco UCS C-Series Rack-Mount ServersFollowing are the Cisco UCS C-Series rack-mount servers:

• Cisco UCS C200 M1 Rack-Mount Server

• Cisco UCS C210 M1 Rack-Mount Server

UCS C200 M1 Rack-Mount Server

The Cisco UCS C200 M1 server is a high-density, two-socket, 1 RU rack-mount server. This server is builtfor production-level network infrastructure, web services, and mainstream data centers, and branch andremote-office applications.

UCS C210 M1 Rack-Mount Server

The Cisco UCS C210 M1 server is a general-purpose, two-socket, 2 RU rack-mount server. It is designed tobalance performance, density, and efficiency for storage-intensiveworkloads. This server is built for applicationssuch as network file and appliances, storage, database, and content-delivery.

Cisco Integrated Management ControllerThe Cisco Integrated Management Controller (CIMC) is the management service for the C-Series servers.CIMC runs within the server.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 1

Page 12: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Management Interfaces

You can use a web-based GUI or SSH-based CLI to access, configure, administer, and monitor the server.Almost all tasks can be performed in either interface, and the results of tasks performed in one interface aredisplayed in another. However, you cannot do the following:

• Use CIMC GUI to invoke CIMC CLI

• View a command that has been invoked through CIMC CLI in CIMC GUI

• Generate CIMC CLI output from CIMC GUI

Tasks You Can Perform in CIMC

You can use CIMC to perform the following server management tasks:

• Power on, power off, power cycle, reset and shut down the server

• Toggle the locator LED

• Configure the server boot order

• View server properties and sensors

• Manage remote presence

• Create and manage local user accounts, and enable remote user authentication through Active Directory

• Configure network-related settings, including NIC properties, IPv4, VLANs, and network security

• Configure communication services, including HTTP, SSH, and IPMI Over LAN

• Manage certificates

• Configure platform event filters

• Update CIMC firmware

• Monitor faults, alarms, and server status

No Operating System or Application Provisioning or Management

CIMC provisions servers, and as a result, exists below the operating system on a server. Therefore, you cannotuse it to provision or manage operating systems or applications on servers. For example, you cannot do thefollowing:

• Deploy an OS, such as Windows or Linux

• Deploy patches for software, such as an OS or an application

• Install base software components, such as anti-virus software, monitoring agents, or backup clients

• Install software applications, such as databases, application server software, or web servers

• Perform operator actions, including restarting an Oracle database, restarting printer queues, or handlingnon-CIMC user accounts

• Configure or manage external storage on the SAN or NAS storage

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)2 OL-21105-01

OverviewCisco Integrated Management Controller

Page 13: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

CIMC CLIThe CIMC CLI is a command-line management interface for Cisco UCS C-Series servers. You can launchthe CIMC CLI and manage the server by the serial port or over the network by SSH or Telnet. By default,Telnet access is disabled.

A user of the CLI will be one of three roles: admin, user (can control, cannot configure), and read-only.

To recover from a lost admin password, see the Cisco UCS C-Series server installation and service guidefor your platform.

Note

Command ModesThe CLI is organized into a hierarchy of command modes, with the EXECmode being the highest-level modeof the hierarchy. Higher-level modes branch into lower-level modes. You use the scope command to movefrom higher-level modes to modes in the next lower level , and the exit command to move up one level in themode hierarchy. The top command returns to the EXEC mode.

Most commandmodes are associated with managed objects. The scope command does not create managedobjects, and can only access modes for which managed objects already exist.

Note

Each mode contains a set of commands that can be entered in that mode. Most of the commands available ineach mode pertain to the associated managed object. Depending on your assigned role, you may have accessto only a subset of the commands available in a mode; commands to which you do not have access are hidden.

The CLI prompt for each mode shows the full path down the mode hierarchy to the current mode. This helpsyou to determine where you are in the command mode hierarchy and can be an invaluable tool when you needto navigate through the hierarchy.

Command Mode TableThe following table lists the main command modes, the commands used to access each mode, and the CLIprompt associated with each mode.

Table 1: Main Command Modes and Prompts

Mode PromptCommands Used to AccessMode Name

#top command from any modeEXEC

/bios #scope bios command from EXEC modebios

/certificate #scope certificate command from EXEC modecertificate

/chassis #scope chassis command from EXEC modechassis

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 3

Command ModesCIMC CLI

Page 14: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Mode PromptCommands Used to AccessMode Name

/cimc #scope cimc command from EXEC modecimc

/cimc/firmware #scope firmware command from cimc modefirmware

/cimc/ log #scope log command from cimc modelog

/cimc/network #scope network command from cimc modenetwork

/cimc/network/ip-blocking #scope ip-blocking command from network modeip-blocking

/cimc/tech-support #scope tech-support command from cimc modetech-support

/fault #scope fault command from EXEC modefault

/fault/pef #scope pef command from fault modepef

/fault/trap-destination #scope trap-destination command from fault modetrap-destination

/http #scope http command from EXEC modehttp

/ipmi #scope ipmi command from EXEC modeipmi

/kvm #scope kvm command from EXEC modekvm

/ldap #scope ldap command from EXEC modeldap

/sel #scope sel command from EXEC modesel

/sensor #scope sensor command from EXEC modesensor

/sol #scope sol command from EXEC modesol

/ssh #scope ssh command from EXEC modessh

/user #scope user user-number command from EXEC modeuser

/user-session #scope user-session session-number command fromEXEC mode

user-session

/vmedia #scope vmedia command from EXEC modevmedia

Complete a CommandYou can use the Tab key in any mode to complete a command. Partially typing a command name and pressingTab causes the command to be displayed in full, or to the point where another keyword must be chosen or anargument value must be entered.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)4 OL-21105-01

OverviewComplete a Command

Page 15: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Command HistoryThe CLI stores all previously used commands in the current session. You can step through the previouslyused commands by using the Up Arrow or Down Arrow keys. The Up Arrow key steps to the previouscommand in the history, and the Down Arrow key steps to the next command in the history. If you get to theend of the history, pressing the Down Arrow key does nothing.

All commands in the history can be entered again by simply stepping through the history to recall the desiredcommand and pressing Enter. The command is entered as if you had manually typed it. You can also recalla command and change it before you enter it.

Committing, Discarding, and Viewing Pending CommandsWhen you enter a configuration command in the CLI, the command is not applied until you enter the commitcommand. Until committed, a configuration command is pending and can be discarded by entering a discardcommand. When any command is pending, an asterisk (*) appears before the command prompt. The asteriskdisappears when you enter the commit command, as shown in this example:Server# scope chassisServer /chassis # set locator-led offServer /chassis *# commitServer /chassis #

You can accumulate pending changes in multiple command modes and apply them together with a singlecommit command. You can view the pending commands by entering the show configuration pendingcommand in any command mode.

Committing multiple commands together is not an atomic operation. If any command fails, the successfulcommands are applied despite the failure. Failed commands are reported in an error message.

Note

Command Output FormatsMost CLI show commands accept an optional detail keyword that causes the output information to be displayedas a list rather than a table. You can configure either of two presentation formats for displaying the outputinformation when the detail keyword is used. The format choices are as follows:

• Default—For easy viewing, the command output is presented in a compact list.

This example shows command output in the default format:Server /chassis # set cli output defaultServer /chassis # show hdd detailName HDD_01_STATUS:

Status : presentName HDD_02_STATUS:

Status : presentName HDD_03_STATUS:

Status : presentName HDD_04_STATUS:

Status : present

Server /chassis #

• YAML—For easy parsing by scripts, the command output is presented in the YAML™ (YAML Ain'tMarkup Language) data serialization language, delimited by defined character strings.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 5

OverviewCommand History

Page 16: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

This example shows command output in the YAML format:Server /chassis # set cli output yamlServer /chassis # show hdd detail---

name: HDD_01_STATUShdd-status: present

---name: HDD_02_STATUShdd-status: present

---name: HDD_03_STATUShdd-status: present

---name: HDD_04_STATUShdd-status: present

...

Server /chassis #For detailed information about YAML, see http://www.yaml.org/about.html.

In most CLI command modes, you can enter set cli output default to configure the default format, or set clioutput yaml to configure the YAML format.

Online Help for the CLIAt any time, you can type the ? character to display the options available at the current state of the commandsyntax. If you have not typed anything at the prompt, typing ? lists all available commands for the mode youare in. If you have partially typed a command, typing ? lists all available keywords and arguments availableat your current position in the command syntax.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)6 OL-21105-01

Online Help for the CLICommand Output Formats

Page 17: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

C H A P T E R 2Managing the Server

This chapter includes the following sections:

• Toggling the Locator LED, page 7

• Resetting the Server Boot Order, page 8

• Powering On the Server, page 8

• Powering Off the Server, page 9

• Power Cycling the Server, page 9

• Resetting the Server, page 10

• Shutting Down the Server, page 10

Toggling the Locator LEDBefore You Begin

You must have user privileges for all power control operations including this operation.

Procedure

PurposeCommand or Action

Enters chassis command mode.Server# scope chassisStep 1

Enables or disables the chassis locator LED.Server /chassis # set locator-led {on | off}Step 2

Commits the transaction to the systemconfiguration.

Server /chassis # commitStep 3

This example disables the chassis locator LED and commits the transaction:Server# scope chassisServer /chassis # set locator-led offServer /chassis *# commit

Server /chassis #

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 7

Page 18: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Resetting the Server Boot OrderProcedure

PurposeCommand or Action

Enters bios command mode.Server# scope biosStep 1

Specifies the boot device options and order. You canselect one or more of the following:

Server /bios # set boot-orderdevice1[,device2[,device3[,device4[,device5]]]]

Step 2

• cdrom—Bootable CD-ROM

• fdd—Floppy disk drive

• hdd—Hard disk drive

• pxe—PXE boot

• efi—Extensible Firmware Interface

Commits the transaction to the system configuration.Server /bios # commitStep 3

This example sets the boot order and commits the transaction:Server# scope biosServer /bios # set boot-order hdd,cdrom,fdd,pxe,efiServer /bios *# commitServer /bios # show detailBIOS:

Boot Order: HDD,CDROM,FDD,PXE,EFI

Server /bios #

Powering On the Server

If the server was powered off other than through the CIMC, the server will not become active immediatelywhen powered on. In this case, the server will enter standby mode until the CIMC completes initialization.

Note

Procedure

PurposeCommand or Action

Enters chassis command mode.Server# scope chassisStep 1

Turns on the server.Server /chassis # power onStep 2

This example turns on the server:Server# scope chassisServer /chassis # power onThis operation will change the server's power state.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)8 OL-21105-01

Managing the ServerResetting the Server Boot Order

Page 19: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Continue?[y|N]y

Server /chassis # showPower Serial Number Product Name UUID----- ------------- ------------- ------------------------------------on Not Specified Not Specified 208F0100020F000000BEA80000DEAD00

Powering Off the ServerProcedure

PurposeCommand or Action

Enters chassis command mode.Server# scope chassisStep 1

Turns off the server.Server /chassis # power offStep 2

This example turns off the server:Server# scope chassisServer /chassis # power offThis operation will change the server's power state.Continue?[y|N]y

Server /chassis # showPower Serial Number Product Name UUID----- ------------- ------------- ------------------------------------off Not Specified Not Specified 208F0100020F000000BEA80000DEAD00

Power Cycling the ServerProcedure

PurposeCommand or Action

Enters chassis command mode.Server# scope chassisStep 1

Power cycles the server.Server /chassis # power cycleStep 2

This example power cycles the server:Server# scope chassisServer /chassis # power cycle

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 9

Managing the ServerPowering Off the Server

Page 20: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Resetting the ServerProcedure

PurposeCommand or Action

Enters chassis command mode.Server# scope chassisStep 1

After a prompt to confirm, resets the server.Server /chassis # power hard-resetStep 2

This example resets the server:Server# scope chassisServer /chassis # power hard-resetThis operation will change the server's power state.Continue?[y|N]

Shutting Down the ServerProcedure

PurposeCommand or Action

Enters chassis mode.Server# scope chassisStep 1

Shuts down the server.Server /chassis # power shutdownStep 2

The following example shuts down the server:Server# scope chassisServer /chassis # power shutdown

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)10 OL-21105-01

Managing the ServerResetting the Server

Page 21: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

C H A P T E R 3Viewing Server Properties

This chapter includes the following sections:

• Viewing CPU Properties, page 11

• Viewing Memory Properties, page 12

• Viewing Power Supply Properties, page 12

• Viewing Storage Properties, page 13

Viewing CPU PropertiesBefore You Begin

The server must be powered on, or the properties will not display.

Procedure

PurposeCommand or Action

Enters chassis command mode.Server# scope chassisStep 1

Displays CPU properties.Server /chassis # show cpu [detail]Step 2

This example displays CPU properties:Server# scope chassisServer /chassis # show cpuName Cores Version------------ -------- --------------------------------------------------CPU1 4 Intel(R) Xeon(R) CPU E5520 @ 2.27GHzCPU2 4 Intel(R) Xeon(R) CPU E5520 @ 2.27GHz

Server /chassis #

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 11

Page 22: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Viewing Memory PropertiesBefore You Begin

The server must be powered on, or the properties will not display.

Procedure

PurposeCommand or Action

Enters chassis command mode.Server# scope chassisStep 1

Displays memory properties.Server /chassis # show dimm [detail]Step 2

This example displays memory properties:Server# scope chassisServer /chassis # show dimmName Capacity (MB) Speed (MHz) Type---------- --------------- --------------- ---------------DIMM_A1 2048 1067 OtherDIMM_A2 0 1067 OtherDIMM_B1 0 1067 OtherDIMM_B2 0 1067 OtherDIMM_C1 0 1067 OtherDIMM_C2 0 1067 OtherDIMM_D1 2048 1067 OtherDIMM_D2 0 1067 OtherDIMM_E1 0 1067 OtherDIMM_E2 0 1067 OtherDIMM_F1 0 1067 OtherDIMM_F2 0 1067 Other

Server /chassis #

Viewing Power Supply PropertiesBefore You Begin

The server must be powered on, or the properties will not display.

Procedure

PurposeCommand or Action

Enters chassis command mode.Server# scope chassisStep 1

Displays power supply properties.Server /chassis # show psu [detail]Step 2

This example displays power supply properties:Server# scope chassisServer /chassis # show psuName In. Power (Watts) Out. Power (Watts) Firmware Status---------- -------------------- -------------------- -------- ----------PSU1 74 650 R0E PresentPSU2 83 650 R0E Present

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)12 OL-21105-01

Viewing Server PropertiesViewing Memory Properties

Page 23: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Server /chassis #

Viewing Storage PropertiesBefore You Begin

The server must be powered on, or the properties will not display.

Procedure

PurposeCommand or Action

Enters chassis command mode.Server# scope chassisStep 1

Displays storage properties.Server /chassis # show hdd [detail]Step 2

This example displays storage properties:Server# scope chassisServer /chassis # show hddName Status-------------------- --------------------HDD_01_STATUS presentHDD_02_STATUS presentHDD_03_STATUS presentHDD_04_STATUS present

Server /chassis #

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 13

Viewing Server PropertiesViewing Storage Properties

Page 24: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)14 OL-21105-01

Viewing Server PropertiesViewing Storage Properties

Page 25: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

C H A P T E R 4Viewing Server Sensors

This chapter includes the following sections:

• Viewing Power Supply Sensors, page 15

• Viewing Fan Sensors, page 16

• Viewing Temperature Sensors, page 16

• Viewing Voltage Sensors, page 17

Viewing Power Supply SensorsProcedure

PurposeCommand or Action

Enters sensor command mode.Server# scope sensorStep 1

Displays power supply sensor statistics for theserver.

Server /sensor # show psu [detail]Step 2

Displays power supply redundancy sensor statusfor the server.

Server /sensor # show psu-redundancy[detail]

Step 3

This example displays power supply sensor statistics:Server# scope sensorServer /sensor # show psuName Sensor Status Reading Units Min. Warning Max. Warning

Min. Failure Max. Failure-------------------- -------------------- ---------- ---------- ------------------------------ --------------- ---------------PSU1_STATUS Normal present

PSU2_STATUS Normal present

Server /sensor # show psu-redundancyName Reading Sensor Status-------------------- ---------- --------------------PSU_REDUNDANCY full Normal

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 15

Page 26: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Server /sensor #

Viewing Fan SensorsProcedure

PurposeCommand or Action

Enters sensor command mode.Server# scope sensorStep 1

Displays fan sensor statistics for the server.Server /sensor # show fan [detail]Step 2

This example displays fan sensor statistics:Server# scope sensorServer /sensor # show fan

Server /sensor #

Viewing Temperature SensorsProcedure

PurposeCommand or Action

Enters sensor command mode.Server# scope sensorStep 1

Displays temperature sensor statistics for theserver.

Server /sensor # show temperature [detail]Step 2

This example displays temperature sensor statistics:Server# scope sensorServer /sensor # show temperatureName Sensor Status Reading Units Min. Warning Max. WarningMin. Failure Max. Failure------------------------- -------------- ---------- ---------- ------------ ------------------------ ------------IOH_TEMP_SENS Normal 32.0 C N/A 80.0N/A 85.0P2_TEMP_SENS Normal 31.0 C N/A 80.0N/A 81.0P1_TEMP_SENS Normal 34.0 C N/A 80.0N/A 81.0DDR3_P2_D1_TMP Normal 20.0 C N/A 90.0N/A 95.0DDR3_P1_A1_TMP Normal 21.0 C N/A 90.0N/A 95.0FP_AMBIENT_TEMP Normal 28.0 C N/A 40.0N/A 45.0

Server /sensor #

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)16 OL-21105-01

Viewing Server SensorsViewing Fan Sensors

Page 27: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Viewing Voltage SensorsProcedure

PurposeCommand or Action

Enters sensor command mode.Server# scope sensorStep 1

Displays voltage sensor statistics for theserver.

Server /sensor # show voltage [detail]Step 2

This example displays voltage sensor statistics:Server# scope sensorServer /sensor # show voltageName Sensor Status Reading Units Min. Warning Max. WarningMin. Failure Max. Failure------------------------- -------------- ---------- ---------- ------------ ------------------------ ------------P3V_BAT_SCALED Normal 3.022 V N/A N/A2.798 3.088P12V_SCALED Normal 12.154 V N/A N/A11.623 12.331P5V_SCALED Normal 5.036 V N/A N/A4.844 5.157P3V3_SCALED Normal 3.318 V N/A N/A3.191 3.381P5V_STBY_SCALED Normal 5.109 V N/A N/A4.844 5.157PV_VCCP_CPU1 Normal 0.950 V N/A N/A0.725 1.391PV_VCCP_CPU2 Normal 0.891 V N/A N/A0.725 1.391P1V5_DDR3_CPU1 Normal 1.499 V N/A N/A1.450 1.548P1V5_DDR3_CPU2 Normal 1.499 V N/A N/A1.450 1.548P1V1_IOH Normal 1.087 V N/A N/A1.068 1.136P1V8_AUX Normal 1.773 V N/A N/A1.744 1.852

Server /sensor #

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 17

Viewing Server SensorsViewing Voltage Sensors

Page 28: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)18 OL-21105-01

Viewing Server SensorsViewing Voltage Sensors

Page 29: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

C H A P T E R 5Managing Remote Presence

This chapter includes the following sections:

• Managing the Virtual KVM, page 19

• Configuring Virtual Media, page 22

• Managing Serial over LAN, page 22

Managing the Virtual KVM

KVM ConsoleThe KVM console is an interface accessible from CIMC that emulates a direct keyboard, video, and mouse(KVM) connection to the server. The KVM console allows you to connect to the server from a remote location.

Instead of using CD/DVD or floppy drives physically connected to the server, the KVM console uses virtualmedia, which are actual disk drives or disk image files that are mapped to virtual CD/DVD or floppy drives.You can map any of the following to a virtual drive:

• CD/DVD or floppy drive on your computer

• Disk image files on your computer

• CD/DVD or floppy drive on the network

• Disk image files on the network

You can use the KVM console to install an OS on the server.

Enabling the Virtual KVM

Before You Begin

You must log in as a user with admin privileges to enable the virtual KVM.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 19

Page 30: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Procedure

PurposeCommand or Action

Enters KVM command mode.Server# scope kvmStep 1

Enables the virtual KVM.Server /kvm # set enabled yesStep 2

Commits the transaction to the systemconfiguration.

Server /kvm # commitStep 3

(Optional) Displays the virtual KVMconfiguration.

Server /kvm # show [detail]Step 4

This example enables the virtual KVM:Server# scope kvmServer /kvm # set enabled yesServer /kvm *# commitServer /kvm # showEncryption Enabled Local Video Active Sessions Enabled KVM Port------------------ ---------------- --------------- ------- --------no yes 0 yes 2068

Server /kvm #

Disabling the Virtual KVM

Before You Begin

You must log in as a user with admin privileges to disable the virtual KVM.

Procedure

PurposeCommand or Action

Enters KVM command mode.Server# scope kvmStep 1

Disables the virtual KVM.Server /kvm # set enabled noStep 2

Disabling the virtual KVM disables access tothe virtual media feature, but does not detachthe virtual media devices if virtual media isenabled.

Note

Commits the transaction to the system configuration.Server /kvm # commitStep 3

(Optional) Displays the virtual KVM configuration.Server /kvm # show [detail]Step 4

This example disables the virtual KVM:Server# scope kvmServer /kvm # set enabled noServer /kvm *# commitServer /kvm # showEncryption Enabled Local Video Active Sessions Enabled KVM Port------------------ ---------------- --------------- ------- --------no yes 0 no 2068

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)20 OL-21105-01

Disabling the Virtual KVMManaging the Virtual KVM

Page 31: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Server /kvm #

Configuring the Virtual KVM

Before You Begin

You must log in as a user with admin privileges to configure the virtual KVM.

Procedure

PurposeCommand or Action

Enters KVM command mode.Server# scope kvmStep 1

Enables or disables the virtual KVM.Server /kvm # set enabled {yes | no}Step 2

If encryption is enabled, the server encrypts all videoinformation sent through the KVM.

Server /kvm # set encrypted {yes |no}

Step 3

Specifies the port used for KVM communication.Server /kvm # set kvm-port portStep 4

If local video is yes, the KVM session is alsodisplayed on any monitor attached to the server.

Server /kvm # set local-video {yes |no}

Step 5

Specifies the maximum number of concurrent KVMsessions allowed. The sessions argument is an integerbetween 1 and 4.

Server /kvm # set max-sessionssessions

Step 6

Commits the transaction to the system configuration.Server /kvm # commitStep 7

(Optional) Displays the virtual KVM configuration.Server /kvm # show [detail]Step 8

This example configures the virtual KVM and displays the configuration:Server# scope kvmServer /kvm # set enabled yesServer /kvm *# set encrypted noServer /kvm *# set kvm-port 2068Server /kvm *# set max-sessions 4Server /kvm *# set local-video yesServer /kvm *# commitServer /kvm # show detailKVM Settings:

Encryption Enabled: noMax Sessions: 4Local Video: yesActive Sessions: 0Enabled: yesKVM Port: 2068

Server /kvm #

What to Do Next

Launch the virtual KVM from the GUI.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 21

Configuring the Virtual KVMManaging the Virtual KVM

Page 32: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Configuring Virtual MediaBefore You Begin

You must log in as a user with admin privileges to configure virtual media.

Procedure

PurposeCommand or Action

Enters virtual media command mode.Server# scope vmediaStep 1

Enables or disables virtual media. By default, virtualmedia is disabled.

Server /vmedia # set enabled {yes |no}

Step 2

Disabling virtual media detaches the virtualCD, virtual floppy, and virtual HDD devicesfrom the host.

Note

Enables or disables virtual media encryption.Server /vmedia # set encryption {yes| no}

Step 3

Commits the transaction to the system configuration.Server /vmedia # commitStep 4

(Optional) Displays the virtual media configuration.Server /vmedia # show [detail]Step 5

This example configures virtual media encryption:Server# scope vmediaServer /vmedia # set enabled yesServer /vmedia *# set encryption yesServer /vmedia *# commitServer /vmedia # show detailvMedia Settings:

Encryption Enabled: yesEnabled: yesMax Sessions: 4Active Sessions: 0

Server /vmedia #

What to Do Next

Use the KVM to attach virtual media devices to a host.

Managing Serial over LAN

Serial Over LANSerial over LAN (SoL) is a mechanism that enables the input and output of the serial port of a managed systemto be redirected via an SSH session over IP. SoL provides a means of reaching the host console via CIMC.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)22 OL-21105-01

Serial Over LANConfiguring Virtual Media

Page 33: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Guidelines and Restrictions for Serial Over LANFor redirection to SoL, the server console must have the following configuration:

• console redirection to serial port A

• no flow control

• baud rate the same as configured for SoL

• VT-100 terminal type

• legacy OS redirection disabled

The SoL session will display line-oriented information such as boot messages, and character-oriented screenmenus such as BIOS setup menus. If the server boots an operating system or application with a bitmap-orienteddisplay, such asWindows, the SoL session will no longer display. If the server boots a command-line-orientedoperating system (OS), such as Linux, you may need to perform additional configuration of the OS in orderto properly display in an SoL session.

In the SoL session, your keystrokes are transmitted to the console except for the function key F2. To send anF2 to the console, press the Escape key, then press 2.

Configuring Serial Over LAN

Before You Begin

You must log in as a user with admin privileges to configure serial over LAN (SoL).

Procedure

PurposeCommand or Action

Enters SoL command mode.Server# scope solStep 1

Enables or disables SoL on this server.Server /sol # set enabled {yes | no}Step 2

Sets the serial baud rate the system uses for SoLcommunication.

Server /sol # set baud-rate {9600 |19200 | 38400 | 57600 | 115200}

Step 3

The baud rate must match the baud rateconfigured in the server serial console.

Note

Commits the transaction to the systemconfiguration.

Server /sol # commitStep 4

(Optional) Displays the SoL settings.Server /sol # show [detail]Step 5

This example configures SoL:Server# scope solServer /sol # set enabled yesServer /sol *# set baud-rate 115200Server /sol *# commitServer /sol # showEnabled Baud Rate(bps)------- ---------------

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 23

Configuring Serial Over LANGuidelines and Restrictions for Serial Over LAN

Page 34: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

yes 115200

Server /sol #

Launching Serial Over LAN

Procedure

PurposeCommand or Action

Opens a serial over LAN (SoL) connection to the redirectedserver console port. You can enter this command in anycommand mode.

Server# connect hostStep 1

What to Do Next

To end the SoL session, you must close the CLI session. For example, to end an SoL session over an SSHconnection, disconnect the SSH connection.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)24 OL-21105-01

Launching Serial Over LANGuidelines and Restrictions for Serial Over LAN

Page 35: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

C H A P T E R 6Managing User Accounts

This chapter includes the following sections:

• Configuring Local Users, page 25

• Configuring Active Directory, page 26

• Viewing User Sessions, page 29

• Terminating a User Session, page 30

Configuring Local UsersBefore You Begin

You must log in as a user with admin privileges to configure local users.

Procedure

PurposeCommand or Action

Enters user command mode for user number usernumber.Server# scope user usernumberStep 1

Enables or disables the user account on the CIMC.Server /user # set enabled {yes| no}

Step 2

Specifies the username for the user.Server /user # set nameusername

Step 3

You are prompted to enter the password twice.Server /user # set passwordStep 4

Specifies the role assigned to the user. The roles are asfollows:

Server /user # set role {readonly| user | admin}

Step 5

• readonly—This user can view information but cannotmake any changes.

• user—This user can do the following:

• View all information

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 25

Page 36: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

PurposeCommand or Action

• Manage the power control options such as poweron, power cycle, and power off

• Launch the KVM console and virtual media

• Clear all logs

• Toggle the locator LED

• admin—This user can perform all actions availablethrough the GUI, CLI, and IPMI.

Commits the transaction to the system configuration.Server /user # commitStep 6

This example configures user 5 as an admin:Server# scope user 5Server /user # set enabled yesServer /user *# set name johnServer /user *# set passwordPlease enter password:Please confirm password:Server /user *# set role readonlyServer /user *# commitServer /user # showUser Name Role Enabled------ ---------------- -------- --------5 john readonly yes

Configuring Active Directory

Active DirectoryActive Directory is a technology that provides a variety of network services including LDAP-like directoryservices, Kerberos-based authentication, and DNS-based naming. The CIMC utilizes the Kerberos-basedauthentication service of Active Directory.

When Active Directory is enabled in the CIMC, all user authentication and role authorization is performedby Active Directory, and the CIMC ignores the local database. If the CIMC cannot connect to Active Directory,it reverts to the local database.

By enabling encryption in the configuration of Active Directory on the server, you can require the server toencrypt data sent to Active Directory.

Configuring the Active Directory ServerThe CIMC can be configured to use Active Directory for user authentication and authorization. To use ActiveDirectory, configure users with an attribute that holds the user role and locale information for the CIMC. Youcan use an existing LDAP attribute that is mapped to the CIMC user roles and locales or you can modify theActive Directory schema to add a new custom attribute, such as the CiscoAVPair attribute, which has an

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)26 OL-21105-01

Active DirectoryConfiguring Active Directory

Page 37: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

attribute ID of 1.3.6.1.4.1.9.287247.1. For more information about altering the Active Directory schema, seethe article at http://technet.microsoft.com/en-us/library/bb727064.aspx.

The following steps are to be performed on the Active Directory server.

This example creates a custom attribute named CiscoAVPair, but you can also use an existing LDAPattribute that is mapped to the CIMC user roles and locales.

Note

Procedure

Step 1 Ensure that the Active Directory schema snap-in is installed.Step 2 Using the Active Directory schema snap-in, add a new attribute with the following properties:

ValueProperties

CiscoAVPairCommon Name

CiscoAVPairLDAP Display Name

1.3.6.1.4.1.9.287247.1Unique X500 Object ID

CiscoAVPairDescription

Case Sensitive StringSyntax

Step 3 Add the CiscoAVPair attribute to the user class using the Active Directory snap-in:a) Expand the Classes node in the left pane and type U to select the user class.b) Click the Attributes tab and click Add.c) Type C to select the CiscoAVPair attribute.d) Click OK.

Step 4 Add the following user role values to the CiscoAVPair attribute, for the users that you want to have accessto CIMC:

CiscoAVPair Attribute ValueRole

shell:roles="admin"admin

shell:roles="user"user

shell:roles="read-only"read-only

For more information about adding values to attributes, see the article at http://technet.microsoft.com/en-us/library/bb727064.aspx.

Note

What to Do Next

Use the CIMC to configure Active Directory.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 27

Managing User AccountsConfiguring Active Directory

Page 38: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Configuring Active Directory in the CIMCConfigure Active Directory in the CIMC when you want to use an Active Directory server for local userauthentication and authorization.

Before You Begin

You must be logged in as admin to configure Active Directory.

Procedure

PurposeCommand or Action

Enters the Active Directory command mode.Server# scope ldapStep 1

Enables or disables Active Directory. When Active Directoryis enabled, all user authentication and role authorization is

Server /ldap # set enabled{yes | no}

Step 2

performed by Active Directory, and the CIMC ignores the localuser database.

If the CIMC cannot establish a connection to ActiveDirectory, the CIMC reverts to using the local userdatabase.

Note

Specifies the Active Directory server IP address.Server /ldap # set server-ipip-address

Step 3

Specifies the number of seconds the CIMCwaits until it assumesthe connection to Active Directory cannot be established.

Server /ldap # set timeoutseconds

Step 4

If encryption is enabled, the server encrypts all information sentto Active Directory.

Server /ldap # set encrypted{yes | no}

Step 5

Specifies the domain that all users must be in.Server /ldap # set base-dndomain-name

Step 6

Specify an LDAP attribute that contains the role and localeinformation for the user. This property is always a name-value

Server /ldap # set attributename

Step 7

pair. The system queries the user record for the value thatmatches this attribute name.

You can use an existing LDAP attribute that is mapped to theCIMC user roles and locales or you can create a customattribute, such as the CiscoAVPair attribute, which has thefollowing attribute ID:

1.3.6.1.4.1.9.287247.1

If you do not specify this property, user access isrestricted to read-only.

Note

Commits the transaction to the system configuration.Server /ldap # commitStep 8

(Optional) Displays the Active Directory configuration.Server /ldap # show [detail]Step 9

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)28 OL-21105-01

Configuring Active Directory in the CIMCConfiguring Active Directory

Page 39: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

This example configures Active Directory using the CiscoAVPair attribute:Server# scope ldapServer /ldap # set enabled yesServer /ldap *# set server-ip 10.10.10.123Server /ldap *# set timeout 60Server /ldap *# set encrypted onServer /ldap *# set base-dn example.comServer /ldap *# set attribute CiscoAVPairServer /ldap *# commitServer /ldap # showServer IP BaseDN Encrypted Timeout Enabled Attribute--------------- ------------ --------- -------- ------- ------------10.10.10.123 example.com yes 60 yes CiscoAvPair

Server /ldap #

Viewing User SessionsProcedure

PurposeCommand or Action

Displays information about current user sessions.Server# show user-sessionStep 1

The command output displays the following information about current user sessions:

DescriptionName

The unique identifier for the session.ID

The username for the user.Name

The IP address from which the user accessed the server.IP Address

The method by which the user accessed the server.Type

If your user account has admin privileges, this column displays yes ifyou can force the associated user session to end. Otherwise it displaysN/A.

Killable

You cannot terminate your currentsession.

Note

This example displays information about current user sessions:Server# show user-sessionID Name IP Address Type Killable------ ---------------- ----------------- ------------ --------15 admin 10.20.30.138 CLI yes

Server /user #

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 29

Managing User AccountsViewing User Sessions

Page 40: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Terminating a User SessionBefore You Begin

You must log in as a user with admin privileges to terminate a user session.

Procedure

PurposeCommand or Action

Displays information about current user sessions. Theuser session to be terminated must be eligible to beterminated (killable) and must not be your own session.

Server# show user-sessionStep 1

Enters user session command mode for the numbereduser session that you want to terminate.

Server /user-session # scopeuser-session session-number

Step 2

Terminates the user session.Server /user-session # terminateStep 3

This example shows how the admin at user session 10 terminates user session 15:Server# show user-sessionID Name IP Address Type Killable------ ---------------- ----------------- ------------ --------10 admin 10.20.41.234 CLI yes15 admin 10.20.30.138 CLI yesServer# scope user-session 15Server /user-session # terminateUser session 15 terminated.

Server /user-session #

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)30 OL-21105-01

Managing User AccountsTerminating a User Session

Page 41: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

C H A P T E R 7Configuring Network-Related Settings

This chapter includes the following sections:

• Server NIC Configuration, page 31

• Configuring Common Properties, page 33

• Configuring IPv4, page 33

• Configuring the Server VLAN, page 35

• Network Security Configuration, page 36

Server NIC Configuration

Server NICsYou can configure NIC mode and NIC redundancy for the server NICs using the CIMC.

Set the NIC mode in the CIMC network command mode to determine which port you want to use to reachthe CIMC:

• Dedicated—The management port is used to access the CIMC

• Shared LOM—The LOM (LAN On Motherboard) host ports 1 and 2 are used to access the CIMC

• Shipping—The out-of-the-box defaults will be used for all options

The available NIC modes may vary depending on your platform.Note

Set the NIC redundancy mode in the CIMC network command mode to determine how NIC redundancy ishandled:

• None—No redundancy

• Active-Active—Use both ports simultaneously

Active-Active provides a throughput improvement by utilizing both host ports simultaneously.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 31

Page 42: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

• Active-Standby—Fail one port over to another

The available NIC redundancy modes may vary depending on your platform.Note

Configuring NICsConfigure a server NIC when you want to set the NIC mode and NIC redundancy.

Before You Begin

You must log in as a user with admin privileges to configure the NIC.

Procedure

PurposeCommand or Action

Enters the CIMC command mode.Server# scope cimcStep 1

Enters the CIMC network command mode.Server /cimc # scopenetwork

Step 2

Sets the NIC mode to one of the following:Server /cimc/network # setmode {dedicated |shared_lom}

Step 3

• Dedicated—Themanagement port is used to access the CIMC.

• Shared LOM—The LOM (LAN On Motherboard) ports areused to access the CIMC.

The available NIC modes may vary depending on yourplatform.

Note

Sets the NIC redundancy for systems in which the NIC mode isShared LOM. The redundancy type can be one of the following:

Server /cimc/network # setredundancy {none |

Step 4

active-active |active-standby} • none—The NICs operate independently and do not failover

if there is a problem.

• active-active—If supported, both NICs are utilizedsimultaneously. This increases throughput and providesmultiple paths to the CIMC.

If you select this option for a server that does notsupport teaming, the system displays an errormessage when you save your changes.

Note

• active-standby—If one NIC fails, traffic fails over to theother NIC.

If you select this option, make sure that both NICsare connected to the same subnet to ensure that thetraffic is secure regardless of which NIC is used.

Note

The available NIC redundancy may vary depending onyour platform.

Note

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)32 OL-21105-01

Configuring NICsServer NIC Configuration

Page 43: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

PurposeCommand or Action

Commits the transaction to the system configuration.Server /cimc/network #commit

Step 5

This example configures the server NIC:Server# scope cimcServer /cimc # scope networkServer /cimc/network # set mode dedicatedServer /cimc/network *# commitServer /cimc/network #

Configuring Common PropertiesUse common properties to describe your server.

Before You Begin

You must log in as a user with admin privileges to configure common properties.

Procedure

PurposeCommand or Action

Enters the CIMC command mode.Server# scope cimcStep 1

Enters the CIMC network command mode.Server /cimc # scope networkStep 2

Specifies the name of the host.Server /cimc/network # set hostnamehost-name

Step 3

Commits the transaction to the systemconfiguration.

Server /cimc/network # commitStep 4

This example configures the common properties:Server# scope cimcServer /cimc # scope networkServer /cimc/network # set hostname ServerServer /cimc/network *# commitServer /cimc/network #

Configuring IPv4Before You Begin

You must log in as a user with admin privileges to configure IPv4 network settings.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 33

Configuring Network-Related SettingsConfiguring Common Properties

Page 44: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Procedure

PurposeCommand or Action

Enters the CIMC command mode.Server# scope cimcStep 1

Enters the CIMC network command mode.Server /cimc # scope networkStep 2

Selects whether the CIMC uses DHCP.Server /cimc/network # set dhcp-enabled{yes | no}

Step 3

Specifies the IP address for the CIMC.Server /cimc/network # set v4-addripv4-address

Step 4

Specifies the subnet mask for the IP address.Server /cimc/network # set v4-netmaskipv4-netmask

Step 5

Specifies the gateway for the IP address.Server /cimc/network # set v4-gatewaygateway-ipv4-address

Step 6

Selects whether the CIMC retrieves the DNSserver addresses from DHCP.

Server /cimc/network # set dns-use-dhcp{yes | no}

Step 7

Specifies the IP address of the primary DNSserver.

Server /cimc/network # setpreferred-dns-server dns1-ipv4-address

Step 8

Specifies the IP address of the secondaryDNS server.

Server /cimc/network # setalternate-dns-server dns2-ipv4-address

Step 9

Commits the transaction to the systemconfiguration.

Server /cimc/network # commitStep 10

(Optional) Displays the IPv4 networksettings.

Server /cimc/network # show [detail]Step 11

This example configures and displays the IPv4 network settings:Server# scope cimcServer /cimc # scope networkServer /cimc/network # set dhcp-enabled yesServer /cimc/network *# set v4-addr 10.20.30.11Server /cimc/network *# set v4-netmask 255.255.248.0Server /cimc/network *# set v4-gateway 10.20.30.1Server /cimc/network *# set dns-use-dhcp-enabled noServer /cimc/network *# set preferred-dns-server 192.168.30.31Server /cimc/network *# set alternate-dns-server 192.168.30.32Server /cimc/network *# commitServer /cimc/network # show detailNetwork Setting:

IPv4 Address: 10.20.30.11IPv4 Netmask: 255.255.248.0IPv4 Gateway: 10.20.30.1DHCP Enabled: yesObtain DNS Server by DHCP: noPreferred DNS: 192.168.30.31Alternate DNS: 192.168.30.32VLAN Enabled: noVLAN ID: 1VLAN Priority: 0Hostname: ServerMAC Address: 01:23:45:67:89:ABNIC Mode: dedicated

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)34 OL-21105-01

Configuring Network-Related SettingsConfiguring IPv4

Page 45: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

NIC Redundancy: none

Server /cimc/network #

Configuring the Server VLANBefore You Begin

You must be logged in as admin to configure the server VLAN.

Procedure

PurposeCommand or Action

Enters the CIMC command mode.Server# scope cimcStep 1

Enters the CIMC network command mode.Server /cimc # scope networkStep 2

Selects whether the CIMC is connected to aVLAN.

Server /cimc/network # set vlan-enabled{yes | no}

Step 3

Specifies the VLAN number.Server /cimc/network # set vlan-id idStep 4

Specifies the priority of this system on theVLAN.

Server /cimc/network # set vlan-prioritypriority

Step 5

Commits the transaction to the systemconfiguration.

Server /cimc/network # commitStep 6

(Optional) Displays the network settings.Server /cimc/network # show [detail]Step 7

This example configures the server VLAN:Server# scope cimcServer /cimc # scope networkServer /cimc/network # set vlan-enabled yesServer /cimc/network *# set vlan-id 10Server /cimc/network *# set vlan-priority 32Server /cimc/network *# commitServer /cimc/network # show detailNetwork Setting:

IPv4 Address: 10.20.30.11IPv4 Netmask: 255.255.248.0IPv4 Gateway: 10.20.30.1DHCP Enabled: yesObtain DNS Server by DHCP: noPreferred DNS: 192.168.30.31Alternate DNS: 192.168.30.32VLAN Enabled: yesVLAN ID: 10VLAN Priority: 32Hostname: ServerMAC Address: 01:23:45:67:89:ABNIC Mode: dedicatedNIC Redundancy: none

Server /cimc/network #

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 35

Configuring Network-Related SettingsConfiguring the Server VLAN

Page 46: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Network Security Configuration

Network SecurityThe CIMC uses IP blocking as network security. IP blocking prevents the connection between a server orwebsite and certain IP addresses or ranges of addresses. IP blocking effectively bans undesired connectionsfrom those computers to a website, mail server, or other Internet servers.

IP banning is commonly used to protect against denial of service (DoS) attacks. CIMC bans IP addresses bysetting up an IP blocking fail count.

Configuring Network SecurityConfigure network security if you want to set up an IP blocking fail count.

Before You Begin

You must log in as a user with admin privileges to configure network security.

Procedure

PurposeCommand or Action

Enters the CIMC command mode.Server# scope cimcStep 1

Enters the CIMC network command mode.Server /cimc # scope networkStep 2

Enters the IP blocking command mode.Server /cimc/network # scopeipblocking

Step 3

Enables or disables IP blocking.Server /cimc/network/ipblocking #set enabled {yes | no}

Step 4

Sets the number of times a user can attempt to log inunsuccessfully before the system locks that user out fora specified length of time.

Server /cimc/network/ipblocking #set fail-count fail-count

Step 5

The number of unsuccessful login attempts must occurwithin the time frame specified in the IP Blocking FailWindow field.

Enter an integer between 3 and 10.

Sets the length of time, in seconds, in which theunsuccessful login attempts must occur in order for theuser to be locked out.

Server /cimc/network/ipblocking #set fail-window fail-seconds

Step 6

Enter an integer between 60 and 120.

Sets the number of seconds the user remains locked outif they exceed the maximum number of login attemptswithin the specified time window.

Server /cimc/network/ipblocking #set penalty-time penalty-seconds

Step 7

Enter an integer between 300 and 900.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)36 OL-21105-01

Network SecurityNetwork Security Configuration

Page 47: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

PurposeCommand or Action

Commits the transaction to the system configuration.Server /cimc/network/ipblocking #commit

Step 8

This example configures IP blocking:Server# scope cimcServer /cimc # scope networkServer /cimc/network # scope ipblockingServer /cimc/network/ipblocking # set enabled yesServer /cimc/network/ipblocking *# set fail-count 5Server /cimc/network/ipblocking *# set fail-window 90Server /cimc/network/ipblocking *# set penalty-time 600Server /cimc/network/ipblocking *# commitServer /cimc/network/ipblocking #

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 37

Configuring Network-Related SettingsNetwork Security Configuration

Page 48: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)38 OL-21105-01

Configuring Network-Related SettingsNetwork Security Configuration

Page 49: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

C H A P T E R 8Configuring Communication Services

This chapter includes the following sections:

• Configuring HTTP, page 39

• Configuring SSH, page 40

• IPMI Over LAN Configuration, page 41

Configuring HTTPBefore You Begin

You must log in as a user with admin privileges to configure HTTP.

Procedure

PurposeCommand or Action

Enters the HTTP command mode.Server# scope httpStep 1

Enables or disables HTTP and HTTPS service on theCIMC.

Server /http # set enabled {yes |no}

Step 2

Sets the port to use for HTTP communication. Thedefault is 80.

Server /http # set http-port numberStep 3

Sets the port to use for HTTPS communication. Thedefault is 443.

Server /http # set https-portnumber

Step 4

Sets the number of seconds to wait between HTTPrequests before the CIMC times out and terminates thesession.

Server /http # set timeout secondsStep 5

Enter an integer between 60 and 10,800. The default is1,800 seconds.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 39

Page 50: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

PurposeCommand or Action

Commits the transaction to the system configuration.Server /http # commitStep 6

This example configures HTTP for the CIMC:Server# scope httpServer /http # set enabled yesServer /http *# set http-port 80Server /http *# set https-port 443Server /http *# set timeout 1800Server /http *# commitServer /http # showHTTP Port HTTPS Port Timeout Active Sessions Enabled---------- ---------- -------- --------------- -------80 443 1800 0 yes

Server /http #

Configuring SSHBefore You Begin

You must log in as a user with admin privileges to configure SSH.

Procedure

PurposeCommand or Action

Enters the SSH command mode.Server# scope sshStep 1

Enables or disables SSH on the CIMC.Server /ssh # set enabled {yes | no}Step 2

Sets the port to use for secure shell access. The defaultis 22.

Server /ssh # set ssh-port numberStep 3

Sets the number of seconds to wait before the systemconsiders an SSH request to have timed out.

Server /ssh # set timeout secondsStep 4

Enter an integer between 60 and 10,800. The defaultis 300 seconds.

Commits the transaction to the system configuration.Server /ssh # commitStep 5

(Optional) Displays the SSH configuration.Server /ssh # show [detail]Step 6

This example configures SSH for the CIMC:Server# scope sshServer /ssh # set enabled yesServer /ssh *# set ssh-port 22Server /ssh *# set timeout 600Server /ssh *# commitServer /ssh # showSSH Port Timeout Active Sessions Enabled---------- -------- --------------- -------22 600 1 yes

Server /ssh #

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)40 OL-21105-01

Configuring Communication ServicesConfiguring SSH

Page 51: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

IPMI Over LAN Configuration

IPMI Over LANIPMI defines the protocols for interfacing with a service processor embedded in a server platform. This serviceprocessor is called a Baseboard Management Controller (BMC), and resides on the server motherboard. TheBMC links to a main processor and other on-board elements using a simple serial bus.

During normal operations, IPMI lets a server operating system obtain information about system health andcontrol system hardware. For example, IPMI enables the monitoring of sensors, such as temperature, fanspeeds and voltages, for proactive problem detection. If server temperature rises above specified levels, theserver operating system can direct the BMC to increase fan speed or reduce processor speed to address theproblem.

Configuring IPMI over LANConfigure IPMI over LAN when you want to manage the CIMC with IPMI messages.

Before You Begin

You must log in as a user with admin privileges to configure IPMI over LAN.

Procedure

PurposeCommand or Action

Enters the IPMI command mode.Server# scope ipmiStep 1

Enables or disables IPMI access on this server.Server /ipmi # set enabled{yes | no}

Step 2

Specifies the user role that must be assigned to users accessing thesystem though IPMI. The user roles are as follows:

Server /ipmi # setprivilege-level {readonly |user | admin}

Step 3

• readonly—This user can view information but cannot makeany changes.

• user—This user can do the following:

• View all information

• Manage the power control options such as power on,power cycle, and power off

• Launch the KVM console and virtual media

• Clear all logs

• Toggle the locator LED

• admin—This user can perform all actions available throughthe GUI, CLI, and IPMI.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 41

IPMI Over LANIPMI Over LAN Configuration

Page 52: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

PurposeCommand or Action

The value of this field must match exactly the roleassigned to the user attempting to log in. For example, ifthis field is set to readonly and a user with the admin roleattempts to log in through IPMI, that login attempt willfail.

Note

Sets the IMPI encryption key to use for IPMI communications.The key value must be 40 hexadecimal numbers.

Server /ipmi # setencryption-key key

Step 4

Commits the transaction to the system configuration.Server /ipmi # commitStep 5

This example configures IPMI over LAN for the CIMC:Server# scope ipmiServer /ipmi # set enabled yesServer /ipmi *# set privilege-level adminServer /ipmi *# set encryption-key abcdef01234567890abcdef01234567890abcdefServer /ipmi *# commitServer /ipmi # showEnabled Encryption Key Privilege Level Limit------- ---------------------------------------- ---------------------yes abcdef01234567890abcdef01234567890abcdef admin

Server /ipmi #

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)42 OL-21105-01

Configuring Communication ServicesIPMI Over LAN Configuration

Page 53: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

C H A P T E R 9Managing Certificates

This chapter includes the following sections:

• Managing the Server Certificate, page 43

• Generating a Certificate Signing Request, page 44

• Creating a Self-Signed Certificate, page 45

• Uploading a Server Certificate, page 47

Managing the Server CertificateYou can generate a certificate signing request (CSR) to obtain a new certificate, and you can upload the newcertificate to the CIMC to replace the current server certificate. The server certificate may be signed eitherby a public Certificate Authority (CA), such as Verisign, or by your own certificate authority.

Procedure

PurposeCommand or Action

Generate the CSR from the CIMC.Step 1

Submit the CSR file to a certificate authority that willissue and sign your certificate. If your organization

Step 2

generates its own self-signed certificates, you can usethe CSR file to generate a self-signed certificate.

The uploaded certificate mustbe created from a CSRgenerated by the CIMC. Donot upload a certificate thatwas not created by thismethod.

NoteUpload the new certificate to the CIMC.Step 3

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 43

Page 54: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Generating a Certificate Signing RequestBefore You Begin

You must log in as a user with admin privileges to configure certificates.

Procedure

PurposeCommand or Action

Enters the certificate command mode.Server# scope certificateStep 1

Launches a dialog for the generation of a certificatesigning request (CSR).

Server /certificate # generate-csrStep 2

You will be prompted to enter the following information for the certificate signing request:

The fully qualified hostname of the CIMC.Common Name (CN)

The organization requesting the certificate.Organization Name (O)

The organizational unit.Organization Unit (OU)

The city or town in which the company requestingthe certificate is headquartered.

Locality (L)

The state or province in which the companyrequesting the certificate is headquartered.

StateName (S)

The two-letter ISO country code for the country inwhich the company is headquartered.

Country Code (CC)

The administrative email contact at the company.Email

After you have entered the requested information, the system will generate and display a certificate signingrequest in the console output. A CSR file will not be created, but you can copy the CSR information from theconsole output and paste the information into a text file.

This example generates a certificate signing request:Server# scope certificateServer /certificate # generate-csrCommon Name (CN): test.example.comOrganization Name (O): Example, Inc.Organization Unit (OU): Test DepartmentLocality (L): San JoseStateName (S): CACountry Code (CC): USEmail: [email protected] to generate CSR?[y|N]y

-----BEGIN CERTIFICATE REQUEST-----MIIB/zCCAWgCAQAwgZkxCzAJBgNVBAYTAlVTMQswCQYDVQQIEwJDQTEVMBMGA1UEBxMMU2FuIEpvc2UsIENBMRUwEwYDVQQKEwxFeGFtcGxlIEluYy4xEzARBgNVBAsT

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)44 OL-21105-01

Managing CertificatesGenerating a Certificate Signing Request

Page 55: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

ClRlc3QgR3JvdXAxGTAXBgNVBAMTEHRlc3QuZXhhbXBsZS5jb20xHzAdBgkqhkiG9w0BCQEWEHVzZXJAZXhhbXBsZS5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMZw4nTepNIDhVzb0j7Z2Je4xAG56zmSHRMQeOGHemdh66u2/XAoLx7YCcYUZgAMivyCsKgb/6CjQtsofvzxmC/eAehuK3/SINv7wd6Vv2pBt6ZpXgD4VBNKONDlGMbkPayVlQjbG4MD2dx2+H8EH3LMtdZrgKvPxPTE+bF5wZVNAgMBAAGgJTAjBgkqhkiG9w0BCQcxFhMUQSBjaGFsbGVuZ2UgcGFzc3dvcmQwDQYJKoZIhvcNAQEFBQADgYEAG61CaJoJaVMhzCl903O6Mg51zq1zXcz75+VFj2I6rH9asckCld3mkOVx5gJUPtt5CVQpNgNLdvbDPSsXretysOhqHmp9+CLv8FDuy1CDYfuaLtvlWvfhevskV0j6mK3Ku+YiORnv6DhxrOoqau8r/hyI/L43l7IPN1HhOi3oha4=-----END CERTIFICATE REQUEST-----

Copy everything from "-----BEGIN ..." to "END CERTIFICATE REQUEST-----",paste to a file, send to your chosen CA for signing,and finally upload the signed certificate via upload command.

---OR---Continue to self sign CSR and overwrite the current certificate?All HTTPS and SSH sessions will be disconnected. [y|N]N

What to Do Next

Perform one of the following tasks:

• If you do not want to obtain a certificate from a public certificate authority, and if your organizationdoes not operate its own certificate authority, you can allow CIMC to internally generate a self-signedcertificate from the CSR and upload it immediately to the server. Type y after the final prompt in theexample to perform this action.

• If your organization operates its own certificate server for generating self-signed certificates, copy thecommand output from "-----BEGIN ..." to "END CERTIFICATE REQUEST-----" and paste to a filenamed csr.txt. Input the CSR file to your certificate server to generate a self-signed certificate.

• If you will obtain a certificate from a public certificate authority, copy the command output from"-----BEGIN ..." to "END CERTIFICATE REQUEST-----" and paste to a file named csr.txt. Submit theCSR file to the certificate authority to obtain a signed certificate.

If you did not use the first option, in which CIMC internally generates and uploads a self-signed certificate,you must upload the new certificate using the upload command in certificate command mode.

Creating a Self-Signed CertificateAs an alternative to using a public Certificate Authority (CA) to generate and sign a server certificate, youcan operate your own CA and sign your own certificates. This section shows commands for creating a CAand generating a server certificate using the OpenSSL certificate server running on Linux. For detailedinformation about OpenSSL, see http://www.openssl.org.

These commands are to be entered on a Linux server with the OpenSSL package, not in the CIMC CLI.Note

Before You Begin

Obtain and install a certificate server software package on a server within your organization.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 45

Managing CertificatesCreating a Self-Signed Certificate

Page 56: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Procedure

PurposeCommand or Action

This command generates an RSA private key that willbe used by the CA.

To allow the CA to access the key without userinput, do not use the -des3 option for thiscommand.

Note

openssl genrsa -out CA_keyfilenamekeysize

Example:# openssl genrsa -out ca.key 1024

Step 1

The specified file name contains an RSA key of thespecified key size.

This command generates a new self-signed certificatefor the CA using the specified key. The certificate is

openssl req -new -x509 -days numdays-keyCA_keyfilename -outCA_certfilename

Step 2

valid for the specified period. The command promptsthe user for additional certificate information.Example:

# openssl req -new -x509 -days 365-key ca.key -out ca.crt The certificate server is an active CA.

This command adds a line to the OpenSSL configurationfile to designate the certificate as a server-only

echo "nsCertType = server" >openssl.conf

Step 3

certificate. This designation is a defense against aExample:# echo "nsCertType = server" >openssl.conf

man-in-the-middle attack, in which an authorized clientattempts to impersonate the server.

The OpenSSL configuration file openssl.conf containsthe statement "nsCertType = server".

This command directs the CA to use your CSR file togenerate a server certificate.

openssl x509 -req -days numdays -inCSR_filename -CA CA_certfilename

Step 4

-set_serial 04 -CAkey CA_keyfilename Your server certificate is contained in the output file.-out server_certfilename -extfileopenssl.conf

Example:# openssl x509 -req -days 365 -incsr.txt -CA ca.crt -set_serial 04-CAkey ca.key -out myserver05.crt-extfile openssl.conf

This example shows how to create a CA and to generate a server certificate signed by the new CA. Thesecommands are entered on a Linux server running OpenSSL.

# /usr/bin/openssl genrsa -out ca.key 1024Generating RSA private key, 1024 bit long modulus.............++++++.....++++++e is 65537 (0x10001)# /usr/bin/openssl req -new -x509 -days 365 -key ca.key -out ca.crtYou are about to be asked to enter information that will be incorporatedinto your certificate request.What you are about to enter is what is called a Distinguished Name or aDN.There are quite a few fields but you can leave some blankFor some fields there will be a default value,

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)46 OL-21105-01

Managing CertificatesCreating a Self-Signed Certificate

Page 57: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

If you enter '.', the field will be left blank.-----Country Name (2 letter code) [GB]:USState or Province Name (full name) [Berkshire]:CaliforniaLocality Name (eg, city) [Newbury]:San JoseOrganization Name (eg, company) [My Company Ltd]:Example IncorporatedOrganizational Unit Name (eg, section) []:Unit ACommon Name (eg, your name or your server's hostname) []:example.comEmail Address []:[email protected]# echo "nsCertType = server" > openssl.conf# /usr/bin/openssl x509 -req -days 365 -in csr.txt -CA ca.crt -set_serial 01 -CAkey ca.key -out server.crt-extfile openssl.confSignature oksubject=/C=US/ST=California/L=San Jose/O=Example Inc./OU=UnitA/CN=example.com/[email protected] CA Private Key#

What to Do Next

Upload the new certificate to the CIMC.

Uploading a Server CertificateBefore You Begin

You must log in as a user with admin privileges to upload a certificate.

The certificate to be uploaded must be available as readable text. During the upload procedure, you will copythe certificate text and paste it into the CLI.

You must first generate a CSR using the CIMC certificate management CSR generation procedure, andyou must use that CSR to obtain the certificate for uploading. Do not upload a certificate that was notobtained by this method.

Note

All current HTTPS and SSH sessions are disconnected when the new server certificate is uploaded.Note

Procedure

PurposeCommand or Action

Enters the certificate command mode.Server# scope certificateStep 1

Launches a dialog for entering and uploading thenew server certificate.

Server /certificate # uploadStep 2

Copy the certificate text, paste it into the console when prompted, and type CTRL+D to upload the certificate.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 47

Managing CertificatesUploading a Server Certificate

Page 58: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

This example uploads a new certificate to the server:Server# scope certificateServer /certificate # uploadPlease paste your certificate here, when finished, press CTRL+D.-----BEGIN CERTIFICATE-----MIIB/zCCAWgCAQAwgZkxCzAJBgNVBAYTAlVTMQswCQYDVQQIEwJDQTEVMBMGA1UEBxMMU2FuIEpvc2UsIENBMRUwEwYDVQQKEwxFeGFtcGxlIEluYy4xEzARBgNVBAsTClRlc3QgR3JvdXAxGTAXBgNVBAMTEHRlc3QuZXhhbXBsZS5jb20xHzAdBgkqhkiG9w0BCQEWEHVzZXJAZXhhbXBsZS5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMZw4nTepNIDhVzb0j7Z2Je4xAG56zmSHRMQeOGHemdh66u2/XAoLx7YCcYUZgAMivyCsKgb/6CjQtsofvzxmC/eAehuK3/SINv7wd6Vv2pBt6ZpXgD4VBNKONDlGMbkPayVlQjbG4MD2dx2+H8EH3LMtdZrgKvPxPTE+bF5wZVNAgMBAAGgJTAjBgkqhkiG9w0BCQcxFhMUQSBjaGFsbGVuZ2UgcGFzc3dvcmQwDQYJKoZIhvcNAQEFBQADgYEAG61CaJoJaVMhzCl903O6Mg51zq1zXcz75+VFj2I6rH9asckCld3mkOVx5gJUPtt5CVQpNgNLdvbDPSsXretysOhqHmp9+CLv8FDuy1CDYfuaLtvlWvfhevskV0j6mK3Ku+YiORnv6DhxrOoqau8r/hyI/L43l7IPN1HhOi3oha4=-----END CERTIFICATE-----<CTRL+D>

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)48 OL-21105-01

Managing CertificatesUploading a Server Certificate

Page 59: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

C H A P T E R 10Configuring Platform Event Filters

This chapter includes the following sections:

• Platform Event Filters, page 49

• Enabling Platform Event Alerts, page 49

• Disabling Platform Event Alerts, page 50

• Configuring Platform Event Filters, page 50

• Configuring SNMP Trap Settings, page 52

Platform Event FiltersA platform event filter (PEF) can trigger an action and generate an alert when a critical hardware-related eventoccurs. For each PEF, you can choose the action to be taken (or take no action) when a platform event occurs.You can also choose to generate and send an alert when a platform event occurs. Alerts are sent as an SNMPtrap, so you must configure an SNMP trap destination before the alerts can be sent.

You can globally enable or disable the generation of platform event alerts. When disabled, alerts are not senteven if PEFs are configured to send them.

Enabling Platform Event AlertsProcedure

PurposeCommand or Action

Enters the fault command mode.Server# scope faultStep 1

Enables platform event alerts.Server /fault # setplatform-event-enabled yes

Step 2

Commits the transaction to the systemconfiguration.

Server /fault # commitStep 3

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 49

Page 60: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

PurposeCommand or Action

(Optional) Displays the platform event alertconfiguration.

Server /fault # show [detail]Step 4

The following example enables platform event alerts:Server# scope faultServer /fault # set platform-event-enabled yesServer /fault *# commitServer /fault # showSNMP Community String Platform Event Enabled--------------------- -----------------------public yes

Server /fault #

Disabling Platform Event AlertsProcedure

PurposeCommand or Action

Enters the fault command mode.Server# scope faultStep 1

Disables platform event alerts.Server /fault # setplatform-event-enabled no

Step 2

Commits the transaction to the systemconfiguration.

Server /fault # commitStep 3

(Optional) Displays the platform event alertconfiguration.

Server /fault # show [detail]Step 4

The following example disables platform event alerts:Server# scope faultServer /fault # set platform-event-enabled noServer /fault *# commitServer /fault # showSNMP Community String Platform Event Enabled--------------------- -----------------------public no

Server /fault #

Configuring Platform Event FiltersYou can configure actions and alerts for the following platform event filters:

Platform Event FilterID

Temperature Critical Assert Filter1

Temperature Warning Assert Filter2

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)50 OL-21105-01

Configuring Platform Event FiltersDisabling Platform Event Alerts

Page 61: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Platform Event FilterID

Voltage Critical Assert Filter3

Voltage Warning Assert Filter4

Current Assert Filter5

Fan Critical Assert Filter6

Fan Warning Assert Filter7

Processor Assert Filter8

Power Supply Critical Assert Filter9

Power Supply Warning Assert Filter10

Power Supply Redundancy Lost Filter11

Discrete Power Supply Assert Filter12

Memory Assert Filter13

Drive Slot Assert Filter14

Procedure

PurposeCommand or Action

Enters the fault command mode.Server# scope faultStep 1

Enters the platform event filter command mode for thespecified event.

Server /fault # scope pef idStep 2

See the Platform Event Filter table for event ID numbers.

Selects the desired system action when this event occurs. Theaction can be one of the following:

Server /fault/pef # set action{none | reboot | power-cycle |power-off}

Step 3

• none—An alert is sent but no other action is taken.

• reboot—An alert is sent and the server is rebooted.

• power-cycle—An alert is sent and the server is powercycled.

• power-off—An alert is sent and the server is poweredoff.

Enables or disables the sending of a platform event alert forthis event.

Server /fault/pef # setsend-alert {yes | no}

Step 4

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 51

Configuring Platform Event FiltersConfiguring Platform Event Filters

Page 62: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

PurposeCommand or Action

For an alert to be sent, the filter trap settings must beconfigured properly and platform event alerts mustbe enabled.

Note

Commits the transaction to the system configuration.Server /fault/pef # commitStep 5

This example configures the platform event alert for an event:Server# scope faultServer /fault # scope pef 13Server /fault/pef # set action rebootServer /fault/pef *# set send-alert yesServer /fault/pef *# commitServer /fault/pef # showPlatform Event Filter Event Action Send Alert--------------------- --------------------------- ----------- ------------------13 Memory Assert Filter reboot yes

Server /fault/pef #

What to Do Next

If you configure any PEFs to send an alert, complete the following tasks:

• Enable platform event alerts

• Configure SNMP trap settings

Configuring SNMP Trap SettingsProcedure

PurposeCommand or Action

Enters the fault command mode.Server# scope faultStep 1

Enter the name of the SNMP community to whichtrap information should be sent.

Server /fault # set community-strstring

Step 2

Enters the SNMP trap destination command modefor the specified destination. Four SNMP trap

Server /fault # scope trap-destinationnumber

Step 3

destinations are available. The destination number isan integer between 1 and 4.

Enables or disables the SNMP trap destination.Server /fault/trap-destination # setenabled {yes | no}

Step 4

Specifies the destination IP address to which SNMPtrap information is sent.

Server /fault/trap-destination # set addrip-address

Step 5

Commits the transaction to the system configuration.Server /fault/trap-destination # commitStep 6

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)52 OL-21105-01

Configuring Platform Event FiltersConfiguring SNMP Trap Settings

Page 63: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

This example configures the SNMP trap destination:Server# scope faultServer /fault # set community-str publicServer /fault *# scope trap-destination 1Server /fault/trap-destination # set enabled yesServer /fault/trap-destination *# set addr 10.20.30.41Server /fault/trap-destination *# commitServer /fault/trap-destination # showTrap Destination IP Address Enabled---------------- ---------------- --------1 10.20.30.41 yes

Server /fault/trap-destination #

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 53

Configuring Platform Event FiltersConfiguring SNMP Trap Settings

Page 64: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)54 OL-21105-01

Configuring Platform Event FiltersConfiguring SNMP Trap Settings

Page 65: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

C H A P T E R 11CIMC Firmware Management

This chapter includes the following sections:

• Overview of Firmware, page 55

• Obtaining CIMC Firmware from Cisco, page 56

• Installing CIMC Firmware from the TFTP Server, page 56

• Activating Installed Firmware, page 57

Overview of FirmwareC-Series servers use firmware obtained from and certified by Cisco to upgrade firmware on the server. Afteryou have obtained a firmware image from Cisco, you can use it to update the firmware on your server. Ciscoalso provides release notes with each image, which you can obtain from the same website from which youobtained the image.

When you update the firmware, you can either upgrade an older firmware version to a newer one, ordowngrade a newer firmware version to an older one.

Note

The CIMC separates the firmware update process into stages to ensure that you can install the firmware to acomponent while the server is running without affecting its uptime. Because you do not need to reboot theserver until after you activate, you can perform that task overnight or during other maintenance periods.Whenyou update firmware, the following stages occur:

Install

During this stage, the CIMC transfers the selected firmware version to the server. The install process alwaysoverwrites the firmware in the non-active slot on the server. You can install the firmware using either of thefollowing methods:

• Through a browser client—this method allows you to browse for a firmware image on your computerand install it on the server.

• From a TFTP server—this method allows you to install a firmware image residing on a TFTP server.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 55

Page 66: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Activate

During this stage, the CIMC sets the non-active firmware version as active and reboots the server. When theserver reboots, the non-active slot becomes the active slot, and the active slot becomes the non-active slot.The firmware in the new active slot becomes the running version.

Obtaining CIMC Firmware from CiscoProcedure

Step 1 In a web browser, navigate to the web link provided by Cisco to obtain firmware images for your server.Step 2 Select one or more firmware images and copy them to a network server.Step 3 Read the release notes provided with the image or images.

What to Do Next

Install the CIMC firmware on the server.

Installing CIMC Firmware from the TFTP ServerBefore You Begin

Obtain the CIMC firmware from Cisco and store the file on a local TFTP server.

If you start an update while an update is already in process, both updates will fail.Note

Procedure

PurposeCommand or Action

Enters the CIMC command mode.Server# scope cimcStep 1

Enters the CIMC firmware command mode.Server /cimc # scope firmwareStep 2

Starts the firmware update. The server will obtainthe update firmware at the specified path and file

Server /cimc/firmware # updatetftp-ip-address path-and-filename

Step 3

name from the TFTP server at the specified IPaddress.

Displays the progress of the firmware update.(Optional) Server /cimc/firmware # showdetail

Step 4

This example updates the firmware:Server# scope cimcServer /cimc # scope firmwareServer /cimc/firmware # update 10.20.34.56 /user/updates/filename

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)56 OL-21105-01

CIMC Firmware ManagementObtaining CIMC Firmware from Cisco

Page 67: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

What to Do Next

Activate the new firmware.

Activating Installed FirmwareBefore You Begin

Install the CIMC firmware on the server.

If you start an activation while an update is in process, the activation will fail.Note

Procedure

PurposeCommand or Action

Enters the CIMC command mode.Server# scope cimcStep 1

Enters the firmware command mode.Server /cimc # scope firmwareStep 2

Displays the available firmware images and status.Server /cimc/firmware # show [detail]Step 3

Activates the selected image. If no image numberis specified, the server activates the currentlyinactive image.

Server /cimc/firmware # activate [1 |2]

Step 4

This example activates firmware image 1:Server# scope cimcServer /cimc # scope firmwareServer /cimc/firmware # show detailFirmware Image Information:

Update Stage: NONEUpdate Progress: 100Current FW Version: 1.0(0.74)FW Image 1 Version: 1.0(0.66a)FW Image 1 State: BACKUP INACTIVATEDFW Image 2 Version: 1.0(0.74)FW Image 2 State: RUNNING ACTIVATED

Server /cimc/firmware # activate 1

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 57

CIMC Firmware ManagementActivating Installed Firmware

Page 68: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)58 OL-21105-01

CIMC Firmware ManagementActivating Installed Firmware

Page 69: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

C H A P T E R 12Viewing Logs

This chapter includes the following sections:

• CIMC Log, page 59

• System Event Log, page 60

CIMC Log

Viewing the CIMC Log

Procedure

PurposeCommand or Action

Enters the CIMC command mode.Server# scope cimcStep 1

Enters the CIMC log command mode.Server /cimc # scope logStep 2

Displays CIMC events, including timestamp, thesoftware module that logged the event, and adescription of the event.

Server /cimc/log # show entries[detail]

Step 3

This example displays the log of CIMC events:Server# scope cimcServer /cimc # scope logServer /cimc/log # show entriesTime Source Description------------------- ---------------- ----------------------------------------1970 Jan 4 18:55:36 BMC:kernel:-<7>/build/trunk/bmc/drivers/pilot2_i2c/pilot2_i2c.c:306:I2c Controller-4 DAT is stuck-low,issuing One Clock Pulse.1970 Jan 4 18:55:36 BMC:kernel:-<7>/build/trunk/bmc/drivers/pilot2_i2c/pilot2_i2c.c:301:I2c Controller-4 Loop:[0].1970 Jan 4 18:55:36 BMC:kernel:- "<7>/build/trunk/bmc/drivers/pilot2_i2c/pilot2_i2c.c:422: Controller-4 has a stuck bus,attempting to clear it now... "1970 Jan 4 18:55:36 BMC:kernel:- "

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 59

Page 70: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

<7>/build/trunk/bmc/drivers/pilot2_i2c/pilot2_i2c.c:402: Controller-4 Initiating I2c recoverysequence. "1970 Jan 4 18:55:36 BMC:IPMI:480 last message repeated 22 times1970 Jan 4 18:55:28 BMC:IPMI:480 " mcddI2CDrv.c:850:PI2CWriteRead: ioctl to driverfailed to read Bus[f4].Dev[5e]! ErrorStatus[77] "1970 Jan 4 18:55:33 BMC:IPMI:486 last message repeated 17 times1970 Jan 4 18:55:28 BMC:IPMI:486 " mcddI2CDrv.c:850:PI2CWriteRead: ioctl to driverfailed to read Bus[f4].Dev[b0]! ErrorStatus[77] "1970 Jan 4 18:55:31 BMC:IPMI:486 last message repeated 17 times1970 Jan 4 18:55:26 BMC:IPMI:486 " mcddI2CDrv.c:850:PI2CWriteRead: ioctl to driverfailed to read Bus[f4].Dev[b2]! ErrorStatus[77] "1970 Jan 4 18:55:26 BMC:kernel:-<7>/build/trunk/bmc/drivers/pilot2_i2c/pilot2_i2c.c:306:I2c Controller-4 DAT is stuck-low,issuing One Clock Pulse.1970 Jan 4 18:55:26 BMC:kernel:-<7>/build/trunk/bmc/drivers/pilot2_i2c/pilot2_i2c.c:301:I2c Controller-4 Loop:[8].--More--

Clearing the CIMC Log

Procedure

PurposeCommand or Action

Enters the CIMC command mode.Server# scope cimcStep 1

Enters the CIMC log command mode.Server /cimc # scope logStep 2

Clears the CIMC log.Server /cimc/log # clearStep 3

The following example clears the log of CIMC events:Server# scope cimcServer /cimc # scope logServer /cimc/log # clear

System Event Log

Viewing the System Event Log

Procedure

PurposeCommand or Action

Enters the system event log (SEL) command mode.Server# scope selStep 1

For system events, displays timestamp, the severity of theevent, and a description of the event. The detail keyword

Server /sel # show entries[detail]

Step 2

displays the information in a list format instead of a tableformat.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)60 OL-21105-01

Clearing the CIMC LogSystem Event Log

Page 71: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

This example displays the sysem event log:Server# scope selServer /sel # show entriesTime Severity Description------------------- ------------- ----------------------------------------[System Boot] Informational " LED_PSU_STATUS: Platform sensor, OFF event was asserted"

[System Boot] Informational " LED_HLTH_STATUS: Platform sensor, GREEN was asserted"[System Boot] Normal " PSU_REDUNDANCY: PS Redundancy sensor, Fully Redundantwas asserted"[System Boot] Normal " PSU2 PSU2_STATUS: Power Supply sensor for PSU2, PowerSupply input lost (AC/DC) was deasserted"[System Boot] Informational " LED_PSU_STATUS: Platform sensor, ON event was asserted"

[System Boot] Informational " LED_HLTH_STATUS: Platform sensor, AMBER was asserted"[System Boot] Critical " PSU_REDUNDANCY: PS Redundancy sensor, Redundancy Lostwas asserted"[System Boot] Critical " PSU2 PSU2_STATUS: Power Supply sensor for PSU2, PowerSupply input lost (AC/DC) was asserted"[System Boot] Normal " HDD_01_STATUS: Drive Slot sensor, Drive Presence wasasserted"[System Boot] Critical " HDD_01_STATUS: Drive Slot sensor, Drive Presence wasdeasserted"[System Boot] Informational " DDR3_P2_D1_INFO: Memory sensor, OFF event was asserted"

2001-01-01 08:30:16 Warning " PSU2 PSU2_VOUT: Voltage sensor for PSU2, failure eventwas deasserted"2001-01-01 08:30:16 Critical " PSU2 PSU2_VOUT: Voltage sensor for PSU2, non-recoverableevent was deasserted"2001-01-01 08:30:15 Informational " LED_PSU_STATUS: Platform sensor, ON event was asserted"

2001-01-01 08:30:15 Informational " LED_HLTH_STATUS: Platform sensor, AMBER was asserted"2001-01-01 08:30:15 Informational " LED_HLTH_STATUS: Platform sensor, FAST BLINK event wasasserted"2001-01-01 08:30:14 Non-Recoverable " PSU2 PSU2_VOUT: Voltage sensor for PSU2, non-recoverableevent was asserted"2001-01-01 08:30:14 Critical " PSU2 PSU2_VOUT: Voltage sensor for PSU2, failure eventwas asserted"--More--

Clearing the System Event Log

Procedure

PurposeCommand or Action

Enters the system event log command mode.Server# scope selStep 1

You are prompted to confirm the action. If you enter y atthe prompt, the system event log is cleared.

Server /sel # clearStep 2

This example clears the system event log:Server# scope selServer /sel # clearThis operation will clear the whole sel.Continue?[y|N]y

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 61

Clearing the System Event LogSystem Event Log

Page 72: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)62 OL-21105-01

Clearing the System Event LogSystem Event Log

Page 73: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

C H A P T E R 13Server Utilities

This chapter includes the following sections:

• Exporting Technical Support Data, page 63

• Resetting the CIMC to Factory Defaults, page 64

• Rebooting the CIMC, page 64

Exporting Technical Support DataPerform this task when requested by the Cisco Technical Assistance Center (TAC). This utility creates asummary report containing configuration information, logs and diagnostic data that will help TAC introubleshooting and resolving a technical issue.

Procedure

PurposeCommand or Action

Enters the CIMC command mode.Server# scope cimcStep 1

Enters the tech-support command mode.Server /cimc # scope tech-supportStep 2

Specifies the IP address of the TFTP server on whichthe support data file should be stored.

Server /cimc/tech-support # settftp-ip ip-address

Step 3

Specifies the file name in which the support datashould be stored on the server. When you enter this

Server /cimc/tech-support # set pathpath/filename

Step 4

name, include the relative path for the file from thetop of the TFTP tree to the desired location.

Commits the transaction to the system configuration.Server /cimc/tech-support # commitStep 5

Begins the transfer of the support data file to the TFTPserver.

Server /cimc/tech-support # startStep 6

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 63

Page 74: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

PurposeCommand or Action

(Optional) Cancels the transfer of the support data fileto the TFTP server.

Server /cimc/tech-support # cancelStep 7

This example creates a support data file and transfers the file to a TFTP server:Server# scope cimcServer /cimc # scope tech-supportServer /cimc/tech-support # set tftp-ip 10.20.30.41Server /cimc/tech-support *# set path /user/user1/supportfileServer /cimc/tech-support *# commitServer /cimc/tech-support # start

What to Do Next

Provide the generated report file to Cisco TAC.

Resetting the CIMC to Factory DefaultsOn rare occasions, such as an issue with the current running firmware, troubleshooting a server may requireyou to reset the CIMC to the factory default. When this happens, all user-configurable settings are reset.

This procedure is not part of the normal server maintenance. After you reset the CIMC, you are logged offand must log in again. You may also lose connectivity and may need to reconfigure the network settings.

Procedure

PurposeCommand or Action

Enters the CIMC command mode.Server# scope cimcStep 1

After a prompt to confirm, the CIMC resets tofactory defaults.

Server /cimc # factory-defaultStep 2

This example resets the CIMC to factory defaults:Server# scope cimcServer /cimc # factory-defaultThis operation will reset the BMC configuration to factory default.All your configuration will be lost.Continue?[y|N]

Rebooting the CIMCOn rare occasions, such as an issue with the current running firmware, troubleshooting a server may requireyou to reboot the CIMC. This procedure is not part of the normal maintenance of a server. After you rebootthe CIMC, you are logged off and the CIMC will be unavailable for a few minutes.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)64 OL-21105-01

Server UtilitiesResetting the CIMC to Factory Defaults

Page 75: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Procedure

PurposeCommand or Action

Enters the CIMC command mode.Server# scope cimcStep 1

The CIMC reboots.Server /cimc # rebootStep 2

This example reboots the CIMC:Server# scope cimcServer /cimc # reboot

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 65

Server UtilitiesRebooting the CIMC

Page 76: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)66 OL-21105-01

Server UtilitiesRebooting the CIMC

Page 77: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

I N D E X

A

active directory 28Active Directory 26

C

certificate managementuploading a certificate 47

CIMCclearing log 60firmware

about 55activating 57installing from TFTP server 56obtaining from Cisco 56

resetting to factory defaults 64viewing log 59

CIMC CLI 3CIMC overview 1common properties 33communication services properties

HTTP properties 39IPMI over LAN properties 41SSH properties 40

CPU properties 11

D

disabling KVM 20

E

enabling KVM 19, 21encrypting virtual media 22event filters, platform

about 49configuring 50

event log, systemclearing 61viewing 60

eventsplatform

disabling alerts 50enabling alerts 49

F

fan sensors 16firmware

about 55activating 57installing from TFTP server 56obtaining from Cisco 56

floppy disk emulation 22

H

HTTP properties 39

I

IP blocking 36IPMI over LAN 41IPMI over LAN properties 41IPv4 properties 33

K

KVMconfiguring 21disabling 20enabling 19, 21

KVM console 19

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 IN-1

Page 78: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

L

local users 25

M

memory properties 12

N

network propertiescommon properties 33IPv4 properties 33NIC properties 32VLAN properties 35

network security 36NIC properties 32

P

platform event filtersabout 49configuring 50

Platform eventsdiabling alerts 50enabling alerts 49

power cycling the server 9power supply properties 12power supply sensors 15powering off the server 9powering on the server 8

R

remote presenceconfiguring serial over LAN 23launching serial over LAN 24virtual KVM 19, 20, 21virtual media 22

resetting the boot order 8resetting the server 10

S

self-signed certificate 45sensors

fan 16power supply 15

sensors (continued)temperature 16voltage 17

serial over LAN 22, 23, 24configuring 23launching 24

server managementpower cycling the server 9powering off the server 9powering on the server 8resetting the boot order 8resetting the server 10shutting down the server 10toggling the locator LED 7

server NIC 31server overview 1shutting down the server 10SNMP trap configuration 52SSH properties 40storage properties 13system event log

clearing 61viewing 60

T

technical support data, exporting 63temperature sensors 16toggling the locator LED 7

U

uploading a server certificate 47user management

active directory 28local users 25terminating user sessions 30viewing user sessions 29

user sessionsterminating 30viewing 29

V

virtual KVM 19, 20, 21virtual media 22VLAN properties 35voltage sensors 17

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)IN-2 OL-21105-01

Index

Page 79: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Y YAML 5

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) OL-21105-01 IN-3

Index

Page 80: Cisco UCS C-Series Servers Integrated Management ...€¦ · Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1) Americas Headquarters

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.0(1)IN-4 OL-21105-01

Index