NEC Express5800/R110d-1E User's Manual

Front Cover

NEC

Command Line Interface

Document Rev.1.08

NEC ESMPRO Manager Ver.5 Command Line Interface

Contents

Front Cover ....................................................................................................................................................... 1

Contents............................................................................................................................................................. 2

Trademarks ...................................................................................................................................................... 5

About This Document ....................................................................................................................................... 6

Chapter1

About Command Line Interface .................................................................................................... 7

1.1

System Requirements ........................................................................................................................ 7

1.2

How to Execute Commands .............................................................................................................. 8

1.2.1

Notes on Entering Commands ............................................................................................... 8

1.3

Execution Results .............................................................................................................................. 9

1.4

Example............................................................................................................................................. 9

1.5

Executing Command from Two or More Manager Server ................................................................ 9

Chapter2

Command Summary.................................................................................................................... 10

2.1

Group management Commands ...................................................................................................... 10

2.1.1

getList .................................................................................................................................. 10

2.1.2

createGroup ......................................................................................................................... 12

2.1.3

deleteGroup ......................................................................................................................... 12

2.1.4

moveGroup .......................................................................................................................... 12

2.1.5

setGroupProperty................................................................................................................. 13

2.1.6

getGroupProperty ................................................................................................................ 13

2.1.7

getGroupStatus .................................................................................................................... 14

2.1.8

groupPowerOn..................................................................................................................... 14

2.1.9

groupPowerOff .................................................................................................................... 15

2.1.10

groupReset........................................................................................................................... 16

2.1.11

groupPowerCycle ................................................................................................................ 17

2.1.12

groupShutdownOs ............................................................................................................... 18

2.1.13

groupSetPowerRestoreDelay............................................................................................... 19

2.1.14

getGroupRemoteKvmLicense ............................................................................................. 20

2.2

Component Management Commands.............................................................................................. 21

2.2.1

getServerList........................................................................................................................ 21

2.2.2

getServerNameByMacAddr ................................................................................................ 22

2.2.3

getServerNameByGuid........................................................................................................ 22

2.2.4

findNewServer..................................................................................................................... 23

2.2.5

findNewServerNetAddr....................................................................................................... 24

2.2.6

createServer ......................................................................................................................... 24

2.2.7

deleteServer ......................................................................................................................... 25

2.2.8

checkConnection ................................................................................................................. 25

2.2.9

setServerProperty................................................................................................................. 26

2.2.10

moveServer.......................................................................................................................... 27

2.2.11

getServerGroup.................................................................................................................... 28

2.2.12

setCurrentPort...................................................................................................................... 28

2.2.13

getServerProperty ................................................................................................................ 28

2.2.14

getServerInfo ....................................................................................................................... 29

2.2.15

getDeviceId.......................................................................................................................... 31

2.2.16

getGuid ................................................................................................................................ 31

2.2.17

getProductName .................................................................................................................. 31

2.2.18

getSoftwareInfo ................................................................................................................... 32

2.2.19

setShutdownPolicy .............................................................................................................. 32

2.2.20

getShutdownPolicy.............................................................................................................. 34

2.2.21

setPowerRestoreDelay......................................................................................................... 34

2.2.22

getPowerRestoreDelay ........................................................................................................ 35

2.2.23

setBmcInfo .......................................................................................................................... 35

2.2.24

getBmcInfo.......................................................................................................................... 42

2


2.2.25

setAuthKey.......................................................................................................................... 44

2.2.26

setSensorLevel..................................................................................................................... 44

2.2.27

getSensorLevel .................................................................................................................... 46

2.2.28

getAgentExtensionLog ........................................................................................................ 48

2.2.29

testAlert ............................................................................................................................... 48

2.2.30

getTestAlertStatus................................................................................................................ 49

2.2.31

getServerStatus .................................................................................................................... 49

2.2.32

getPowerStatus .................................................................................................................... 50

2.2.33

getStatusLamp ..................................................................................................................... 50

2.2.34

getPanelInfo......................................................................................................................... 51

2.2.35

powerOn .............................................................................................................................. 52

2.2.36

powerOff.............................................................................................................................. 52

2.2.37

reset ..................................................................................................................................... 53

2.2.38

powerCycle.......................................................................................................................... 54

2.2.39

shutdownOs ......................................................................................................................... 55

2.2.40

dumpSwitch......................................................................................................................... 55

2.2.41

clearSel ................................................................................................................................ 56

2.2.42

identifyChassis .................................................................................................................... 56

2.2.43

getIpmiInfo.......................................................................................................................... 56

2.2.44

getSensorList ....................................................................................................................... 57

2.2.45

getSensorStatus.................................................................................................................... 57

2.2.46

getConsoleLog..................................................................................................................... 58

2.2.47

setBmcIpSync...................................................................................................................... 59

2.2.48

getBmcIpSync ..................................................................................................................... 59

2.2.49

getBladeSlotId ..................................................................................................................... 60

2.2.50

setBmcIpAddressLan1......................................................................................................... 60

2.2.51

setBmcIpAddressLan2......................................................................................................... 61

2.3

EM Card Management Commands ................................................................................................. 62

2.3.1

getEmCardList..................................................................................................................... 62

2.3.2

getEmActiveState ................................................................................................................ 63

2.3.3

identifyEm ........................................................................................................................... 63

2.3.4

getEmStatusLamp................................................................................................................ 64

2.4

Chassis Management Commands .................................................................................................... 65

2.4.1

getBladeEnclosureList......................................................................................................... 65

2.4.2

getChassisSlotState.............................................................................................................. 65

2.4.3

getChassisInfo ..................................................................................................................... 66

2.4.4

setChassisProperty............................................................................................................... 67

2.4.5

getChassisProperty .............................................................................................................. 67

2.4.6

setBladeAutoSetting ............................................................................................................ 68

2.4.7

getBladeAutoSetting............................................................................................................ 69

2.5

Communication Management Commands....................................................................................... 70

2.5.1

connect................................................................................................................................. 70

2.5.2

disconnect ............................................................................................................................ 70

2.5.3

getConnectionStatus ............................................................................................................ 70

2.6

Environment Setting Commands..................................................................................................... 71

2.6.1

setOption.............................................................................................................................. 71

2.6.2

getOption ............................................................................................................................. 72

2.6.3

getPermitIpAddrList............................................................................................................ 72

2.6.4

isPermitIpAddr .................................................................................................................... 73

2.6.5

addPermitIpAddr ................................................................................................................. 73

2.6.6

removePermitIpAddr ........................................................................................................... 73

2.6.7

clearPermitIpAddr ............................................................................................................... 74

2.7

User Management Commands......................................................................................................... 75

2.7.1

createUser ............................................................................................................................ 75

2.7.2

deleteUser ............................................................................................................................ 75

3


2.7.3

getUserList .......................................................................................................................... 75

2.7.4

setUserProperty ................................................................................................................... 76

2.7.5

getUserProperty ................................................................................................................... 77

2.8

Other Commands............................................................................................................................. 78

2.8.1

getApplicationLog ............................................................................................................... 78

2.8.2

about .................................................................................................................................... 78

2.8.3

help ...................................................................................................................................... 78

4


Trademarks

NEC EXPRESSBUILDER and NEC ESMPRO are registered trademarks of NEC Corporation.

Microsoft, Windows, Windows Vista, Windows Server are registered trademarks or trademarks of Microsoft

Corporation in the United States and other countries.

NetWare is a registered trademark of Novell, Inc. of the United States.

All other company, or product names used in this document are registered trademarks or trademarks of their respective trademark owners.

Windows 7 stands for Windows® 7 Professional operating system, Windows® 7 Ultimate operating system.

Windows Server 2008 stands for Windows Server® 2008 Standard operating system, Windows Server®

2008 Enterprise operating system, Windows Server® 2008 Datacenter operating system, and Windows

Server® 2008 Foundation.

Windows Vista stands for Windows Vista® Business operating system, Windows Vista® Enterprise operating system, and Windows Vista® Ultimate operating system.

Windows Server 2003 stands for Windows Server® 2003, Standard Edition operating system, Windows

Server® 2003, Enterprise Edition operating system, Windows Server® 2003, Standard x64 Edition operating system, and Windows Server® 2003, Enterprise x64 Edition operating system.

Windows Server 2003 R2 stands for Windows Server® 2003 R2, Standard Edition operating system,

Windows Server® 2003 R2, Enterprise Edition operating system, Windows Server® 2003 R2, Standard x64

Edition operating system, and Windows Server® 2003 R2, Enterprise x64 Edition operating system.

Windows XP stands for Windows® XP Professional operating system, and Windows® XP Professional x64

Edition operating system.

Windows 2000 stands for Windows® 2000 Professional operating system, Windows® 2000 Server operating system, and Windows® 2000 Advanced Server operating system.

All names used in sample applications are fictitious. They are unrelated to existing product, organization, or individual names.

 Notes

(1) No part of this document may be reproduced in any form without the prior written permission of NEC

Corporation.

(2) The contents of this document may be revised without prior notice.

(3) The contents of this document shall not be copied or altered without the prior written permission of NEC

Corporation

(4) All efforts have been made to ensure the accuracy of all information in this document. If you notice any part unclear, incorrect, or omitted in the document, contact your authorized NEC sales representative.

(5) NEC assumes no liability for damages arising from the use of this product, nor any liability for incidental or consequential damages arising from the use of this document regardless of (4)

5


About This Document

This document introduces command line interface of the component management utility "NEC ESMPRO

Manager".

Before attempting to operate the command line interface, read this document so as to gain an adequate understanding of the contents.

 Attention

This document is intended for persons who are familiar with the operating system's functions and operations and the network's functions and setup. For operations and inquiries about the operating system, see its online help information.

This document covers universal information about generally managed components. The notes and restrictions on use of each product as a managed component are explained in the user's guide provided with the managed component.

Names used with screen images in this document are fictitious. They are unrelated to existing product names, names of organizations, or individual names. The setting values on the screen images are shown as examples, so setting values such as IP addresses on screen images are not guaranteed for operation.

 About Symbols in This Document

The following explains three symbols that are used in this document:

IMPORTANT: Points that are mandatory or require attention when using the software or the

CHECK: component.

Points that are require confirmation when using the software or the component.

TIP: Helpful and convenient piece of information.

 About Font in This Document

The Italic font shows the option of command in this document.

 For other information about the NEC ESMPRO Manager

See the documents below.

NEC ESMPRO Manager Ver.5 Installation Guide

NEC ESMPRO Manager Ver.5 Setup Guide

NEC ESMPRO Manager Ver.5 Command Line Interface User's Guide for NEC ExpressUpdate

6


Chapter1 About Command Line Interface

The NEC ESMPRO Manager command line interface provides a set of commands that can control managed components through the command line from the management PC.

The set of commands covers a part of functions that can be executed by using the web browser.

CHECK:



The set of commands mainly enables to execute functions by communication with BMC or

NEC ESMPRO Agent Extension on the managed component. It does not support the functions that require NEC ESMPRO Agent on the managed component.

The following commands are available:

 Group management Commands

Use to operate a group due to operate more than one managed components through a single operation.

 Component Management Commands

Use to operate a managed component.

 EM Card Management Commands

Use to operate an EM card.

 Chassis Management Commands

Use to operate a chassis.

 Communication Management Commands

Use to change settings for connection to a managed component via modem or directly.

 Environment Setting Commands

Use to view and change the settings of NEC ESMPRO Manager.

 User Management Commands

Use to manage users who operate NEC ESMPRO Manager on web browser.

 Other Commands

1.1 System Requirements

The NEC ESMPRO Manager command line interface can be executed only on a PC (called a Manager server) that is installed the NEC ESMPRO Manager.

The NEC ESMPRO Manager command line interface requires following user level of operating system:

On Windows: Administrator

On Linux: root

CHECK:



In case of Windows Vista, Windows 7 and Windows Server 2008, you need to set the permission to access to the directory including Command Line Interface execution file

(dscli.exe). After setting the permission to access the directory, the standard user can also use Command Line Interface.

TIP:



See “NEC ESMPRO Manager Ver.5 Installation Guide” about the system requirement of

NEC ESMPRO Manager.

7


1.2 How to Execute Commands

To execute a command, enter the command following the command prompt as shown below. dscli CommandName [Option, …] dscli :

CommandName :

Indicates the NEC ESMPRO Manager command line interface command

Enter the name of the command you want to execute.

Option : Enter the option parameters defined for each command

1.2.1 Notes on Entering Commands

This section explains notes on entering commands

(1) When entering special characters:

If you input null string or special characters as option, enclose the option parameter between double quotation marks. The following shows examples:

Example1: Input null string dscli setGroupProperty MyGroup GROUP_COMMENT “”

Example 2: Input special characters dscli setServerProperty MyServer CFG_SERIAL_INIT “ATE1Q0V1X4&D2&C1S0=0”

(2) When entering MAC address:

MAC address that can be specified in “Component” of command option is the MAC address of LAN that BMC uses on the managed component. Input MAC address as hexadecimal number that is delimited to octets by a colon. The following shows an example: dscli getServerProperty 00:30:13:16:cd:fe SERVER_IP_1

(3) When entering GUID:

Input GUID as hexadecimal number that is delimited to sections by a colon. The following shows an example: dscli getServerProperty 80c03228:35d8:d711:8001:003013f10072 SERVER_IP_1

CHECK:



You can enter the command format that MAC address or GUID is specified as Server option after the “Check Connection” is performed for the server.

8


1.3 Execution Results

All the commands return the end status. If an error has occurred, they return an error message.

The end status of all the commands is as follows:

Non Zero value Error end

If a command error occurs, a non-zero value will be returned as the end status and the error message will be displayed. Some error messages are displayed followed by an error cause message

TIP:



If a command is executed with a shell script, the end status can be confirmed with

"ERRORLEVEL" for Windows and "$?" for Linux.

1.4 Example

The procedure to manage a component via LAN is as follows:

(1) Creates a new component group using createGroup command.

(2) Register a managed component using createServer command.

(3) Perform a "Check Connection" for the managed component using checkConnection command.

You can manage the managed component after "Check Connection" is completed.

1.5 Executing Command from Two or More Manager Server

As well as one component can be managed from two or more manager server, you can also execute command from two or more manager server.

IMPORTANT:



See “NEC ESMPRO Manager Ver.5 Installation Guide” about Notes.

9


Chapter2 Command Summary

2.1 Group management Commands

2.1.1 getList

Syntax: dscli getList GroupName [/g] [/x]

Description:

Displays the list of groups and components registered under the specified group.

If no appending option is specified, displays the groups and components just under the specified group.

Options:

GroupName

Specify the name of the group.

If you want to display the groups and components under root, specify “root”.

/g

/x

Display only groups.

Display the list under the specified group or its sub-groups.

Output:

Shows the example that the groups and components have following structure. root group1 <GROUP> group11 <GROUP> component11 group2 <GROUP> component1 group3 <GROUP> component111 group31 <GROUP> component311 component31 component32 group32 <GROUP> component321 component322 component2 component3

10


Displays the list of groups and components. The following shows an example.

>dscli getList root

group1 <GROUP>

group2 <GROUP>

component1

group3 <GROUP>

component2

component3

Displays the case specified “/g” option. The following shows an example.

>dscli getList root /g

group1 <GROUP>

group2 <GROUP>

group3 <GROUP>

Displays the case specified “/x” option. The following shows an example.

>dscli getList root /x root

group1 <GROUP>

group11 <GROUP>

component111

component11

group2 <GROUP>

component1

group3 <GROUP>

group31 <GROUP>

component311

component31

component32

group32 <GROUP>

component321

component322

component2

component3

Displays the case specified “/g” and “/x” option. The following shows an example.

>dscli getList root /g /x root

group1 <GROUP>

group11 <GROUP>

group2 <GROUP>

group3 <GROUP>

group31 <GROUP>

group32 <GROUP>

11


2.1.2 createGroup

Syntax: dscli createGroup GroupName [ParentGroupName]

Description:

Creates a new component group.

Options:

GroupName

Specify the group name to create. You can input up to 63 characters.

ParentGroupName

Specify the name of the parent group when the group is made under the group.

If you create a group under root, specify “root” or omit this option.

TIP:



The name of group that is already registered cannot be specified to GroupName

2.1.3 deleteGroup

Syntax: dscli deleteGroup GroupName

Description:

Deletes a specified group. All managed components and sub-groups in the group are also deleted.

Options:

GroupName

Specify the name of the group.

2.1.4 moveGroup

Syntax: dscli moveGroup GroupName [ParentGroupName]

Description:

Move the specified group. All managed components and sub-groups in the group are also moved

Options:

GroupName

Specify the name of group.

ParentGroupName

Specify the name of the parent group to move to.

If you move the group under root, specify “root” or omit this option.

12


2.1.5 setGroupProperty

Syntax: dscli setGroupProperty GroupName PropertyName Value

Description:

Sets the property of a group.

Options:

GroupName


PropertyName

Specify the name of the group property. The following is group property list:

PropertyName Contents Value

GROUP_NAME

GROUP_COMMENT

Specify the name of the group. Up to characters.

63

Default

(None)

Enter the comments of the group. Up to 255 characters.

Value

Specify a new value to be set.

TIP:



The name of group that is already registered cannot be specified to GROUP_NAME.

2.1.6 getGroupProperty

Syntax: dscli getGroupProperty GroupName PropertyName

Description:

Displays the property of a group.

Options:

GroupName


PropertyName

Specify the name of group property. For the list of group properties, see the 2.1.5 setGroupProperty

command

Output:

Display the property of a group.

13


2.1.7 getGroupStatus

Syntax: dscli getGroupStatus GroupName

Description:

Displays the status of a specified component group. Among all component condition under the group, displays the worst condition as a status of the group.

Confirms the condition of component by component monitoring function.

Options:

GroupName


Output:

Displays the status of the specified component group. There are following types of status.

ERROR Error

WARNING Warning

UNKNOWN Unknown or connection error

DC-OFF DC-OFF

NORMAL Normal

NO_MONITORING Out of monitoring

2.1.8 groupPowerOn

Syntax: dscli groupPowerOn GroupName [/p] [/exs ComponentName1 ComponentName2 ...

ComponentNameN] [/exg GroupName1 GroupName2 ... GroupNameN]

Description:

Turns on all managed components in a specified group.

The managed components in the sub-group are also controlled.

IMPORTANT:



In case that the managed component does not support a force network-boot function which boots the component from network regardless of boot order, a force network-boot function cannot be executed. See “NEC ESMPRO Manager Managed Components Summary” whether the managed component supports function.

CHECK:



This command is not executed for the PowerBay, the EM card, and the switch blade.

Options:

GroupName


If you want to control all the components under root, specify “root”.

/p

Force boot from network after the power is turned on.

14


TIPS:



See 2.2.9 setServerProperty for server properties.

/exs

When you specify “/exs” option and the component name after it, the command is not executed on the specified component. You can specify plural component names.

/exg

When you specify “/exg” option and the group name after it, the command is not executed on the component under the specified group. You can specify plural group names.

Output:

If error has occurred, the name and the error message about each error-occurred managed component is displayed.

The following shows an example.

Component1

: Connection to the server could not be made. (Timeout)

Component2

: Connection to the server could not be made. (Authentication error)

2.1.9 groupPowerOff

Syntax: dscli groupPowerOff GroupName [/exs ComponentName1 ComponentName2 ...


Description:

Forcibly turns off all managed components in a specified group.


IMPORTANT:



Since remote power control using NEC ESMPRO Manager is provided by hardware regardless of the condition of operating system on the managed component, the system may be damaged. Be careful when you perform remote power control. Reconfirm the status of the managed component before power controls.

CHECK:




Options:

GroupName



/exs


/exg


15


Output:



Component1


Component2


2.1.10 groupReset

Syntax: dscli groupReset GroupName [/p] [/exs ComponentName1 ComponentName2 ...


Description:

Forcibly resets all managed components in a specified group.


IMPORTANT:







CHECK:




Options:

GroupName



/p

Force boot from network after reset.

TIP:




/exs


/exg


16


Output:



Component1


Component2


2.1.11 groupPowerCycle

Syntax: dscli groupPowerCycle GroupName [/p] [/exs ComponentName1 ComponentName2 ...


Description:

Forcibly turns off all managed components in a specified group and then turns them on.


IMPORTANT:







CHECK:




Options:

GroupName



/p


/exs


/exg


TIP:




17


Output:



Component1


Component2


2.1.12 groupShutdownOs

Syntax: dscli groupShutdownOs GroupName [/force] [/exs ComponentName1

Description:

Shut downs operating systems on all managed components in a specified group.


This command via LAN instructs the NEC ESMPRO Agent Extension service to shutdown the operating system.

If you specify “/force” option, this command executes the forced shutdown OS function without communication to the NEC ESMPRO Agent Extension or the NEC ESMPRO Agent.

You need to specify “/force” option if the connection is via LAN or direct.

CHECK:




Options:

GroupName



/force

If you specify “/force” option, this command executes the forced shutdown OS function. This shutdown may not work depending on the kind of OS or the OS settings.

/exs


/exg


Output:



Component1

: Connection to the component could not be made. (Timeout)

Component2

: Connection to the component could not be made. (Authentication error)

18


2.1.13 groupSetPowerRestoreDelay

Syntax: dscli groupSetPowerRestoreDelay GroupName DelayTime [/x Policy] [/exs

ComponentName1 ComponentName2 ... ComponentNameN] [/exg GroupName1

GroupName2 ... GroupNameN]

Description:

Changes the power option that specifies working of managed components in a specified group when they are turned AC ON.


The power option includes AC-LINK policy and the time that delays Power ON (DC ON) when the managed component is set to be turned DC ON in time with AC ON.

IMPORTANT:



In case that the managed component does not support a setting of power restore delay, this command is invalid. See “NEC ESMPRO Manager Managed Components Summary” whether the managed component supports the function.

CHECK:




Options:

GroupName



DelayTime

Specify delay time in the range 0-600 seconds. When -1 is specified, the delay time is not changed.

/x Policy

Sets AC-Link Policy. No change is made if omitted There are 3 types of the policy.

STAY_OFF The managed component remains OFF when AC power is restored.

LAST_STATE If the managed component is OFF when AC power is lost, the managed component remains OFF when AC power is restored.

If the managed component is ON, when AC power is lost, the managed component turns ON after the delay time when AC power is restored.

POWER_ON The managed component turns ON after the delay time when AC power is restored.

/exs


/exg


Output:



Component1

19


: Connection to the component could not be made. (Timeout)

Component2

: Connection to the component could not be made. (Authentication error)

2.1.14 getGroupRemoteKvmLicense

Syntax: dscli getGroupRemoteKvmLicense GroupName

Description:

Displays the state of “Remote KVM and Media License” for each managed components in a specified group.

The managed components in the sub-group are also displayed.

Options:

GroupName



Output:

The following are states of “Remote KVM and Media License”.

Installed “Remote KVM and Media License” has been installed.

Not Installed

Unsupported

“Remote KVM and Media License” has not been installed.

“Remote KVM and Media License” is not supported for the component.

- The state of “Remote KVM and Media License” is unknown.


Component1

: Installed

Component2

: Installed

Component3

: Not Installed

Component4

: Unsupported

Component5

: -

:

:

20


2.2 Component Management Commands

2.2.1 getServerList

Syntax: dscli getServerList [/d]

Description:

Displays the name list of all managed components registered on NEC ESMPRO Manager.

Options:

/d

If you specify “/d” option, the managed components list will indicate component name, GUID and

MAC address of LAN port that BMC uses of each component. Added information below is also indicated.

EXPRESSSCOPE Engine series BMC is EXPRESSSCOPE Engine series.

BMC is Advanced Remote Management Card. indicates that the managed component is a kind of switch blade.

Output:

ARMC :

SWB :

Displays the name list of all managed components registered on NEC ESMPRO Manager. The following shows an example.

If “/d” option is not specified:

Component1

Component2

Component3

:

:

If “/d” option is specified:

Component1

GUID 02010202:0000:0000:0000:000000000000

MAC1 00:30:13:f1:00:5a

MAC2 00:30:13:f1:00:5b

EXPRESSSCOPE Engine

Component2

GUID 00301316:cdfe:0180:0010:846e8062d906

MAC1 00:30:13:16:cd:fe

SWB

Component3

GUID 00010203:0405:0607:0809:0a0b0c0d0e0f

MAC1 00:00:4c:9f:13:cb

ARMC

:

:

21


2.2.2 getServerNameByMacAddr

Syntax: dscli getServerNameByMacAddr MacAddress

Description:

Displays the name of the managed component that has the specified MAC address.

Options:

MacAddress

Specify a MAC address of LAN port that BMC uses on the managed component.

The following shows an example. dscli getServerNameByMacAddr 00:30:13:f1:00:5a

Output:

Displays the name of the managed component. The following shows an example.

Component1

2.2.3 getServerNameByGuid

Syntax: dscli getServerNameByGuid GUID

Description:

Displays the name of the managed component that has the specified GUID.

Options:

GUID

Specify a GUID.

The following shows an example. dscli getServerNameByGuid 00301316:cdfe:0180:0010:846e8062d906

Output:

Displays the name of the managed component. The following shows an example.

Component2

22


2.2.4 findNewServer

Syntax: dscli findNewServer StartIpAddr EndIpAddr

Description:

Finds BMC on managed components that are not registered on NEC ESMPRO Manager according to IP address range specification.

TIP:



To register the managed component that is found using findNewServer command or

findNewServerNetAddr command, you can use createServer command. See 2.2.6 createServer.

Options:

StartIpAddr

Specify the start address of IP address range.

EndIpAddr

Specify the end address of IP address range.

Output:

Displays the list of the found managed components. The following shows an example.

Status: SUCCESS

No.1

1st IP Address : 192.168.14.18

2nd IP Address : 0.0.0.0

Current IP Address : 192.168.14.18

IPMI Version : 1.5

GUID : 84ee20b0:84a1:d511:0080:a0ff94470300

No.2

1st IP Address : 192.168.14.19

2nd IP Address : 0.0.0.0

Current IP Address : 192.168.14.19

IPMI Version : 1.5

GUID : 00004c79:45c0:0180:0010:f57f80d8cef8

:

:

23


2.2.5 findNewServerNetAddr

Syntax: dscli findNewServerNetAddr NetAddr NetMask

Description:

Finds BMC on managed components that are not registered on NEC ESMPRO Manager according to

Network address specification.

TIP:



To register the managed component that is found using findNewComponent command or

findNewServerNetAddr command, you can use createServer command. See 2.2.6 createServer.

Options:

NetAddr

Specify network address.

NetMask

Specify network mask.

Output:

Displays the list of the found managed components same as the output by “findNewServer” command. See

2.2.4 findNewServer.

2.2.6 createServer

Syntax: dscli createServer ComponentName GroupName AuthKey [IpAddr1] [IpAddr2]

Description:

Newly registers a managed component on the NEC ESMPRO Manager.

Options:

ComponentName

Specify the name of the managed component. You can input up to 63 characters.

GroupName

Specify the name of group that the managed component belongs to.

AuthKey

Specify the authentication key that is configured on BMC. You can input up to 16 characters.

IpAddr1

Specify the IP address of the managed component's BMC. This option is omissible if you control the managed component via modem or with direct connection.

IpAddr2

Specify the extra IP address of the managed component's BMC. This option is omissible.

TIPS:



The name of component that is already registered cannot be specified to ComponentName.



The IP address that is already registered cannot be specified to IpAddr1and IpAddr2.



Set other properties using 2.2.9 setServerProperty command.

24


2.2.7 deleteServer

Syntax: dscli deleteServer Component [/force]

Description:

Deletes the specified managed component that is registered on the NEC ESMPRO Manager.

Options:

Component

Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component.

/force

When you delete the managed component that has been set schedule running, the schedule is deleted from NEC ESMPRO Agent Extension. But if the schedule deletion is failed (such as NEC ESMPRO

Agent Extension is uninstalled), the component cannot be deleted. In this case you can specify “/force” option to delete component forcibly.

2.2.8 checkConnection

Syntax: dscli checkConnection Component [/force]

Description:

Confirms connection with BMC on a managed component. This command also collects information for remote control of the managed component.

Options:

Component

Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component..

/force

Execute the command with "/force" option if the managed component is replaced.

TIP:



If NEC ESMPRO Manager Ver.5 manage NEC ESMPRO Manager Ver.4, and the “/force” option is specified, NEC ESMPRO Manager Ver.5 may connect with different component in communication with NEC ESMPRO Manager Ver.4 and BMC communication.

25


2.2.9 setServerProperty

Syntax: dscli setComponentProperty Component PropertyName Value

Description:

Sets the property of a managed component.

Options:

Component


PropertyName

Specify the name of the property. The following is property list:

PropertyName Contents Value Default

1

CONSOLE_LOG_ENABLE

CONSOLE_LOG_SIZE

CONSOLE_LOG_KEEP_CONN

ECTION enable/disable the get console log function to save the Remote

1: Enabled

Console screen data in text format.

Specify the maximum size (in KB) of the console log.

4 - 1000

Determine whether to get console log even while remote console is not open on web browser.

0: Disabled

1: Enabled

64

0

1

CONSOLE_LOG_FAULT_MESS

AGE_MONITORING

CONSOLE_LOG_FAULT_MESS

AGE_IDENTIFIER

SERVER_NAME *1

SERVER_AUTHKEY *1

SERVER_CURRENT_PORT_T

YPE

SERVER_IP_1 *1

SERVER_IP_2

SERVER_CURRENT_IP *1

SERVER_SUBNETMASK_1 *1 enable/disable the fault message monitoring function that set fault condition when a fault message string is found on head of each console log line.

1: Enabled

Specify the character string for the fault message monitoring function.

Specify the name of the managed component. characters characters.

Specify the authentication key to communicate with BMC of the characters managed component.

Specify the connection type 0: LAN between the NEC ESMPRO 1: Direct

Manager component and the 2: Modem managed component. Only LAN can be specified for the EM card.

Specify BMC IP address to communicate via LAN. format

Specify extra BMC IP address to communicate via LAN. format

Specify current BMC IP address to communicate via LAN.

Specify subnet mask of the BMC

IP address. format format

0

.255.0

26


PropertyName

SERVER_SUBNETMASK_2

SERVER_PHONE_NUMBER

Contents

Specify subnet mask of the extra

BMC IP address.

Value format

Specify the phone number to communicate via modem. characters

Default

.255.0

SERVER_ALIAS *1

Specify the alias of the managed component.

Up to 255 bytes (Same as compon ent name)

*1 The property can be also set for an EM card.

Value

Specify new value to be set.

TIPS:



The name of component that is already registered cannot be specified to SERVER_NAME.



The IP address that is already registered cannot be specified to SERVER_IP_1 and

SERVER_IP_2.



You can use moveServer command to change group that the managed component belongs to. See 2.2.10.

2.2.10 moveServer

Syntax: dscli moveServer Component GroupName

Description:

Changes the group that a managed component belongs to.

Options:

Component


GroupName

Specify the name of new group.

If you want to move the component under root, specify “root”.

27


2.2.11 getServerGroup

Syntax: dscli getServerGroup Component

Description:

Display the name of group that a managed component belongs to.

Options:

Component


Output:

Display the name of group that the managed component belongs to.

If it belongs to root, displays “root”.

2.2.12 setCurrentPort

Syntax: dscli setCurrentPort Component Connection

Description:

Changes the connection type between the NEC ESMPRO Manager component and a managed component.

Options:

Component


Connection

Specify the connection type between the NEC ESMPRO Manager component and the managed component.

LAN Connects via LAN

SERIAL Connects directly to serial port

MODEM Connects via modem

2.2.13 getServerProperty

Syntax: dscli getServerProperty Component PropertyName

Description:

Displays the specified property of a managed component.

Options:

Component


PropertyName

Specify the name of component property. For the list of component properties, see the 2.2.9

28


setServerProperty command.

Output:

Displays the specified property of a managed component.

2.2.14 getServerInfo

Syntax: dscli getComponentInfo Component

Description:

Displays the managed component information that includes main component properties.

Options:

Component


Output:

Displays the managed component information. The following information is shown:

Item Name Contents

Component Name

Alias

Group

Connection Type

BMC Control

Check Connection

BMC Current IP Address

Failover

BMC LAN1 IP Address

BMC LAN1 Subnet Mask

BMC LAN2 IP Address

BMC LAN2 Subnet Mask

Phone Number

Product Name

Serial Number

GUID

IPMI Version

Remote KVM and

Media License

Chassis Name

Slot Number

Blade Width

Name of the managed component

Alias of the managed component

Name of the group that the managed component belongs to.

Connection type between the managed component and the NEC ESMPRO

Manager component.

Display BMC management status

Enable : management is valid

Disable : managemant is invalid

Not Registered : not registered for management

Not Support : out of management (BMC is not integrated)

Display “Completed” if the Check connection has been executed.

Current BMC IP address to connect to the managed component via LAN.

Determine whether to enable/disable the Fail over function that continues communication by changing to the other IP address if communication with the current BMC IP address encounters an error.

BMC IP address to connect to the managed component via LAN.

Subnet mask of the BMC IP address

Extra BMC IP address to connect to the managed component via LAN.

Subnet mask of the extra BMC IP address

Phone number of the managed component

Product name of the managed component

Serial number of the managed component

ID for identifying the managed component

IPMI version that the managed component supports

State of "Remote KVM and Media License" of the managed component. If this managed component does not contain EXPRESSSCOPE Engine series, this

item is not shown. See 2.1.14”getGroupRemoteKvmLicense” for details.

Name of chassis in which the managed component is installed. This item is shown If the managed component is CPU blade or switch blade.

Slot number of the blade slot in which the managed component is installed.

This item is shown If the managed component is CPU blade or switch blade.

Blade width with the occupied slot count. This item is shown If the managed component is CPU blade or switch blade.

29


Blade Height

Blade Name

Blade Height with the occupied slot count. This item is shown If the managed component is CPU blade or switch blade.

Blade name. This item is shown if the managed component has the name.

30


2.2.15 getDeviceId

Syntax: dscli getDeviceId Component

Description:

Obtains management controller information of the managed component.

Options:

Component


Output:

Displays management controller information. The following shows an example.

Device ID : 20H

Device Rev. : 1

Fw Rev. : 00.08

Manufacturer ID : 119

Product ID : 2c3H

2.2.16 getGuid

Syntax: dscli getGuid Component

Description:

Obtains GUID of a managed component. GUID is ID for identifying a managed component.

Options:

Component


Output:

Displays GUID.

2.2.17 getProductName

Syntax: dscli getProductName Component

Description:

Obtains the product name and serial number of a managed component.

Options:

Component


Output:

Displays the following information.

31


ProductName product name of the managed component.

SerialNumber serial number of the managed component.

2.2.18 getSoftwareInfo

Syntax: dscli getSoftwareInfo Component

Description:

Obtains version information about NEC ESMPRO Agent Extension, operating system, BIOS and LAN driver on the managed component.

This command can be used via LAN when NEC ESMPRO Agent Extension service is running on the managed component.

Options:

Component


Output:

Displays version information. The following shows an example.

Agent Extension Version : 2.03.04

BIOS Version : 6.0.0106

OS Version : Windows 2003 Server

LAN driver Version : 5.0.2175.1

2.2.19 setShutdownPolicy

Syntax: dscli setShutdownPolicy Component KeyName Value

Description:

Changes shutdown policy of NEC ESMPRO Agent Extension on a managed component.


Options:

Component


KeyName

Specify a key name. See the list below..

Value

Specify a new value. See the list below.

KeyName Contents Value

32



SCH_ACLINK_STAYON_ENABLE Determine whether to enable/disable the function that 1: Enabled changes AC-LINK policy to ”Always Power On” when “OS shutdown” is executed through

“scheduled running”

(This setting works like as setPowerRestoreDelay command.)

* Display only. Cannot be set.

SCH_DC_OFF_DELAY

SCH_SHUTDOWN_ENABLE

SCH_SHUTDOWN_WAIT enable/disable the function that turns the managed component

1: Enabled off forcibly after shutdown OS.

If the managed component is still

DC-ON state after OS shutdown, set enable to turn it off when

NEC ESMPRO Agent Extension shutdowns its OS.

Specify delay time in minutes to turn the managed component off after shutdown OS.

This setting is effective only when

5-60

SCH_DC_OFF_ENABLE is enabled. enable/disable the function which 1: Enabled shutdowns OS when the managed component is turned on during the down period specified through “scheduled running”.

Specify delay time in seconds to - shutdown the managed component after shutdown OS command is issued.

* Display only. Cannot be set.

33


2.2.20 getShutdownPolicy

Syntax: dscli getShutdownPolicy Component

Description:

Obtains shutdown policy of NEC ESMPRO Agent Extension on a managed component.


Options:

Component


Output:

Displays shutdown policy. For details, see 2.2.19.


SCH_ACLINK_STAYON_ENABLE=0

SCH_AC_LINK=1

SCH_DC_OFF_ENABLE=1

SCH_DC_OFF_DELAY=10

SCH_SHUTDOWN_ENABLE=1

SCH_SHUTDOWN_WAIT=60

2.2.21 setPowerRestoreDelay

Syntax: dscli setPowerRestoreDelay Component DelayTime [/x Policy]

Description:

Changes the power option that specifies working of a managed component when it is turned AC ON.

The power option includes AC-LINK policy and the time that delays Power ON (DC ON) when the managed component is set to be turned DC ON in time with AC ON.

IMPORTANT:



In case that the managed component does not support a setting of power restore delay, This command is invalid. See “NEC ESMPRO Manager Managed Components Summary” whether the managed component supports the function.

Options:

Component


DelayTime

Specify delay time in the range 0-600 seconds. When -1 is specified, the delay time is not changed.

/x Policy

Sets AC-Link Policy. No change is made if omitted There are 3 types of the policy.

STAY_OFF The managed component remains OFF when AC power is restored.

34


LAST_STATE If the managed component is OFF when AC power is lost, the managed component remains OFF when AC power is restored.

If the managed component is turned AC OFF during it is in DC ON, the managed component is turned DC ON after the delay time when it is turned AC ON.

POWER_ON The managed component is turned DC ON after the delay time when it is turned AC

ON.

2.2.22 getPowerRestoreDelay

Syntax: dscli getPowerRestoreDelay Component

Description:

Obtains power option that specifies working of a managed component when it is turned AC ON.

For details, see 2.2.21 setPowerRestoreDelay.

Options:

Component


Output:

Display power option information. The following shows an example.

POLICY : LAST_STATE

Power Restore Delay : 30 sec

Power Restore Delay(default) : 0 sec

2.2.23 setBmcInfo

Syntax: dscli setBmcInfo Component KeyName Value

Description:

Changes BMC configuration information on the managed component. The parameter supported according to the kind of BMC is different.

TIP:



Use setAuthKey command to change authentication key or password of PPP server. See

2.2.25 setAuthKey.



Use setSensorLevel command to change separate sensor level. See 2.2.26 setSensorLevel.



CFG_NETWORK_SHARED_BMC_LAN,CFG_NETWORK_BMC_MAC is not change.

Use getBmcInfo command. See 2.2.24 getBmcInfo.

Options:

Component


KeyName

Specify the key name of BMC configuration. See the following list.

Value

Specify the new values to be set. See the following list.

35



CFG_COMPUTER_NAME Common: Up to 15 characters

Computer Name

Community Name

1: Enabled

Destination

2: All Alert Destination

CFG_ALERT_ACKNOWLEDGE Common:Alert Acknowledge 0: Disabled

1: Enabled

CFG_ALERT_LEVEL Common: Alert Level

CFG_LAN_CONTROL_LAN1 Common:

Remote Control (LAN1)

0: no Alert

1-6: Alert Level 1-6

0: Disabled

1: Enabled

(WAN/Direct)

CFG_LAN_REDIRECTION Common: 0: Disabled

Redirection (LAN) 1: Enabled

CFG_SERIAL_REDIRECTION Common:

Redirection (WAN/Direct)

CFG_LAN_CONTROL_LAN2 Common:

Remote Control (LAN2)

CFG_LAN_ALERT_POLICY_LAN Common:

LAN1 / LAN2 priority

CFG_LAN_ALERT_POLICY_DESTINATION Common:

LAN / Alert Receiver priority

0: Disabled

1: Enabled

0: Disabled

1: Enabled

0: LAN1

1: LAN2

0: LAN Channel

1: Alert Receiver

Obtain an IP Address 1: Enabled automatically(DHCP)

IP Address

CFG_LAN_SUBNET_LAN1 LAN1:

Subnet Mask

CFG_LAN_GATEWAY_LAN1 LAN1:

Default Gateway

CFG_LAN_MANAGE1_ALERT_LAN1 LAN1:

Alert Receiver/ management

PC(1) Alert

CFG_LAN_MANAGE1_IP_LAN1 LAN1:


PC(1) IP address



PC(2) Alert



PC(2) IP address



PC(3) Alert

IP address format

IP address format

0: Disabled

1: Enabled

IP address format

0: Disabled

1: Enabled

IP address format

0: Disabled

1: Enabled

36


KeyName Contents



PC(3) IP address

Value

IP address format

CFG_LAN_ALERT_RETRY_COUNT_LAN1 LAN1:

Alert Retry Count

0 - 7

CFG_LAN_ALERT_RETRY_TIMEOUT_LAN1 LAN1: Alert Timeout (in 3 - 30 seconds)

Obtain an IP Address 1: Enabled automatically(DHCP)

IP Address

CFG_LAN_SUBNET_LAN2 LAN2:

Subnet Mask

CFG_LAN_GATEWAY_LAN2 LAN2:

Default Gateway



PC (1) Alert



PC (1) IP address



PC (2) Alert



PC (2) IP address



PC (3) Alert



PC (3) IP address

CFG_LAN_ALERT_RETRY_COUNT_LAN2 LAN2:

Alert Retry Count

CFG_LAN_ALERT_RETRY_TIMEOUT_LAN2 LAN2:

Alert Timeout (in seconds)

CFG_SERIAL_MODE WAN/Direct: Mode

CFG_SERIAL_BAUDRATE WAN/Direct: Baud Rate

CFG_SERIAL_FLOW_CONTROL WAN/Direct

Flow Control

IP address format

IP address format

0: Disabled

1: Enabled

IP address format

0: Disabled

1: Enabled

IP address format

0: Disabled

1: Enabled

IP address format

0 – 7

3 – 30

1: Direct

2: Modem

1: 9600bps

2: 19.2Kbps

3: 57.6Kbps

4: 115.2Kbps

1: None

2: RTS/CTS

3: XON/XOFF

2: Tone Dial Mode

Initial Command

Hang-up Command

37



CFG_SERIAL_DTR_HANG_UP WAN/Direct

DTR Hang-up

CFG_SERIAL_ESCAPE_CODE WAN/Direct

Escape Code

CFG_SERIAL_DIAL_RETRY_COUNT WAN/Direct

Dial retry count

Value

0: Disabled

1: Enabled

1character

0 – 7

CFG_SERIAL_DIAL_RETRY_INTERVAL WAN/Direct

Dial retry interval (in

60 – 240 seconds)

CFG_SERIAL_ALERT_RETRY_COUNT WAN/Direct

Alert retry count

0 – 7

CFG_SERIAL_ALERT_RETRY_INTERVAL WAN/Direct

Alert timeout Interval (in

3 – 30 seconds)

CFG_SERIAL_ALERT_PPP1 WAN/Direct 0: Disabled

Primary PPP component

Alert

1: Enabled

Up to 19 characters CFG_SERIAL_DIAL_NUMBER_PPP1 WAN/Direct


Phone Number

CFG_SERIAL_USER_ID_PPP1 WAN/Direct


User ID

Up to 16 characters

CFG_SERIAL_DOMAIN_PPP1 WAN/Direct


Domain

Up to 16 characters

CFG_SERIAL_ALERT_PPP2 WAN/Direct 0: Disabled

Secondary PPP component

Alert

1: Enabled

Up to 19 characters CFG_SERIAL_DIAL_NUMBER_PPP2 WAN/Direct


Phone Number

CFG_SERIAL_USER_ID_PPP2 WAN/Direct


User ID

Up to 16 characters

CFG_SERIAL_DOMAIN_PPP2 WAN/Direct


Domain

Up to 16 characters

CFG_SERIAL_MANAGE1_IP WAN/Direct IP address format

Alert Receiver (1)

IP address


Alert Receiver (2)

IP address


Alert Receiver (3)

IP address

CFG_PAGER_MANAGE1_ALERT Pager:

Alert Receiver (1) Alert

0: Disabled

1: Enabled

CFG_PAGER_MANAGE1_DIAL_NUMBER Pager:

Alert Receiver (1) Phone

Up to 19 characters

Number

CFG_PAGER_MANAGE2_ALERT Pager:

Alert Receiver (2) Alert

0: Disabled

1: Enabled

38



CFG_PAGER_MANAGE2_DIAL_NUMBER Pager:

Alert Receiver (2) Phone

Number

Value

Up to 19 characters

CFG_PAGER_MESSAGE Pager:

Pager message

Up to 29 characters

CFG_PAGER_TIMEOUT Pager:

Guide Message Waiting

0-30

Time (2 seconds unit)

CFG_NETWORK_SHARED_BMC_LAN Network

Property:

0:Management LAN

1:Shared System LAN

Management LAN

Management LAN Port

CFG_NETWORK_CONNECTION_TYPE Network

Property:

Basic Connection Type

0: Auto Negotiation

1: 100Mbps Full

Duplex

2: 100Mbps Half

Duplex

3: 10Mbps Full

Duplex

4: 10Mbps Half

Duplex

CFG_NETWORK_BMC_MAC Network

Property:

BMC MAC Address

MAC address format

CFG_NETWORK_DHCP Network 0: Disabled

Property:

Basic DHCP

1: Enabled

CFG_NETWORK_IP_LAN Network IP address format

Property:

Basic IP Address

IP address format CFG_NETWORK_SUBNET_LAN Network

Property:

Basic Subnet Mask

IP address format CFG_NETWORK_GATEWAY_LAN Network

Property:

Basic Default Gateway

CFG_NETWORK_DYNAMIC_DNS Network

Property:

Basic Dynamic DNS

0: Disabled

1: Enabled

CFG_NETWORK_DNS_SERVER Network

Property:

Basic DNS Server

CFG_NETWORK_HOST_NAME Network

CFG_NETWORK_ACCESS_LIMITATION_TY

PE

Property:

Basic Host Name

CFG_NETWORK_DOMAIN_NAME Network

Property:

Basic Domain Name

IP address format

Up to total of 254 characters of Host

Name and Domain

Name

Up to total of 254 characters of Host

Name and Domain

Name

Network

Property:

0: Allow All

1: Allow Address

Access Limitation Access 2: Deny Address

Limitation Type

39



CFG_NETWORK_ACCESS_ADDRESS Network

Property:

Address

Value

IP address format

Please delimit Internet using comma

The wildcard (*) can be used in IP address.

Service:

Web Server

HTTP

CFG_NETWORK_HTTP_PORT Network

Service:

Web Server

HTTP Port

1: Enabled

1 - 65535

CFG_NETWORK_HTTPS Network 0: Disabled

Service:

Web Server

1: Enabled

HTTPS

CFG_NETWORK_HTTPS_PORT Network

Service:

Web Server

HTTPS Port

1 - 65535

Service:

SSH Interface SSH

CFG_NETWORK_SSH_PORT Network

Service:

SSH Interface SSH Port

1: Enabled

1 - 65535

Mail Alert:

Alert

CFG_MAIL_ALERT_TIMEOUT Alert

Mail Alert:

Response time of SMTP server

1: Enabled

30 - 600

Up to 255 characters CFG_MAIL_ALERT_SERVER Alert

Mail Alert:

SMTP Server

SMTP Server

CFG_MAIL_ALERT_PORT Alert

Mail Alert:

SMTP Server

SMTP Port

1 - 65535

CFG_MAIL_ALERT_CRAMMD5 Alert

Mail Alert:

SMTP Server

SMTP Authentication

CRAM-MD5

CFG_MAIL_ALERT_LOGIN Alert

Mail Alert:

SMTP Server

SMTP Authentication

LOGIN

0: Disabled

1: Enabled

0: Disabled

1: Enabled

40



CFG_MAIL_ALERT_PLAIN Alert

Mail Alert:

SMTP Server

SMTP Authentication

PLAIN

CFG_MAIL_ALERT_USER Alert

Mail Alert:

SMTP Server

User Name

CFG_MAIL_ALERT_TO1 Alert

Mail Alert:

Mail To1

Mail To1 Address


Mail Alert:

Mail To2

Mail To2 Address


Mail Alert:

Mail To3

Mail To3 Address

CFG_MAIL_ALERT_FROM Alert

Mail Alert:

Mail From

CFG_MAIL_ALERT_REPLY Alert

Mail Alert:

Mail Reply-To

CFG_MAIL_ALERT_SUBJECT Alert

Mail Alert:

Mail Subject

CFG_MAIL_ALERT_LEVEL Alert

Mail Alert:

Alert Level

Value

0: Disabled

1: Enabled

Up to 64characters

Up to 255 characters

Please specify 0 when Mail Alert is disabled.







Up to 63characters

0: Error

1: Error, Warning

2: Error, Warning,

Information

3: Separate setting

SNMP Alert:

Alert

CFG_SNMP_COMPUTER_NAME Alert

SNMP Alert:

Computer Name

CFG_SNMP_COMMUNITY Alert

SNMP Alert:

Community Name

CFG_SNMP_ALERT_ACKNOWLEDGE Alert

SNMP Alert:

Alert Acknowledge

CFG_SNMP_ALERT_POLICY Alert

SNMP Alert:

Alert Process

CFG_SNMP_ALERT_RETRY_COUNT Alert

SNMP Alert:

Alert Retry Count

1: Enabled

Up to 16characters

Up to 16characters

0: Disabled

1: Enabled

1: One Alert

Receiver

2: All Alert Receivers

0 – 7

41



CFG_SNMP_ALERT_TIMEOUT Alert

SNMP Alert:

Alert Timeout

CFG_SNMP_MANAGE1_ALERT Alert

SNMP Alert:

Alert Receiver Primary Alert

Value

3 - 30

0: Disabled

1: Enabled

CFG_SNMP_MANAGE1_IP Alert

SNMP Alert:

Alert Receiver Primary IP

Address

IP address format


SNMP Alert:

Alert Receiver Secondary

Alert

0: Disabled

1: Enabled

IP address format CFG_SNMP_MANAGE2_IP Alert

SNMP Alert:

Alert Receiver Secondary IP

Address


SNMP Alert:

Alert Receiver Tertiary Alert

0: Disabled

1: Enabled

CFG_SNMP_MANAGE3_IP Alert

SNMP Alert:

Alert Receiver Tertiary IP

Address

IP address format

CFG_SNMP_ALERT_LEVEL Alert

SNMP Alert:

Alert Level

CFG_MISCELLANEOUS_SEL Other:

SEL

0: Error

1: Error, Warning

2: Error, Warning,

Information

3: Separate setting

0: Stop logging SEL

1: Clear all SEL repository is full SEL

CFG_MISCELLANEOUS_PEF Other:

Platform Event Filter

Platfrom Event Filter

2.2.24 getBmcInfo

Syntax: dscli getBmcInfo Component

0: Disabled

1: Enabled

Description:

Obtains BMC configuration information of a specified managed component.

Options:

Component


Output:

Displays BMC configuration information. See 2.2.23 setBmcInfo for details.

42



CFG_COMPUTER_NAME=Component1

CFG_COMMUNITY=public

CFG_ALERT_ALL=1

CFG_POLICY=1

CFG_ALERT_ACKNOWLEDGE=1

CFG_ALERT_LEVEL=4

CFG_LAN_REDIRECTION=1

CFG_LAN_CONTROL_LAN1=1

CFG_SERIAL_REDIRECTION=1

CFG_SERIAL_CONTROL=1

CFG_LAN_IP_LAN1=192.168.14.14

CFG_LAN_SUBNET_LAN1=255.255.255.0

CFG_LAN_GATEWAY_LAN1=192.168.14.1

CFG_LAN_MANAGE1_ALERT_LAN1=0

CFG_LAN_MANAGE1_IP_LAN1=0.0.0.0





CFG_LAN_ALERT_RETRY_COUNT_LAN1=3

CFG_LAN_ALERT_RETRY_TIMEOUT_LAN1=6

:

:

43


2.2.25 setAuthKey

Syntax: dscli setAuthKey Component OldPassword NewPassword SelectAuthKey

Description:

Changes the authentication key, PPP server’s password or SMTP server’s password of a BMC configuration.

The parameter supported according to the kind of BMC is different.

TIP:



After you succeed to change authentication key, you should change the authentication key

registered on NEC ESMPRO Manager using setComponentProperty command. See 2.2.9 setServerProperty.

Options:

Component


OldPassword

Specify current password.

NewPassword

Specify new authentication key or PPP sever’s password up to 16 characters.

Specify new SMTP server’s password up to 20 characters.

SelectAuthKey

Specify a type of password.

1

2

Password of primary PPP server

Password of secondary PPP server

3 Password of SMTP server

2.2.26 setSensorLevel

Syntax: dscli setSensorLevel Component Type SensorName Level1 Level2 Level3

Description:

Changes separate setting at the alert level of BMC configuration information on the managed component.

This command can be used when alert Level is only a separate setting.

TIP:



Use setBmcInfo command to change alert level to the separate setting of component. See

2.2.23setBmcInfo.



8 is not use. Use getSensorLevel command. See 2.2.27 getSensorLevel.

Options:

Component


44


Target

Specify an alert type.

SensorName

Specify the key name of sensor. See the following list.

Level1

Specify the alert level of error.

Level2

Specify the alert level of warning.

Level3

Specify the alert level of information.

0: Disable to change SNMP alert or MAIL alert of alert level

1:

2:

3:

4:

Enable to change SNMP alert or MAIL alert to1 of alert level

Enable to change MAIL alert to2 of alert level

Enable to change MAIL alert to3 of alert level

Enable to change MAIL alert to1 or MAIL alert to2 of alert level

5:

6:

8:



7: Enable to change MAIL alert to1,

MAIL alert to2 or MAIL alert to3 of alert level

SNMP alert and MAIL alert of unalterable alert level

TIP:



0 is specified for a unalterable alert level.

See the following list.

OK : Enable to change, NG : Disable to change

SensorName Contents Level1 Level2 Level3

(Monitoring

Threshold)

Threshold)

(Monitoring

Threshold)

(Monitoring Abnormal

State)

Resize

MODULE_BOARD Module/Board(Missin g)

OK NG OK

SMI_TIMEOUT SMI OK

Abnormal State)

45


SensorName Contents Level1 Level2 Level3

TRANSITION_PW_SAVE

(Monitoring Abnormal

State)

Transition to Power

Save

MICROCONTROLL_STS Microcontroller State

NG NG OK

NG OK OK

Redundancy

Security(Chassis

Intrusion)

Violation Attempt

PW_UNIT_STS Power Unit State OK OK OK

SYS_BOOT_RESTART_INIT System NG NG OK

Initiated

OS_STOP_SHUTDOWN OS OK

ACPI System ACPI Power

State

NG NG OK

WATCHDOG_TIMER Watchdog OK

Information

FRU_HOT_SWAP FRU Hot Swap

Power State

NG NG OK

2.2.27 getSensorLevel

Syntax: dscli getSensorLevel Component Type

Description:

Obtains separate setting at the alert level of BMC configuration information of a specified managed component.

46


Options:

Component


Target

Specify an alert type.

Output:

Displays alert level of BMC configuration information. See 2.2.26 setSensorLevel for details.


TEMP_THRESHOLD=111

VOLT_THRESHOLD=000

FAN_SENSOR=000

PLATFORM_SEC=800

PROCESSOR=000

PW_SUPPLY=000

PW_UNIT_STS=000

MEM=000

DRIVE_SLOT=000

EVT_LOG_DISABLED=800

SYS_EVT=080

CRITICAL_INT=000

BUTTON_SWITCH=880

MODULE_BOARD=800

SYS_BOOT_RESTART_INIT=880

BOOT_ERR=880

ACPI=880

SMI_TIMEOUT=800

POST_MEM_RESIZE=800

POST_ERR=800

SLOT_CONNECTOR=080

WATCHDOG_TIMER=080

SENSOR_FAILTURE=800

:

47


2.2.28 getAgentExtensionLog

Syntax: dscli getAgentExtensionLog Component

Description:

Obtains the application logs of the NEC ESMPRO Agent Extension on a managed component. This command can be used via LAN when NEC ESMPRO Agent Extension service is running on the managed component.

Options:

Component


Output:

Displays the application logs of the NEC ESMPRO Agent Extension.

2.2.29 testAlert

Syntax: dscli testAlert Component Target

Description:

Executes an alert test.

You can confirm the result of test using 2.2.30 getTestAlertStatus command. The parameter supported

according to the kind of BMC is different.

Options:

Component


Target

Specify an alert receiver.

LAN1_1 or 0:

LAN1_2 or 1:

LAN1_3 or 2:

LAN2_1 or 3:

LAN2_2 or 4:

LAN2_3 or 5:

PPP1_1 or 6:

PPP1_2 or 7:

PPP1_3 or 8:

PPP2_1 or 9:

PPP2_2 or 10:

PPP2_3 or 11:

Pager1 or 12:

Pager2 or 13:

SNMP1 or 14:

SNMP2 or 15:

SNMP3 or 16:

LAN1 alert receiver (1)






PPP1 alert receiver (1)






Pager alert receiver (1)

Pager alert receiver (2)

SNMP alert receiver (1)



48


MAIL1 or 17:

MAIL2 or 18:

MAIL3 or 19:

MAIL alert receiver (1)



2.2.30 getTestAlertStatus

Syntax: dscli getTestAlertStatus Component Target

Description:

Obtains the state of an alert test. The parameter supported according to the kind of BMC is different.

Options:

Component


Target

Specify an alert receiver.. See 2.2.29 testAlert.

Output:

Displays the state of the alert test. One of the following test states is displayed.

TEST_SUCCESS:

TEST_ABORT:

Alert test is succeeded.

Alert test is failed.

TEST_TIMEOUT: Alert test is failed. (Timeout)

TEST_ERROR: Alert test is failed (Other reason)

While an alert is being sent, the alert state is displayed as follows:

TEST_TESTING

2.2.31 getServerStatus

Syntax: dscli getServerStatus Component

Description:

Displays the status of a specified managed component.

Confirms the managed component status by component monitoring function.

Options:

Component


Output:

Displays the managed component status as following.

ERROR: Error

WARNING: Warning

UNKNOWN: Unknown or connection error

DC-OFF: DC-OFF

49


NORMAL: Normal

NO_MONITORING: Out of monitoring

2.2.32 getPowerStatus

Syntax: dscli getPowerStatus Component

Description:

Obtains the power state of a specified managed component.

Options:

Component


Output:

Displays the power state of a specified managed component.. There are the following power states:

DC-ON Power-ON

DC-OFF Power-OFF

2.2.33 getStatusLamp

Syntax: dscli getStatusLamp Component [/x ModuleNo]

Description:

Obtains the state of a specified managed component STATUS lamp.

Options:

Component


Output:

Displays the state of a specified managed component STATUS lamp. There are the following states of the

STATUS lamp

GREEN_ON Turn on green.

AMBER_ON

RED_ON

Turn on amber.

Turn on red.

50


2.2.34 getPanelInfo

Syntax: dscli getPanelInfo Component [/x ModuleNo]

Description:

Obtains the following state as the front panel information of a managed component: power state, the

STATUS lamp state, the displays of LCD, the system monitoring state of the watchdog timer, the counter of power-on hours.

Options:

Component


Output:

Displays the front panel information. The following shows an example.

Power Status : S0_G0

STATUS Lamp : GREEN_ON

LCD0 : Prepare To Boot

LCD1 :

Watchdog Status : STARTED

Watchdog Use : SMS_OS

Watchdog Interval : 10 sec

POH : 262920 min

:

51


2.2.35 powerOn

Syntax: dscli powerOn Component [/p]

Description:

Turns on a specified managed component.

If the POWER switch needs to be pressed to recover the managed component from the sleep state, it can also be recovered by executing this command.

IMPORTANT:






In the case of PowerBay, The power control is not performed to the powerbay. It is performed to the maintenance card integrated on the PowerBay.

Options:

Component


/p


TIP:




2.2.36 powerOff

Syntax: dscli powerOff Component

Description:

Forcibly turns off a specified managed component.

IMPORTANT:







Options:

Component


52


2.2.37 reset

Syntax: dscli reset Component [/p]

Description:

Forcibly resets a specified managed component.

IMPORTANT:










Options:

Component


/p

Force boot from network after reset.

TIP:




53


2.2.38 powerCycle

Syntax: dscli powerCycle Component [/p]

Description:

Forcibly turns off a specified managed component and then turns it on.

IMPORTANT:










Options:

Component


/p


TIP:




54


2.2.39 shutdownOs

Syntax: dscli shutdownOs Component [/force]

Description:

Shut downs the operating system on a managed component.

This command via LAN instructs the NEC ESMPRO Agent Extension service to shutdown the operating system. The command via modem or with direct connection instructs the NEC ESMPRO Agent.

If you specify “/force” option, this command executes the forced shutdown OS function without communication to the NEC ESMPRO Agent Extension or the NEC ESMPRO Agent.

Options:

Component


/force

If you specify “/force” option, this command executes the forced shutdown OS function. This shutdown may not work depending on the kind of OS or the OS settings.

2.2.40 dumpSwitch

Syntax: dscli dumpSwitch Component

Description:

Pushes DUMP switch on a managed component.

IMPORTANT:




Options:

Component

Specify the name, the MAC address of LAN port that BMC uses or the GUID of the managed component.

55


2.2.41 clearSel

Syntax: dscli clearSel Component [/force]

Description:

Clears the System Event Log (SEL) area on a managed component.

Options:

Component


/force

If you specify “/force” option, this command clears the SEL area even while the automatic backup service of NEC ESMPRO Agent is active on the managed component.

2.2.42 identifyChassis

Syntax: dscli identifyChassis Component Period

Description:

Turns on the Unit ID lamp on a managed component.

Options:

Component


Period

Specify lamp-on period in seconds. You can specify 0 – 255.

2.2.43 getIpmiInfo

Syntax: dscli getIpmiInfo Component FileName

Description:

Collects IPMI information and saves it as a specified file name.

If there is the type of information that is not read in but NEC ESMPRO Manager holds the previously read-in information, the information is also saved in the file.

TIP:



You can display the IPMI information file on web browser interface of the NEC ESMPRO

Manager. Log in the NEC ESMPRO Manager and click the “Tools” on the header menu.

Options:

Component


56


FileName

Specify the filename with path name for saving the IPMI information.

2.2.44 getSensorList

Syntax: dscli getSensorList Component

Description:

Creates a sensor list from the previously collected SDR of IPMI information through 2.2.43 getIpmiInfo

command and displays the list. The SDR record ID indicating each sensor is also displayed.

Options:

Component


Output:

Displays the list of the sensor names. The following shows an example.

0001h: Sensor Type=Temperature(Front Panel Temp), Owner=Basbrd Mgmt Ctlr

0002h: Sensor Type=Temperature(Baseboard Temp), Owner=Basbrd Mgmt Ctlr

0003h: Sensor Type=Temperature(Processor 1 Temp), Owner=Basbrd Mgmt Ctlr

0004h: Sensor Type=Temperature(Processor 2 Temp), Owner=Basbrd Mgmt Ctlr

0005h: Sensor Type=Temperature(PwrDstBd Temp), Owner=Basbrd Mgmt Ctlr

:

2.2.45 getSensorStatus

Syntax: dscli getSensorStatus Component RecordId

Description:

Obtains the status of specified sensor on the managed component.

Options:

Component


RecordId

Specify the SDR record ID from the sensor list displayed by 2.2.44 getSensorList command.

57


Output:

Displays the status of the sensor. The following shows an example.

Current Value:

30.00 degrees C

Current Status:

Normal

Upper non-recoverable Threshold:

---

Upper critical Threshold:

46.00 degrees C (Hysteresis:44.00 degrees C)

Upper non-critical Threshold:


Lower non-critical Threshold:


Lower critical Threshold:


Lower non-recoverable Threshold:

---

2.2.46 getConsoleLog

Syntax: dscli getConsoleLog Component

Description:

Displays the console log of a specified component.

Options:

Component


Output:

Displays the console log of a specified component.

58


2.2.47 setBmcIpSync

Syntax: dscli setBmcIpSync Component Value

Description:

Changes BMC IP Address Synchronization of NEC ESMPRO Agent Extension on a managed component.

BMC IP Address Synchronization means the function that the NEC ESMPRO Agent Extension corrects the

IP address in the BMC configuration information periodically to the IP address set on the operating system if the managed component contains the BMC that use standard LAN port.


Options:

Component


Value

Specify a new value.

0 Disable

1 Enable

TIP:



If this command is sent to NEC ESMPRO Agent Extension on the managed component that contains the BMC that uses an exclusive LAN port (Management LAN Port), the command end successfully, but nothing is set.

2.2.48 getBmcIpSync

Syntax: dscli getBmcIpSync Component

Description:

Obtains BMC IP Address Synchronization of NEC ESMPRO Agent Extension on a managed component.

BMC IP Address Synchronization means the function that the NEC ESMPRO Agent Extension corrects the

IP address in the BMC configuration information periodically to the IP address set on the operating system if the managed component contains the BMC that use standard LAN port.


Options:

Component


Output:

Displays BMC IP Address Synchronization. The following shows an example.

Agent Config (BMC IP Sync) : Enable

59


2.2.49 getBladeSlotId

Syntax: dscli getBladeSlotId Component

Description:

Execute 2.2.41 getIpmiInfo command previously.

Obtains enclosure ID and slot ID of a managed component if the managed server is a blade. The enclosure ID is for identifying the blade assembly unit where the blade is installed. The slot ID shows the installation position inside the blade assembly unit where the slot is installed.

Options:

Component


Output:

Displays enclosure ID and slot ID. The following shows an example.

Enclosure ID: 0040000000

Slot ID: 2

2.2.50 setBmcIpAddressLan1

Syntax: dscli setBmcIpAddressLan1 Component IpAddress [/force]

Description:

Changes the LAN1 IP address for BMC on the managed component.

Options:

Component


IpAddress

Specify the IP address of LAN1 for BMC.

/force

If the managed component contains BMC that uses a standard LAN port, specify "/force" option to change IP address for BMC while the operating system is running.

TIP:



The IP address that is already registered cannot be specified to IpAddress.

60


2.2.51 setBmcIpAddressLan2

Syntax: dscli setBmcIpAddressLan2 Component IpAddress [/force]

Description:

Changes the LAN2 IP address for BMC on the managed component.

Options:

Component


IpAddress

Specify the IP address of LAN2 for BMP.

/force

If you specify “/force” option, this command changes the IP address even while an OS is running.

TIP:



The IP address that is already registered cannot be specified to IpAddress.

61


2.3 EM Card Management Commands

The following component management commands can be used for an EM card. However, the MAC address cannot be specified for the option "Server".

2.2.4 findNewServer

2.2.4 findNewServer

2.2.5 findNewServerNetAddr

2.2.6 createServer

2.2.7 deleteServer

2.2.8 checkConnection

2.2.9 setServerProperty

2.2.13 getServerProperty

2.2.14 getServerInfo

2.2.4 findNewServer

2.2.16 getGuid

2.2.31 getServerStatus

2.3.1 getEmCardList

Syntax: dscli getEmCardList [/d]

Description:

Displays the name list of all EM cards registered on NEC ESMPRO Manager.

Options:

/d

If you specify “/d” option, the EM cards list indicates EM card name and GUID.

Output:


If “/d” option is not specified:

EM0001

EM0002

If “/d” option is specified:

EM0001

GUID 01b21dd2:1dd2:11b2:2fa4:003013630cc5

EM0002

GUID 01b21dd2:1dd2:11b2:49bd:003013630cc0

62


2.3.2 getEmActiveState

Syntax: dscli getEmActiveState EmCard

Description:

Displays state of active/standby of the specified EM card.

Options:

EmCard

Specify the name of EM card.

Output:

There are the following states of EM card

Active active

Standby standby

2.3.3 identifyEm

Syntax: dscli identifyEm EmCard [/x SwmSlotNumber]

Description:

Turns on the Unit ID lamp of specified EM card or the switch module that is managed by the EM card for 15 seconds. Only when the EM card is active, this command is available.

Options:

EmCard

Specify the name of the EM card.

/x SwmSlotNumber

Specify the slot number of the switch module, when you want to turn on Unit ID lamp of the switch module that is managed by the EM card.

63


2.3.4 getEmStatusLamp

Syntax: dscli getEmStatusLamp EmCard [/x SwmSlotNumber]

Description:

Obtains the state of a specified EM card or the switch module that is managed by the EM card. Only when the EM card is active, this command is available.

Options:

EmCard

Specify the name of the EM card.

/x SwmSlotNumber

Specify the slot number of the switch module, when you want to obtain Status lamp of switch module that is managed by the EM card.

Output:

There are the following states of the STATUS lamp

GREEN_ON Turn on green.

64


2.4 Chassis Management Commands

2.4.1 getBladeEnclosureList

Syntax: dscli getBladeEnclosureList

Description:

Displays the list of the blade enclosure in which the managed component or the EM card registered on NEC

ESMPRO Manager is installed.

Output:

Displays the list of the blade enclosure with the component or the EM card registered on NEC ESMPRO

Manager.

2.4.2 getChassisSlotState

Syntax: dscli getChassisSlotState ChassisName

Description:

Displays the state of blade slots when the specified chassis is a blade enclosure. The list of the EM card and the switch module are displayed if the EM card and the switch module are installed in chassis.

Options:

ChassisName

Specify the chassis name.

Output:

Following information is shown for each slot.

Contents Explanation slot number Displays the slot number.

Displays two slot numbers when the installed blade has double wide or full height.

slot state component name Displays the component name when the component is installed in the slot and it is registered on NEC ESMPRO

Manager. For double wide blade, displays “(Double-wide)” following the component name. For full height blade,

Installed displays “(Full-height)” following the component name.

Displays “Installed” when the switch module is installed in the slot.

Not registered Displays “Not registered” when the component is installed in the slot and it is not registered on NEC ESMPRO

Manager.

Not installed

(blank)

Display “Not Installed” when nothing is installed in the slot.

Displays nothing if “Installed” and “Not Registered” cannot be distinguished.

65



CPU Blade:

1: SERVER_0001

2: SERVER_0002

3,4: SERVER_0003 (Double-wide)

5: Not installed

6: Not registered

7: Not installed

8: Not registered

EM Card:

1.EM0001

2.EM0002

Switch Module:

1: Installed

2: Installed

3: Not installed

4: Not installed

5: Not installed

6: Not installed

2.4.3 getChassisInfo

Syntax: dscli getChassisInfo ChassisName

Description:

Displays information on the specified chassis.

Options:

ChassisName


Output:

Display information on the specified chassis.

Item Name Contents

Chassis Name

Comments

Rack Name

Rack ID

Unit Name

Serial Number

Name of the chassis.

Comments of the chassis

Displays the rack name which is set on the EM card.

Displays the rack id which is set on the EM card.

Displays the unit name which is set on the EM card.

Displays the chassis serial number of the blade enclosure.

66


2.4.4 setChassisProperty

Syntax: dscli setChassisProperty ChassisName PropertyName Value

Description:

Sets the chassis property of a chassis.

Options:

ChassisName


PropertyName

Specify the name of the chassis property.

Value



CHASSIS_NAME

CHASSIS COMMENT

Specify the name of the chassis.

Enter the comments of the chassis.

Up to 32 characters.

Up to 100 characters.

TIP:



The name of chassis that is already registered cannot be specified to ChassisName.

2.4.5 getChassisProperty

Syntax: dscli getChassisProperty ChassisName PropertyName

Description:

Displays the property of the specified chassis.

Options:

ChassisName


PropertyName

Specify the name of chassis property. For the list of chassis properties, see the 2.4.4 setChassisProperty

command.

Output:

Display the property of a chassis.

67


2.4.6 setBladeAutoSetting

Syntax: dscli setBladeAutoSetting ChassisName SlotNumber PropertyName Value

Description:

This command is effective only to the chassis in which EM card can be installed.

If NEC ESMPRO Manger detects new CPU blade installed on the chassis, NEC ESMPRO Manager configures BMC on the CPU blade (managed component) through the EM card to control the managed component remotely.

Set information to perform the configuration of BMC on CPU blade and the component registration automatically.

Options:

ChassisName


SlotNumber

Specify the slot number of CPU blade. When a common value to all slots is set, “all” is specified.

PropertyName

Specify the name of the chassis property.

Value



AUTH_KEY

RECONFIGURE_ BMC “Enabled" means that NEC ESMPEO 0: Disabled

Manager executes BMC configuration not only new installed CPU blade but also all

1: Enabled

CPU blade. “Disabled” means that NEC

ESMPRO Manager executes BMC configuration only if BMC on new installed

CPU blade has not been configured.

REWRITE_IP_ADDRE

SS

Specify the authentication key that is Up to 16 characters configured on BMC.

DHCP

IP address of the BMC on the CPU blade may be obtained by DHCP even through the

BMC configuration has not been executed.

If this option is set “Enable”, NEC ESMPRO

0: Disabled

1: Enabled

Manager always update the IP address when BMC configuration is executed.

BMC automatically acquires IP address from

DHCP.

0: Disabled

1: Enabled

IP_ADDRESS

SUBNET_MASK

Specify IP address set to CPU blade. When you specify “all” for “SlotNumber” option, IP address consecutive from specified IP address is sequentially set from the first slot.

IP Address form

Specify the subnet mask.

DEFAULT_GATEWAY Specify the default gateway.

ALERT_RECEIVER_IP

_ADDRESS

Specify the alert receiver(1)/IP address of

PC for management.

IP Address form

IP Address form

IP Address form

68


2.4.7 getBladeAutoSetting

Syntax: dscli getBladeAutoSetting ChassisName SlotNumber

Description:

This command is effective only to the chassis that can install the EM card.

Display information to perform configuration of BMC of a CPU blade and component registration automatically when NEC ESMPRO Manager detects new CPU blade installed on the chassis.

See 2.4.6 setBladeAutoSetting for each information details.

Options:

ChassisName


SlotNumber

Specify the slot number of CPU blade.

Output:


RECONFIGURE_BMC:Disable

REWRITE_IP_ADDRESS:Diasable

DHCP:Enable

ALERT_RECEIVER_IP_ADDRESS:192.168.14.18

69


2.5 Communication Management Commands

2.5.1 connect

Syntax: dscli connect Component

Description:

Connects to a managed component with via modem or with direct connection according to the connection type of the component property.

Options:

Component


2.5.2 disconnect

Syntax: dscli disconnect

Description:

Disconnects the currently connected line.

2.5.3 getConnectionStatus

Syntax: dscli getConnectionStatus

Description:

Displays the status of the serial connection (via modem or with direct connection).

Output:

Displays the status of the serial connection. There are following status:

CONNECTING

Connection is complete. CONNECTED

DISCONNECTING

DISCONNECTED

CONNECTION_FAILURE

NO_CARRIER

Disconnection is complete.

Failed to connect.

NO_DIALTONE

70


2.6 Environment Setting Commands

2.6.1 setOption

Syntax: dscli setOption OptionName Value

Description:

Sets an option of the NEC ESMPRO Manager.

Options:

OptionName

Specify a name of the NEC ESMPRO Manager option. See the following list.

OptionName Contents Value Default

BMC_RETRY_COUNT

BMC_TIMEOUT

BMC_SOURCE_PORT

CUI_NO_RESPONSE_TI

MEOUT

CUI_SYS_RQ_KEY communicating to BMC on a managed component.

Communication Timeout (in seconds) to BMC on a managed component.

1-15 5

Specify a UDP port number for 1025-65535 47117 communicating to BMC on a managed component.

Specify times (in seconds) until the remote console is disconnected due

20-1800 60 to a communication timeout.

Specify alias for SysRq key on CUI remote console.

"": Not specified

"Q": Ctrl+Alt+Q

"X": Ctrl+Alt+X

“”

HISTORY_LOG_NUMBER

_OF_RECORDS

MODEM_PORT_NUMBER

MONITORING_ENABLE

MONITORING_AUTO_UP

DATE_INTERVAL application logs.

Specify a serial port on NEC 1-8 1

ESMPRO Manager component.

The serial port is used for communicating to the managed component via modem or with direct connection.

0: Disabled

1: Enabled

1 Determine whether to enable/disable the component monitoring function that monitors the power status and the STATUS lamp on each managed component.

Specify interval times (in seconds) to update automatically the displays of component status.

1-60 5

RC_POWER_CONTROL_I

NTERVAL_MILLIS

RMI_PORT

Value

Specify new value to be set. milliseconds) at which power control is performed continuously for multiple components.

Specify a TCP port number for RMI. 1024 - 65535 1099

71


2.6.2 getOption

Syntax: dscli getOption OptionName

Description:

Displays an option of the NEC ESMPRO Manager.

Options:

OptionName

Specify a name of the NEC ESMPRO Manager option. See 2.6.1 setOption for option list.

Output:

Display the value of the specified option.

2.6.3 getPermitIpAddrList

Syntax: dscli getPermitIpAddrList

Description:

Displays the IP address ranges in which login to NEC ESMPRO Manager is permitted.

Only the Web clients in this IP address ranges are possible to login to NEC ESMPRO Manager.

Output:

Displays the list of IP address ranges. The following shows an example.

No.1: 192.168.0.1 – 192.168.0.254

No.2: 192.168.1.10

No.3: 192.168.2.10

72


2.6.4 isPermitIpAddr

Syntax: dscli isPermitIpAddr CheckIpAddr

Description:

Checks whether a specified IP address is permitted for login from a Web client and displays the check result.

Options:

CheckIpAddr

Specify IP address.

Output:

Displays the result of IP address check.

OK means this IP address is permitted

NG means this IP address is not permitted.

2.6.5 addPermitIpAddr

Syntax: dscli addPermitIpAddr StartIpAddr [EndIpAddr]

Description:

Adds an IP address range in which login to NEC ESMPRO Manager is permitted.

Only the Web clients in this IP address ranges are possible to login to NEC ESMPRO Manager.

TIP:



You can login to NEC ESMPRO Manager from a web browser on the component that NEC

ESMPRO Manager is installed even if the IP address is not permitted using this command.

Options:

StartIpAddr

Specify the start IP address of IP address range to permit login.

EndIpAddr

Specify the end IP address of IP address range. If this option is omitted, it will be permitted the single

IP address that is specified in the StartIAddr option.

2.6.6 removePermitIpAddr

Syntax: dscli removePermitIpAddr StartIpAddr [EndIpAddr]

Description:

Removes IP address range in which login from a Web client is permitted.

Options:

StartIpAddr

Specify the start IP address of IP address range.

EndIpAddr

Specify the end IP address of IP address range.

73


2.6.7 clearPermitIpAddr

Syntax: dscli clearPermitIpAddr

Description:

Removes all IP address ranges in which login from a Web client is permitted.

74


2.7 User Management Commands

2.7.1 createUser

Syntax: dscli createUser UserName Password

Description:

Registers a new user that can login to the NEC ESMPRO Manager from web browser. The user level of the user to be registered is “operator”. Up to 30 users can be created.

Options:

UserName

Specify a new user name. Up to 16 characters.

Password

Specify a login password for the new user. You can input the password with 6 - 16 letters.

TIP:



The name of user that is already registered cannot be specified to UserName.

2.7.2 deleteUser

Syntax: dscli deleteUser UserName

Description:

Deletes a user that can login to the NEC ESMPRO Manager from web browser.

Options:

UserName

Specify a name of the user.

2.7.3 getUserList

Syntax: dscli getUserList

Description:

Displays the list of registered user names and levels. “Administrator” or “Operator” is displayed as the user level.

Output:


Admin Administrator

User1 Operator

User2 Operator

:

:

75


2.7.4 setUserProperty

Syntax: dscli setUserProperty UserName PropertyName Value

Description:

Sets a property of a specified user.

Options:

UserName

Specify a user name.

PropertyName

Specify a property name. See the following list.

It is valid for “Operator” level user to change the executable authority.

OK : Enable to change, NG : Disable to change

PropertyName

USER_NAME

USER_PASSWORD

Contents

Specify the user name

Specify the login password.

Value

6-16 characters.

Default

Administrator

Operator

Up to 16 (Blank) OK OK characters.

(Blank) OK OK

USER_COMMENT

UL_POWER_ON

UL_POWER_OFF

UL_RESET

UL_POWER_CYCLE

Specify the comment about the user.

Up to 100 (Blank) OK OK

Specify the enable/disable of Power

ON. characters.

0: Disabled

1: Enabled


OFF function.

Specify the enable/disable of Reset function.


Cycle function.

0: Disabled

1: Enabled

0: Disabled

1: Enabled

0: Disabled

1: Enabled

UL_SHUTDOWN

UL_DUMP

UL_SEL_CLEAR

UL_BMC_REMOTE

UL_CONFIG_CREATE

UL_CONFIG_CHANGE_

DELETE

UL_REMOTE_CONSOLE

UL_SCHEDULE

UL_REMOTE_BATCH

UL_SET_POWER_REST

ORE_DELAY

Shutdown OS function.

Specify the enable/disable of DUMP switch function.

1: Enabled

0: Disabled

1: Enabled

Specify the enable/disable of Clear

System Event Log function.

0: Disabled

1: Enabled

Specify the enable/disable of Change

BMC Configuration function.

Specify the enable/disable of Add

Component function.

0: Disabled

1: Enabled

0: Disabled

1: Enabled

Specify the enable/disable of Set 0: Disabled

Component Property function and 1: Enabled

Delete Component function.

Specify the enable/disable of Remote

Console function.

0: Disabled

1: Enabled

Specify the enable/disable of Set 0: Disabled

Schedule function.

Specify the enable/disable of Remote

Batch function.

1: Enabled

0: Disabled

1: Enabled


Power Option Setting.

0: Disabled

1: Enabled

76


PropertyName Contents Value Default

Administrator

UL_SET_AGENT_SETTI

NG

UL_SET_CONSOLE_LO

G

UL_SET_ENVIRONMEN

T_OPTION

UL_SET_BLADE_AUTO_

SETTING

UL_ELECTRIC_POWER

_MONITORING


Agent Setting..


Console log Setting.


Environment Setting.


CPU Blade Auto Setting.

Specify the enable/disable of Start or

Stop Read Power Value.

UL_SET_SERVER_DOW

N_MONITORING

Value

Specify new value to be set.


Component Monitoring function.

0: Disabled

1: Enabled

0: Disabled

1: Enabled

0: Disabled

1: Enabled

0: Disabled

1: Enabled

0: Disabled

1: Enabled

0: Disabled

1: Enabled

TIP:



The name of user that is already registered cannot be specified to USER_NAME.

2.7.5 getUserProperty

Syntax: dscli getUserProperty PropertyName

Description:

Displays a property of a specified user.

Options:

UserName

Specify a user name.

PropertyNameName

Specify a property name. See 2.7.4 setUserProperty. But “USER_PASSWORD” property is not

displayed.

Output:

Displays a property of a specified user.

Operator

77


2.8 Other Commands

2.8.1 getApplicationLog

Syntax: dscli getApplicationLog [Number]

Description:

Displays the latest application logs up to the number that is specified by Number option.

Options:

Number

Specify the number of logs to be displayed. If this option is omitted, the latest 10 logs are displayed.

Output:

Displays the application logs. Each log includes date, a managed component name, OS IP address of the managed component, BMC IP address, user name and event.

2.8.2 about

Syntax: dscli about

Description:

Displays version information of NEC ESMPRO Manager.

Output:

Displays version information of NEC ESMPRO Manager.

2.8.3 help

Syntax: dscli help [CommandName]

Description:

Displays help information. If no options are specified, a command list will be displayed. If an option is specified, the help information of the specified command will be displayed.

Options:

CommandName

Specify a command name.

Output:

Display the command list or the help information of the specified command.

78


Revision History

1.00 2009/01/16 Initial edition.

1.02 2009/10/22 Modifies about Trademarks.

1.05

1.06

1.07

2010/04/19

2010/08/31

2011/03/28

1.08 2011/06/22

Adds the note of the remote power control command for the PowerBay.

Modifies the note of the setUserProperty command.

Modifies the note of the groupSetPowerRestoreDelay command.

Adds a configuration key for set/getBmcInfo command.

Adds the note of the setAuthKey command.

Adds setSensorLevel/getSensorLevel command.

Modifies the note of the setPowerRestoreDelay command.

Delete ft server command and about ft server.

Modifies the note of the setSensorLevel command.


© NEC Corporation 2011

79

NEC Express5800/R110d-1E User's Manual

NEC

Command Line Interface

Document Rev.1.08

Contents

About This Document

Chapter1 About Command Line Interface

1.1 System Requirements

1.2 How to Execute Commands

1.3 Execution Results

1.4 Example

1.5 Executing Command from Two or More Manager Server

Chapter2 Command Summary

2.1 Group management Commands

2.2 Component Management Commands

2.3 EM Card Management Commands

2.4 Chassis Management Commands

2.5 Communication Management Commands

2.6 Environment Setting Commands

2.7 User Management Commands

2.8 Other Commands

Related manuals

Table of contents

NEC Express5800/R110d-1E User's Manual

NEC

Command Line Interface

Document Rev.1.08

Contents

About This Document

Chapter1 About Command Line Interface

1.1 System Requirements

1.2 How to Execute Commands

1.3 Execution Results

1.4 Example

1.5 Executing Command from Two or More Manager Server

Chapter2 Command Summary

2.1 Group management Commands

2.2 Component Management Commands

2.3 EM Card Management Commands

2.4 Chassis Management Commands

2.5 Communication Management Commands

2.6 Environment Setting Commands

2.7 User Management Commands

2.8 Other Commands

Related manuals

NEC

Express5800/R110d-1E

NEC

Express5800/R110f-1E

NEC

Express5800/R120d-2E SR

NEC

Express5800/R110f-1E

NEC

Express5800/R110d-1E

Table of contents