envconfig - Configures the Environmental Monitoring daemon
/usr/sbin/envconfig -c var=value
/usr/sbin/envconfig start | stop
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.
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.
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).
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.
Specifies the threshold level that can be encountered before the
envmond daemon broadcasts a warning and suggested action.
Specifies the frequency (in seconds) between queries of the system
by the envmond daemon. The default value is 60 seconds.
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.
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
+ 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
+ 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
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.
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
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:
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
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.