.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.13 .\" .\" Standard preamble: .\" ======================================================================== .de Sh \" Subsection heading .br .if t .Sp .ne 5 .PP \fB\\$1\fR .PP .. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. | will give a .\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to .\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C' .\" expand to `' in nroff, nothing in troff, for use with C<>. .tr \(*W-|\(bv\*(Tr .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .\" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .hy 0 .if n .na .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "RRD_HWREAPPLY 1" .TH RRD_HWREAPPLY 1 "2004-05-16" "rrdman 1.0.1" "rrdman" .SH "NAME" rrd_hwreapply \- Re\-apply Holt\-Winters prediction parameters to RRD data .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBrrd_hwreapply\fR \fIin.rrd\fR \fIout.rrd\fR [\fB\-\-force\fR] [\fB\-\-start\fR=\fIstart\fR] [\fB\-\-delta\fR=\fIscale-value\fR] [\fB\-\-deltapos\fR=\fIscale-value\fR] [\fB\-\-deltaneg\fR=\fIscale-value\fR] [\fB\-\-failure\-threshold\fR=\fIfailure-threshold\fR] [\fB\-\-window\-length\fR=\fIwindow-length\fR] [\fB\-\-alpha\fR=\fIadaption-parameter\fR] [\fB\-\-beta\fR=\fIadaption-parameter\fR] [\fB\-\-gamma\fR=\fIadaption-parameter\fR] [\fB\-\-gamma\-deviation\fR=\fIadaption-parameter\fR] [\fB\-\-rralen\fR=\fIrows\fR] [\fB\-\-season\fR=\fIrows\fR] [\fB\-\-defaults\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" The prorgam takes the input \s-1RRD\s0, and copies all data to the output \s-1RRD\s0, with new Holt-Winters prediction parameters applied. If the input file is not Holt-Winters enabled, all parameters must be specified, or use the \fB\-\-defaults\fR option. .PP The resulting \s-1RRD\s0 will not contain exactly the same data as the source file. It is a result of numerous transformations during the data fetching and storing. However, the tests have shown quite good results: for a counter with average values of order of \fI1e+06\fR, the resulting data relative difference is of order of \fI1e\-10\fR. For a counter with average values at the level of \fI1e+03\fR, the precision is approximately \fI1e\-08\fR. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-\-force\fR" 4 .IX Item "--force" Forces the output file to be overwritten. Otherwise the program terminates if the output file already presents. .IP "\fB\-\-start\fR=\fIstart\fR" 4 .IX Item "--start=start" Specifies the earliest date to copy the data for. If not specified, the earliest available data with one-step (no consolidation) \&\s-1AVERAGE\s0 RRAs will be taken. .IP "\fB\-\-delta\fR=\fIscale-value\fR, \fB\-\-deltapos\fR=\fIscale-value\fR, \fB\-\-deltaneg\fR=\fIscale-value\fR, \fB\-\-failure\-threshold\fR=\fIfailure-threshold\fR, \fB\-\-window\-length\fR=\fIwindow-length\fR, \fB\-\-alpha\fR=\fIadaption-parameter\fR, \fB\-\-beta\fR=\fIadaption-parameter\fR, \fB\-\-gamma\fR=\fIadaption-parameter\fR, \fB\-\-gamma\-deviation\fR=\fIadaption-parameter\fR" 4 .IX Item "--delta=scale-value, --deltapos=scale-value, --deltaneg=scale-value, --failure-threshold=failure-threshold, --window-length=window-length, --alpha=adaption-parameter, --beta=adaption-parameter, --gamma=adaption-parameter, --gamma-deviation=adaption-parameter" Set the Holt-Winters algorithm parameters. See \fIrrdtune\fR\|(1) and the article of Jake Brutlag on Aberrant Behavior Detection. .IP "\fB\-\-rralen\fR=\fIrows\fR" 4 .IX Item "--rralen=rows" Set the length of \s-1HWPREDICT\s0 \s-1RRA\s0. Default is 4032 (2 weeks of 5\-minute samples). .IP "\fB\-\-season\fR=\fIrows\fR" 4 .IX Item "--season=rows" Set the length of \s-1SEASONAL\s0 \s-1RRA\s0. Default is 288 (1 day of 5\-minute samples). .IP "\fB\-\-defaults\fR" 4 .IX Item "--defaults" Use the default values for all Holt-Winters parameters. Individual parameters may be overwritten by the above options. The default values are: .Sp .Vb 8 \& delta = 2 \& alpha = 0.1 \& beta = 0.0035 \& gamma = 0.1 \& window_length = 9 \& failure_threshold = 6 \& hw_rra_length = 4032 \& seasonal_period = 288 .Ve .SH "RESTRICTIONS" .IX Header "RESTRICTIONS" This program requires RRDtool version 1.1.x (currently available as development snapshot only), Perl version 5.8.2 (version 5.8.0 is known to have bugs which break this utility). .SH "NOTES" .IX Header "NOTES" RRDman is a set of utilities that manipulate the RRDtool database files. .SH "AUTHOR" .IX Header "AUTHOR" Stanislav Sinyagin