FAQ Search Today's Posts Mark Forums Read
» Video Reviews

» Linux Archive

Linux-archive is a website aiming to archive linux email lists and to make them easily accessible for linux users/developers.


» Sponsor

» Partners

» Sponsor

Go Back   Linux Archive > Redhat > Cluster Development

 
 
LinkBack Thread Tools
 
Old 02-15-2011, 09:11 PM
Lon Hohberger
 
Default RHEL5: fence-agents: Regerate fence_ipmilan.8 man page

Resolves: rhbz#671089

Signed-off-by: Lon Hohberger <lhh@redhat.com>
---
fence/man/fence_ipmilan.8 | 262 ++++++++++++++++++++++++++++----------------
1 files changed, 167 insertions(+), 95 deletions(-)

diff --git a/fence/man/fence_ipmilan.8 b/fence/man/fence_ipmilan.8
index 9b10198..3bca4d1 100644
--- a/fence/man/fence_ipmilan.8
+++ b/fence/man/fence_ipmilan.8
@@ -1,111 +1,183 @@
-." Copyright (C) Sistina Software, Inc. 1997-2003 All rights reserved.
-." Copyright (C) 2004 Red Hat, Inc. All rights reserved.
-."
-." This copyrighted material is made available to anyone wishing to use,
-." modify, copy, or redistribute it subject to the terms and conditions
-." of the GNU General Public License v.2.
-
-.TH fence_ipmilan 8

+.TH FENCE_AGENT 8 2009-10-20 "fence_ipmilan (Fence Agent)"
.SH NAME
-fence_ipmilan - I/O Fencing agent for machines controlled by IPMI over
-LAN.
+fence_ipmilan - Fence agent for IPMI over LAN
+.SH DESCRIPTION
+.P

-.SH SYNOPSIS
-.B
-fence_ipmilan
-[fIOPTIONfR]...
+fence_ipmilan is an I/O Fencing agent which can be used with machines controlled by IPMI. This agent calls support software using ipmitool (http://ipmitool.sf.net/).

-.SH DESCRIPTION
-fence_ipmilan is an I/O Fencing agent which can be used with
-machines controlled by IPMI. This agent calls support software
-using ipmitool (http://ipmitool.sf.net/).
+To use fence_ipmilan with HP iLO 3 you have to enable lanplus option (lanplus / -P) and increase wait after operation to 4 seconds (power_wait=4 / -T 4)
+.P
+fence_ipmilan accepts options on the command line as well
+as from stdin. Fenced sends parameters through stdin when it execs the
+agent. fence_ipmilan can be run by itself with command
+line options. This is useful for testing and for turning outlets on or off
+from scripts.

-fence_ipmilan accepts options on the command line as well as from stdin.
-fenced sends the options through stdin when it execs the agent. fence_ipmilan
-can be run by itself with command line options which is useful for testing.
+.SH PARAMETERS

-.SH OPTIONS
-.TP
-fB-afP fIIPaddressfP
-IP address or hostname of the IPMI controller.
-.TP
-fB-hfP
-Print out a help message describing available options, then exit.
-.TP
-fB-lfP fIloginfP
-Login (if required) with administrative privileges.
-.TP
-fB-ofP fIoptionfP
-Action to perform (on, off, reboot).
-.TP
-fB-pfP fIpasswordfP
-Password (if required) for login.
-.TP
-fB-PfP
-Use the lanplus option if this is a lanplus capable interface (for example iLo2)
+
+.TP
+.B -A
+.
+IPMI Lan Auth type (md5, password, or none)
+
+.TP
+.B -a
+.
+IPMI Lan IP to talk to
+
+.TP
+.B -p
+.
+Password (if required) to control power on IPMI device
+
+.TP
+.B -S
+.
+Script to retrieve password (if required)
+
+.TP
+.B -P
+.
+Use Lanplus
+
+.TP
+.B -l
+.
+Username/Login (if required) to control power on IPMI device
+
+.TP
+.B -o
+.
+Operation to perform. Valid operations: on, off, reboot, status, list, monitor or metadata (Default Value: reboot)
+
+.TP
+.B -t
+.
+Timeout (sec) for IPMI operation
+
+.TP
+.B -C
+.
+Ciphersuite to use (same as ipmitool -C parameter)
+
+.TP
+.B -M
+.
+Method to fence (onoff or cycle) (Default Value: onoff)
+
+.TP
+.B -T
+.
+Wait X seconds after on/off operation (Default Value: 2)
+
+.TP
+.B -f
+.
+Wait X seconds before fencing is started
+
+.TP
+.B -v
+.
+Verbose mode
+
+.SH ACTIONS
+
+
.TP
-fB-AfP fIAuthentication TypefP
-Can be set to none, password, md2, or md5.
+fBon fP
+Power on machine.
+
.TP
-fB-CfP fICiphersuite TypefP
-If you are using lanplus, this option avails you to define type of ciphersuite to
-use. Standard is 3 (defined if you just use lanplus). For more information please
-refer ipmitool man page (option -C).
+fBoff fP
+Power off machine.
+
.TP
-fB-MfP fImethodfP
-Method to fence (onoff or cycle). Default is onoff. Use cycle in case your management
-card will power off with default method so there will be no chance to power machine
-on by IPMI.
+fBreboot fP
+Reboot machine.
+
.TP
-fB-tfP fItimeoutfP
-Timeout in seconds for IPMI operation. Default is 10, but in some cases it
-must be set to higher value (anything above 30 is not recommended and may
-cause strange problems).
+fBstatus fP
+This returns the status of the plug/virtual machine.
+
.TP
-fB-qfP
-Quiet operation. Only print out error messages.
+fBlist fP
+List available plugs with aliases/virtual machines if there is support for more then one device. Returns N/A otherwise.
+
.TP
-fB-VfP
-Print out a version message, then exit.
+fBmonitor fP
+Check if fencing device is running. List available plugs/virtual machines or get status of machine (if it does not support more).
+
.TP
-fB-vfP
-Verbose mode.
+fBmetadata fP
+ The operational behavior of this is not known.

.SH STDIN PARAMETERS
-.TP
-fIipaddr = < hostname | ip >fR
-IP address or hostname of the IPMI controller.
-.TP
-fIlogin= < param >fR
-Login (if required) with administrative privileges.
-.TP
-fIoption = < param >fR
-Action to perform (on, off, reboot).
-.TP
-fIpasswd = < param >fR
-Password (if required) for login.
-.TP
-fIauth = < param >fR
-Authentication type (none, password, md2, md5).
-.TP
-fItimeout = < param >fR
-Timeout in seconds for IPMI operation. Default is 10, but in some cases it
-must be set to higher value (anything above 30 is not recommended and may
-cause strange problems).
-.TP
-fIcipher = < param >fR
-If you are using lanplus, this option avails you to define type of ciphersuite to
-use. Standard is 3 (defined if you just use lanplus). For more information please
-refer ipmitool man page (option -C).
-.TP
-fImethod = < param >fR
-Method to fence (onoff or cycle). Default is onoff. Use cycle in case your management
-card will power off with default method so there will be no chance to power machine
-on by IPMI.
-.TP
-fIlanplusfR
-If we are using the lanplus option for ipmitool

-.SH SEE ALSO
-fence(8), fence_node(8), ipmitool(1)
+
+.TP
+.B auth
+.
+IPMI Lan Auth type (md5, password, or none)
+
+.TP
+.B ipaddr
+.
+IPMI Lan IP to talk to
+
+.TP
+.B passwd
+.
+Password (if required) to control power on IPMI device
+
+.TP
+.B passwd_script
+.
+Script to retrieve password (if required)
+
+.TP
+.B lanplus
+.
+Use Lanplus
+
+.TP
+.B login
+.
+Username/Login (if required) to control power on IPMI device
+
+.TP
+.B action
+.
+Operation to perform. Valid operations: on, off, reboot, status, list, monitor or metadata (Default Value: reboot)
+
+.TP
+.B timeout
+.
+Timeout (sec) for IPMI operation
+
+.TP
+.B cipher
+.
+Ciphersuite to use (same as ipmitool -C parameter)
+
+.TP
+.B method
+.
+Method to fence (onoff or cycle) (Default Value: onoff)
+
+.TP
+.B power_wait
+.
+Wait X seconds after on/off operation (Default Value: 2)
+
+.TP
+.B delay
+.
+Wait X seconds before fencing is started
+
+.TP
+.B verbose
+.
+Verbose mode
--
1.7.2.3
 
Old 02-16-2011, 04:21 AM
"Fabio M. Di Nitto"
 
Default RHEL5: fence-agents: Regerate fence_ipmilan.8 man page

ACK'ed

Fabio

On 02/15/2011 11:11 PM, Lon Hohberger wrote:
> Resolves: rhbz#671089
>
> Signed-off-by: Lon Hohberger <lhh@redhat.com>
> ---
> fence/man/fence_ipmilan.8 | 262 ++++++++++++++++++++++++++++----------------
> 1 files changed, 167 insertions(+), 95 deletions(-)
>
> diff --git a/fence/man/fence_ipmilan.8 b/fence/man/fence_ipmilan.8
> index 9b10198..3bca4d1 100644
> --- a/fence/man/fence_ipmilan.8
> +++ b/fence/man/fence_ipmilan.8
> @@ -1,111 +1,183 @@
> -." Copyright (C) Sistina Software, Inc. 1997-2003 All rights reserved.
> -." Copyright (C) 2004 Red Hat, Inc. All rights reserved.
> -."
> -." This copyrighted material is made available to anyone wishing to use,
> -." modify, copy, or redistribute it subject to the terms and conditions
> -." of the GNU General Public License v.2.
> -
> -.TH fence_ipmilan 8
>
> +.TH FENCE_AGENT 8 2009-10-20 "fence_ipmilan (Fence Agent)"
> .SH NAME
> -fence_ipmilan - I/O Fencing agent for machines controlled by IPMI over
> -LAN.
> +fence_ipmilan - Fence agent for IPMI over LAN
> +.SH DESCRIPTION
> +.P
>
> -.SH SYNOPSIS
> -.B
> -fence_ipmilan
> -[fIOPTIONfR]...
> +fence_ipmilan is an I/O Fencing agent which can be used with machines controlled by IPMI. This agent calls support software using ipmitool (http://ipmitool.sf.net/).
>
> -.SH DESCRIPTION
> -fence_ipmilan is an I/O Fencing agent which can be used with
> -machines controlled by IPMI. This agent calls support software
> -using ipmitool (http://ipmitool.sf.net/).
> +To use fence_ipmilan with HP iLO 3 you have to enable lanplus option (lanplus / -P) and increase wait after operation to 4 seconds (power_wait=4 / -T 4)
> +.P
> +fence_ipmilan accepts options on the command line as well
> +as from stdin. Fenced sends parameters through stdin when it execs the
> +agent. fence_ipmilan can be run by itself with command
> +line options. This is useful for testing and for turning outlets on or off
> +from scripts.
>
> -fence_ipmilan accepts options on the command line as well as from stdin.
> -fenced sends the options through stdin when it execs the agent. fence_ipmilan
> -can be run by itself with command line options which is useful for testing.
> +.SH PARAMETERS
>
> -.SH OPTIONS
> -.TP
> -fB-afP fIIPaddressfP
> -IP address or hostname of the IPMI controller.
> -.TP
> -fB-hfP
> -Print out a help message describing available options, then exit.
> -.TP
> -fB-lfP fIloginfP
> -Login (if required) with administrative privileges.
> -.TP
> -fB-ofP fIoptionfP
> -Action to perform (on, off, reboot).
> -.TP
> -fB-pfP fIpasswordfP
> -Password (if required) for login.
> -.TP
> -fB-PfP
> -Use the lanplus option if this is a lanplus capable interface (for example iLo2)
> +
> +.TP
> +.B -A
> +.
> +IPMI Lan Auth type (md5, password, or none)
> +
> +.TP
> +.B -a
> +.
> +IPMI Lan IP to talk to
> +
> +.TP
> +.B -p
> +.
> +Password (if required) to control power on IPMI device
> +
> +.TP
> +.B -S
> +.
> +Script to retrieve password (if required)
> +
> +.TP
> +.B -P
> +.
> +Use Lanplus
> +
> +.TP
> +.B -l
> +.
> +Username/Login (if required) to control power on IPMI device
> +
> +.TP
> +.B -o
> +.
> +Operation to perform. Valid operations: on, off, reboot, status, list, monitor or metadata (Default Value: reboot)
> +
> +.TP
> +.B -t
> +.
> +Timeout (sec) for IPMI operation
> +
> +.TP
> +.B -C
> +.
> +Ciphersuite to use (same as ipmitool -C parameter)
> +
> +.TP
> +.B -M
> +.
> +Method to fence (onoff or cycle) (Default Value: onoff)
> +
> +.TP
> +.B -T
> +.
> +Wait X seconds after on/off operation (Default Value: 2)
> +
> +.TP
> +.B -f
> +.
> +Wait X seconds before fencing is started
> +
> +.TP
> +.B -v
> +.
> +Verbose mode
> +
> +.SH ACTIONS
> +
> +
> .TP
> -fB-AfP fIAuthentication TypefP
> -Can be set to none, password, md2, or md5.
> +fBon fP
> +Power on machine.
> +
> .TP
> -fB-CfP fICiphersuite TypefP
> -If you are using lanplus, this option avails you to define type of ciphersuite to
> -use. Standard is 3 (defined if you just use lanplus). For more information please
> -refer ipmitool man page (option -C).
> +fBoff fP
> +Power off machine.
> +
> .TP
> -fB-MfP fImethodfP
> -Method to fence (onoff or cycle). Default is onoff. Use cycle in case your management
> -card will power off with default method so there will be no chance to power machine
> -on by IPMI.
> +fBreboot fP
> +Reboot machine.
> +
> .TP
> -fB-tfP fItimeoutfP
> -Timeout in seconds for IPMI operation. Default is 10, but in some cases it
> -must be set to higher value (anything above 30 is not recommended and may
> -cause strange problems).
> +fBstatus fP
> +This returns the status of the plug/virtual machine.
> +
> .TP
> -fB-qfP
> -Quiet operation. Only print out error messages.
> +fBlist fP
> +List available plugs with aliases/virtual machines if there is support for more then one device. Returns N/A otherwise.
> +
> .TP
> -fB-VfP
> -Print out a version message, then exit.
> +fBmonitor fP
> +Check if fencing device is running. List available plugs/virtual machines or get status of machine (if it does not support more).
> +
> .TP
> -fB-vfP
> -Verbose mode.
> +fBmetadata fP
> + The operational behavior of this is not known.
>
> .SH STDIN PARAMETERS
> -.TP
> -fIipaddr = < hostname | ip >fR
> -IP address or hostname of the IPMI controller.
> -.TP
> -fIlogin= < param >fR
> -Login (if required) with administrative privileges.
> -.TP
> -fIoption = < param >fR
> -Action to perform (on, off, reboot).
> -.TP
> -fIpasswd = < param >fR
> -Password (if required) for login.
> -.TP
> -fIauth = < param >fR
> -Authentication type (none, password, md2, md5).
> -.TP
> -fItimeout = < param >fR
> -Timeout in seconds for IPMI operation. Default is 10, but in some cases it
> -must be set to higher value (anything above 30 is not recommended and may
> -cause strange problems).
> -.TP
> -fIcipher = < param >fR
> -If you are using lanplus, this option avails you to define type of ciphersuite to
> -use. Standard is 3 (defined if you just use lanplus). For more information please
> -refer ipmitool man page (option -C).
> -.TP
> -fImethod = < param >fR
> -Method to fence (onoff or cycle). Default is onoff. Use cycle in case your management
> -card will power off with default method so there will be no chance to power machine
> -on by IPMI.
> -.TP
> -fIlanplusfR
> -If we are using the lanplus option for ipmitool
>
> -.SH SEE ALSO
> -fence(8), fence_node(8), ipmitool(1)
> +
> +.TP
> +.B auth
> +.
> +IPMI Lan Auth type (md5, password, or none)
> +
> +.TP
> +.B ipaddr
> +.
> +IPMI Lan IP to talk to
> +
> +.TP
> +.B passwd
> +.
> +Password (if required) to control power on IPMI device
> +
> +.TP
> +.B passwd_script
> +.
> +Script to retrieve password (if required)
> +
> +.TP
> +.B lanplus
> +.
> +Use Lanplus
> +
> +.TP
> +.B login
> +.
> +Username/Login (if required) to control power on IPMI device
> +
> +.TP
> +.B action
> +.
> +Operation to perform. Valid operations: on, off, reboot, status, list, monitor or metadata (Default Value: reboot)
> +
> +.TP
> +.B timeout
> +.
> +Timeout (sec) for IPMI operation
> +
> +.TP
> +.B cipher
> +.
> +Ciphersuite to use (same as ipmitool -C parameter)
> +
> +.TP
> +.B method
> +.
> +Method to fence (onoff or cycle) (Default Value: onoff)
> +
> +.TP
> +.B power_wait
> +.
> +Wait X seconds after on/off operation (Default Value: 2)
> +
> +.TP
> +.B delay
> +.
> +Wait X seconds before fencing is started
> +
> +.TP
> +.B verbose
> +.
> +Verbose mode
 

Thread Tools




All times are GMT. The time now is 09:53 AM.

VBulletin, Copyright ©2000 - 2014, Jelsoft Enterprises Ltd.
Content Relevant URLs by vBSEO ©2007, Crawlability, Inc.
Copyright 2007 - 2008, www.linux-archive.org