nut/docs/man/nut-recorder.txt

81 lines
1.4 KiB
Text
Raw Normal View History

2012-06-01 13:55:19 +00:00
NUT-RECORDER(8)
===============
NAME
----
2022-06-29 10:37:36 +00:00
2012-06-01 13:55:19 +00:00
nut-recorder - utility to record device status and values changes
SYNOPSIS
--------
2022-06-29 10:37:36 +00:00
2012-06-01 13:55:19 +00:00
*nut-recorder* 'device-name' [output-file] [interval]
DESCRIPTION
-----------
2022-06-29 10:37:36 +00:00
2013-11-24 15:00:12 +00:00
*nut-recorder* is an utility to record sequences from running devices (such as
power failures, or any other value changes) from upsd, and dump it in a .seq
format.
2012-06-01 13:55:19 +00:00
The .seq file can then be used by the linkman:dummy-ups[8] driver
to replay the sequence.
OPTIONS
-------
2022-06-29 10:37:36 +00:00
2012-06-01 13:55:19 +00:00
'device-name'::
2013-11-24 15:00:12 +00:00
Record the changes of this device. The format for this option is
2012-06-01 13:55:19 +00:00
'devname[@hostname[:port]]'. The default hostname is "localhost".
'output-file'::
Optional. Data will be saved to this file. The default is
'dummy-device.seq'.
'interval'::
Optional. The status of the device will be checked every 'interval'.
The default is 5 seconds.
EXAMPLES
--------
To record data from 'ups1@host1' every 10 seconds:
$ nut-recorder ups1@host1' ups1-output.seq 10
. . .
battery.charge: 100.0
battery.voltage: 13.9
battery.voltage.nominal: 13.6
ups.status: OL
. . .
battery.charge: 90.0
ups.status: OB
. . .
You can then define a dummy device in linkman:ups.conf[5]:
[ups-test]
driver = dummy-ups
port = ups1-output.seq
AUTHOR
------
2022-06-29 10:37:36 +00:00
2012-06-01 13:55:19 +00:00
Arnaud Quette
SEE ALSO
--------
2022-06-29 10:37:36 +00:00
The dummy-ups driver:
~~~~~~~~~~~~~~~~~~~~~
2012-06-01 13:55:19 +00:00
linkman:dummy-ups[8]
2022-06-29 10:37:36 +00:00
Internet resources:
~~~~~~~~~~~~~~~~~~~
2012-06-01 13:55:19 +00:00
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/