Feedback
Table Of Contents
Logging in to the command-line session
Server power and restart control commands
Command-line interface
Use the IMM command-line interface (CLI) to access the IMM without having to use the Web interface. It provides a subset of the management functions that are provided by the Web interface.
You can access the CLI through a Telnet or SSH session. You must be authenticated by the IMM before you can issue any CLI commands.
Managing the IMM using IPMI
The IMM comes with User ID 2 set initially to a user name of USERID and password of PASSW0RD (with a zero, not the letter O). This user has Supervisor access.
Important: Change this default password during your initial configuration for enhanced security.
The IMM also provides the following IPMI remote server management capabilities:
Command-line interfaces
The command-line interface provides direct access to server-management functions through the IPMI 2.0 protocol. You can use IPMItool to issue commands to control server power, view server information, and identify the server.
Accessing the command line
To access the command line, start a Telnet or SSH session to the IMM IP address.
Logging in to the command-line session
To log in to the command line, complete the following steps:
Step 1
Establish a connection with the IMM.
Step 2
Step 3
You are logged in to the command line. The command-line prompt is system>. The command-line session continues until you type exit at the command line. Then you are logged off and the session is ended.
Command syntax
Read the following guidelines before you use the commands:
•
command [arguments] [-options]•
•
•
•
•
ifconfig eth0 -i 192.168.70.34 -g 192.168.70.29 -s 255.255.255.0where ifconfig is the command, eth0 is an argument, and -i, -g, and -s are options. In this example, all three options have arguments.
•
Features and limitations
The CLI has the following features and limitations:
•
Note
•
•
•
system> history0 ifconfig eth01 readlog2 readlog3 readlog4 historysystem> !0-state enabled-c dthens-i 192.168.70.125-g 0.0.0.0-s 255.255.255.0-n IMMA00096B9E003A-r auto-d auto-m 1500-b 00:09:6B:9E:00:3A-l 00:00:00:00:00:00system>•
•
•
system> power onoksystem> power statePower: OnState: System power off/State unknownsystem>•
•
•
system> power -hsystem> power -helpsystem> power ?•
system> helpsystem> ?Utility commands
The utility commands are as follows:
•
•
•
exit command
Description
Use the exit command to log off and end the command-line interface session.
help command
Description
Use the help command to display a list of all commands with a short description for each. You can also type ? at the command prompt.
history command
Description
Use the history command to display an indexed history list of the last eight commands that were issued. The indexes can then be used as shortcuts (preceded by !) to reissue commands from this history list.
Example
system> history0 ifconfig eth01 readlog2 readlog3 readlog4 historysystem> ifconfig eth0-state enabled-c dthens-i 192.168.70.125-g 0.0.0.0-s 255.255.255.0-n IMMA00096B9E003A-r auto-d auto-m 1500-b 00:09:6B:9E:00:3A-l 00:00:00:00:00:00system>Monitor commands
The monitor commands are as follows:
•
•
•
•
•
•
clearlog command
Description
Use the clearlog command to clear the event log of the IMM or IMM. You must have the authority to clear event logs to use this command.
fans command
Description
Use the fans command to display the speed for each of the server fans.
Example
system> fansfan1 75%fan2 80%fan3 90%system>readlog command
Syntax
readlog [options]option:-fDescription
Use the readlog command to display the IMM event log entries, five at a time. The entries are displayed from the most recent to the oldest.
•
•
Example
system> readlog -f1 I SERVPROC 12/18/03 10:18:58 Remote Login Successful.Login ID:''USERID' CLI authenticated from 192.168.70.231 (Telnet).'2 I SERVPROC 12/18/03 10:12:22 Remote Login successful.Login ID: ''USERID' from web browser at IP@=192.168.70.231'3 E SERVPROC 12/18/03 10:10:37 Failure reading I2C device.4 E SERVPROC 12/18/03 10:10:37 Environmental monitor not responding.5 E SERVPROC 12/18/03 10:10:37 Failure reading I2C device.system> readlog6 E SERVPROC 12/18/03 10:09:31 Fan 2 Fault. Multiple fan failures7 E SERVPROC 12/18/03 10:09:31 Fan 1 Fault. Single fan failure8 I SERVPROC 12/18/03 10:09:25 Ethernet[0] Link Established at 100Mb, Full Duplex.9 I SERVPROC 12/18/03 10:09:24 Ethernet[0] configured to do Auto Speed/Auto Duplex.10 I SERVPROC 12/18/03 10:09:24 Ethernet[0] MAC Address currentlybeing used: 0x00-09-6B-CA-0C-80system>syshealth command
Description
Use the syshealth command to display a summary of the health of the server. The power state, system state, restart count, and IMM software status are displayed.
Example
system> syshealthPower OnState System on/starting UEFIRestarts 71system>temps command
Description
Use the temps command to display all the temperatures and temperature thresholds. The same set of temperatures are displayed as in the Web interface.
Example
system> tempsTemperatures are displayed in degrees Fahrenheit/CelsiusWR W T SS HS----------------------------------------CPU1 65/18 72/22 80/27 85/29 90/32CPU2 58/14 72/22 80/27 85/29 9/320DASD1 66/19 73/23 82/28 88/31 9/332Amb 59/15 70/21 83/28 90/32 9/355system>Notes:
1.
WR: warning reset
W: warning
T: temperature (current value)
SS: soft shutdown
HS: hard shutdown
2.
volts command
Description
Use the volts command to display all the voltages and voltage thresholds. The same set of voltages are displayed as in the Web interface.
Example
system> voltsHSL SSL WL WRL V WRH WH SSH HSH----------------------------------------------------------5v 5.02 4.00 4.15 4.50 4.60 5.25 5.50 5.75 6.003.3v 3.35 2.80 2.95 3.05 3.10 3.50 3.65 3.70 3.8512v 12.25 11.10 11.30 11.50 11.85 12.15 12.25 12.40 12.65-5v -5.10 -5.85 -5.65 -5.40 -5.20 -4.85 -4.65 -4.40 -4.20-3.3v -3.35 -4.10 -3.95 -3.65 -3.50 -3.10 -2.95 -2.80 -2.70VRM1 3.45VRM2 5.45system>Note: The output has the following column headings:
HSL: hard shutdown low
SSL: soft shutdown low
WL: warning low
WRL: warning reset low
V: voltage (current value)
WRH: warning reset high
WH: warning high
SSH: soft shutdown high
HSH: hard shutdown high
vpd command
Syntax
vpd sysvpd IMMvpd biosvpd dsaDescription
Use the vpd command to display vital product data for the system (sys), IMM, server firmware (bios), and Dynamic System Analysis Preboot (dsa). The same information is displayed as in the Web interface.
Example
system> vpd dsaType Version ReleaseDate---- ------- -----------dsa D6YT19AUS 02/27/2009system>Server power and restart control commands
The server power and restart commands are as follows:
•
•
power command
Syntax
power onpower off [-s]power statepower cycle [-s]Description
Use the power command to control the server power. To issue the power commands, you must have power and restart access authority.
•
•
•
•
reset command
Syntax
reset [option]option:-sDescription
Use the reset command to restart the server. To use this command, you must have power and restart access authority. The -s option shuts down the operating system before the server is restarted.
Configuration commands
The configuration commands are as follows:
•
•
•
•
•
•
•
•
•
•
•
•
•
dhcpinfo command
Syntax
dhcpinfo eth0Description
Use the dhcpinfo command to view the DHCP server-assigned IP configuration for eth0, if the interface is configured automatically by a DHCP server. You can use the ifconfig command to enable or disable DHCP.
Example
system> dhcpinfo eth0-server 192.168.70.29-n IMMA00096B9E003A-i 192.168.70.202-g 192.168.70.29-s 255.255.255.0-d linux-test.cisco.com-dns1 192.168.70.29-dns2 0.0.0.0-dns3 0.0.0.0system>The following table describes the output from the example.
ifconfig command
Syntax
ifconfig eth0 [options]options:-state interface_state-c config_method-i static_ip_address-g gateway_address-s subnet_mask-n hostname-r data_rate-d duplex_mode-m max_transmission_unit-l locally_administered_MACDescription
Use the ifconfig command to configure the Ethernet interface. Type ifconfig eth0 to display the current Ethernet interface configuration. To change the Ethernet interface configuration, type the options, followed by the values. To change the interface configuration, you must have at least Adapter Networking and Security Configuration authority.
The following table shows the arguments for the options.
Example
system> ifconfig eth0-state enabled-c dthens-i 192.168.70.125-g 0.0.0.0-s 255.255.255.0-n IMMA00096B9E003A-r auto-d auto-m 1500-b 00:09:6B:9E:00:3A-l 00:00:00:00:00:00system> ifconfig eth0 -c static -i 192.168.70.133These configuration changes will become active after the next reset of the IMM.system>
Note
ldap command
Syntax
ldap [options]options:-a loc|ldap|locId|Idloc-b anon|client|login-c client_dn-d search_domain-f group_filter-g group_search_attr-l string-m login|cfg|lthenc-n service_name-p client_pw-pc confirm_pw-r root_dn-s1ip host name/ip_addr-s2ip host name/ip_addr-s3ip host name/ip_addr-s1pn port_number-s2pn port_number-s3pn port_number-u search_attrib-v off|on-w on|off-hDescription
Use the ldap command to display and configure the LDAP protocol configuration parameters.
The following table shows the arguments for the options.
ntp command
Syntax
ntp [options]options:-en state-i hostname-f frequency-synchDescription
Use the ntp command to display and configure the Network Time Protocol (NTP).
The following table shows the arguments for the options.
Example
system> ntp-en: disabled-f: 3 minutes-i: not setpasswordcfg command
Syntax
passwordcfg [options]options: {-high}|{-legacy}|{-exp|-cnt|-nul}-legacy-high-exp:-cnt:-nul:-hDescription
Use the passwordcfg command to display and configure the password parameters.
Example
system> passwordcfgSecurity Level: Legacysystem> passwordcfg -exp 365oksystem> passwordcfg -nul yesoksystem> passwordcfg -cnt 5oksystem> passwordcfgSecurity Level: Customize-exp: 365-cnt: 5-nul: allowedportcfg command
Syntax
portcfg [options]portcfg [options]options:-b baud_rate-climode cli_mode-cliauth cli_authDescription
Use the portcfg command to configure the serial port. To change the serial port configuration, type the options, followed by the values. To change the serial port configuration, you must have at least Adapter Networking and Security Configuration authority.
The parameters are set in the hardware and cannot be changed:
•
•
•
The following table shows the arguments for the options.
Example
system> portcfg-b : 115200-climode : 2 (CLI with user defined keystroke sequences) system>system>srcfg command
Syntax
srcfg [options]options:-exitcliseq exitcli_keyseqDescription
Use the srcfg command to configure the serial redirection. Type srcfg to display the current configuration. To change the serial redirect configuration, type the options, followed by the values. To change the serial redirect configuration, you must have at least Adapter Networking and Security Configuration authority.
The following table shows the arguments for the -exitcliseq option.
Example
system> srcfg-exitcliseq ^[Qsystem>ssl command
Syntax
ssl [options]options:-ce on | off-se on | off-hDescription
Note
Use the ssl command to display and configure the Secure Sockets Layer (SSL) parameters.
-ce
Enables or disables an SSL client
-se
Enables or disables an SSL server
-h
Lists usage and options
Parameters
The following parameters are presented in the option status display for the ssl command and are output only from the command-line interface:
Server secure transport enable
This status display is read-only and cannot be set directly.
Server Web/CMD key status
This status display is read-only and cannot be set directly. Possible command line output values are as follows:
Private Key and Cert/CSR not availablePrivate Key and CA-signed cert installedPrivate Key and Auto-gen self-signed cert installedPrivate Key and Self-signed cert installedPrivate Key stored, CSR available for downloadSSL server CSR key status
This status display is read-only and cannot be set directly. Possible command line output values are as follows:
Private Key and Cert/CSR not availablePrivate Key and CA-signed cert installedPrivate Key and Auto-gen self-signed cert installedPrivate Key and Self-signed cert installedPrivate Key stored, CSR available for downloadSSL client LDAP key status
This status display is read-only and cannot be set directly. Possible command line output values are as follows as follows:
Private Key and Cert/CSR not availablePrivate Key and CA-signed cert installedPrivate Key and Auto-gen self-signed cert installedPrivate Key and Self-signed cert installedPrivate Key stored, CSR available for downloadSSL client CSR key status
This status display is read-only and cannot be set directly. Possible command line output values are as follows:
Private Key and Cert/CSR not availablePrivate Key and CA-signed cert installedPrivate Key and Auto-gen self-signed cert installedPrivate Key and Self-signed cert installedPrivate Key stored, CSR available for downloadtimeouts command
Syntax
timeouts [options]options:-o OS_watchdog_option-l loader_watchdog_optionDescription
Use the timeouts command to display the timeout values or change them. To display the timeouts, type timeouts. To change timeout values, type the options followed by the values. To change timeout values, you must have at least Adapter Configuration authority.
The following table shows the arguments for the timeout values. These values match the graduated scale pull-down options for server timeouts on the Web interface.
-o
Operating system timeout
minutes
disabled, 2.5, 3, 3.5, 4
-l
Loader timeout
minutes
disabled, 0.5, 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5, 7.5, 10, 15, 20, 30, 60, 120
Example
system> timeouts-o disabled-l 3.5system> timeouts -o 2.5oksystem> timeouts-o 2.5-l 3.5usbeth command
Syntax
usbeth [options]options:-en <enabled|disabled>Description
Use the usbeth command to enable or disable the in-band LAN over USB interface. For more information about enabling or disabling this interface, see "Disabling the USB in-band interface" section on page 3-6.
Example
system>usbeth-en : disabledsystem>usbeth -en enabledoksystem>usbeth-en : disabledusers command
Syntax
users [options]options:-user number-n username-p password-a authority levelDescription
Use the users command to access all user accounts and their authority levels and to create new user accounts and modify existing accounts.
Read the following guidelines about the users command:
•
•
•
•
–
–
–
am (User account management access)
rca (Remote console access)
rcvma (Remote console and virtual media access)
pr (Remote server power/restart access)
cel (Ability to clear event logs)
bc (Adapter configuration [basic])
nsc (Adapter configuration [network and security])
ac (Adapter configuration [advanced])
Example
system> users1. USERID Read/WritePassword Expires: no expiration2. manu Read OnlyPassword Expires: no expiration3. eliflippen Read OnlyPassword Expires: no expiration4. <not used>5. jacobyackenovic custom:cel|acPassword Expires: no expirationsystem> users -7 -n sptest -p PASSW0RD -a custom:am|rca|cel|nsc|acoksystem> users1. USERID Read/WritePassword Expires: no expiration2. test Read/WritePassword Expires: no expiration3. test2 Read/WritePassword Expires: no expiration4. <not used>5. jacobyackenovic custom:cel|acPassword Expires: no expiration6. <not used>7. sptest custom:am|rca|cel|nsc|acPassword Expires: no expiration8. <not used>9. <not used>10. <not used>11. <not used>12. <not used>system>IMM control commands
The IMM control commands are as follows:
•
•
•
•
•
clearcfg command
Description
Use the clearcfg command to set the IMM configuration to its factory defaults. You must have at least Advanced Adapter Configuration authority to issue this command. After the configuration of the IMM is cleared, the IMM is restarted.
clock command
Syntax
clock [options]options:-d mm/dd/yyyy-t hh:mm:ss-g gmt offset-dst on/off/special caseDescription
Use the clock command to display the current date and time according to the IMM clock and the GMT offset. You can set the date, time, GMT offset, and daylight saving time settings.
Note the following information:
•
•
•
•
•
•
Example
system> clock12/12/2003 13:15:23 GMT-5:00 dst onsystem> clock -d 12/31/2004oksystem> clock12/31/2004 13:15:30 GMT-5:00 dst onidentify command
Syntax
identify [options]options:-s on/off/blink-d secondsDescription
Use the identify command to turn the chassis identify LED on or off, or to have it flash. The -d option can be used with -s on to turn the LED on for only for the number of seconds specified with the -d parameter. The LED then turns off after the number of seconds elapses.
Example
system> identify-s offsystem> identify -s on -d 30oksystem>resetsp command
Description
Use the resetsp command to restart the IMM or IMM. You must have at least Advanced Adapter Configuration authority to be able to issue this command.
