'\" t .\" Title: nut-recorder .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets v1.75.2 .\" Date: 08/07/2012 .\" Manual: NUT Manual .\" Source: Network UPS Tools .\" Language: English .\" .TH "NUT\-RECORDER" "8" "08/07/2012" "Network UPS Tools" "NUT Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" nut-recorder \- utility to record device status and values changes .SH "SYNOPSIS" .sp \fBnut\-recorder\fR \fIdevice\-name\fR [output\-file] [interval] .SH "DESCRIPTION" .sp \fBnut\-recorder\fR is an utility to record device running sequence (Ie power failures or any other change) through a NUT data server, and dump it in a \&.seq format\&. .sp The \&.seq file can then be used by the \fBdummy-ups\fR(8) driver to replay the sequence\&. .SH "OPTIONS" .PP \fIdevice\-name\fR .RS 4 Record the changes of that device\&. The format for this option is \fIdevname[@hostname[:port]]\fR\&. The default hostname is "localhost"\&. .RE .PP \fIoutput\-file\fR .RS 4 Optional\&. Data will be saved to this file\&. The default is \fIdummy\-device\&.seq\fR\&. .RE .PP \fIinterval\fR .RS 4 Optional\&. The status of the device will be checked every \fIinterval\fR\&. The default is 5 seconds\&. .RE .SH "EXAMPLES" .sp To record data from \fIups1@host1\fR every 10 seconds: .sp .if n \{\ .RS 4 .\} .nf $ nut\-recorder ups1@host1\*(Aq 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 \&. \&. \&. .fi .if n \{\ .RE .\} .sp You can then define a dummy device in \fBups.conf\fR(5): .sp .if n \{\ .RS 4 .\} .nf [ups\-test] driver = dummy\-ups port = ups1\-output\&.seq .fi .if n \{\ .RE .\} .SH "AUTHOR" .sp Arnaud Quette .SH "SEE ALSO" .sp \fBdummy-ups\fR(8) .SH "INTERNET RESOURCES" .sp The NUT (Network UPS Tools) home page: http://www\&.networkupstools\&.org/