GEM CLI Commands

Introduction to commands for controlling and monitoring hardware infrastructure

This section describes command line commands provided by the Generic Enclosure Management (GEM) software. While these commands are not typically used during normal operation, they can be used to help resolve issues.

The GEM software controls and monitors the hardware infrastructure and overall system environmental conditions. GEM manages system health, provides power control to power-cycle major subsystems, monitors fans, thermals, power consumption, etc., and offers extensive event capture and logging mechanisms to support file system failover and enable post-failure analysis of hardware components.

Each enclosure and FRU within has an EEPROM containing Vital Product Data (VPD) that is used by GEM to identify and control system components. GEM can parse three (3) main VPD types:

Midplane
Power/Cooling Module (PCM)
Canister

Unified Sytem Management (USM) combines the GEM firmware with firmware from other enclosure components, such as x86 subsystems, primarily BIOS, BMC, and FPGA.

Supported number bases

Numeric parameters passed into CLIs can be in different bases. Decimal is the default. Octal or hexadecimal can be supplied by using a leading code:

Decimal – Plain number

Octal – Leading ‘0’

Hexadecimal – Leading ‘0x’

For example, the decimal number 14 would be represented in the following ways:

Decimal – 14

Octal – 016

Hexadecimal – 0xE

Serial port settings

Use the following settings for using HyperTerminal or other serial communications GUI to work with the CLI:

Baud rate (bits per second):	115200
Data bits:	8
Parity:	None
Stop bits:	1
Flow control:	None

The above settings apply to manually typed commands. If multiple commands are sent via a text file, then the baud rate needs to be reduced for all characters to be processed.

Set the baud rate in the running firmware by issuing:

rmon baud 0

Change the serial communications GUI settings to: Baud rate (bits/sec):

Baud rate (bits/sec):	9600
Data bits:	8
Parity:	None
Stop bits:	1
Flow control:	None

To return to the higher baud rate, issue:

rmon baud 4

The complete set of supported values is:

0 = 9600

1 = 19200

2 = 38400

3 = 57600

4 = 115200