Home

NEC Express5800/R110d-1E User's Manual

1. 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 Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed 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 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 For the list of component properties see the 2 2 9 28 NEC ESMPRO Manager Ver 5 Command Line Interface setServerProperty command Output Displays the specified property of a managed component 2 2 14 getServerlnto Syntax dscli getComponentInfo Component Description Displays the managed component information that includes main component properties Options Component Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed component Output Displays the
2. USER PASSWORD Specify the login password 6 16 Blank OK OK characters USER COMMENT Specify the comment about the user Up to 100 Blank OK OK characters UL POWER ON Specify the enable disable of Power 0 Disabled O NG OK ON 1 Enabled Specify the enable disable of Power 0 Disabled 0 NG OK UE POWERLOFE OFF function 1 Enabled UL_RESET Specify the enable disable of Reset 0 Disabled 0 NG OK function 1 Enabled UL POWER CYCLE Specify the enable disable of Power 0 Disabled 0 NG OK Cycle function 1 Enabled Specify the enable disable of 0 Disabled O NG OK JS PUTOOWNN Shutdown OS function 1 Enabled UL_DUMP Specify the enable disable of DUMP 0 Disabled 0 NG OK switch function 1 Enabled Specify the enable disable of Clear 0 Disabled 0 NG OK DL SER CLEAR System Event Log function 1 Enabled Specify the enable disable of Change 0 Disabled O NG OK DEABMEzREMOTE BMC Configuration function 1 Enabled UL_CONFIG_CREATE Specify the enable disable of Add 0 Disabled 0 NG OK Component function 1 Enabled UL CONFIG CHANGE Specify the enable disable of Set 0 Disabled 0 NG OK Component Property function and 1 Enabled DELETE Delete Component function UL REMOTE CONSOLE Specify the enable disable of Remote 0 Disabled 0 NG OK Console function 1 Enabled Specify the enable disable of Set 0 Disabled O NG OK UES CHERUEE Schedule function 1 Enabled UL REMOTE BATCH Specify the enable di
3. 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 NEC ESMPRO Manager Ver 5 Command Line Interface 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 GREEN_BLINK Blink green AMBER_BLINK Blink amber RED_BLINK Blink red 64 NEC ESMPRO Manager Ver 5 Command Line Interface 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 Displa
4. 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 Component 1 Connection to the server could not be made Timeout Component 2 Connection to the server could not be made Authentication error 2 1 9 groupPowerOff Syntax dscli groupPowerOff GroupName exs ComponentNamel ComponentName2 ComponentNameN exg GroupNamel GroupName2 GroupNameN Description Forcibly turns off all managed components in a specified group The managed components in the sub group are also controlled IMPORTANT e 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 Options GroupName Specify the name of group If you want to control all the components under root specify root exs When you specify exs option and the component na
5. Mail Reply To CFG MAIL ALERT SUBJECT Alert Up to 63characters Mail Alert Mail Subject CFG MAIL ALERT LEVEL Alert O Error Mail Alert 1 Error Warning Alert Level 2 Error Warning Information 3 Separate setting CFG_SNMP_ALERT Alert 0 Disabled SNMP Alert 1 Enabled Alert CFG_SNMP_COMPUTER_NAME Alert Up to 16characters SNMP Alert Computer Name CFG_SNMP_COMMUNITY Alert Up to 16characters SNMP Alert Community Name CFG_SNMP_ALERT_ACKNOWLEDGE Alert 0 Disabled SNMP Alert 1 Enabled Alert Acknowledge CFG_SNMP_ALERT_POLICY Alert 1 One Alert SNMP Alert Receiver Alert Process 2 All Alert Receivers CFG_SNMP_ALERT_RETRY_COUNT Alert 0 7 SNMP Alert Alert Retry Count 41 NEC ESMPRO Manager Ver 5 Command Line Interface KeyName Contents Value CFG SNMP ALERT TIMEOUT Alert 3 30 SNMP Alert Alert Timeout CFG SNMP MANAGE1 ALERT Alert 0 Disabled SNMP Alert 1 Enabled Alert Receiver Primary Alert CFG SNMP MANAGE1 IP Alert IP address format SNMP Alert Alert Receiver Primary IP Address CFG SNMP MANAGE ALERT Alert 0 Disabled SNMP Alert 1 Enabled Alert Receiver Secondary Alert CFG_SNMP_MANAGE2_ IP Alert IP address format SNMP Alert Alert Receiver Secondary IP Address CFG_SNMP_MANAGE3_ALERT Alert 0 Disabled SNMP Alert 1 Enabled Alert Receiver Tertiary Alert CFG SNMP MANAGES IP Alert IP address format SNMP Alert Alert Receiver Tertiary IP Address CFG SNMP ALERT LEVEL Ale
6. Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed component p Force boot from network after the power is turned on 2 2 36 power Off Syntax dscli powerOff Component Description Forcibly turns off a specified managed component IMPORTANT e 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 e 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 Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed component 52 NEC ESMPRO Manager Ver 5 Command Line Interface 2 2 37 reset Syntax dscli reset Component p Description Forcibly resets a specified managed component IMPORTANT e 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 In case that the managed component does not support a force network boot function which boots the component from networ
7. 70 NEC ESMPRO Manager Ver 5 Command Line Interface 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 Specify Retry count for 0 10 5 BMC_RETRY_COUNT communicating to BMC on a managed component BMC TIMEOUT Communication Timeout in seconds 1 15 5 to BMC on a managed component Specify a UDP port number for 1025 65535 47117 BMC_SOURCE_PORT communicating to BMC on a managed component CUI NO RESPONSE TI Specify times in seconds until the 20 1800 60 MEOUT remote console is disconnected due to a communication timeout Specify alias for SysRq key on CUI Not specified E CUI SYS RQ KEY remote console Q Ctrl Alt Q X Ctrl Alt X HISTORY LOG NUMBER Specify maximum number of 2000 10000 2000 _OF_RECORDS application logs Specify a serial port on NEC 1 8 1 ESMPRO Manager component MODEM PORT NUMBER The serial port is used for communicating to the managed component via modem or with direct connection Determine whether to enable disable O Disabled 1 the component monitoring function 1 Enabled MONITORING ENABLE that monitors the power status and the STATUS lamp on each managed component MONITORING AUTO UP Specify i
8. 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 NEC ESMPRO Manager Ver 5 Command Line Interface 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 PropertyName Contents Value Default GROUP_NAME Specify the name of the group Up to 63 None characters GROUP_COMMENT Enter the comments of the group Up to 255 Blank characters Value Specify a new value to be set 2 1 6 getGroupProperty Syntax dscli getGroupProperty GroupName PropertyName Description Displays the property of a group Options GroupName Specify the name of group 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 NEC ESMPRO Man
9. NEC ESMPRO Manager Ver 5 Command Line Interface Output Displays the status of the sensor The following shows an example Current Value 30 00 degrees C C rremt Ses wise Normal Upper non recoverable Threshold Upper critical Threshold 46 00 degrees C Hysteresis 44 00 degrees C Upper non critical Threshold 43 00 degrees C Hysteresis 41 00 degrees C Lower non critical Threshold 3 00 degrees C Hysteresis 5 00 degrees C Lower critical Threshold 0 00 degrees C Hysteresis 2 00 degrees C Lower non recoverable Threshold 2 2 46 getConsoleLog Syntax dscli getConsoleLog Component Description Displays the console log of a specified 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 console log of a specified component 58 NEC ESMPRO Manager Ver 5 Command Line Interface 2 2 47 setBmclpSync 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 This command can be used via LAN when NEC ESMPRO Agent Extension
10. 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
11. findNewServerNetAddr command you can use createServer command See 2 2 6 createServer Options Start IpAddr 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 ist IP Address OZ IS 14 8 2nd IP Address 0 0 0 0 Cilicia We Acleress 2 192 108 14 18 IPMI Version Be cles GUID 84ee20b0 84a1 d511 0080 a0f 94470300 No 2 ist IP Address E LOZA ALS 2nd IP Address OOO 0 Curren Ie wAcleleess 3 192 108 14 108 IPMI Version do bas GUID 00004c79 45c0 0180 0010 f57f80d8cef8 23 NEC ESMPRO Manager Ver 5 Command Line Interface 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 e To register the managed component that is found using findNewComponent command or findNewServerNetAddr command you can use createServer command See 2 2 6 eee ae a eee A een ote 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 Descrip
12. 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 Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed component Output Displays enclosure ID and slot ID The following shows an example Enclosure ID 0040000000 Silos Hk 2 2 2 50 setBmclpAddressLan1 Syntax dscli setBmcIpAddressLanl Component IpAddress force Description Changes the LANI IP address for BMC 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 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 60 NEC ESMPRO Manager Ver 5 Command Line Interface 2 2 51 setBmclpAddressLan2 Syntax dscli setBmcIpAddressLan2 Component IpAddress force Description Changes the LAN2 IP address for BMC 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 IpAddress Specify the IP address of LAN2 for BMP force If you specify force option th
13. managed component information The following information is shown Item Name Contents Component Name Name of the managed component Alias Alias of the managed component Group Name of the group that the managed component belongs to Connection Type Connection type between the managed component and the NEC ESMPRO Manager component BMC Control 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 Check Connection Display Completed if the Check connection has been executed BMC Current IP Address Current BMC IP address to connect to the managed component via LAN Failover 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 LAN1 IP Address BMC IP address to connect to the managed component via LAN BMC LAN1 Subnet Mask Subnet mask of the BMC IP address BMC LAN2 IP Address Extra BMC IP address to connect to the managed component via LAN BMC LAN2 Subnet Mask Subnet mask of the extra BMC IP address Phone Number Phone number of the managed component Product Name Product name of the managed component Serial Number Serial number of the managed component GUID ID for identifying the managed comp
14. 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 EH 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 NEC ESMPRO Manager Ver 5 Command Line Interface 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 E 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 t
15. you can specify force option to delete component forcibly 2 28 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 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 NEC ESMPRO Manager Ver 5 Command Line Interface 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 PropertyName Contents Value Default Determine whether to 0 Disabled 1 enable disable the get console log 1 Enabled CONSOLE_LOG_ENABLE function to save the Remote Console screen data in text format CONSOLE LOG SIZE Specify the maximum size in KB 4 1000 6
16. 0 E Component 1 14 14 0 000 0 000 03 0 0 0 COUNT_LAN1 3 CFG_LAN A IA E RY IM EOUT_LAN1 6 43 NEC ESMPRO Manager Ver 5 Command Line Interface 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 e 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 Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed 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 0 Authentication key 1 Password of primary PPP server 2 Password of secondary PPP server 3 Password of SMTP server 2 2 26 setSensorLevel Syntax dscli setSensorLevel Component Type SensorName Levell 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 s
17. 3 or 11 PPP2 alert receiver 3 Pager1 or 12 Pager2 or 13 SNMP1 or 14 SNMP2 or 15 SNMP3 or 16 1 2 Pager alert receiver Pager alert receiver SNMP alert receiver 1 SNMP alert receiver 2 SNMP alert receiver 3 Fu om lt mH 48 NEC ESMPRO Manager Ver 5 Command Line Interface MAIL1 or 17 MAIL alert receiver 1 MAIL2 or 18 MAIL alert receiver 2 MAIL3 or 19 MAIL alert receiver 3 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 TEST_UNKNOWN Unknown status TEST_TESTING Now Alerting TEST_SUCCESS Alert test is succeeded TEST_ABORT Alert test is failed TEST CALL FAILED Alert test is failed Dial up error 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 c
18. 4 of the console log CONSOLE LOG KEEP CONN Determine whether to get console 0 Disabled 0 log even while remote console is 1 Enabled ECTION not open on web browser Determine whether to 0 Disabled 1 enable disable the fault message 1 Enabled CONSOLE_LOG_FAULT_MESS monitoring function that set fault AGE_MONITORING condition when a fault message string is found on head of each console log line CONSOLE_LOG_FAULT_MESS Specify the character string for the Up to 20 lt BP gt AGE_IDENTIFIER fault message monitoring function characters SERVER NAME 1 Specify the name of the managed Up to 63 None component characters Specify the authentication key to Up to 16 None SERVER AUTHKEY 1 communicate with BMC of the characters managed component Specify the connection type 0 LAN 0 SERVER CURRENT PORT T between the NEC ESMPRO 1 Direct YPE Manager component and the 2 Modem managed component Only LAN can be specified for the EM card SERVER IP_1 1 Specify BMC IP address to IP address 0 0 0 0 communicate via LAN format SERVER IP 2 Specify exira BMC IP address to IP address 0 0 0 0 communicate via LAN format SERVER CURRENT IP 1 Specify current BMC IP address IP address 0 0 0 0 to communicate via LAN format SERVER SUBNETMASK 1 1 Specify subnet mask of the BMC IP address 255 255 IP address format 255 0 26 NEC ESMPRO Manager Ver 5 Command Line Inter
19. ASSIS COMMENT Enter the comments of the chassis Up to 100 characters TIP 2 4 5 getChassisProperty Syntax dscli getChassisProperty ChassisName PropertyName Description Displays the property of the specified chassis Options ChassisName Specify the chassis name 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 NEC ESMPRO Manager Ver 5 Command Line Interface 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 Specify the chassis name 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 Specify a new value to be set PropertyName Conients Value AUTH_KEY Specify the authentication key that is Up to 16 characters configured on BMC RECONFIGURE BMC Enabled means that NEC ESMPE
20. 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 e See NEC ESMPRO Manager Ver 5 Installation Guide about Notes NEC ESMPRO Manager Ver 5 Command Line Interface 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 x Display the list under the specified group or its sub groups Output Shows the example that the groups and components have following structure root H group1 lt GROUP gt H group11 lt GROUP gt Lo component 11 L componentii H group2 lt GROUP gt componenti group3 lt GROUP gt group31 lt GROUP gt Ee component311 L component31 L component32 L__ group32 lt GROUP gt IL component321 L component322 component component3 NEC ESMPRO Manager Ver 5 Command Line Interface Displays the list of groups and components The following shows an example gt dscli getList root gr
21. ID 00301316 cdfe 0180 0010 846e8062d906 MACHO US ORS SEE EERS SWB Component3 GUID 00010203 0405 0607 0809 0a0b0c0d0e0f MACIO OO Oi AC aoe Sci ARMC 21 NEC ESMPRO Manager Ver 5 Command Line Interface 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 Component 1 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 NEC ESMPRO Manager Ver 5 Command Line Interface 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 e To register the managed component that is found using findNewServer command or
22. NEC NEC SM PROS Command Line Interface Document Rev 1 08 NEC ESMPRO Manager Ver 5 Command Line Interface Contents Front Covet A aba kaneis seas aa ua cs ESG o E aa oe spas GER ss nes ane eo Gaes 1 Cont ii A A a A ash 2 Trademarks cion nia 5 About This DOCUMENE id rt titi 6 Chapter About Command Line Interface ee eseceeeescneeeeceseeecssecseesecsessecsaseecsaecesssecseeseeneeeeceaeeeesaesate 7 1 1 System Requirements once da 7 1 2 Howto Execute Commander iaa 8 1 2 1 Notes on Entering Commands misrik eser ipene e eap e aa e adei EEEN e asn 8 1 3 Execution Result i eae E are aia 9 1 4 EXAM O NN 9 1 5 Executing Command from Two or More Manager Server erraram 9 Chapter Command Summary sree esenp aeneo ire aeia SOUTO NEER EEE SE EESE SESE vs POEN alp quado seyaesessepeesty 10 2 1 Group management Commands 0 eee ee cesecesecseeceecseeeeeeeeeeeeeeceesecsaecsaecsaecsaecaaecaeseaeseaeeeeeeeseeeees 10 2 1 1 TAL A A AR RR RP 10 2 1 2 Create Group a en nis ae ee hee 12 2 1 3 delete Group avec sacezees da tess acts ecseesupedods AAA E 12 2 1 4 MOVIDA ee ae 12 2 1 5 setGTOUpRroperty iii rd 13 2 1 6 getGroupProperty sais ete Rite Roti ce GRA ER ain Ries 13 2 1 7 POELGTOUP StAtUs aAA AEDE SEE E EEEE E da tated egies ae pocos a 14 2 1 8 PTOUPPOWELON ii ee rae Re es 14 2 1 9 STOUPPOW ELOEE assist seid eek vee raa a rt 15 2 1610 PrOUpREset visser 16 211 groupPower Cycle sic ina iia ia 17 21 12 gro
23. Name force exs ComponentNamel ComponentName2 ComponentNameN exg GroupNamel 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 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 Options GroupName Specify the name of group If you want to control all the components under root specify root 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 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 Component 1 Connection to the componen
24. O 0 Disabled Manager executes BMC configuration not 1 Enabled only new installed CPU blade but also all 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 IP address of the BMC on the CPU blade 0 Disabled SS may be obtained by DHCP even through the 1 Enabled BMC configuration has not been executed If this option is set Enable NEC ESMPRO Manager always update the IP address when BMC configuration is executed DHCP BMC automatically acquires IP address from 0 Disabled DHCP 1 Enabled IP_ADDRESS Specify IP address set to CPU blade When IP Address form you specify all for SlotNumber option IP address consecutive from specified IP address is sequentially set from the first slot SUBNET_MASK Specify the subnet mask IP Address form DEFAULT_GATEWAY Specify the default gateway IP Address form ALERT_RECEIVER_IP Specify the alert receiver 1 IP address of IP Address form _ADDRESS PC for management 68 NEC ESMPRO Manager Ver 5 Command Line Interface 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 Mana
25. OST_ERR 800 SLOT_CONNECTOR 080 WATCHDOG_TIMER 080 SENSOR_FAILTURE 800 47 NEC ESMPRO Manager Ver 5 Command Line Interface 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 LAN1_1 or 0 LAN1 alert receiver 1 LAN1_2 or 1 LAN1 alert receiver 2 LAN1_3 or 2 LAN1 alert receiver 3 LAN2_1 or 3 LAN2 alert receiver 1 LAN2_2 or 4 LAN2 alert receiver 2 LAN2_3 or 5 LAN2 alert receiver 3 PPP1_1 or 6 PPP1 alert receiver 1 PPP1_2 or 7 PPP1 alert receiver 2 PPP1_3 or 8 PPP1 alert receiver 3 PPP2_1 or 9 PPP2 alert receiver 1 PPP2_2 or 10 PPP2 alert receiver 2 PPP2_
26. This setting is effective only when SCH_DC_OFF_ENABLE is enabled SCH_SHUTDOWN_ENABLE Determine whether to 0 Disabled enable disable the function which 1 Enabled shutdowns OS when the managed component is turned on during the down period specified through scheduled running SCH_SHUTDOWN_WAIT Specify delay time in seconds to shutdown the managed component after shutdown OS command is issued Display only Cannot be set 33 NEC ESMPRO Manager Ver 5 Command Line Interface 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 Options Component Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed component Output Displays shutdown policy For details see 2 2 19 The following shows an example 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 t
27. UTDOWN OS Stop Shutdown OK NG OK SLOT CONNECTOR Slot Connector OK OK OK ACPI System ACPI Power NG NG OK State WATCHDOG TIMER Watchdog Timer OK NG OK ENTITY PRESENCE INFO Entity Presence NG NG OK Information VERSION CHANGE Version Change NG NG OK FRU HOT SWAP FRU Hot Swap NG NG OK SyS SPEC PW STATE System Specific NG NG OK Power State PW CAPPING Power Capping OK OK NG SENSOR FAILURE Sensor Failure OK NG OK MANAGEMENT ENGINE Management Engine OK 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 NEC ESMPRO Manager Ver 5 Command Line Interface 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 type SNMP SNMP alert MAIL MAIL alert Output Displays alert level of BMC configuration information See 2 2 26 setSensorLevel for details The following shows an example TEMP THRESHOLD 111 OLT THRESHOLD 000 AN SENSOR 000 M E PLATFORM_SEC 800 E E ROCESSOR 00 W_SUPPLY 00 Di Sl O W_UNIT_STS EM 000 DRIVE_SLOT 000 VI_LOG_DISABLED 800 YS_EVI 080 RITICAL_INT 000 UTTON_SWITCH 880 MODULE_BOARD 800 SYS_BOOT_RESTART_INIT 880 BOOT_ERR 880 DADA ACPI 880 SMI_TIMEOUT 800 POST_MEM_RESIZE 800 P
28. a property of a specified user 77 NEC ESMPRO Manager Ver 5 Command Line Interface 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 NEC ESMPRO Manager Ver 5 Command Line Interface Revision History 1 00 1 02 1 03 1 04 1 05 1 06 1 07 2009 01 16 2009 10 22 2009 11 24 2010 03 10 2010 04 19 2010 08 31 2011 03 28 2011 06 22 Initial edition Modifies about Trademarks Adds a configuration key for set getBmclnfo command Corrects writing er
29. ager Ver 5 Command Line Interface 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 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 ComponentNamel ComponentName2 ComponentNameN exg GroupNamel 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 Options GroupName Specify the name of group If you want to control all the components under root specify root p Force boot from network after the power is turned on NEC ESMPRO Manager Ver 5 Command Line Interface
30. ce 1 Enabled SSH Interface SSH CFG_NETWORK_SSH_PORT Network 1 65535 Service SSH Interface SSH Port CFG_MAIL_ALERT Alert 0 Disabled Mail Alert 1 Enabled Alert CFG_MAIL_ALERT_TIMEOUT Alert 30 600 Mail Alert Response time of SMTP server CFG_MAIL_ALERT_SERVER Alert Up to 255 characters Mail Alert SMTP Server SMTP Server CFG_MAIL_ALERT_PORT Alert 1 65535 Mail Alert SMTP Server SMTP Port CFG_MAIL_ALERT_CRAMMD5 Alert 0 Disabled Mail Alert 1 Enabled SMTP Server SMTP Authentication CRAM MD5 CFG_MAIL_ALERT_LOGIN Alert 0 Disabled Mail Alert 1 Enabled SMTP Server SMTP Authentication LOGIN 40 NEC ESMPRO Manager Ver 5 Command Line Interface KeyName Contents Value CFG MAIL ALERT PLAIN Alert 0 Disabled Mail Alert 1 Enabled SMTP Server SMTP Authentication PLAIN CFG_MAIL_ALERT_USER Alert Up to 64characters Mail Alert SMTP Server User Name CFG_MAIL_ALERT_TO1 Alert Up to 255 characters Mail Alert Please specify 0 Mail To1 when Mail Alert is Mail To1 Address disabled CFG_MAIL_ALERT_TO2 Alert Up to 255 characters Mail Alert Please specify 0 Mail To2 when Mail Alert is Mail To2 Address disabled CFG_MAIL_ALERT_TO3 Alert Up to 255 characters Mail Alert Please specify 0 Mail To3 when Mail Alert is Mail To3 Address disabled CFG_MAIL_ALERT_FROM Alert Up to 255 characters Mail Alert Mail From CFG_MAIL_ALERT_REPLY Alert Up to 255 characters Mail Alert
31. cuted See NEC ESMPRO Manager Managed Components Summary whether the managed component supports function Options GroupName Specify the name of group If you want to control all the components under root specify root p Force boot from network after reset 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 16 NEC ESMPRO Manager Ver 5 Command Line Interface Output If error has occurred the name and the error message about each error occurred managed component is displayed The following shows an example Component 1 Connection to the server could not be made Timeout Component 2 Connection to the server could not be made Authentication error 2 1 11 groupPowerCycle Syntax dscli groupPowerCycle GroupName p exs ComponentNamel ComponentName ComponentNameN exg GroupNamel 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 IMPORTANT e Since remote power control using NEC ESMPRO Manager is provided by hardware regardless of the condition o
32. d component Output Display power option information The following shows an example POLICY LAST_STATE Power Restore Delay 30 sec Power Restore Delay default O sec 2 2 23 setBmcinfo Syntax dscli setBmcInfo Component KeyName Valu Description Changes BMC configuration information on the managed component The parameter supported according to the kind of BMC is different 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 e CFG_NETWORK_SHARED_BMC_LAN CFG_NETWORK_BMC_MAC is not change Use getBmcInfo command See 2 2 24 getBmcInfo Options Component Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed 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 NEC ESMPRO Manager Ver 5 Command Line Interface KeyName Contents Value CFG COMPUTER NAME Common Up to 15 characters Computer Name CFG COMMUNITY Common Up to 16 characters Community Name CFG ALERT ALL Common Alert 0 Disabled 1 Enabled CFG_POLICY Common Alert Policy 1 One Alert Destination 2 All Alert Destination CFG_ALERT_ACKNOWLEDGE Common Alert Acknowledge O Disabled 1 Enabled CFG_ALERT_LEVEL Common Alert Leve
33. ensorLe velan ei 44 2 227 petsensorbeveL asas iden ltd esti do su padeas riot do fa db ago Srta 46 2 2 28 getAgentExtensionLos iii ind 48 22 29 gt ASA lui di ed 48 2 230 get lestAlertStatUS ci a 49 Did PELSELVETO tal ri ii pad arta 49 2 2 32 cpetPOWerStatuS ii Rei eae ee AS See ea ee 50 2233 PELSALUSLAMP ii toda paren 50 2 234 getPanelnfo iii RA 51 2239 NN 52 2 2 36 O NN 52 DDD Ode lo A titi 53 2238 powerCyclervaii state Ashes REE he A ee ne 54 2 2 39 ShUtdO MOS iria ei ira 55 2 240 dumps ii 55 224 ClearSEl asso ssesscgstetsercotiovsh toveusthevectn ii iria 56 2 242 identifyChassis s sf cie aes en rena ii 56 22 43 Coe pinto eck O 56 2 244 getSensorbistsccicakei Aid 57 22450 PELSENSOLSTALUS iaa plo 57 2 246 petConsoleLOP aiii ines a A pa i ee Ca DE aa edad 58 2247 SCtUBMICIPS VDC eE paes spestes re cusses Sopdet EEE E terete se aes ieee 59 2 248 Set BiMClpS YN wees rss TS ea ASE OE ed es ean EIA ey 59 22 40 getBladeSlotld ciutat 60 2 2 50 setBmclpAddressLanl inician ia 60 2 25 setBmiclpAddresslian2 core rt tdi trece boda creia 61 EM Card Management Commands rece nono cera cnn nnnn aeee nn nncnnecnnecnnos 62 2 3 1 SetEmCardliStd it A id ie 62 2 3 2 SetEmA cover 63 2 3 3 identify EM A as 63 2 3 4 getEmStatus Lamp A A 64 Chassis Manasement Commands octanos id 65 2 4 1 getBladeEnclosurel ista 65 2 4 2 getChassisSIotState n eane ri te tease sapere 65 2 4 3 getChassiSINTO
34. eparate setting Use setBmcInfo command to change alert level to the separate setting of component See 2 2 23setBmclnfo 2 is not use Use getSensorLevel command See 2 2 27 getSensorLevel Options Component Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed component 44 NEC ESMPRO Manager Ver 5 Command Line Interface Target Specify an alert type SNMP SNMP alert MAIL MAIL alert SensorName Specify the key name of sensor See the following list Levell Specify the alert level of error Level2 Specify the alert level of warning Level3 Specify the alert level of information O Disable to change SNMP alert or MAIL alert of alert level 1 Enable to change SNMP alert or MAIL alert to1 of alert level 2 Enable to change MAIL alert to2 of alert level 3 Enable to change MAIL alert to3 of alert level 4 Enable to change MAIL alert to1 or MAIL alert to2 of alert level 5 Enable to change MAIL alert to1 or MAIL alert to3 of alert level 6 Enable to change MAIL alert to2 or MAIL alert to3 of alert level 7 Enable to change MAIL alert to1 MAIL alert to2 or MAIL alert to3 of alert level 8 SNMP alert and MAIL alert of unalterable alert level TIP See the following list OK Enable to change NG Disable to change SensorName Contents Level1 Level2 Level3 TEMP_THRESHOLD Temperature OK OK OK Monitoring Threshold VOLT_THRESHOLD Voltage Monitori
35. ess of LAN port that BMC uses or the GUID of the managed component 56 NEC ESMPRO Manager Ver 5 Command Line Interface 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 getIpmilnfo command and displays the list The SDR record ID indicating each sensor is also displayed Options Component Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed 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 Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed component Recordid Specify the SDR record ID from the sensor list displayed by 2 2 44 getSensorList command 57
36. f IP address check OK means this IP address is permitted NG means this IP address is not permitted 2 6 5 addPermitlpAddr 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 You can login to NEC ESMPRO Manager from a web browser on the component that NEC mate O ts sleeve nat the TE adress 1 not pernate vane Mis Commend Options Start IpAddr 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 removePermitlpAddr Syntax dscli removePermit IpAddr StartlpAddr EndIpAddr Description Removes IP address range in which login from a Web client is permitted Options Start IpAddr Specify the start IP address of IP address range EndIpAddr Specify the end IP address of IP address range 73 NEC ESMPRO Manager Ver 5 Command Line Interface 2 6 7 clearPermitlpAddr Syntax dscli clearPermitIpAddr Description Removes all IP address ranges in which login from a Web client is permitted 74 NEC ESMPRO Manager Ver 5 Command Line Interface 2 7 User Management Commands 2 7 1 createUser Syntax dscli createUser UserName Password Descriptio
37. f 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 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 Options GroupName Specify the name of group If you want to control all the components under root specify root p Force boot from network after the power is turned on 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 17 NEC ESMPRO Manager Ver 5 Command Line Interface Output If error has occurred the name and the error message about each error occurred managed component is displayed The following shows an example Component 1 Connection to the server could not be made Timeout Component 2 Connection to the server could not be made Authentication error 2 1 12 groupShutdownOs Syntax dscli groupShutdownOs Group
38. face PropertyName Contents Value Specify subnet mask of the extra IP address 255 255 SERVER A UBNETMASEOS BMC IP address format 255 0 SERVER PHONE NUMBER Specify the phone number to Up to 19 Blank communicate via modem characters Specify the alias of the managed Up to 255 bytes Same component as SERVER ALIAS 1 compon ent name 1 The property can be also set for an EM card Value Specify new value to be set e 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 Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed component GroupName Specify the name of new group If you want to move the component under root specify root 27 NEC ESMPRO Manager Ver 5 Command Line Interface 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
39. ger 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 Output The following shows an example RECONFIGURE_BMC Disable REWRITE_IP_ADDRESS Diasable D A HCP Enable ER RECRIVER TP ADDRESS 3 OAR 168 1418 69 NEC ESMPRO Manager Ver 5 Command Line Interface 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 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 Now connecting CONNECTED Connection is complete DISCONNECTING Now disconnecting DISCONNECTED Disconnection is complete CONNECTION_ FAILURE Failed to connect NO_CARRIER Line is disconnected BUSY Now talking NO_DIALTONE Cannot detect dialtone
40. he 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 E 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 component CHECK 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 EH 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 NEC ESMPRO Manager Ver 5 Command Line Interface Chapter1 About Command Line Interface The NEC ESMPRO Manager command line interface provides a set of commands that can control managed componen
41. ice ID ELO Device Rev Bl Fw Rev amp 010 0 Manvi ac ic unas ID AUS Product ID 3 AOS 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 Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed 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 Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed component Output Displays the following information 31 NEC ESMPRO Manager Ver 5 Command Line Interface ProductName product name of the managed component SerialNumber serial number of the managed component 2 2 18 getSoftwarelnfo Syntax dscli getSoftwarelnfo 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 Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed component Output Displays version information The following shows an example Agent Extension Version 2 03 04 BIOS Version 3 Go O LOG OS Version Wi
42. ime 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 Options Component Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed 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 NEC ESMPRO Manager Ver 5 Command Line Interface 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 Specify the name the MAC address of LAN port that BMC uses or the GUID of the manage
43. is command changes the IP address even while an OS is running 61 NEC ESMPRO Manager Ver 5 Command Line Interface 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 The following shows an example If d option is not specified EM0001 002 ee ni E If d option is specified EM0001 GUID 01b21dd2 1dd2 11b2 2fa4 003013630cc5 EM0002 GUID 01b21dd2 1dd2 11b2 49bd 003013630cc0 62 NEC ESMPRO Manager Ver 5 Command Line Interface 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
44. ission 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 e See NEC ESMPRO Manager Ver 5 Installation Guide about the system requirement of NEC ESMPRO Manager NEC ESMPRO Manager Ver 5 Command Line Interface 1 2 Howto Execute Commands To execute a command enter the command following the command prompt as shown below dscli CommandName Option dscli Indicates the NEC ESMPRO Manager command line interface command CommandName 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 Examplel Input null string dscli setGroupProperty MyGroup GROUP_COMMENT Example 2 Input special characters dscli setServerProperty MyServer CFG SERIAL INIT ATE1Q0V1X4 amp D2 amp 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 b
45. k 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 e 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 Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed component p Force boot from network after reset 53 NEC ESMPRO Manager Ver 5 Command Line Interface 2 2 38 powerCycle Syntax dscli powerCycle Component p Description Forcibly turns off a specified managed component and then turns it on IMPORTANT e 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 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 e 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 Optio
46. l 0 no Alert 1 6 Alert Level 1 6 CFG_LAN_CONTROL_LAN1 Common 0 Disabled Remote Control LAN1 1 Enabled CFG_SERIAL_CONTROL Common 0 Disabled Remote Control 1 Enabled WAN Direct CFG LAN REDIRECTION Common 0 Disabled Redirection LAN 1 Enabled CFG_SERIAL_REDIRECTION Common 0 Disabled Redirection WAN Direct 1 Enabled CFG LAN CONTROL LAN2 Common 0 Disabled Remote Control LAN2 1 Enabled CFG_LAN_ALERT_POLICY_LAN Common 0 LAN1 LAN1 LAN2 priority 1 LAN2 CFG_LAN_ALERT_POLICY_DESTINATION Common 0 LAN Channel LAN Alert Receiver priority 1 Alert Receiver CFG_DHCP LAN1 0 Disabled Obtain an IP Address 1 Enabled automatically DHCP CFG_LAN_IP_LAN1 LAN1 IP address format IP Address CFG_LAN_SUBNET_LAN1 LAN1 IP address format Subnet Mask CFG_LAN_GATEWAY_LAN1 LAN1 IP address format Default Gateway CFG_LAN_MANAGE1_ALERT_LAN1 LAN1 0 Disabled Alert Receiver management 1 Enabled PC 1 Alert CFG_LAN_MANAGE1_IP_LAN1 LAN1 IP address format Alert Receiver management PC 1 IP address CFG_LAN_MANAGE2_ALERT_LAN1 LAN1 0 Disabled Alert Receiver management 1 Enabled PC 2 Alert CFG_LAN_MANAGE2_IP_LAN1 LAN1 IP address format Alert Receiver management PC 2 IP address CFG_LAN_MANAGE3_ALERT_LAN1 LAN1 Alert Receiver management PC 3 Alert 0 Disabled 1 Enabled KeyName CFG_LAN_MANAGE3_IP_LAN1 NEC ESMPRO Manager Ver 5 Command Line Interface Contents LAN1 Ale
47. lowing shows an example CPU Blade ig SERVER OOO i 2 SERVER_0002 3 4 SERVER_0003 Double wide 5 Not installed 6 7 8 Not registered ot installed ot registered EM Card 1 EM0001 2 EM0002 Switch Module Installed Installed Not installed Not installed Not installed Not installed y Gil ds CODA 2 4 3 getChassisInfo Syntax dscli getChassisInfo ChassisName Description Displays information on the specified chassis Options ChassisName Specify the chassis name Output Display information on the specified chassis Item Name Contents Chassis Name Name of the chassis Comments Comments of the chassis Rack Name Displays the rack name which is set on the EM card Rack ID Displays the rack id which is set on the EM card Unit Name Displays the unit name which is set on the EM card Serial Number Displays the chassis serial number of the blade enclosure 66 NEC ESMPRO Manager Ver 5 Command Line Interface 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 Value Specify a new value to be set PropertyName Contents Value CHASSIS_NAME Specify the name of the chassis Up to 32 characters CH
48. me 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 15 NEC ESMPRO Manager Ver 5 Command Line Interface Output If error has occurred the name and the error message about each error occurred managed component is displayed The following shows an example Component 1 Connection to the server could not be made Timeout Component 2 Connection to the server could not be made Authentication error 2 1 10 groupReset Syntax dscli groupReset GroupName p exs ComponentNamel ComponentName2 ComponentNameN exg GroupNamel GroupName2 GroupNameN Description Forcibly resets all managed components in a specified group The managed components in the sub group are also controlled IMPORTANT e 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 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 exe
49. n 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 2 7 2 deleteUser Syntax dscli deleteUser UserNam 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 The following shows an example Admin Administrator Userl Operator User2 Operator 75 NEC ESMPRO Manager Ver 5 Command Line Interface 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 Contents Value Defaut Admink Ope strator rator USER NAME Specify the user name Up to 16 Blank OK OK characters
50. n installed Not Installed Remote KVM and Media License has not been installed Unsupported Remote KVM and Media License is not supported for the component The state of Remote KVM and Media License is unknown The following shows an example Component 1 Installed Component 2 Installed Component 3 Not Installed Component 4 Unsupported Component 5 20 NEC ESMPRO Manager Ver 5 Command Line Interface 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 SWB indicates that the managed component is a kind of switch blade Output Displays the name list of all managed components registered on NEC ESMPRO Manager The following shows an example If d option is not specified Component 1 Component 2 Component 3 If d option is specified Component 1 GUID 02010202 0000 0000 0000 000000000000 INCH OOS SOs LS Saci e OO Ral INEA OS SOS sis EXPRESSSCOPE Engine Component 2 GU
51. naged 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 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 Component 1 NEC ESMPRO Manager Ver 5 Command Line Interface 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 Specify the name of group If you want to control all the components under root specify root Output The following are states of Remote KVM and Media License Installed Remote KVM and Media License has bee
52. ndows 2003 Server LAN driver Version DO 21785 2 2 19 setShutdownPolicy Syntax dscli setShutdownPolicy Component KeyName Valu 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 See the list below Value Specify a new value See the list below KeyName Contents Value 32 NEC ESMPRO Manager Ver 5 Command Line Interface KeyName Contents Value SCH_ACLINK_STAYON_ENABLE Determine whether to 0 Disabled enable disable the function that 1 Enabled changes AC LINK policy to Always Power On when OS shutdown is executed through scheduled running SCH_AC_LINK Specify AC LINK Policy E This setting works like as setPowerRestoreDelay command Display only Cannot be set SCH DC OFF ENABLE Determine whether to O Disabled enable disable the function that 1 Enabled turns the managed component 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 SCH_DC_OFF_DELAY Specify delay time in minutes to 5 60 turn the managed component off after shutdown OS
53. ng OK OK OK Threshold FAN_SENSOR FAN Speed OK OK OK COOL_DEV_THRESHOLD Cooling Device OK OK OK Monitoring Threshold TEMP_ABNORMAL Temperature OK NG OK Monitoring Abnormal State POST_MEM_RESIZE POST Memory NG OK OK Resize MODULE_BOARD Module Board Missin OK NG OK 9 SMI_TIMEOUT SMI Timeout OK NG OK VOL_ABNORMAL Voltage Monitoring OK NG OK Abnormal State 45 NEC ESMPRO Manager Ver 5 Command Line Interface SensorName Contents Level1 Level2 Level3 COOL_DEV_ABNORMAL Cooling Device OK OK OK Monitoring Abnormal State TRANSITION_PW_SAVE Transition to Power NG NG OK Save MICROCONTROLL_STS Microcontroller State NG OK OK PW_UNIT_REDUN Power Unit OK OK OK Redundancy PHY_SEC Physical NG NG OK Security Chassis Intrusion PLATFORM_SEC Platform Security NG NG OK Violation Attempt PROCESSOR Processor OK NG OK PW_SUPPLY Power Supply NG OK OK PW_UNIT_STS Power Unit State OK OK OK MEM Memory OK NG OK DRIVE_SLOT Drive Slot Bay OK OK OK POST_ERR POST OK NG OK EVT_LOG_DISABLED Event Logging NG OK OK SYS_EVT System Event NG NG OK CRITICAL_INT Critical Interrupt OK NG OK BUTTON SWITCH Button Switch NG NG OK CHIP_SET Chip Set OK NG OK CABLE_INTERRUPT Cable Interconnect NG NG OK SYS_BOOT_RESTART_INIT System Boot Restart NG NG OK Initiated BOOT ERR Boot Error NG NG OK Os BOOT OS Boot NG NG OK OS STOP SH
54. ns Component Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed component p Force boot from network after the power is turned on 54 NEC ESMPRO Manager Ver 5 Command Line Interface 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 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 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 e 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 Options Compone
55. nt Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed component 55 NEC ESMPRO Manager Ver 5 Command Line Interface 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 42 identifyChassis Syntax dscli identifyChassis Component Period Description Turns on the Unit ID lamp 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 Period Specify lamp on period in seconds You can specify 0 255 2 2 43 getlpmilnfo Syntax dscli getIpmilnfo 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 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 Specify the name the MAC addr
56. nterval times in seconds to 1 60 5 DATE INTERVAL update automatically the displays of component status Specify interval times in 0 5000 500 RC POWER CONTROL milliseconds at which power control NTERVAL MILLIS is performed continuously for multiple components RMI PORT Specify a TCP port number for RMI 1024 65535 1099 Value Specify new value to be set 71 NEC ESMPRO Manager Ver 5 Command Line Interface 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 Output Display the value of the specified option 2 6 3 getPermitipAddrList Syntax dscli getPermitIpAddrList Description See 2 6 1 setOption for option list 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 Lg 192 US sd 192 GS 0 254 NEAR TZ LOS od o LO NOS LIZ LOS 2 ILO 72 NEC ESMPRO Manager Ver 5 Command Line Interface 2 6 4 isPermitlpAddr 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 o
57. o 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 Output Displays the front panel information The following shows an example Power Status 5 SO_Ce STATUS Lamp GREEN_ON LCDO Prepare To Boot LCD1 8 Watchdog Status 3 SIVARICEID Watchdog Use SMS OS Watchdog Interval 10 sec POH g 2628210 mila 51 NEC ESMPRO Manager Ver 5 Command Line Interface 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 See NEC ESMPRO Manager Managed Components Summary whether the managed component supports function e 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
58. ol 2 RTS CTS 3 XON XOFF CFG_SERIAL_DIAL_MODE WAN Direct 1 Pulse Dial Mode 2 Tone CFG_SERIAL_INIT WAN Direct Up to 48 characters Initial Command CFG_SERIAL_HANG_UP WAN Direct Up to 8 characters Hang up Command 37 NEC ESMPRO Manager Ver 5 Command Line Interface KeyName Conients Value CFG_SERIAL_DTR_HANG_UP WAN Direct 0 Disabled DTR Hang up 1 Enabled CFG_SERIAL_ESCAPE_CODE WAN Direct 1character Escape Code CFG_SERIAL_DIAL_RETRY_COUNT WAN Direct 0 7 Dial retry count CFG_SERIAL_DIAL_RETRY_INTERVAL WAN Direct 60 240 Dial retry interval in seconds CFG_SERIAL_ALERT_RETRY_COUNT WAN Direct 0 7 Alert retry count CFG_SERIAL_ALERT_RETRY_INTERVAL WAN Direct 3 30 Alert timeout Interval in seconds CFG_SERIAL_ALERT_PPP1 WAN Direct 0 Disabled Primary PPP component 1 Enabled Alert CFG_SERIAL_DIAL_NUMBER_PPP1 WAN Direct Primary PPP component Phone Number Up to 19 characters CFG_SERIAL_USER_ID_PPP1 WAN Direct Primary PPP component User ID Up to 16 characters CFG_SERIAL_DOMAIN_PPP1 WAN Direct Primary PPP component Domain Up to 16 characters CFG_SERIAL_ALERT_PPP2 WAN Direct Secondary PPP component Alert 0 Disabled 1 Enabled CFG_SERIAL_DIAL_NUMBER_PPP2 WAN Direct Secondary PPP component Phone Number Up to 19 characters CFG_SERIAL_USER_ID_PPP2 WAN Direct Secondary PPP component User ID Up to 16 character
59. omponent monitoring function Options Component Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed component Output Displays the managed component status as following ERROR Error WARNING Warning UNKNOWN Unknown or connection error DC OFF DC OFF 49 NEC ESMPRO Manager Ver 5 Command Line Interface 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 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 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 Specify the name the MAC address of LAN port that BMC uses or the GUID of the managed component Output Displays the state of a specified managed component STATUS lamp There are the following states of the STATUS lamp OFF Turn off GREEN_ON Turn on green GREEN_BLINK Blink green AMBER_ON Turn on amber AMBER_BLINK Blink amber RED_ON Turn on red RED_BLINK Blink red 50 NEC ESMPRO Manager Ver 5 Command Line Interface 2 2 34 getPanellnfo Syntax dscli getPanelInf
60. onent IPMI Version IPMI version that the managed component supports Remote KVM and State of Remote KVM and Media License of the managed component If this Media License managed component does not contain EXPRESSSCOPE Engine series this item is not shown See 2 1 14 getGroupRemoteKvmLicense for details Chassis Name 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 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 Blade width with the occupied slot count This item is shown If the managed component is CPU blade or switch blade 29 NEC ESMPRO Manager Ver 5 Command Line Interface Blade Height Blade Height with the occupied slot count This item is shown If the managed component is CPU blade or switch blade Blade Name Blade name This item is shown if the managed component has the name 30 NEC ESMPRO Manager Ver 5 Command Line Interface 2 2 15 getDeviceld Syntax dscli getDeviceld 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 Dev
61. oupl lt GROUP gt group2 lt GROUP gt component 1 group3 lt GROUP gt component 2 component 3 Displays the case specified g option The following shows an example gt dscli getList root g groupl lt GROUP gt group2 lt GROUP gt group3 lt GROUP gt Displays the case specified x option The following shows an example gt dscli getList root x root groupl lt GROUP gt group11 lt GROUP gt component111 component11 group2 lt GROUP gt component 1 group3 lt GROUP gt group31 lt GROUP gt component 311 component 31 component 32 group32 lt GROUP gt component 321 component 322 component 2 component 3 Displays the case specified g and x option The following shows an example gt dscli getList root g x root groupl lt GROUP gt group11 lt GROUP gt group2 lt GROUP gt group3 lt GROUP gt group31 lt GROUP gt group32 lt GROUP gt 11 NEC ESMPRO Manager Ver 5 Command Line Interface 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 2 1 3 deleteGroup Syntax dscli deleteGroup GroupName Description
62. rors 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 getBmclnfo 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 ESMPRO Manager Ver 5 Command Line Interface O NEC Corporation 2011 79
63. rt O Error SNMP Alert 1 Error Warning Alert Level 2 Error Warning Information 3 Separate setting CFG MISCELLANEOUS SEL Other 0 Stop logging SEL SEL 1 Clear all SEL Behavior when SEL 2 Overwrite oldest repository is full SEL CFG MISCELLANEOUS PEF Other 0 Disabled Platform Event Filter 1 Enabled Platfrom Event Filter 2 2 24 getBmcinfo Syntax dscli getBmcInfo Component 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 Output Displays BMC configuration information See 2 2 23 setBmcInfo for details 42 NEC ESMPRO Manager Ver 5 Command Line Interface The following shows an example CFG_COMPUT CFG_COMMUNITY public CFG_ALER ER_NAM ALL 1 CFG_POLICY 1 CFG_ALER CE HA CFG_ALER ACKNOWL _LEVEL 4 EDGE 1 DIRECTION 1 CERA ME SERIA O REDIR CHEMO BRA CHCETA CIMEIRA CHCETA CHCE IAN CITE IWA CHCETA CFG_LAN tia CFG_LAN_ GATI _MANAGE1_ALE _MANAGE1_1P MANAGE2_ALE CFG_LAN_MANAGE2_IP _MANAG _MANAGE3_1P _ CONTRO LAN1 192 168 CCR ANS UNEN AS A OO EWAY LAN1 192 168 14 1 ROL LAN1 1 ECTION 1 L 1 AN1 AN1 E3 ALE AN1 ALERT R E RT LAN1 0 RT LAN1 0 RT LAN1
64. rt Receiver management PC 3 IP address Value IP address format CFG_LAN_ALERT_RETRY_COUNT_LAN1 LAN1 0 7 Alert Retry Count CFG_LAN_ALERT_RETRY_TIMEOUT_LAN1 LAN1 Alert Timeout in 3 30 seconds CFG_DHCP_LAN2 LAN2 0 Disabled Obtain an IP Address 1 Enabled automatically DHCP CFG_LAN_IP_LAN2 LAN2 IP address format IP Address CFG_LAN_SUBNET_LAN2 LAN2 IP address format Subnet Mask CFG_LAN_GATEWAY_LAN2 LAN2 IP address format Default Gateway CFG_LAN_MANAGE1_ALERT_LAN2 LAN2 0 Disabled Alert Receiver management 1 Enabled PC 1 Alert CFG LAN MANAGE1 IP LAN2 LAN2 IP address format Alert Receiver management PC 1 IP address CFG_LAN_MANAGE2_ALERT_LAN2 LAN2 0 Disabled Alert Receiver management 1 Enabled PC 2 Alert CFG_LAN_MANAGE2_IP_LAN2 LAN2 IP address format Alert Receiver management PC 2 IP address CFG_LAN_MANAGE3_ALERT_LAN2 LAN2 0 Disabled Alert Receiver management 1 Enabled PC 3 Alert CFG_LAN_MANAGE3_IP_LAN2 LAN2 IP address format Alert Receiver management PC 3 IP address CFG_LAN_ALERT_RETRY_COUNT_LAN2 LAN2 0 7 Alert Retry Count CFG_LAN_ALERT_RETRY_TIMEOUT_LAN2 LAN2 3 30 Alert Timeout in seconds CFG_SERIAL_MODE WAN Direct Mode 1 Direct 2 Modem CFG_SERIAL_BAUDRATE WAN Direct Baud Rate 1 9600bps 2 19 2Kbps 3 57 6Kbps 4 115 2Kbps CFG_SERIAL_FLOW_CONTROL WAN Direct 1 None Flow Contr
65. s CFG_SERIAL_DOMAIN_PPP2 WAN Direct Secondary PPP component Domain Up to 16 characters CFG SERIAL MANAGE1 IP WAN Direct IP address format Alert Receiver 1 IP address CFG SERIAL MANAGEZ IP WAN Direct IP address format Alert Receiver 2 IP address CFG SERIAL MANAGES IP WAN Direct IP address format Alert Receiver 3 IP address CFG PAGER MANAGE1 ALERT Pager 0 Disabled Alert Receiver 1 Alert 1 Enabled CFG PAGER MANAGE1 DIAL NUMBER Pager Up to 19 characters Alert Receiver 1 Phone Number CFG PAGER MANAGE2 ALERT Pager 0 Disabled Alert Receiver 2 Alert 1 Enabled 38 NEC ESMPRO Manager Ver 5 Command Line Interface KeyName Contents Value CFG PAGER MANAGE2 DIAL NUMBER Pager Up to 19 characters Alert Receiver 2 Phone Number CFG PAGER MESSAGE Pager Up to 29 characters Pager message CFG PAGER TIMEOUT Pager 0 30 Guide Message Waiting Time 2 seconds unit CFG NETWORK SHARED BMC LAN Network Property Management Management LAN Port LAN 0 Management LAN 1 Shared System LAN CFG_NETWORK_CONNECTION_TYPE Network 0 Auto Negotiation Property 1 100Mbps Full Basic Connection Type Duplex 2 100Mbps Half Duplex 3 10Mbps Full Duplex 4 10Mbps Half Duplex CFG_NETWORK_BMC_MAC Network MAC address format Property BMC MAC Address CFG_NETWORK_DHCP Network 0 Disabled Property 1 Enabled Basic DHCP CFG NETWORK IP LAN Net
66. sable of Remote 0 Disabled 0 NG OK Batch function 1 Enabled UL SET POWER REST Specify the enable disable of Change 0 Disabled 0 NG OK ORE DELAY Power Option Setting 1 Enabled 76 NEC ESMPRO Manager Ver 5 Command Line Interface PropertyName Contents Value Default Admini Ope strator rator UL SET AGENT SETTI Specify the enable disable of Change 0 Disabled 0 NG OK NG Agent Setting 1 Enabled UL SET CONSOLE LO Specify the enable disable of Change 0 Disabled 0 NG OK G Console log Setting 1 Enabled UL SET ENVIRONMEN Specify the enable disable of Change 0 Disabled 0 NG OK T OPTION Environment Setting 1 Enabled UL SET BLADE AUTO Specify the enable disable of Change 0 Disabled 0 NG OK SETTING CPU Blade Auto Setting 1 Enabled UL ELECTRIC POWER Specify the enable disable of Start or 0 Disabled 0 NG OK _ MONITORING Stop Read Power Value 1 Enabled UL_SET_SERVER_DOW Specify the enable disable of Change 0 Disabled 0 NG OK N_MONITORING Component Monitoring function 1 Enabled Value Specify new value to be set 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
67. 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 Value Specify a new value 0 Disable 1 Enable TIP e 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 getBmclpSync 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 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 BMC IP Address Synchronization The following shows an example Agent Config BMC IP Sync Enable 59 NEC ESMPRO Manager Ver 5 Command Line Interface 2 2 49 getBladeSlotld Syntax dscli getBladeSlotId Component Description Execute 2 2 41 getlpmilnfo command previously Obtains enclosure ID and slot ID of a
68. t could not be made Timeout Component 2 Connection to the component could not be made Authentication error 18 NEC ESMPRO Manager Ver 5 Command Line Interface 2 1 13 groupSetPowerRestoreDelay Syntax dscli groupSetPowerRestoreDelay GroupName DelayTime x Policy exs ComponentNamel Component Name aves Component NameN exg GroupNamel 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 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 Options GroupName Specify the name of group If you want to control all the components under root specify root 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 ma
69. tion 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 IpAddri 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 e The name of component that is already registered cannot be specified to ComponentName e The IP address that is already registered cannot be specified to IpAddrland IpAddr2 Set other properties using 2 2 9 setServerProperty command 24 NEC ESMPRO Manager Ver 5 Command Line Interface 2 2 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
70. ts 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 e 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 E 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 E EM Card Management Commands Use to operate an EM card EH Chassis Management Commands Use to operate a chassis EH Communication Management Commands Use to change settings for connection to a managed component via modem or directly E Environment Setting Commands Use to view and change the settings of NEC ESMPRO Manager EH User Management Commands Use to manage users who operate NEC ESMPRO Manager on web browser EH 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 perm
71. uni AA 66 2 4 4 SetC hassis Property ito 67 2 4 5 get Chassis Property 2 225 va lala de aie ila Sea ie aided Aiea 67 2 4 6 setBladeAuto Setting id 68 2 4 7 getBlad AutoSetting jscnraedieneh elias nein ean Seine ies 69 Communication Management Commands cecseeescssssecsecseesecseesececeeesscceaeeecsaeceessesaeeseeneseeeeaees 70 2 5 1 COMME aia a 70 25 2 disconnect hi a iba 70 2 5 3 getConnectonStatus coi ia A ea 70 Environment Setting Commands seigarrenean e e e a aria eiii 71 2 6 1 SetOption Misti a 71 2 6 2 O A NN 72 2 6 3 getPermtlpAdd Dista teen ee eh he ne a Se ee a 72 2 6 4 1S Perrin tL pA Gi ii 73 2 6 5 addPermitIpA ddr cinta ion 73 2 6 6 TemovePerimitIpAdAR coi een riera ies 73 2 6 7 clearPermitIpA dd siii A A 74 User Management Commands iii ira dis ii 75 2 7 1 Create User tis ae tt a 75 21 2 delete Usada a 15 NEC ESMPRO Manager Ver 5 Command Line Interface 2 8 2 7 3 PEt SOLAS tai 75 2 7 4 setUserPrOpertycoioiana cl 76 2 7 5 petUserProperty NN 77 Other Commands siti 2teeal aie AS 78 2 8 1 SetAppliCAONLOS vseree Hei Ss sorsestoecits E a bitea ida aqu co ias aie e ee tear 78 2 8 2 DOUE la A aed dal WEG ices 78 2 8 3 El ps eet NN 78 NEC ESMPRO Manager Ver 5 Command Line Interface 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
72. upShutdownOs ci ie Aa i aie eee 18 21 13 groupsetPowerRestoreDelay ovina ist 19 2 1 14 getGroupRemoteKvmLicense ooconcoonnonoccnoncnnconnnnconononononnnonnonncnnon nono nono aeee ra non non con cnn non crac 20 2 2 Component Management COMIMAN S ooooococnconocononononononnnonnnonnnonnnonnnnnnnnnn cone cn nono neon nono nono aerea nrnncnnnons 21 2 2 1 getServerLlitii AA 21 222 getServerNameByMacAddr aiii tra 22 2 2 3 g tServerNameB y Guid eiii id dd 22 2 2 4 A O 23 2 2 5 findNewServerNetA ddr niione nenii iie a ae ENa oe Sapasie eva E a es 24 2 2 6 O O O ON RN 24 2 2 7 deleteServer oia 25 2 2 8 CheckConnection id iota ceca seid A eee eee 25 2 2 9 setS erverProperty a See ei RA ee ea A aa al rasta esa vasta nad 26 220 MOVES CI VE ti ias Potes ile 27 221 O ih 28 DZ setCurrentPOR ua 28 2 213 OELSCLVErPrOpErty ii A AA E a 28 22514 oetServerIn o nnna fans ain do a a herd dl cup das alii nora sad rena do 29 22 19 gt PetDevicel daria 31 PAPAI K O A EE EEE SE seat sesso O 31 2 2217 getProd ctName me n e E A R E R RE EE RAA 31 22 18 get Otal ads 32 2 219 setShutdownPoli y ios iia a pie 32 22 20 setShutdowniPoli cy aiii a 34 2 2 2 setPowerRestoreDelay iii ii 34 2 2 22 petPowerRestoreDelay civilidad 35 2 2 23 sEtBIMCI O veia ee A calos GR i eR Re Re 35 2 2 24 Be tBIMCID O POSAR RENNES RR RPE OR RR das 42 NEC ESMPRO Manager Ver 5 Command Line Interface 2 3 2 4 2 5 2 6 2 7 SS O E O RO 44 22 20 SEtS
73. work IP address format Property Basic IP Address CFG NETWORK SUBNET LAN Network IP address format Property Basic Subnet Mask CFG NETWORK GATEWAY LAN Network IP address format Property Basic Default Gateway CFG NETWORK DYNAMIC DNS Network 0 Disabled Property 1 Enabled Basic Dynamic DNS CFG_NETWORK_DNS_SERVER Network IP address format Property Basic DNS Server CFG_NETWORK_HOST_NAME Network Up to total of 254 Property characters of Host Basic Host Name Name and Domain Name CFG_NETWORK_DOMAIN_NAME Network Property Basic Domain Name Up to total of 254 characters of Host Name and Domain Name CFG_NETWORK_ACCESS_LIMITATION_TY PE Network Property Access Limitation Access Limitation Type 0 Allow All 1 Allow Address 2 Deny Address 39 NEC ESMPRO Manager Ver 5 Command Line Interface KeyName Contents Value CFG NETWORK ACCESS ADDRESS Network IP address format Property Please delimit Internet Access Limitation IP Protocol address by Address using comma The wildcard can be used in IP address CFG NETWORK HTTP Network 0 Disabled Service 1 Enabled Web Server HTTP CFG_NETWORK_HTTP_PORT Network 1 65535 Service Web Server HTTP Port CFG_NETWORK_HTTPS Network 0 Disabled Service 1 Enabled Web Server HTTPS CFG_NETWORK_HTTPS_PORT Network 1 65535 Service Web Server HTTPS Port CFG_NETWORK_SSH Network 0 Disabled Servi
74. y 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 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 NEC ESMPRO Manager Ver 5 Command Line Interface 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 Normal end 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 e 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
75. ys 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 displays Full height following the component name Installed 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 Display Not Installed when nothing is installed in the slot blank Displays nothing if Installed and Not Registered cannot be distinguished 65 NEC ESMPRO Manager Ver 5 Command Line Interface The fol

NEC Express5800/R110d-1E User's Manual

Contents

Download Pdf Manuals

Related Search

Related Contents