Serial Over LAN (SOL)

If the external NVIDIA® BlueField® serial connection is not available to the switch (i.e., not connected), BMC software enables access to the BlueField through an internal serial connection redirected over an IP address.

To establish the SOL connection, users may retrieve information from the redfish/v1/Systems/Bluefield schema. Inside the SerialConsole properties (SSH, IPMI), there are various methods that a client can utilize to initiate a serial session with the host through its manager.

            

            
curl -k -u root:'<password>' -H 'Content-Type: application/json' -X GET https://<bmc_ip>/redfish/v1/Systems/Bluefield
        

Example output:

            

            
{
  ...
  "SerialConsole": {
    "IPMI": {
      "ServiceEnabled": true
    },
    "MaxConcurrentSessions": 15,
    "SSH": {
      "HotKeySequenceDisplay": "Press ~. to exit console",
      "Port": 2200,
      "ServiceEnabled": true
    }
  },
...
}
        

Based on the information provided, it is possible to establish a connection to the system's serial interface using the configured settings. In the following example, an SSH connection is utilized to connect to the system's serial interface:

            

            
ssh <bmc_ip> -p <port-number>
        

The port number can be obtain from the SerialConsole schema. In this example, that would be port 2200.

To connect to serial-over-LAN use the following IPMI command from an external server:

            

            
ipmitool -C 17 -I lanplus -H <ip-address-of-bmc > -U ADMIN -P ADMIN sol activate
        

For example:

            

            
ipmitool -C 17 -I lanplus -H 10.10.10.10 -U ADMIN -P ADMIN sol activate
[SOL Session operational. Use ~? for help]
 
Poky (Yocto Project Reference Distro)
 
2.3.1 bluefield /dev/ttyAMA0
 
bluefield login:
        

The IPMI SOL commands are listed in the following table:

            

            
ipmitool sol info
        

            

            
ipmitool sol info 1
        

            

            
ipmitool sol set set-in-progress set-complete 1
        

            

            
ipmitool sol set enabled true 1
        

            

            
ipmitool -C 17 -I lanplus -U <username> -P <password> -H <ip_address> sol activate
        

            

            
ipmitool -C 17 -I lanplus -U <username> -P <password> -H <ip_address> sol deactivate