- Logging In to the CLI.
- Command Syntax.
- Managing the Host.
- Managing the Host.
- Managing the ELOM Network Settings.
- Managing User Accounts.
- Resetting the SP Password
- Managing Alerts.
- Updating the Firmware.
- To Display Version Information
Logging In to the CLI
You can access the command line through the serial port or over the Ethernet.
- Serial port – The serial port provides access to the CLI and to the system console. IPMI terminal mode and PPP mode are not available on the serial port.
- SSH -You can connect to the CLI using an Ethernet connection. Secure shell connections (SSC) are enabled by default.
The embedded lights out manager (Embedded LOM) supports a maximum of 10 active sessions, including serial, SSH, and web interface sessions.
This section describes how to log in to the service processor using secure shell.
2. To log into the ELOM, enter:
$ ssh root@SPipaddress
3. Enter your password when prompted.
1. Configure your terminal device or the terminal emulation software running on a laptop or PC to the following settings:
2. Connect a serial cable from the server RJ-45 Serial Mgt port to a terminal device.
3. Press ENTER on the terminal device to establish a connection between that terminal device and the SP.
You should see the following prompt:
SP -> SUNSP0016364A9934 login:
4. Log in to the SP, and enter the user name and password.
Command Syntax
CLI commands are case-sensitive.
Syntax
The syntax of a command is: <verb><options><target><properties>
Command Verbs
TABLE 8-1 describes the CLI command verbs.
Options
The CLI supports the following options. All options are not supported for all commands. See a specific command section for the options that are valid with that command. The help and examine options can be used with any command.
Targets
Every object in your namespace is a target. All targets are not supported for all commands. Each command section lists the valid targets for that command.
Properties
Properties are the configurable attributes specific to each object. An object can have one or more properties. Each command section lists the valid properties for each target.
Managing the Host
To power on the host, enter the following command:
-> set /SP/SystemInfo/CtrlInfo PowerCtrl=on
To power off the host gracefully, enter the following command:
-> set /SP/SystemInfo/CtrlInfo PowerCtrl=gracefuloff
To power off the host forcefully, enter the following command:
-> set /SP/SystemInfo/CtrlInfo PowerCtrl=forceoff
To reset the host, enter the following command:
-> set /SP/SystemInfo/CtrlInfo PowerCtrl=reset
To reboot and enter the BIOS automatically, enter the following command:
-> set /SP/SystemInfo/CtrlInfo BootCtrl=BIOSSetup
To start start a session on the server console, enter this command:
-> start /SP/AgentInfo/console
To revert to CLI once the console has been started:
Press Esc-Shift-9 keys
To terminate a server console session started by another user, enter this command:
-> stop /SP/AgentInfo/console
Host systems are equipped with sensors that show the state of critical components. For example, the sensors allow you to monitor temperatures, voltages, and fan speeds. The showcommand can be used to show the state of sensors.
-> show /SP/SystemInfo/CPU/sensor
where sensor is the sensor name.
For example, the following command shows the state of sensor /CPU/CPU0:
show /SP/SystemInfo/CPU/CPU0
You can display or configure the ELOM network settings from the CLI.
Enter the following command to display network settings:
show /SP/AgentInfo
Configuring Network Settings
Use the set command to change properties and values for network settings.
Syntax
set /SP/AgentInfo IpAddress=xxx.xxx.xxx.xxx
Targets, Properties, and Values
These targets, properties, and values are valid for the ELOM network settings.
Examples
To change the IP address for the ELOM, enter:
-> set /SP/AgentInfo IpAddress=xxx.xxx.xxx.xxx
Note – Changing the IP address will disconnect your active session if you are connected to the ELOM via a network. |
To set the Gateway address for the ELOM, enter:
-> set /SP/AgentInfo Gateway=xxx.xxx.xxx.xxx
To change the network settings from static to DHCP settings, enter:
-> set /SP/AgentInfo DhcpConfigured=enable
To disable DHCP network settings, enter:
-> set /SP/AgentInfo DhcpConfigured=disable
Managing User Accounts
This section describes how to add, modify, and delete user accounts from the CLI.
The ELOM supports up to 10 user accounts. Two of those, root and anonymous, are set by default, and cannot be removed. Therefore, you can configure eight additional accounts.
Each user account consists of a user name, a password, and a role.
- Administrator – Enables access to all features, functions, and commands.
- Operator – Enables limited access to features, functions, and commands. In general, Operators cannot change configuration settings.
- User – Enables access to benign commands such as sensor reading.
set Permission=[Administrator|Operator|User]
To add a local user account, enter the following command:
Then change to the User directory:
-> set /SP/user/username Password=password
To delete a local user account, enter the following command:
To display information about all local user accounts, enter the following command:
Configuring User Accounts
Use the set command to change passwords and permissions for configured user accounts.
Syntax
set target propertyname=value
Targets, Properties, and Values
These targets, properties, and values are valid for local user accounts.
Target | Property | Value | Default |
---|---|---|---|
/SP/User/username | Permission Password | [Administrator|Operator|User]string | Operator |
Examples
To change the permissions for user1 from Administrator to Operator enter:
-> set /SP/User/user1 Permission=Operator
To change user1’s password enter:
-> set /SP/users/user1 Password=string
Resetting the SP Password
You might need to reset the Service Processor password to the original factory default for any number of reasons including a user forgetting the password.
1. Press F2 to enter the BIOS.
2. Under the Advanced tab point to Ipmi 2.0 Configuration.
3. Choose Reset BMC Root Password.
4. To save and exit changes, click OK.
The BMC (SP) password is reset to the default changeme.
Managing Alerts
The system is equipped with a number of strategically placed sensors. The service processor (SP) uses these sensors to monitor critical system parameters for certain key components, such as, power supplies (voltages), CPUs (temperature), and fans (RPM). For the SP to operate efficiently, the components being monitored must perform within a specific range. The SP continually monitors each sensor to see if it is within its range. When a component exceeds its range, the SP generates an alert and posts an event in the system event log (SEL).
Note – All alerts are IPMI PEF traps, as defined in the Intelligent Platform Management Interface (IPMI) v2.0. |
You can define which alerts the SP will report. This entails using the Platform Event Traps (PET) and the Platform Event Filters (PEF) to configure alerts to respond to certain rules. You can also configure a destination IP address for the alert. For example, you can configure the SP to send an IPMI trap to a specified destination when any sensor crosses the upper or lower critical temperature (CT) threshold.
Note – The Informational alert level, is reserved for system events that are not related to sensors. |
Displaying Alerts
Use the show command to display current configurations or to verify changes.
Syntax
Enter the following command to display alerts:
show /SP/AgentInfo/PET/Destination[1…4]
show /SP/AgentInfo/PEF/EventFilterTable[1…6]
Configuring Alerts
Use the set command to change values for properties and configure alerts.
Syntax
Targets, Properties, and Values
These targets, properties, and values are valid for PET alerts.
Target | Property | Value | Default |
---|---|---|---|
/SP/AgentInfo/PET/[Destination1…Destination4] | IPAddressMACAddressStatus | IP addressMAC Addressenable|disable | (none)(none)disable |
Examples
To configure an alert for Destination1, enter:
-> set /SP/AgentInfo/PET/Destination1=128.145.77.21 Status=enable
To turn off Destination1 alert, enter:
-> set /SP/AgentInfo/PEF/Destination1 Status=disable
Targets, Properties, and Values
These targets, properties, and values are valid for PEF alerts.
Examples
To enable global control of PEF actions, enter the following commands:
To enable global control for individual actions, such as power cycle, enter:
-> set PEFActionGlobalCtrlPowerCycle=enable
To enable global control for individual actions, such as mail, enter:
-> set PEFActionGlobalCtrlMail=enable
To disable global control for mail, enter:
-> set PEFActionGlobalCtrlMail=disable
Targets, Properties, and Values
These targets, properties, and values are valid for PET event filter tables.
Property | Value |
---|---|
Status | enable|disable |
SensorType | all, temperature, voltage, fan, processor, memory |
PowerCtrl | enable|disable |
DiagnosticInterrupt | enable|disable |
SendAlert | enable|disable |
SendMail | enable|disable |
Examples
To configure EventFilterTable1 to filter all sensors and enable all actions, enter the following commands:
-> cd /SP/AgentInfor/PEF/EventFilterTable1
-> set Status=enable
-> set SensorType=all
-> set PowerCtrl=enable
-> set DiagnosticInterrupt=enable
-> set SendAlert=enable
-> set SendMail=enable
Updating the Firmware
You can use CLI to update the SP firmware. Updating the ELOM from the command line enables you to update both the firmware and the BIOS at the same time.
Caution – Shut down your host operating system before proceeding. Otherwise the SP will shut the host down ungracefully, which could cause file system corruption. |
Note – The upgrade takes about 5 minutes to complete, depending on network traffic. During this time, no other tasks can be performed in the embedded lights out manager software. |
1. Copy the combined bios/bmc image to your Tftp server.
2. If the server OS is running, perform a clean shutdown.
3. Log in to the CLI, and change to the TftpUpdate directory:
cd TftpUpdate
Note – A network failure during the file upload will result in a timeout. This causes the SP to reboot with the prior version of the firmware. |
4. Enter the following command to set the IP address of the Tftp server:
set ServerIPAddress=$IPMI_SERVER_IP_ADDRESS
5. Enter the following command to set the file name of the combined bmc.bios image:
set FileName=$IPMI_SERVER_FIRMWARE_FILENAME
a. To set the update method to overwrite existing customizations, enter:
set UpdateMethod=ClearCMOS
This is the default method; it clears the CMOS and overwrites all customized BIOS settings.
b. To set the update method to preserve existing customizations, enter:
This method preserves the CMOS settings.
Example:
To display the current SP version, enter the following command:
Leave a comment