|
Packit |
db01ca |
### OpenHPI configuration example file ###
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
#######
|
|
Packit |
db01ca |
## OpenHPI will not be useful unless it is configured for your system. Once
|
|
Packit |
db01ca |
## you have modified this file, remove or comment the following line to allow
|
|
Packit |
db01ca |
## the OpenHPI daemon to run. This line causes the daemon to exit immediately.
|
|
Packit |
db01ca |
OPENHPI_UNCONFIGURED = "YES"
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
#######
|
|
Packit |
db01ca |
## FIRST section: declaration of global parameters like the following.
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
#OPENHPI_LOG_ON_SEV = "MINOR"
|
|
Packit |
db01ca |
#OPENHPI_EVT_QUEUE_LIMIT = 10000
|
|
Packit |
db01ca |
#OPENHPI_DEL_SIZE_LIMIT = 10000
|
|
Packit |
db01ca |
#OPENHPI_DEL_SAVE = "NO"
|
|
Packit |
db01ca |
#OPENHPI_DAT_SIZE_LIMIT = 0
|
|
Packit |
db01ca |
#OPENHPI_DAT_USER_LIMIT = 0
|
|
Packit |
db01ca |
#OPENHPI_DAT_SAVE = "NO"
|
|
Packit |
db01ca |
#OPENHPI_PATH = "/usr/local/lib/openhpi:/usr/lib/openhpi"
|
|
Packit |
db01ca |
#OPENHPI_VARPATH = "/usr/local/var/lib/openhpi"
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Auto insertion timeout
|
|
Packit |
db01ca |
## Use "BLOCK" or "IMMEDIATE" or positive integer value
|
|
Packit |
db01ca |
## Negative integer value shall be quoted due to Glib scanner limitation
|
|
Packit |
db01ca |
## For example "-1".
|
|
Packit |
db01ca |
## All negative values will be interpreted as "BLOCK"
|
|
Packit |
db01ca |
#OPENHPI_AUTOINSERT_TIMEOUT = 0
|
|
Packit |
db01ca |
#OPENHPI_AUTOINSERT_TIMEOUT_READONLY = "YES"
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## The default values for each have been selected in the example above (except
|
|
Packit |
db01ca |
## for OPENHPI_PATH and OPENHPI_CONF. See below).
|
|
Packit |
db01ca |
## No need to specify any one of them because the defaults is used
|
|
Packit |
db01ca |
## automatically. The library also looks for these as environment variables.
|
|
Packit |
db01ca |
## Environment variables found that match a global parameter override the
|
|
Packit |
db01ca |
## corresponding parameter set in this configuration file.
|
|
Packit |
db01ca |
##
|
|
Packit |
db01ca |
## OPENHPI_LOG_SEV sets the lowest severity level an event must meet to be
|
|
Packit |
db01ca |
## logged in the domain event log. Possible values are (highest to lowest):
|
|
Packit |
db01ca |
## "CRITICAL", "MAJOR", "MINOR", "INFORMATIONAL", "OK", and "DEBUG".
|
|
Packit |
db01ca |
## OPENHPI_EVT_QUEUE_LIMIT sets the maximum number of events that are allowed
|
|
Packit |
db01ca |
## in the session's event queue. Default is 10000 events. Setting it to 0 means
|
|
Packit |
db01ca |
## unlimited.
|
|
Packit |
db01ca |
## OPENHPI_DEL_SIZE_LIMIT sets the maximum size (in number of event log entries)
|
|
Packit |
db01ca |
## for the domain event log. Default is 10000 log entries. Setting it to 0
|
|
Packit |
db01ca |
## means unlimited.
|
|
Packit |
db01ca |
## OPENHPI_DEL_SAVE sets whether the domain event log is persisted to disk or
|
|
Packit |
db01ca |
## not. The event log is written to OPENHPI_VARPATH value.
|
|
Packit |
db01ca |
## OPENHPI_DAT_SIZE_LIMIT sets the maximum size (in number of alarm entries) for
|
|
Packit |
db01ca |
## the alarm table. The default 0 means unlimited.
|
|
Packit |
db01ca |
## OPENHPI_DAT_USER_LIMIT sets the maximum number of user type alarm entries
|
|
Packit |
db01ca |
## allowed in the alarm table. The default 0 means unlimited.
|
|
Packit |
db01ca |
## OPENHPI_DAT_SAVE sets whether the domain alarm table is persisted to disk or
|
|
Packit |
db01ca |
## not. The alarm table is written to the directory where OPENHPI_VARPATH
|
|
Packit |
db01ca |
## points to.
|
|
Packit |
db01ca |
## OPENHPI_PATH is a colon (:) delimited list of directories specifying
|
|
Packit |
db01ca |
## the location of openhpi plugin libraries. The default is defined when the
|
|
Packit |
db01ca |
## library is configured.
|
|
Packit |
db01ca |
## OPENHPI_VARPATH is a directory to which certain openhpi data is saved to.
|
|
Packit |
db01ca |
## The DEL (Domain Event Log), DAT (Domain Alarm Table), and UID (Unique IDs
|
|
Packit |
db01ca |
## used for resources) mappings are saved to this directory. The default is set
|
|
Packit |
db01ca |
## at compile time through the ./configure options.
|
|
Packit |
db01ca |
#######
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
#######
|
|
Packit |
db01ca |
## SECOND section: handler (instance) declaration with arguments understood by the plugin.
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
#############################################################################
|
|
Packit |
db01ca |
##**CAUTION** System administrators have to make sure that entity paths are
|
|
Packit |
db01ca |
## unique in a domain. To avoid entity paths conflicting among handlers, make
|
|
Packit |
db01ca |
## sure the "entity_root" is unique for each handler definition, unless the
|
|
Packit |
db01ca |
## plugin documentation says otherwise.
|
|
Packit |
db01ca |
#############################################################################
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Strings are enclosed by "", numbers are not.
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Section for the simulator plugin
|
|
Packit |
db01ca |
## You can load multiple copies of the simulator plugin but each
|
|
Packit |
db01ca |
## copy must have a unique name.
|
|
Packit |
db01ca |
handler libsimulator {
|
|
Packit |
db01ca |
entity_root = "{SYSTEM_CHASSIS,1}"
|
|
Packit |
db01ca |
name = "simulator"
|
|
Packit |
db01ca |
}
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Section for ipmi plugin using SMI -- local interface
|
|
Packit |
db01ca |
#handler libipmi {
|
|
Packit |
db01ca |
# entity_root = "{SYSTEM_CHASSIS,2}"
|
|
Packit |
db01ca |
# name = "smi"
|
|
Packit |
db01ca |
# addr = 0
|
|
Packit |
db01ca |
#}
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Section for ipmi plugin based on OpenIPMI:
|
|
Packit |
db01ca |
#handler libipmi {
|
|
Packit |
db01ca |
# entity_root = "{SYSTEM_CHASSIS,3}"
|
|
Packit |
db01ca |
# name = "lan"
|
|
Packit |
db01ca |
# addr = "x.x.x.x" #ipaddress
|
|
Packit |
db01ca |
# port = "999"
|
|
Packit |
db01ca |
# auth_type = "straight"
|
|
Packit |
db01ca |
# auth_level= "user"
|
|
Packit |
db01ca |
# username = "joe"
|
|
Packit |
db01ca |
# password = "blow"
|
|
Packit |
db01ca |
#}
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Section for BladeCenter snmp_bc plugin:
|
|
Packit |
db01ca |
#handler libsnmp_bc {
|
|
Packit |
db01ca |
# entity_root = "{SYSTEM_CHASSIS,4}" # Required. BladeCenter chassis Entity Path.
|
|
Packit |
db01ca |
# host = "192.168.70.125" # Required. BladeCenter Management Module (MM) IP address.
|
|
Packit |
db01ca |
# host_alternate = "192.168.70.127" # Optional. BladeCenter Management Module 2nd IP address.
|
|
Packit |
db01ca |
# Some BladeCenter MM Firmware allows the 2 MMs,
|
|
Packit |
db01ca |
# active and standby, to have 2 different IP address.
|
|
Packit |
db01ca |
# If the targetted BladeCenter 2 MMs are configured
|
|
Packit |
db01ca |
# with 2 IPs, use this key for the 2nd IP.
|
|
Packit |
db01ca |
# version = "1" # Required. SNMP protocol version (1|3).
|
|
Packit |
db01ca |
# community = "public" # SNMP V1: Required. SNMP V1 community name.
|
|
Packit |
db01ca |
# security_name = "snmpv3_user" # SNMP V3: Required. SNMP V3 user Login ID.
|
|
Packit |
db01ca |
# context_name = "" # SNMP V3: Optional. Must match MM's "Context name" field, if defined.
|
|
Packit |
db01ca |
# security_level = "noAuthNoPriv" # SNMP V3: Required. Security level (noAuthNoPriv|authNoPriv|authPriv).
|
|
Packit |
db01ca |
# passphrase = "" # SNMP V3: Authentication password. Required if security_level
|
|
Packit |
db01ca |
# # is authNoPriv or authPriv.
|
|
Packit |
db01ca |
# auth_type = "" # SNMP V3: Authentication password encoding (MD5|SHA). Required if
|
|
Packit |
db01ca |
# # security_level is authNoPriv or authPriv.
|
|
Packit |
db01ca |
# privacy_passwd = "" # SNMP V3: Privacy password. Required if security_level is authPriv.
|
|
Packit |
db01ca |
# privacy_protocol = "" # SNMP V3: Privacy password encoding (DES).
|
|
Packit |
db01ca |
# # Required if security_level is authPriv.
|
|
Packit |
db01ca |
# # If security_level is authPriv, DES encoding is assumed since there
|
|
Packit |
db01ca |
# # currently is no other privacy password encoding choice.
|
|
Packit |
db01ca |
# count_per_getbulk = "32" # SNMP V3: Optional. SNMP_MSG_GETBULK commands can be used to increase
|
|
Packit |
db01ca |
# # performance. This variable sets the maximum OIDs allowable per
|
|
Packit |
db01ca |
# # MSG_GETBULK command.
|
|
Packit |
db01ca |
# # Positive values less than 16 default to "16", since values less than
|
|
Packit |
db01ca |
# # 16 don't necessarily increase performance. Too high of a value (> 40)
|
|
Packit |
db01ca |
# # can cause SNMP commands to BladeCenter to timeout. The default is "32".
|
|
Packit |
db01ca |
# # A value of "0" disables the use of the SNMP_MSG_GETBULK SNMP command.
|
|
Packit |
db01ca |
#}
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Section for static simulator plugin:
|
|
Packit |
db01ca |
## If openhpi configured with
|
|
Packit |
db01ca |
## configure --enable-simulator=static
|
|
Packit |
db01ca |
## the dummy plugin is compiled in.
|
|
Packit |
db01ca |
## It is possible to use simulator and libsimulator
|
|
Packit |
db01ca |
## at the same time.
|
|
Packit |
db01ca |
#handler libsimulator {
|
|
Packit |
db01ca |
# entity_root = "{SYSTEM_CHASSIS,5}"
|
|
Packit |
db01ca |
# name = "test"
|
|
Packit |
db01ca |
#}
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Section for ipmidirect plugin using SMI -- local interface
|
|
Packit |
db01ca |
#handler libipmidirect {
|
|
Packit |
db01ca |
# entity_root = "{SYSTEM_CHASSIS,6}"
|
|
Packit |
db01ca |
# name = "smi"
|
|
Packit |
db01ca |
# addr = 0
|
|
Packit |
db01ca |
#}
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Section for ipmidirect plugin using RMCP:
|
|
Packit |
db01ca |
#handler libipmidirect {
|
|
Packit |
db01ca |
# entity_root = "{SYSTEM_CHASSIS,7}"
|
|
Packit |
db01ca |
# name = "lan" # RMCP
|
|
Packit |
db01ca |
# addr = "localhost" # Host name or IP address
|
|
Packit |
db01ca |
# port = "623" # RMCP port
|
|
Packit |
db01ca |
# auth_type = "none" # none, md2, md5 or straight
|
|
Packit |
db01ca |
# auth_level = "admin" # operator or admin
|
|
Packit |
db01ca |
# username = "arthur"
|
|
Packit |
db01ca |
# password = "pieman"
|
|
Packit |
db01ca |
# IpmiConnectionTimeout = "5000"
|
|
Packit |
db01ca |
# AtcaConnectionTimeout = "1000"
|
|
Packit |
db01ca |
# MaxOutstanding = "1" # Allow parallel processing of
|
|
Packit |
db01ca |
# # ipmi commands; change with care
|
|
Packit |
db01ca |
# logflags = "" # logging off
|
|
Packit |
db01ca |
# # logflags = "file stdout"
|
|
Packit |
db01ca |
# # infos goes to logfile and stdout
|
|
Packit |
db01ca |
# # the logfile are log00.log, log01.log ...
|
|
Packit |
db01ca |
# logfile = "log"
|
|
Packit |
db01ca |
# # if #logfile_max reached replace the oldest one
|
|
Packit |
db01ca |
# logfile_max = "10"
|
|
Packit |
db01ca |
#}
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Section for ilo2_ribcl plugin for ProLiant Rack Mount servers
|
|
Packit |
db01ca |
#handler libilo2_ribcl {
|
|
Packit |
db01ca |
# entity_root = "{RACK_MOUNTED_SERVER,8}"
|
|
Packit |
db01ca |
# ilo2_ribcl_hostname = "IP address" # iLO2 IP address
|
|
Packit |
db01ca |
# ilo2_ribcl_portstr = "443" # iLO2 RIBCL SSL server port number
|
|
Packit |
db01ca |
# ilo2_ribcl_username = "username" # iLO2 username
|
|
Packit |
db01ca |
# ilo2_ribcl_password = "password" # iLO2 password
|
|
Packit |
db01ca |
#}
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Section for oa_soap plugin for HP BladeSystem c-Class,
|
|
Packit |
db01ca |
## using SOAP XML over https
|
|
Packit |
db01ca |
#handler liboa_soap {
|
|
Packit |
db01ca |
# entity_root = "{SYSTEM_CHASSIS,8}"
|
|
Packit |
db01ca |
# OA_User_Name = "user" # OA user name with admin privileges (required)
|
|
Packit |
db01ca |
# OA_Password = "passwd" # OA password for above user (required)
|
|
Packit |
db01ca |
# ACTIVE_OA = "hostname" # Active OA hostname or IP address (required)
|
|
Packit |
db01ca |
# STANDBY_OA = "hostname" # Standby OA hostname or IP address (optional)
|
|
Packit |
db01ca |
#}
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Section for ov_rest plugin for HPE Synergy
|
|
Packit |
db01ca |
## using CURL JSON-C over https RESTfull interfaces.
|
|
Packit |
db01ca |
#handler libov_rest {
|
|
Packit |
db01ca |
# entity_root = "{RACK,8}"
|
|
Packit |
db01ca |
# OV_User_Name = "user" # OV/Composer user name with admin privileges (required)
|
|
Packit |
db01ca |
# OV_Password = "passwd" # OV/Composer password for above user (required)
|
|
Packit |
db01ca |
# ACTIVE_OV = "hostname" # Active OV hostname or IP address (required)
|
|
Packit |
db01ca |
#}
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Section for sysfs plugin
|
|
Packit |
db01ca |
#handler libsysfs2hpi {
|
|
Packit |
db01ca |
# # Mandatory.
|
|
Packit |
db01ca |
# entity_root = "{SYSTEM_CHASSIS,9}"
|
|
Packit |
db01ca |
#}
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Section for Run-Time Abstraction Services (RTAS) plugin:
|
|
Packit |
db01ca |
#handler librtas {
|
|
Packit |
db01ca |
# # Mandatory.
|
|
Packit |
db01ca |
# entity_root = "{SYSTEM_CHASSIS,50}"
|
|
Packit |
db01ca |
#}
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Section for watchdog plugin for Linux watchdog device interface:
|
|
Packit |
db01ca |
#handler libwatchdog {
|
|
Packit |
db01ca |
# # Mandatory.
|
|
Packit |
db01ca |
# entity_root = "{SYSTEM_CHASSIS,51}"
|
|
Packit |
db01ca |
# # Watchdog device path. Mandatory.
|
|
Packit |
db01ca |
# addr = "/dev/watchdog"
|
|
Packit |
db01ca |
#}
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Section for dynamic_simulator plugin
|
|
Packit |
db01ca |
#handler libdyn_simulator {
|
|
Packit |
db01ca |
# entity_root = "{SYSTEM_CHASSIS,9}"
|
|
Packit |
db01ca |
## Location of the simulation data file
|
|
Packit |
db01ca |
## Normally an example file is installed in the same directory as openhpi.conf.
|
|
Packit |
db01ca |
## Please change the following entry if you have configured another install
|
|
Packit |
db01ca |
## directory or will use your own simulation.data.
|
|
Packit |
db01ca |
# file = "/etc/openhpi/simulation.data"
|
|
Packit |
db01ca |
# # infos goes to logfile and stdout
|
|
Packit |
db01ca |
# # the logfile are log00.log, log01.log ...
|
|
Packit |
db01ca |
## logflags = "file stdout"
|
|
Packit |
db01ca |
## logfile = "dynsim"
|
|
Packit |
db01ca |
# # if #logfile_max reached replace the oldest one
|
|
Packit |
db01ca |
## logfile_max = "5"
|
|
Packit |
db01ca |
#}
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Section for slave plugin
|
|
Packit |
db01ca |
#handler libslave {
|
|
Packit |
db01ca |
# # Optional.
|
|
Packit |
db01ca |
# # Entity path that will be added to slave daemon resources' entity paths.
|
|
Packit |
db01ca |
# # Default value is empty.
|
|
Packit |
db01ca |
# entity_root = "{RACK,1}"
|
|
Packit |
db01ca |
# # Mandatory. Address of slave OpenHPI daemon.
|
|
Packit |
db01ca |
# host = "192.168.1.42"
|
|
Packit |
db01ca |
# # Optional. Port of slave OpenHPI daemon.
|
|
Packit |
db01ca |
# # Default value is 4743
|
|
Packit |
db01ca |
# #port = "4743"
|
|
Packit |
db01ca |
#}
|
|
Packit |
db01ca |
|
|
Packit |
db01ca |
## Section for slave plugin
|
|
Packit |
db01ca |
#handler libtest_agent {
|
|
Packit |
db01ca |
# # Mandatory. TCP port for console.
|
|
Packit |
db01ca |
# port = "41415"
|
|
Packit |
db01ca |
#}
|
|
Packit |
db01ca |
|