*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> fcagent (1)              
Title
Content
Arch
Section
 

Contents


fcagent(1m)							   fcagent(1m)


NAME    [Toc]    [Back]

     fcagent - FibreVault Status/Configuration daemon

SYNOPSIS    [Toc]    [Back]

     fcagent fcagent-options-file

DESCRIPTION    [Toc]    [Back]

     fcagent and fccli have been deprecated in favor of	a new fibre channel
     drive manager sesdaemon and sesmgr.  Accordingly, fcagent is now
     chkconfig off by default.

     fcagent is	a daemon which allows communication with attached FibreVault
     enclosures; status	is collected and re-configuration is allowed.

     The low-level transport protocol is the industry standard SES (SCSI-3
     Enclosure Services). The top-level	transport is via RPC to	allow for
     remote system monitoring and control. See fccli(1M) for details.

     The fcagent is normally started automatically during boot if fcagent is
     chkconfig'ed on. Three processes are started for each instance of
     fcagent; the backend polling thread which handles polling the FibreVault
     enclosures	for status, the	frontend RPC thread which is responsible for
     communication with	user interfaces	like fccli, and	an event handler
     thread which handles FRU status change events. Each event results in a
     user configurable callout shell script being executed. These scripts are
     user customizable.

OPTIONS    [Toc]    [Back]

     The fcagent-options-file is provided for customizing certain aspects of
     fcagent operation.	This file normally resides at
     /etc/config/fcagent.options. The contents of the file is a	list of
     customizable variables and	their values.

     PollPeriod	    Specifies the time,	in seconds, between successive polls
		    of a particular FibreVault enclosure. Status change
		    detection is not interrupt driven so status	changes	will
		    not	be detected until the next poll	period.	The default
		    value is 60.

     FlashPeriod    Specifies the "flash-period", in 1/10ths seconds,
		    pertaining to the fccli flash command. The default value
		    is 5.

     PreRemovalCallout    [Toc]    [Back]
		    Specifies the pathname of the script to be executed	just
		    prior to performing	a fccli	remove or bypass command. The
		    default value is /usr/lib/fcagent/preremove.CO.





									Page 1






fcagent(1m)							   fcagent(1m)



     PostRemovalCallout    [Toc]    [Back]
		    Specifies the pathname of the script to be executed
		    immediately	following the performance of a fccli remove or
		    bypass command. The	default	value is
		    /usr/lib/fcagent/postremove.CO.

     PostInsertionCallout    [Toc]    [Back]
		    Specifies the pathname of the script to be executed
		    immediately	following the performance of a fccli insert or
		    unbypass command. The default value	is
		    /usr/lib/fcagent/postinsert.CO.

     StatusChangedCallout    [Toc]    [Back]
		    Specifies the pathname of the script to be executed
		    following a	FRU status change. The default value is
		    /usr/lib/fcagent/statchanged.CO.

     DebugLevel	    Specifies the "verbosity" of fcagent. The default value is
		    0.

     AllowRemoteRequests    [Toc]    [Back]
		    Tells fcagent to process requests that are not from
		    localhost on a reserved port.  This	option allows any host
		    on the network to perform any operation.  The default
		    value is 0,	and can	be set to 1 to allow remote requests.

CONFIGURATION OF EVENT CALLOUT SCRIPTS    [Toc]    [Back]

     The fcagent event handler executes	one or more callout scripts in
     response to a FRU status change or	user initiated reconfiguration.	Each
     time a script is executed,	9 arguments are	passed to it which a user can
     use to customize said scripts. For	example, the StatusChangedCallout
     script can	be modified to send mail to a system administrator's chatty
     pager should a fault be detected. The arguments are as follows:


     1 - host name  A character	string specifying the name of the host machine
		    where the FRU status change	was detected.

     2 - callout type
		    A character	string specifying the callout type. The
		    possible values are	INFO, RECONFIG and FAILURE. The	types
		    can	be viewed in increasing	priority of importance.	 The
		    INFO type is used when the FRU status change is
		    informational and little or	no system administrator
		    intervention is needed. An example of an informational
		    state change is a disk FRU transitioning from not present
		    to OK following the	insertion of of	a previously absent
		    disk drive.	The RECONFIG type is used following a
		    configuration change which may be of interest to the
		    system administrator. An example of	a reconfiguration
		    state change is a disk FRU transitioning from OK to



									Page 2






fcagent(1m)							   fcagent(1m)



		    bypassed following the execution of	a fccli	bypass
		    command. The FAILURE type is used when system
		    administrator intervention is needed due to	an unexpected
		    FRU	failure.

     3 - time stamp A character	string specifying the time at which the	status
		    change occurred.

     4 - channel ID A numerical	character string specifying the	channel	number
		    on which the state change was detected.

     5 - enclosure ID
		    A numerical	character string specifying the	FibreVault
		    enclosure number on	which the state	change was detected.
		    Is only specified for the case of the
		    StatusChangedCallout. It is	set to -1 for other callouts.

     6 - FRU type   A character	string specifying the type/class of FRU	for
		    which the status change is being reported. Possible	values
		    are	DISK (for disk FRUs), PS (for power supply FRUs), FAN
		    (for fan FRUs), and	LCC (for Link-Control-Card FRUs).

     7 - FRU ID	    A numerical	character string specifying the	ID of the FRU
		    which underwent the	state change. Possible values are 0-9
		    for	disk FRUs, 0-1 for power supply	FRUs, 0	for fan	FRUs,
		    and	0 for LCC FRUs.

     8 - State transition from state
		    A character	string specifying the from state of the	FRU
		    state transition. Possible values are OK, OFF, FAILED,
		    NOT-PRESENT, BYPASSED, and PEER-FAILED. Is only specified
		    for	the case of the	StatusChangedCallout. Is set to	-1 for
		    other callouts.

     9 - State transition to state
		    A character	string specifying the to state of the FRU
		    state transition. Possible values are OK, OFF, FAILED,
		    NOT-PRESENT, BYPASSED, and PEER-FAILED. Is only specified
		    for	the case of the	StatusChangedCallout. Is set to	-1 for
		    other callouts.

EXAMPLES    [Toc]    [Back]

     The following is an example of a StatusChangedCallout C-shell script
     which may be used to send mail to a system	administrator following	the
     detection of a FRU	failure.

     #!	/bin/csh -f
     #
     # If the status change is a failure, send mail to system
     # administrator.
     #



									Page 3






fcagent(1m)							   fcagent(1m)



     set TMP="/tmp/statchanged_$$"

     if	("$2" == FAILURE) then
	  echo "$6 #$7 in enclosure $5 on channel $4 on	host $1	FAILED at $3" >	$TMP
	  Mail -s "FRU Failure"	root@alpha.centauri.com	< $TMP
	  /bin/rm -f $TMP
     endif


FILES    [Toc]    [Back]

     /usr/bin/fcagent
     /etc/config/fcagent.options
     /etc/init.d/fcagent

SEE ALSO    [Toc]    [Back]

      
      
     fccli(1M),	chkconfig(1M), sesdaemon(1M), sesmgr(1M)


									PPPPaaaaggggeeee 4444
[ Back ]
 Similar pages
Name OS Title
fccli IRIX FibreVault Status/Configuration Command Line Interface
sesdaemon IRIX Fibre Channel Drive Enclosure Status/Configuration daemon
rpc.statd FreeBSD host status monitoring daemon
statd IRIX network status monitor daemon
statd Tru64 Network status monitor daemon
rpc.statd Tru64 Network status monitor daemon
insight_manager Tru64 Web-based device status and configuration
lanscan HP-UX display LAN device configuration and status
amdsp HP-UX display the status and operating configuration of the disk array
sesmgr IRIX Fibre Channel Drive Enclosure Status/Configuration Command Line Interface
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service