components/mrtg/Solaris/rateup.1
author manish.c.choudhary@oracle.com <manish.c.choudhary@oracle.com>
Thu, 05 May 2016 14:17:50 -0700
changeset 5930 d23d52b0c303
parent 5826 9c90e4a8156c
permissions -rw-r--r--
23210168 Upgrade Gnutls-3 to 3.4.9
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
5239
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
     1
'\" te
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
     2
.\"
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
     3
.\" CDDL HEADER START
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
     4
.\"
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
     5
.\" The contents of this file are subject to the terms of the
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
     6
.\" Common Development and Distribution License (the "License").
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
     7
.\" You may not use this file except in compliance with the License.
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
     8
.\"
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
     9
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    10
.\" or http://www.opensolaris.org/os/licensing.
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    11
.\" See the License for the specific language governing permissions
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    12
.\" and limitations under the License.
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    13
.\"
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    14
.\" When distributing Covered Code, include this CDDL HEADER in each
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    15
.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    16
.\" If applicable, add the following below this CDDL HEADER, with the
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    17
.\" fields enclosed by brackets "[]" replaced with your own identifying
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    18
.\" information: Portions Copyright [yyyy] [name of copyright owner]
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    19
.\"
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    20
.\" CDDL HEADER END
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    21
.\"
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    22
.\" Copyright 2010 Sun Microsystems, Inc.  All rights reserved.
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    23
.\" Use is subject to license terms.
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    24
.\"
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    25
.\" ident	"@(#)rateup.1	1.2	10/03/16 SMI"
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    26
.\"
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    27
.\" Copyright (c) 1996-2001 Tobias Oetiker and all the Contributers to MRTG.  All rights reserved.
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    28
.\"
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    29
.TH rateup 1 "9 Jan 2009" "SunOS 5.11" "User Commands"
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    30
.SH NAME
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    31
rateup \- Create graphic image files for MRTG
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    32
.SH SYNOPSIS
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    33
.B "rateup -f <parameter file>"
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    34
.br
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    35
.B "rateup directory basename [sampletime] [t sampletime]"
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    36
.br
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    37
.B "      [-(t)ransparent] [-(b)order]" 
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    38
.br
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    39
.B "      [u|a|g|h|m in out abs_max]" 
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    40
.br
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    41
.B "      [i/p file maxvi maxvo maxx maxy growright step bits]"
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    42
.br
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    43
.SH DESCRIPTION
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    44
.sp
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    45
rateup is a fast add-on to the great MRTG Traffic monitor. It makes 
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    46
the database file updates much faster, and creates the graphic image
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    47
files, ready for processing by PPMTOGIF.  It also reduces memory
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    48
requirements by a factor of 10, and increases the speed of updates
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    49
by a factor of at least 10.  This makes it feasible to run mrtg
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    50
every 5 minutes.
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    51
.sp
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    52
rateup attempts to compensate for missed updates by repeating the last
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    53
sample, and also tries to catch bad update times.  The .log file stores
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    54
real history every five minutes for 31 hours, then 'compresses' the
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    55
history into 30 minute samples for a week, then 2-hour samples for
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    56
31 days, then daily samples for two years.  This ensures that the
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    57
log files don't grow in size.
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    58
.sp
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    59
The log files are a slightly different format, but convert.perl
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    60
will fix that for you.
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    61
.SH AUTHOR
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    62
.sp
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    63
Dave Rand <[email protected]>, Alexandre Steinberg <[email protected]>
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    64
.SH ATTRIBUTES
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    65
.sp
5826
9c90e4a8156c 23137909 Userland man page normalization work
Rich Burridge <rich.burridge@oracle.com>
parents: 5239
diff changeset
    66
See \fBattributes\fR(7) for descriptions of the following attributes:
5239
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    67
.sp
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    68
.TS
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    69
tab() box;
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    70
cw(2.75i) |cw(2.75i) 
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    71
lw(2.75i) |lw(2.75i) 
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    72
.
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    73
ATTRIBUTE TYPEATTRIBUTE VALUE
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    74
_
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    75
Availabilitydiagnostic/mrtg
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    76
_
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    77
Interface StabilityUncommitted
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    78
_
5826
9c90e4a8156c 23137909 Userland man page normalization work
Rich Burridge <rich.burridge@oracle.com>
parents: 5239
diff changeset
    79
StandardSee \fBstandards\fR(7).
5239
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    80
.TE
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    81
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    82
.SH SEE ALSO
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    83
.sp
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    84
\fBmrtg\fR(1), \fBmrtg-reference\fR(1), \fBmrtg-logfile\fR(1), \fBmrtg-traffic-sum\fR(1), \fBcfgmaker\fR(1), \fBindexmaker\fR(1)
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    85
.SH NOTES
a4bfde1dd226 22369771 Move MRTG to Userland
Vladimir Marek <Vladimir.Marek@oracle.com>
parents:
diff changeset
    86
Source for rateup is available on http://opensolaris.org.