Skip to content

Intelligent Platform Management Interface

Each cluster is equipped with Serial Over LAN connectivity features via Intelligent Platform Management Interface (IPMI) allowing for complete management of each node at any power state. This provides accessibility to the system while powered off, through boot cycles, and during live operation. In order to utilize these features, you must first create a user and enable it on each device. Below are the steps for creating a new user and some of the common commands you may wish to utilize at different stages of your cluster's operation.

To access the node via SSH, you will first need to be connected to the HyperCloud Dashboard. From there you will be able to locate the required IP to Open the Serial Over LAN session. These instructions can be found at HyperCloud Dashboard Console IP.

On Node

Create and Enable IPMI User

Remotely connect via SSH to the IP of one of your nodes (refer to the equipment register in your portal for system IP addresses).

Also, to show all of the currently defined users and ID slots available for creating additional users, use the command below:

root@hypercloud-compute-kvm-e0fff7001d03:~# ipmitool user list
ID  Name         Callin  Link Auth  IPMI Msg   Channel Priv Limit
1                    true    false      false      USER
2   ipmiusr          true    false      true       ADMINISTRATOR
3                    true    false      false      Unknown (0x00)
4                    true    false      false      Unknown (0x00)
5                    true    false      false      Unknown (0x00)
6                    true    false      false      Unknown (0x00)
7                    true    false      false      Unknown (0x00)
8                    true    false      false      Unknown (0x00)
9                    true    false      false      Unknown (0x00)
10                   true    false      false      Unknown (0x00)
11                   true    false      false      Unknown (0x00)
...(truncated)

Next, you need to set the username and password.

ipmitool user set name 10 "mynewuser"
ipmitool user set password 10 "p@ssw0rd"
ipmitool user enable 10
ipmitool channel setaccess 1 10 privilege=4

Identify Node

An orange light on the front of the chassis will blink per "interval" in seconds. Default interval is 15 seconds. Use 0 to turn it off or "force" to turn on indefinitely.

ipmitool chassis identify <interval>

Changing BMC from DHCP to Static IPs

If the need to change the BMC from DHCP to a static IP address scheme arises, follow these steps on each node:

Single node example:

ssh root@172.31.2.112
ipmitool lan set 1 ipsrc static
ipmitool lan set 1 ipaddr 192.168.0.100
ipmitool lan set 1 netmask 255.255.255.0
ipmitool lan set 1 defgw ipaddr 192.168.0.1

Remote Login

Open Serial Over LAN Session

username and password are both case-sensitive

ipmitool -H <hostname or ip> -U mynewuser -P p@ssw0rd -I lanplus sol activate

Deactivate Serial Over LAN Session

ipmitool -H <hostname or ip> -U mynewuser -P p@ssw0rd -I lanplus sol deactivate

Power Status of Host

ipmitool -H <hostname or ip> -U mynewuser -P p@ssw0rd chassis power status

Power On the Host

ipmitool -H <hostname or ip> -U mynewuser -P p@ssw0rd chassis power on

Power Off the Host

ipmitool -H <hostname or ip> -U mynewuser -P p@ssw0rd chassis power off

Power Cycle the Host

ipmitool -H <hostname or ip> -U mynewuser -P p@ssw0rd chassis power cycle

Shut Down the Host Gracefully

ipmitool -H <hostname or ip> -U mynewuser -P p@ssw0rd chassis power soft