unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



envconfig(8)							 envconfig(8)



NAME

  envconfig - Configures the Environmental Monitoring daemon

SYNOPSIS

  /usr/sbin/envconfig -c var=value

  /usr/sbin/envconfig start | stop

  /usr/sbin/envconfig -q

OPTIONS

  Environmental	Monitoring provides a means of detecting system	threshold
  conditions, that if exceeded,	could result in	a loss of data or damage to
  the system itself.  To detect	and notify users of critical conditions, the
  envmond daemon is used. This utility,	envconfig, is used to customize	the
  envmond daemon.  This	section	describes the envconfig	options	you can	use
  to configure the daemon.

  -c var=value
      Sets the variables that specify how the system environment is moni-
      tored.  These variables are stored in the	/etc/rc.config file and	are
      read by the envmond daemon at system start-up. If	a variable is not
      set, the default value of	that variable is assumed.

      ENVMON_CONFIGURED
	  Specifies the	state of Environmental Monitoring.  If this variable
	  is set to zero (0), the Environmental	Monitoring package is not
	  started during the system boot.  If this variable is set to 1, and
	  Environmental	Monitoring is supported	by that	platform, it is
	  started during the system boot.  The default value is	zero (0).

      ENVMON_GRACE_PERIOD
	  Specifies the	time (in minutes) that can elapse between the detec-
	  tion of a high temperature condition and the shutdown	of the sys-
	  tem.	The default value is 15	minutes.

      ENVMON_HIGH_THRESH
	  Specifies the	threshold level	that can be encountered	before the
	  envmond daemon broadcasts a warning and suggested action.

      ENVMON_MONITOR_PERIOD
	  Specifies the	frequency (in seconds) between queries of the system
	  by the envmond daemon.  The default value is 60 seconds.

      ENVMON_USER_SCRIPT
	  Specifies the	path of	a user-defined script that you want to the
	  envmond daemon to execute when a high	threshold level	is encoun-
	  tered.  The envmond daemon continues to check	the environment	after
	  the script has executed and proceeds as needed should	the high
	  threshold levels persist.

	  If you set this variable, the	envmond	daemon directs output from
	  the script to	/dev/console.  Output is not displayed on standard
	  output or written to a file as this is not the behavior of the dae-
	  mon.	To display on standard output, explicitly specify the logger
	  command within the user defined script.

  start	| stop
      Turns the	envmond	daemon on or off after system startup.

  -q  Displays the values of ENVMON_CONFIGURED,	ENVMON_GRACE_PERIOD,
      ENVMON_HIGH_THRESH, ENVMON_MONITOR_PERIOD	and ENVMON_USER_SCRIPT as
      specified	in the /etc/rc.config file.  If	a specified entry is not
      found, the environmental variable	is not displayed.

DESCRIPTION

  The envconfig	utility	is used	to customize the envmond daemon.  You must
  have root privileges to use this utility. Using this utility,	you can:

    +  Specify whether or not Environmental Monitoring is turned on or off at
       system startup.

    +  Specify how much	time can elapse	between	the envmond daemon encounter-
       ing a critical condition	and the	daemon initiating an orderly shutdown
       of the system.

    +  Specify how frequently the envmond daemon queries the system for
       information.

    +  Start and stop the envmond after	Environmental Monitoring has been
       turned on at system startup.

    +  Display the settings of the environment variables as specified in the
       /etc/rc.config file.

  Note that the	feature	that you want to monitor must be supported on a	given
  platform. For	example, the AlphaServer 8400/GS140 supports reporting of
  power	supply and fan status, the current system temperature, and the max-
  imum allowed system temperature.

EXAMPLES

  The following	procedure describes how	you test for and start the environ-
  mental monitoring subsystem

   1.  In multiuser mode, check	the status of the environmental	monitoring
       subsystem as follows:
	    #  /sbin/sysconfig -q envmon
	    envmon:
	    env_current_temp = 35
	    env_high_temp_thresh = 40
	    env_fan_status = 0
	    env_ps_status = 0
	    env_supported = 1


   2.  If the value of env_supported is	0, configure the envmond daemon	and
       reboot the system using either of the following methods:

	 +  At the command prompt, enter the following command:
		 #  /usr/sbin/envconfig	-c ENVMON_CONFIGURED=1

	 +  Use	the rcmgr command as follows:
		 #  rcmgr set ENVMON_CONFIGURED	1


  This command will enable the envmond daemon and export the variable, creat-
  ing the following two	lines in the /etc/rc.configfile:
       ENVMON_CONFIGURED="1"
       export ENVMON_CONFIGURED



  You can use the /sbin/sysconfig command to view the system environment at
  any time. The	envmond	daemon will the	print warning messages in the event
  of a power supply failure, abnormality, or high temperatures.	Error logs
  are logged in	the /var/adm/binary.errlog.

  In the following example, the	system shuts down in 10	minutes	if the tem-
  perature does	not fall below the critical threshold.

       /usr/sbin/envconfig -c ENVMON_GRACE_PERIOD=10

FILES

  /etc/rc.config*
      Databases	that contains the values of the	environment monitoring vari-
      ables. Note that you must	use the	rcmgr comand to	update the rc.config*
      files, particularly on clustered systems.

SEE ALSO

  Commands: envmond(8)