ipmipower.conf(5)

."############################################################################# ."$Id: ipmipower.conf.5.in,v 1.35.10.1 2007/07/11 00:15:58 chu11 Exp $ ."############################################################################# ." Copyright (C) 2003 The Regents of the University of California. ." Produced at Lawrence Livermore National Laboratory (cf, DISCLAIMER). ." Written by Albert Chu <chu11@llnl.gov> ." UCRL-CODE-155698 ." ." This file is part of Ipmipower, a remote power control utility. ." For details, see http://www.llnl.gov/linux/. ." ." Ipmipower is free software; you can redistribute it and/or modify it under ." the terms of the GNU General Public License as published by the Free ." Software Foundation; either version 2 of the License, or (at your option) ." any later version. ." ." Ipmipower is distributed in the hope that it will be useful, but WITHOUT ." ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or ." FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License ." for more details. ." ." You should have received a copy of the GNU General Public License along ." with Ipmipower; if not, write to the Free Software Foundation, Inc., ." 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. ."############################################################################

NAME
ipmipower.conf - specify alternate default values to ipmipower

DESCRIPTION
The ipmipower configuration file can be used to set default values to ipmipower when values aren't set on the command line. This allows users to avoid typing in a long list of command line options everytime ipmipower is executed. It can also be used to hide usernames and passwords from the ps(1) command (See KNOWN ISSUES in ipmipower(1) for details). By default, the configuration file is stored at /usr/local/etc/ipmipower.conf. But users may select a different configuration file at the command line through the --config option. The user can still override the configuration file values by specifying the options on the command line. The configuration file does not stop a user from specifying any options on the command line.

CONFIGURATION OPTIONS
The following are a list of configuration options that can be specified in the configuration file. Each configuration option must be listed on a separate line. Arguments for an option are separated by any amount of whitespace. Multiple arguments are also separated by whitespace. Comments can be marked by using the pound sign ("#") character, and lines can be continued on the next using backslash ("\"). Note that it is possible to list the username and password in the configuration file. If this data is stored in a configuration file, system administrators should limit access to this file.

hostnames host1 host2 host3 ...
    Specify the default hostnames. Multiple hostnames or hostname ranges can be specified by separating each range by whitespace. See ipmipower (1) for information on hostname ranges. For example, any of the following configuration listings would be acceptable: hostnames host1 host2 host3 foo1 bar1 hostnames host1,host2,host3,foo1,bar1 hostnames host[1-3] foo1 bar1 hostnames host[1-3] foo1,bar1 At most 64 hostnames or hostname ranges can be separted by whitespace.

username str
    Specify the default username to use.

password str
    Specify the default password to use.

k_g str
    Specify the BMC key (K_g) to use. Prefix the string with '0x' to specify the key in hexadecimal.

authentication-type str
    Specify the default authentication type to use. Ipmipower currently supports the following authentication types: "auto", "none", "straight_password_key", "md2", and "md5".

privilege str
    Specify the default privilege type to use. Ipmipower currently supports the following privilege types: "auto", "user", "operator", and "admin".

ipmi-version str
    Specify the default IPMI protocol version to use: "auto", "1.5", and "2.0"

cipher_suite_id str
    Specify the default Cipher Suite ID to use: "auto", "0", "1", "2", "3", "6", "7", "8", "11", 12"

on-if-off enable|disable
    Specify if on-if-off is enabled or disabled by default.

wait-until-on enable|disable
    Specify if wait-until-on is enabled or disabled by default.

wait-until-off enable|disable
    Specify if wait-until-off is enabled or disabled by default.

consolidate-output enable|disable
    Specify if consolidate-output is enabled or disabled by default.

eliminate enable|disable
    Specify if eliminate is enabled or disabled by default.

workaround-flags str
    Specify default workaround flags to use: "forcepermsg", "idzero", "unexpectedauth", "endianseq", "intel20", "supermicro20", "sun20"

timeout ms
    Specify the timeout in ms.

retry-timeout ms
    Specify the retry timeout in ms. See ipmipower (1) for an explanation on the difference between this is the timeout option.

retry-wait-timeout ms
    Specify the retry wait timeout in ms. See ipmipower (1) for an explanation on the difference between this is the above timeout options.

retry-backoff-count num
    Specify the retry backoff count

ping-interval ms
    Specify the ping interval length in ms.

ping-timeout ms
    Specify the ping timeout length in ms.

ping-packet-count num
    Specify a new ping packet count

ping-percent num
    Specify a new ping percent

ping-consec-count num
    Specify a new ping consec count

FILES
/usr/local/etc/ipmipower.conf

SEE ALSO
ipmipower(8)