pefconfig(8) - Linux man page

Name

Synopsis

Description

Options

-a alertnum

Specify which PEF alert number is to be used. Default is 1. This would only be used if extra PEF alert destinations had been set.

-d

This option disables the BMC LAN and PEF parameters, so as not to allow BMC LAN connections or alerts.

-e

This option enables the BMC LAN configuration and PEF event alerts. The utility will attempt to obtain the default BMC LAN parameters from the OS automatically, or they can be specified with command options below.

-i ethif

By default, the eth0 interface is used to find IP and MAC addresses. Sometimes, however, the first ethernet port on the baseboard may be represented by Linux as eth1 or eth2 instead. If so, use this option to indicate the correct ethernet interface to use. By default, pefconfig will scan up to 32 eth interfaces for the onboard one that BMC LAN uses.

-l

This option enables the BMC LAN configuration, but not PEF events. The utility will attempt to obtain the default BMC LAN parameters from the OS automatically, or they can be specified with command options below.

-n num

By default, the new PEF entry for OS Critical Stop is inserted at offset 12 into the table. This can be changed to insert it at an offset > 12 if another entry already exists at offset 12.

-#

Same as -q below.

-q

Specify an alternate user number for the LAN username from the -u option. This is normally user number 2, 3, or 4, where 2 is the default. The maximum number of users is 15.

-r

This option just reads the configuration without writing any BMC LAN parameters or writing any new entries to the PEF table.

-s

This option will also display some of the Serial parameters.

-t

Test if the BMC LAN has already been configured. Returns 0 if so.

-x

Causes extra debug messages to be displayed.

-B baud_sol

This specifies the Baud rate for SerialOverLan. The possible values are: 9600, 19.2k, 38.4k, 57.6k, and 115.2k. The default is 19.2k.

-D

This causes the local IP address to be determined by DHCP instead of a static IP address.

-I ip_addr

This specifies the local IP address to use for the BMC LAN on eth0. The default is to automatically obtain this from the Linux ifconfig.

-M mac_addr

This specifies the local MAC address to use for the BMC LAN on eth0. The format can be either 11:22:33:44:55:66 or 11-22-33-44-55-66. The default is to automatically obtain this from the Linux ifconfig.

-S subnet

This specifies the local subnet mask to use for the BMC LAN on eth0. The default is to automatically obtain this from the Linux ifconfig.

-G gwy_ip_addr

This specifies the default gateway IP address to use for the BMC LAN. The default is to automatically obtain this from the Linux route table.

-H gwy_mac_addr

This specifies the default gateway's MAC address to use for the BMC LAN. The format can be either 11:22:33:44:55:66 or 11-22-33-44-55-66. The default is to automatically obtain this from the Linux arp cache.

-A alert_ip_addr

This specifies the SNMP Alert Destination IP address to use for the BMC LAN. By default, this utility will attempt to obtain this from the /etc/snmp/snmpd.conf file, via the trapsink parameter. The alert destination will see the BMC LAN traps with the enterprises.3183.1.1 OID. If no alert IP address is specified in either snmpd.conf or this parameter, or if that IP address does not respond, the other SNMP parameters for BMC LAN will be skipped.

-X alert_mac_addr

This specifies the SNMP Alert Destinations's MAC address to use for the BMC LAN. The format can be either 11:22:33:44:55:66 or 11-22-33-44-55-66. The default is to attempt to obtain this from the Linux arp cache. This parameter is ignored if there is no Alert IP address.

-C snmp_community

This specifies the SNMP Community name to use for BMC LAN Alerts. The default community string is "public". This parameter is ignored if there is no Alert IP address.

-u username_to_set

This specifies the firmware username to set for BMC LAN access. If a username is specified, user 3 will be set. If not specified, the default user 1 will be used.

-p password_to_set

This specifies the firmware password to set for BMC LAN access. If not specified, the user and password configuration will not be changed.

-L lan_ch_num

This specifies the IPMI LAN channel number used for BMC LAN. This varies by platform, and can be found in the platform technical specifications. By default, pefconfig scans all IPMI channels to find a LAN channel for BMC LAN.

-N nodename

Nodename or IP address of the remote target system. If a nodename is specified, IPMI LAN interface is used. Otherwise the local system management interface is used.

-P/-R rmt_pswd

Remote password for the nodename given. The default is a null password.

-U rmt_user

Remote username for the nodename given. The default is a null username.

-E

Use the remote password from Environment variable IPMI_PASSWORD.

-F drv_t

Force the driver type to one of the followng: imb, va, open, gnu, landesk, lan2, lan, kcs, smb. The default is to detect any available driver type and use it.

-T

Use a specified IPMI LAN Authentication Type: 0=None, 1=MD2, 2=MD5, 4=Straight Password, 5=OEM.

-V

Use a specified IPMI LAN privilege level. 1=Callback level, 2=User level, 3=Operator level, 4=Administrator level (default), 5=OEM level.

-Y

Yes, do prompt the user for the IPMI LAN remote password. Alternatives for the password are -E or -P.

Examples

To enable IPMI LAN with default settings detected:
pefconfig -e

To set up IPMI LAN for a unique IP address and set PEF SNMP Alerts:
pefconfig -e -I 192.168.1.1 -A 192.168.1.10

To set the IPMI LAN password for the default user:
pefconfig -e -p mypassword

To disable access to the IPMI LAN channel:

pefconfig -d

Sample Pef Table

See Also

Warnings

Copyright

See the file COPYING in the distribution for more details regarding redistribution.

This utility is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY.

Author

Andy Cress <arcress@users.sourceforge.net>

Referenced By