User's Guide Express5800 Series NEC ESMPRO Manager Ver.6 Command Line Interface Chapter1 About Command Line Interface Chapter2 Command Summary Ver.1.
Contents Contents............................................................................................................................................................. 1 Trademarks...................................................................................................................................................... 4 About This Document .......................................................................................................................................
2.3 2.4 2.5 2.6 2.2.26 setSensorLevel..................................................................................................................... 46 2.2.27 getSensorLevel .................................................................................................................... 51 2.2.28 getAgentExtensionLog ........................................................................................................ 52 2.2.29 testAlert .......................................................
clearPermitIpAddr ............................................................................................................... 82 2.6.7 User Management Commands......................................................................................................... 83 2.7.1 createUser ............................................................................................................................ 83 2.7.2 deleteUser ..............................................................................
Trademarks 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. All other product, brand, or trade names used in this publication are the trademarks or registered trademarks of their respective trademark owners. Windows Server 2012 R2 stands for Windows Server® 2012 R2 Standard, and Windows Server® 2012 R2 Datacenter.
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.
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.
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 : Option : Indicates the NEC ESMPRO Manager command line interface command Enter the name of the command you want to execute. Enter the option parameters defined for each command 1.2.
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: 0 Non Zero value Normal end 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.
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 Display only groups.
Displays the list of groups and components. The following shows an example. >dscli getList root group1 group2 component1 group3 component2 component3 Displays the case specified “/g” option. The following shows an example. >dscli getList root /g group1 group2 group3 Displays the case specified “/x” option. The following shows an example.
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.
2.1.5 setGroupProperty Syntax: dscli setGroupProperty GroupName PropertyName Value Description: Sets the property of a group. Options: GroupName Specify the name of group. PropertyName Specify the name of the group property. The following is group property list: Value Specify a new value to be set. See the list below. PropertyName GROUP_NAME GROUP_COMMENT Contents Specify the name of the group. Enter the comments of the group. Value Up to characters. Up to characters.
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 Specify the name of group. Output: Displays the status of the specified component group. There are following types of status.
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.
2.1.9 groupPowerOff Syntax: dscli groupPowerOff GroupName [/exs ComponentName1 ComponentName2 ComponentNameN] [/exg GroupName1 GroupName2 ... GroupNameN] ... Description: Forcibly turns off all managed components in a specified group. The managed components in the sub-group are also controlled. 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.
2.1.10 groupReset Syntax: dscli groupReset GroupName [/p] [/exs ComponentName1 ComponentName2 ... ComponentNameN] [/exg GroupName1 GroupName2 ... GroupNameN] Description: Forcibly resets all managed components in a specified group. The managed components in the sub-group are also controlled. 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.
2.1.11 groupPowerCycle Syntax: dscli groupPowerCycle GroupName [/p] [/exs ComponentName1 ComponentName2 ... ComponentNameN] [/exg GroupName1 GroupName2 ... GroupNameN] Description: Forcibly turns off all managed components in a specified group and then turns them on. The managed components in the sub-group are also controlled.
2.1.12 groupShutdownOs Syntax: dscli groupShutdownOs GroupName [/force] [/exs ComponentName1 ComponentName2 ... ComponentNameN] [/exg GroupName1 GroupName2 ... GroupNameN] Description: Shut downs operating systems on all managed components in a specified group. The managed components in the sub-group are also controlled. This command via LAN instructs the NEC ESMPRO Agent Extension service to shutdown the operating system.
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 managed components in the sub-group are also controlled.
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 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.
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. ARMC : BMC is Advanced Remote Management Card.
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.
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.
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.
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.
2.2.9 setServerProperty Syntax: dscli setComponentProperty Component PropertyName Value Description: Sets the property of a managed component. Options: Component Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component. PropertyName Specify the name of the property. The following is property list: Value Specify new value to be set. See the list below.
PropertyName SERVER_SUBNETMASK_1 *1 SERVER_SUBNETMASK_2 SERVER_PHONE_NUMBER Contents Specify subnet mask of the BMC IP address. Specify subnet mask of the extra BMC IP address. Specify the phone number to communicate via modem. Value IP address format IP address format Up to 19 characters Default 255.255 .255.0 255.255 .255.0 (Blank) Specify the alias of the managed component. Up to 255 bytes (Same as compon ent name) SERVER_ALIAS *1 *1 The property can be also set for an EM card.
2.2.11 getServerGroup Syntax: dscli getServerGroup Component Description: Display the name of group that a managed component belongs to. Options: Component Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component. Output: Display the name of group that the managed component belongs to. If it belongs to root, displays “root”. 2.2.
2.2.13 getServerProperty Syntax: dscli getServerProperty Component PropertyName Description: Displays the specified property of a managed component. Options: Component Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component. PropertyName Specify the name of component property. setServerProperty command. For the list of component properties, see the 2.2.9 Output: Displays the specified property of a managed component. 2.2.
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 Blade Height Blade Name Extra BMC IP address to connect to the managed component via LAN.
2.2.15 getDeviceId Syntax: dscli getDeviceId Component Description: Obtains management controller information 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. 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.
2.2.17 getProductName Syntax: dscli getProductName Component Description: Obtains the product name and serial number of a managed component. Options: Component Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component. Output: Displays the following information. ProductName SerialNumber product name of the managed component. serial number of the managed component. 2.2.
2.2.19 setShutdownPolicy Syntax: dscli setShutdownPolicy Component KeyName Value Description: Changes shutdown policy of 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 Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component. KeyName Specify a key name to be set. See the list below. Value Specify a new value to be set.
KeyName SCH_SHUTDOWN_WAIT Contents Specify delay time in seconds to shutdown the managed component after shutdown OS command is issued. * Display only. Cannot be set. Value - 2.2.20 getShutdownPolicy Syntax: dscli getShutdownPolicy Component Description: Obtains shutdown policy of 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.
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.
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 Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component. Output: Display power option information. The following shows an example. Policy Delay Time Delay Time Range : LAST_STATE : RANDOM : 45 - 600 sec 2.2.
/x ModuleNo Specify the CPU/IO module number (0 or 1) if the managed component is a fault tolerant server. This parameter is valid for the network items. For network items, this command changes the setting of the CPU/IO module 0 if you omit this parameter for the fault tolerant server. For the other items, this command changes the setting of both CPU/IO modules regardless of the parameter.
KeyName CFG_LAN_MANAGE1_IP_LAN1 CFG_LAN_MANAGE2_ALERT_LAN1 CFG_LAN_MANAGE2_IP_LAN1 CFG_LAN_MANAGE3_ALERT_LAN1 CFG_LAN_MANAGE3_IP_LAN1 CFG_LAN_ALERT_RETRY_COUNT_LAN1 CFG_LAN_ALERT_RETRY_TIMEOUT_LAN1 CFG_DHCP_LAN2 CFG_LAN_IP_LAN2 CFG_LAN_SUBNET_LAN2 CFG_LAN_GATEWAY_LAN2 CFG_LAN_MANAGE1_ALERT_LAN2 CFG_LAN_MANAGE1_IP_LAN2 CFG_LAN_MANAGE2_ALERT_LAN2 CFG_LAN_MANAGE2_IP_LAN2 CFG_LAN_MANAGE3_ALERT_LAN2 CFG_LAN_MANAGE3_IP_LAN2 CFG_LAN_ALERT_RETRY_COUNT_LAN2 CFG_LAN_ALERT_RETRY_TIMEOUT_LAN2 CFG_SERIAL_MOD
KeyName CFG_SERIAL_BAUDRATE Contents WAN/Direct: Baud Rate CFG_SERIAL_FLOW_CONTROL WAN/Direct Flow Control CFG_SERIAL_DIAL_MODE WAN/Direct Dial Mode WAN/Direct Initial Command WAN/Direct Hang-up Command WAN/Direct DTR Hang-up WAN/Direct Escape Code WAN/Direct Dial retry count WAN/Direct Dial retry interval (in seconds) WAN/Direct Alert retry count WAN/Direct Alert timeout Interval (in seconds) WAN/Direct Primary PPP component Alert WAN/Direct Primary PPP component Phone Number WAN/Direct Primary PPP co
KeyName CFG_SERIAL_MANAGE2_IP Contents WAN/Direct Alert Receiver (2) IP address WAN/Direct Alert Receiver (3) IP address Pager: Alert Receiver (1) Alert Pager: Alert Receiver (1) Phone Number Pager: Alert Receiver (2) Alert Pager: Alert Receiver (2) Phone Number Pager: Pager message Pager: Guide Message Waiting Time (2 seconds unit) Network Property: Management LAN Management LAN Port Network Property: Basic Connection Type CFG_SERIAL_MANAGE3_IP CFG_PAGER_MANAGE1_ALERT CFG_PAGER_MANAGE1_DIAL_NUMBER CFG_
KeyName CFG_NETWORK_DNS_SERVER Contents Network Property: Basic DNS Server Network Property: Basic Host Name CFG_NETWORK_HOST_NAME CFG_NETWORK_DOMAIN_NAME Network Property: Basic Domain Name CFG_NETWORK_GUID Network Property: Basic System GUID Network Property: Access Limitation Access Limitation Type Network Property: Access Limitation IP Address CFG_NETWORK_ACCESS_LIMITATION_TY PE CFG_NETWORK_ACCESS_ADDRESS CFG_NETWORK_HTTP Network Service: Web Server HTTP Network Service: Web Server HTTP Port N
KeyName CFG_MAIL_ALERT_SERVER Contents Alert Mail Alert: SMTP Server SMTP Server Alert Mail Alert: SMTP Server SMTP Port Alert Mail Alert: SMTP Server SMTP Authentication CRAM-MD5 Alert Mail Alert: SMTP Server SMTP Authentication LOGIN Alert Mail Alert: SMTP Server SMTP Authentication PLAIN Alert Mail Alert: SMTP Server User Name Alert Mail Alert: Mail To1 Mail To1 Address Alert Mail Alert: Mail To2 Mail To2 Address Alert Mail Alert: Mail To3 Mail To3 Address Alert Mail Alert: Mail From Alert Mail Alert: M
KeyName CFG_SNMP_ALERT Contents Alert SNMP Alert: Alert Alert SNMP Alert: Computer Name Alert SNMP Alert: Community Name Alert SNMP Alert: Alert Acknowledge Alert SNMP Alert: Alert Process Alert SNMP Alert: Alert Retry Count Alert SNMP Alert: Alert Timeout Alert SNMP Alert: Alert Receiver Primary Alert Alert SNMP Alert: Alert Receiver Primary IP Address Alert SNMP Alert: Alert Receiver Secondary Alert Alert SNMP Alert: Alert Receiver Secondary IP Address Alert SNMP Alert: Alert Receiver Tertiary Alert Aler
KeyName CFG_MISCELLANEOUS_PEF Contents Other: Platform Event Filter Platform Event Filter 44 Value 0: Disabled 1: Enabled
2.2.24 getBmcInfo Syntax: dscli getBmcInfo Component [/x ModuleNo] Description: Obtains BMC configuration information of a specified managed component. Options: Component Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component. /x ModuleNo Specify the CPU/IO module number (0 or 1) if the managed component is a fault tolerant server. This parameter is valid for the network items.
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.
Type Specify an alert type. SNMP: MAIL: SNMP alert MAIL alert 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.
SensorName COOL_DEV_ABNORMAL Contents Cooling Device (Monitoring Abnormal State) Transition to Power Save Microcontroller State Power Unit Redundancy Physical Security(Chassis Intrusion) Platform Security Violation Attempt Processor Power Supply Power Unit State Memory Drive Slot(Bay) POST Event Logging System Event Critical Interrupt Button/Switch Chip Set Cable/Interconnect System Boot/Restart Initiated Boot Error OS Boot OS Stop/Shutdown Slot/Connector System ACPI Power State Watchdog Timer Entity Prese
See the following list for a fault tolerant server.
SensorName PROCESSOR_DEGRADED Contents Processor(Monitoring Degraded State) Module/Board(Monitor ing Degraded State) Microcontroller State Slot/Connector(Monit oring Degraded State) FAN Redundancy Memory Redundancy Power Unit Redundancy Platform Security Violation Attempt Processor Power Supply Power Unit State Memory Drive Slot(Bay) POST Event Logging System Event Critical Interrupt Button/Switch Chip Set System Boot/Restart Initiated Boot Error OS Boot OS Stop/Shutdown Slot/Connector System ACPI Power St
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. Options: Component Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component. Type Specify an alert type. SNMP: MAIL: SNMP alert MAIL alert Output: Displays alert level of BMC configuration information. See 2.2.26 setSensorLevel for details. The following shows an example.
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 Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed 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 Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component. Target Specify an alert receiver.
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 Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed 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.
2.2.32 getPowerStatus Syntax: dscli getPowerStatus Component Description: Obtains the power state of a specified managed component. Options: Component Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component. Output: Displays the power state of a specified managed component. There are the following power states: DC-ON DC-OFF Power-ON Power-OFF 2.2.
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 Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component.
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 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.
2.2.37 reset Syntax: dscli reset Component [/p] Description: Forcibly resets a specified managed component. 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.
2.2.38 powerCycle Syntax: dscli powerCycle Component [/p] Description: Forcibly turns off a specified managed component and then turns it on. 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.
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.
2.2.41 clearSel Syntax: dscli clearSel Component [/force] Description: Clears the System Event Log (SEL) area on a managed component. Options: Component Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed 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.
FileName Specify the filename with path name for saving the IPMI information. /x ModuleNo Specify the CPU/IO module number (0 or 1) if the managed component is a fault tolerant server. If you omit this parameter for the fault tolerant server, this command obtains the information of the CPU/IO module 0. 2.2.44 getSensorList Syntax: dscli getSensorList Component [/x ModuleNo] Description: Creates a sensor list from the previously collected SDR of IPMI information through 2.2.
/x ModuleNo Specify the CPU/IO module number (0 or 1) if the managed component is a fault tolerant server. If you omit this parameter for the fault tolerant server, this command obtains the status of the CPU/IO module 0. 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: 43.
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.
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.
2.2.51 getBmcUserList Syntax: dscli getBmcUserList Component Description: Displays a list of user accounts that is set in the BMC configuration of components Options: Component Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component. Output: The following shows an example. No.1 User User Name Privilege No.2 User User Name Privilege No.
2.2.52 setBmcUserInfo Syntax: dscli setBmcUserInfo Component UserId KeyName Values Description: Changes the user account information for the BMC configuration Options: Component Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component. UserId Specify the number being allocated by user that uses BMC(1 – 12). KeyBane Specify the key name of BMC configuration. See the list below. Value Specify a new value to be set. See the list below.
2.2.54 setPowerRestorePolicy Syntax: dscli setPowerRestorePolicy Component Policy Description: Changes AC-Link policy that specifies working of a managed component when it is turned AC ON. Options: Component Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component. Policy Set AC-Link policy. There are 3 types of the policy. STAY_OFF LAST_STATE POWER_ON The managed component remains OFF when AC power is restored.
2.2.56 getSystemFtLamp Syntax: dscli getSystemFtLamp Component Description: Obtains the state of System FT LED if the managed component is a fault tolerant server. Options: Component Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component. Output: There are the following states of the System FT LED. GREEN_OFF GREEN_ON GREEN_BLINK Power off or simplex Duplex Split mode.
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". getServerNameByGuid findNewServer findNewServerNetAddr createServer deleteServer checkConnection setServerProperty getServerProperty getServerInfo getDeviceId getGuid getServerStatus 2.3.1 getEmCardList Syntax: dscli getEmCardList [/d] Description: Displays the name list of all EM cards registered on NEC ESMPRO Manager.
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 Standby active 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.
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.
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.
The following shows an example. 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 Specify the chassis name.
2.4.4 setChassisProperty Syntax: dscli setChassisProperty ChassisName PropertyName Value Description: Sets the chassis property of a chassis. Options: ChassisName Specify the chassis name. PropertyName Specify the name of the chassis property. See the list below. Value Specify a new value to be set. See the list below. PropertyName CHASSIS_NAME CHASSIS COMMENT Contents Specify the name of the chassis. Enter the comments of the chassis. Value Up to 32 characters. Up to 100 characters.
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.
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 Specify the chassis name. SlotNumber Specify the slot number of CPU blade.
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 Specify the name, the MAC address of LAN port that BMC uses, or the GUID of the managed component. 2.5.2 disconnect Syntax: dscli disconnect Description: Disconnects the currently connected line. 2.5.
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 list below. Value Specify new value to be set. See the list below.
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.
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 NG means this IP address is permitted means this IP address is not permitted. 2.6.
2.6.7 clearPermitIpAddr Syntax: dscli clearPermitIpAddr Description: Removes all IP address ranges in which login from a Web client is permitted.
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. user to be registered is “operator”. Up to 30 users can be created. The user level of the 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.
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 list below. It is valid for “Operator” level user to change the executable authority. OK : Enable to change, NG : Disable to change Value Specify new value to be set. See the list below.
PropertyName UL_REMOTE_BATCH UL_SET_POWER_REST ORE_DELAY UL_SET_AGENT_SETTI NG UL_SET_CONSOLE_LO G UL_SET_ENVIRONMEN T_OPTION UL_SET_BLADE_AUTO_ SETTING UL_ELECTRIC_POWER _MONITORING UL_SET_SERVER_DOW N_MONITORING UL_MODULE_UPDATE_ MAINTENANCE 0 Administrator NG Operator OK 0 NG OK 0 NG OK 0 NG OK 0 NG OK 0 NG OK 0 NG OK 0 NG OK 0 NG OK Contents Value Default Specify the enable/disable of Remote Batch function. Specify the enable/disable of Change Power Option Setting.
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.
