sol command

This command configures SOL (serial over LAN) functions and indicates SOL status.

Note: You access the compute node Integrated Management Module (IMM) CLI using a CMM SOL session (see Starting an SOL session). If no user accounts have been manually set up for the IMM of a compute node, connection to that IMM must be done using the current CMM user ID and password. In order for an IMM to communicate with the compute node Advanced Settings Utility (ASU) and UpdateXpress System Pack Installer (UXSPI) programs, a local user account must be set up for the compute node IMM. This local account is not included in an IMM configuration backup. For information about using the compute node IMM interface, see the compute node or IMM documentation.

If command syntax is not correctly entered, or if a command fails to run, an error message is returned. See Common errors for a list of error messages that apply to all commands or sol command errors for a list of error messages that are specific to the sol command.

Table 1. sol command.

The command table is a multi-row, four-column table where each row describes a CMM CLI command option: column one lists command function, column two provides a detailed command description, column three shows command-option syntax, and column four lists valid command targets.
Function What it does Command Target (see paths in Command targets)
Display SOL status Displays the SOL status for the targeted device:
  • When the command target is the primary CMM, it displays the following values:
    • -status on/off (global SOL status)
    • -c retry_count
    • -e CLI_key_sequence
    • -i retry_interval
    • -r reset_blade_key_seq
    • -s send_threshold
    • -t accumulate_timeout
  • When the command target is a compute node, it displays the following:
    • -status enabled/disabled (SOL status for the compute node)
    • Status of any SOL sessions for that compute node:
      • Not ready
      • Ready
      • Active
    • SOL retry interval
    • SOL retry count
    • SOL bytes sent
    • SOL bytes received
    • SOL destination IP address (IPv6 format)
    • SOL destination MAC address
    • SOL console user ID
    • SOL console login IP address
    • SOL console session start time
    • SOL console session stop time
    • Compute node power state
 sol
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Compute node:
  • blade[x]
  • where x is the node bay number.
SOL retry interval - set Sets the SOL retry interval to the input value. sol -i value

where value is from 10 ms to 2550 ms, inclusive, in 10 ms increments. If you enter a value less than 10 ms, the retry interval will be set to 10 ms. If you enter a value greater than 2550 ms, the retry interval will be set to 2550 ms.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
  • Blade configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
SOL retry count - set Sets the SOL retry count to the input value. sol -c value

where value is from 0 to 7, inclusive. If you enter a value of 0, no retries will be attempted. If you enter a value greater than 7, an error will be displayed.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
  • Blade configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
SOL send threshold - set Sets the SOL send threshold to the input value. Setting the threshold value to 1 causes the compute node system-management processor to send an SOL packet as soon as the first character is received. sol -s value

where value is from 1 to 251, inclusive. If you enter a value outside this range, an error will be displayed.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
  • Blade configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
SOL accumulate timeout - set Sets the SOL accumulate timeout to the input value. sol -t value

where value is from 5 ms to 1275 ms, inclusive. If you enter a value less than 5 ms, the accumulate timeout will be set to 5 ms. If you enter a value greater than 1275 ms, an error will be displayed.

This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
  • Blade configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
SOL enable - global Enables SOL globally for the Lenovo Flex System chassis. The global SOL enable command does not affect the SOL session status for each compute node. sol -status enabled
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
  • Blade configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
SOL enable - compute node Enables SOL for the specified compute node. sol -status enabled
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
  • Blade configuration
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
SOL disable - global Disables SOL globally for the Lenovo Flex System chassis. The global SOL disable command does not affect the SOL session status for each compute node. sol -status disabled
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
  • Blade configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
SOL disable - compute node Disables SOL for the specified compute node. sol -status disabled
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
  • Blade configuration
See Commands and user authority for additional information.
Compute node:
  • blade[x]
  • where x is the node bay number.
CLI key sequence - set Sets the key sequence that is used to enter the CLI while a Telnet session in SOL mode. sol -e value
where value is the key sequence. In this sequence, a ^ (the carat symbol) indicates a Ctrl that maps to control-key sequences; for example:
  • ^[ (the carat symbol followed by a left bracket) means Esc
  • ^M (the carat symbol followed by a capitol M) means carriage return.
Refer to an ASCII-to-key conversion table for a complete listing of control-key sequences.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
  • Blade configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.
Reset compute node key sequence - set Sets the key sequence that will reset a compute node while a Telnet session in SOL mode. sol -r value
where value is the key sequence. In this sequence, a ^ (the carat symbol) indicates a Ctrl that maps to control-key sequences; for example:
  • ^[ (the carat symbol followed by a left bracket) means Esc
  • ^M (the carat symbol followed by a capitol M) means carriage return.
Refer to an ASCII-to-key conversion table for a complete listing of control-key sequences.
This command can only be run by users who have one or more of the following command authorities:
  • Supervisor
  • Chassis configuration
  • Blade configuration
See Commands and user authority for additional information.
Primary CMM:
  • mm[p]
  • mm[P]
  • mm[x]
  • where x is the primary CMM bay number.

Example:

To set the SOL accumulate timeout to 25 ms, while the primary CMM in bay 1 is set as the persistent command environment, at the system:mm[1]> prompt, type 
sol -t 25
To set the reset compute node key sequence to Esc R Esc r Esc R, while the primary CMM in bay 1 is set as the persistent command environment, at the system:mm[1]> prompt, type 
sol -r ^[R^[r^[R
To display the SOL settings for the CMM, while the primary CMM in bay 1 is set as the persistent command environment, at the system:mm[1]> prompt, type 
sol

The following example shows the information that is returned from these commands:

system:mm[1]> sol -t 25
OK
system:mm[1]> sol -r ^[R^[r^[R
OK
system:mm[1]> sol
-status enabled
-c 3
-e ^[(
-i 250
-r ^[R^[r^[R
-s 250
-t 25
system:mm[1]>
To display the SOL settings for the compute node in the third bay, while compute node 3 is set as the persistent command environment, at the system:blade[3]> prompt, type 
sol

The following example shows the information that is returned from this command:

system:blade[3]> sol
-status enabled
SOL Session: Ready
SOL retry interval: 64000 ms
SOL retry count: 7
SOL bytes sent: 0
SOL bytes received: 0
SOL destination IP address: FE80::3BA7:94FF:FE07:CBD0
SOL destination MAC: unknown
SOL console user ID:
SOL console login from:
SOL console session started:
SOL console session stopped:
Blade power state: On
system:blade[3]>
Parent topic: Command reference