upswatch(8) CLIX upswatch(8)
NAME
upswatch - Configures the uninterruptable power supply (UPS) daemon
SYNOPSIS
upswatch -p port_id [-B] [-i time] [-t time] -m model
FLAGS
-B Directs the UPS daemon to shut down the system when the UPS is
in bypass mode. By default, the UPS daemon issues a warning
to the system console that the UPS is in bypass mode instead
of shutting down the system.
-i time Specifies the time, in seconds, that the system will run on
UPS battery power after a loss of AC power.
-m model Specifies the UPS model. Models INGR_UPS_1 (for the Deltec
UPS) and INGR_UPS_2 (for the APC UPS) are currently supported.
-p port_id Specifies the device ID of the RS-232 port to which the UPS is
connected.
-t time Specifies the time, in seconds, between a warning issued to
users about an impending system shutdown and the actual system
shutdown.
DESCRIPTION
The upswatch command configures support for an uninterruptable power
supply (UPS), which is monitored by the UPS daemon upswatch. You can use
this command to set operating parameters for the UPS daemon.
A manual startup script for the UPS daemon is found in /etc/init.d/ups.
To enable the UPS daemon to start at system boot, key in the following
command:
# /etc/init.d/ups enable
To disable automatic startup at system boot, key in the following command:
# /etc/init.d/ups disable
The UPS deamon can also be started up after system startup by keying in
the following command:
# /etc/init.d/ups start
A running upswatch daemon can be stopped using the the following command:
2/94 - Intergraph Corporation 1
upswatch(8) CLIX upswatch(8)
# /etc/init.d/ups stop
The current options can be checked using the following command:
# /etc/init.d/ups status
An automatic startup script for UPS is found in /etc/rc2.d/S95ups. This
file must be present in the /etc/rc2.d directory for the UPS daemon to
activate during a system boot or reboot.
The system administrator should modify the automatic startup script before
booting or rebooting the machine. The administrator can change the values
of the following keywords in the script to control the operating
parameters of the UPS daemon:
PORT The value is the device ID of the RS-232 port to which the UPS
is connected.
INTR_TIME The value is the time, in seconds, that the system will run on
battery power after a loss of AC power.
GRACE_TIME The value is the time, in seconds, between a warning issued to
users about an impending system shutdown and the actual system
shutdown.
BYPASS Controls bypass mode.
MODEL Specifies the UPS model in use. The value may be either
INGR_UPS_1 (for the Deltec UPS) or INGR_UPS_2 (for the APC
UPS).
By default, if the UPS switches to bypass mode, the UPS daemon issues a
warning to the system console every 10 minutes. To override this default
behavior, issue the upswatch -B command to force a system shutdown when
the UPS switches to bypass mode. (This only applies to UPS units provided
with the bypass bus.)
The values for the interrupt and grace times depend on the capacity of the
UPS and the maximum power consumption of the system to which it is
connected. The sum of the grace time and the interrupt time should not
exceed two-thirds of the total time the UPS battery can sustain a fully
loaded system. For example, for a UPS capable of sustaining a fully
loaded system up to 1 hour on battery power, the sum of the grace time and
the interrupt time should not exceed 2400 seconds (40 minutes).
The system automatically shuts down, overriding the administrator-
specified times, under the following conditions:
Impending low battery signal
Only 3 minutes of battery power are left at full load and a 0.8
factor.
2 Intergraph Corporation - 2/94
upswatch(8) CLIX upswatch(8)
-B option specified and UPS in bypass
The UPS is off and the system is being supplied power through the
bypass bus. (This only applies to UPS units provided with the
bypass bus.)
Integrated overload signal
The UPS has suffered an extended overload. This results in a
shutdown of the UPS.
Overtemperature
The UPS is reaching an unsafe temperature level, and may shut down
immediately.
Open battery circuit breaker
The battery circuit breaker is open. When this occurs, the UPS has
no backup power source and the system shuts down.
CAUTIONS
The device ID (/dev/tty) for the RS-232 port to which the UPS is connected
must not be used by any other application. For that port's entry in the
/etc/inittab file, the third field in the entry must be set to off.
EXAMPLES
1. The following command sets the grace time to 60 seconds (1 minute) and
the interrupt time to 3600 second (1 hours) for the UPS daemon:
/etc/upswatch -t 60 -i 3600 -m INGR_UPS_1
2. The following is an /etc/inittab entry for the RS-232 port to which a
UPS is connected (port 1, device ID /dev/tty01):
t1:234:off:/etc/getty tty01 9600 none
2/94 - Intergraph Corporation 3