|
Packit |
667938 |
.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.29)
|
|
Packit |
667938 |
.\"
|
|
Packit |
667938 |
.\" Standard preamble:
|
|
Packit |
667938 |
.\" ========================================================================
|
|
Packit |
667938 |
.de Sp \" Vertical space (when we can't use .PP)
|
|
Packit |
667938 |
.if t .sp .5v
|
|
Packit |
667938 |
.if n .sp
|
|
Packit |
667938 |
..
|
|
Packit |
667938 |
.de Vb \" Begin verbatim text
|
|
Packit |
667938 |
.ft CW
|
|
Packit |
667938 |
.nf
|
|
Packit |
667938 |
.ne \\$1
|
|
Packit |
667938 |
..
|
|
Packit |
667938 |
.de Ve \" End verbatim text
|
|
Packit |
667938 |
.ft R
|
|
Packit |
667938 |
.fi
|
|
Packit |
667938 |
..
|
|
Packit |
667938 |
.\" Set up some character translations and predefined strings. \*(-- will
|
|
Packit |
667938 |
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
|
|
Packit |
667938 |
.\" double quote, and \*(R" will give a right double quote. \*(C+ will
|
|
Packit |
667938 |
.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
|
|
Packit |
667938 |
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
|
|
Packit |
667938 |
.\" nothing in troff, for use with C<>.
|
|
Packit |
667938 |
.tr \(*W-
|
|
Packit |
667938 |
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
|
|
Packit |
667938 |
.ie n \{\
|
|
Packit |
667938 |
. ds -- \(*W-
|
|
Packit |
667938 |
. ds PI pi
|
|
Packit |
667938 |
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
|
|
Packit |
667938 |
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
|
|
Packit |
667938 |
. ds L" ""
|
|
Packit |
667938 |
. ds R" ""
|
|
Packit |
667938 |
. ds C` ""
|
|
Packit |
667938 |
. ds C' ""
|
|
Packit |
667938 |
'br\}
|
|
Packit |
667938 |
.el\{\
|
|
Packit |
667938 |
. ds -- \|\(em\|
|
|
Packit |
667938 |
. ds PI \(*p
|
|
Packit |
667938 |
. ds L" ``
|
|
Packit |
667938 |
. ds R" ''
|
|
Packit |
667938 |
. ds C`
|
|
Packit |
667938 |
. ds C'
|
|
Packit |
667938 |
'br\}
|
|
Packit |
667938 |
.\"
|
|
Packit |
667938 |
.\" Escape single quotes in literal strings from groff's Unicode transform.
|
|
Packit |
667938 |
.ie \n(.g .ds Aq \(aq
|
|
Packit |
667938 |
.el .ds Aq '
|
|
Packit |
667938 |
.\"
|
|
Packit |
667938 |
.\" If the F register is turned on, we'll generate index entries on stderr for
|
|
Packit |
667938 |
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
|
|
Packit |
667938 |
.\" entries marked with X<> in POD. Of course, you'll have to process the
|
|
Packit |
667938 |
.\" output yourself in some meaningful fashion.
|
|
Packit |
667938 |
.\"
|
|
Packit |
667938 |
.\" Avoid warning from groff about undefined register 'F'.
|
|
Packit |
667938 |
.de IX
|
|
Packit |
667938 |
..
|
|
Packit |
667938 |
.nr rF 0
|
|
Packit |
667938 |
.if \n(.g .if rF .nr rF 1
|
|
Packit |
667938 |
.if (\n(rF:(\n(.g==0)) \{
|
|
Packit |
667938 |
. if \nF \{
|
|
Packit |
667938 |
. de IX
|
|
Packit |
667938 |
. tm Index:\\$1\t\\n%\t"\\$2"
|
|
Packit |
667938 |
..
|
|
Packit |
667938 |
. if !\nF==2 \{
|
|
Packit |
667938 |
. nr % 0
|
|
Packit |
667938 |
. nr F 2
|
|
Packit |
667938 |
. \}
|
|
Packit |
667938 |
. \}
|
|
Packit |
667938 |
.\}
|
|
Packit |
667938 |
.rr rF
|
|
Packit |
667938 |
.\"
|
|
Packit |
667938 |
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
|
|
Packit |
667938 |
.\" Fear. Run. Save yourself. No user-serviceable parts.
|
|
Packit |
667938 |
. \" fudge factors for nroff and troff
|
|
Packit |
667938 |
.if n \{\
|
|
Packit |
667938 |
. ds #H 0
|
|
Packit |
667938 |
. ds #V .8m
|
|
Packit |
667938 |
. ds #F .3m
|
|
Packit |
667938 |
. ds #[ \f1
|
|
Packit |
667938 |
. ds #] \fP
|
|
Packit |
667938 |
.\}
|
|
Packit |
667938 |
.if t \{\
|
|
Packit |
667938 |
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
|
|
Packit |
667938 |
. ds #V .6m
|
|
Packit |
667938 |
. ds #F 0
|
|
Packit |
667938 |
. ds #[ \&
|
|
Packit |
667938 |
. ds #] \&
|
|
Packit |
667938 |
.\}
|
|
Packit |
667938 |
. \" simple accents for nroff and troff
|
|
Packit |
667938 |
.if n \{\
|
|
Packit |
667938 |
. ds ' \&
|
|
Packit |
667938 |
. ds ` \&
|
|
Packit |
667938 |
. ds ^ \&
|
|
Packit |
667938 |
. ds , \&
|
|
Packit |
667938 |
. ds ~ ~
|
|
Packit |
667938 |
. ds /
|
|
Packit |
667938 |
.\}
|
|
Packit |
667938 |
.if t \{\
|
|
Packit |
667938 |
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
|
|
Packit |
667938 |
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
|
|
Packit |
667938 |
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
|
|
Packit |
667938 |
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
|
|
Packit |
667938 |
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
|
|
Packit |
667938 |
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
|
|
Packit |
667938 |
.\}
|
|
Packit |
667938 |
. \" troff and (daisy-wheel) nroff accents
|
|
Packit |
667938 |
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
|
|
Packit |
667938 |
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
|
|
Packit |
667938 |
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
|
|
Packit |
667938 |
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
|
|
Packit |
667938 |
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
|
|
Packit |
667938 |
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
|
|
Packit |
667938 |
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
|
|
Packit |
667938 |
.ds ae a\h'-(\w'a'u*4/10)'e
|
|
Packit |
667938 |
.ds Ae A\h'-(\w'A'u*4/10)'E
|
|
Packit |
667938 |
. \" corrections for vroff
|
|
Packit |
667938 |
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
|
|
Packit |
667938 |
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
|
|
Packit |
667938 |
. \" for low resolution devices (crt and lpr)
|
|
Packit |
667938 |
.if \n(.H>23 .if \n(.V>19 \
|
|
Packit |
667938 |
\{\
|
|
Packit |
667938 |
. ds : e
|
|
Packit |
667938 |
. ds 8 ss
|
|
Packit |
667938 |
. ds o a
|
|
Packit |
667938 |
. ds d- d\h'-1'\(ga
|
|
Packit |
667938 |
. ds D- D\h'-1'\(hy
|
|
Packit |
667938 |
. ds th \o'bp'
|
|
Packit |
667938 |
. ds Th \o'LP'
|
|
Packit |
667938 |
. ds ae ae
|
|
Packit |
667938 |
. ds Ae AE
|
|
Packit |
667938 |
.\}
|
|
Packit |
667938 |
.rm #[ #] #H #V #F C
|
|
Packit |
667938 |
.\" ========================================================================
|
|
Packit |
667938 |
.\"
|
|
Packit |
667938 |
.IX Title "MRTG-NT-GUIDE 1"
|
|
Packit |
667938 |
.TH MRTG-NT-GUIDE 1 "2018-07-13" "2.17.7" "mrtg"
|
|
Packit |
667938 |
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
|
Packit |
667938 |
.\" way too many mistakes in technical documents.
|
|
Packit |
667938 |
.if n .ad l
|
|
Packit |
667938 |
.nh
|
|
Packit |
667938 |
.SH "NAME"
|
|
Packit |
667938 |
mrtg\-nt\-guide \- The MRTG 2.17.7 Windows Installation Guide
|
|
Packit |
667938 |
.SH "SYNOPSIS"
|
|
Packit |
667938 |
.IX Header "SYNOPSIS"
|
|
Packit |
667938 |
Installing \s-1MRTG\s0 on a Windows box is not quite as \*(L"click and point\*(R" as some
|
|
Packit |
667938 |
might want it to be. But then again, it is not all that difficult if you
|
|
Packit |
667938 |
follow the instructions below.
|
|
Packit |
667938 |
.SH "PREREQUISITES"
|
|
Packit |
667938 |
.IX Header "PREREQUISITES"
|
|
Packit |
667938 |
To get \s-1MRTG\s0 to work on Windows you need the following:
|
|
Packit |
667938 |
.IP "\(bu" 4
|
|
Packit |
667938 |
A current copy of Perl.
|
|
Packit |
667938 |
For Example ActivePerl 5.8.8 from ActiveState
|
|
Packit |
667938 |
http://www.activestate.com/store/activeperl/download/
|
|
Packit |
667938 |
.IP "\(bu" 4
|
|
Packit |
667938 |
The latest version of \s-1MRTG\s0 from http://oss.oetiker.ch/mrtg/pub. Look for
|
|
Packit |
667938 |
mrtg\-2.17.7.zip or better. The archive also contains a precompiled copy of
|
|
Packit |
667938 |
rateup.exe for Win32.
|
|
Packit |
667938 |
.SH "INSTALLING"
|
|
Packit |
667938 |
.IX Header "INSTALLING"
|
|
Packit |
667938 |
I suggest you do the following from the machine that will be running \s-1MRTG,\s0
|
|
Packit |
667938 |
which, in this case, is also a web server. All examples are for doing things
|
|
Packit |
667938 |
to a \s-1LOCAL\s0 machine.
|
|
Packit |
667938 |
.IP "First" 4
|
|
Packit |
667938 |
.IX Item "First"
|
|
Packit |
667938 |
Unzip \s-1MRTG\s0 to C:\emrtg\-2.17.7 on the Windows machine of your choice.
|
|
Packit |
667938 |
.IP "Next" 4
|
|
Packit |
667938 |
.IX Item "Next"
|
|
Packit |
667938 |
Install Perl on the same Windows machine. You might want to make sure
|
|
Packit |
667938 |
that the Perl binary directory is listed in your system path.
|
|
Packit |
667938 |
.Sp
|
|
Packit |
667938 |
.Vb 1
|
|
Packit |
667938 |
\& C:\ePerl\ebin;%SystemRoot%\esystem32;%SystemRoot%;...
|
|
Packit |
667938 |
.Ve
|
|
Packit |
667938 |
.Sp
|
|
Packit |
667938 |
You can manually check this by going to [Control Panel]\->[System]\->[Environment]
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
To see if everything is installed properly you can open a Command Shell
|
|
Packit |
667938 |
and go into \fIc:\emrtg\-2.17.7\ebin\fR. Type:
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
.Vb 1
|
|
Packit |
667938 |
\& perl mrtg
|
|
Packit |
667938 |
.Ve
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
This should give you a friendly error message complaining about the missing \s-1MRTG\s0
|
|
Packit |
667938 |
configuration file. Now, you have successfully installed \s-1MRTG\s0 and Perl.
|
|
Packit |
667938 |
.SH "CONFIGURING MRTG"
|
|
Packit |
667938 |
.IX Header "CONFIGURING MRTG"
|
|
Packit |
667938 |
Now it is time to create a configuration for \s-1MRTG.\s0 But before we begin you need to know a few things. Take an
|
|
Packit |
667938 |
opportunity to gather the following information:
|
|
Packit |
667938 |
.IP "\(bu" 4
|
|
Packit |
667938 |
The \s-1IP\s0 address or hostname and the \s-1SNMP\s0 port number, (if non standard), of the device you want to monitor.
|
|
Packit |
667938 |
.IP "\(bu" 4
|
|
Packit |
667938 |
If you want to monitor something other than bytes in and out, you must also know the \s-1SNMPOID\s0 of what you
|
|
Packit |
667938 |
want to monitor.
|
|
Packit |
667938 |
.IP "\(bu" 4
|
|
Packit |
667938 |
Finally you need to know the read-only \s-1SNMP\s0 community string
|
|
Packit |
667938 |
for your device. If you don't know it, try \fBpublic\fR, that is the default.
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
For the rest of this document we will be using device \fB10.10.10.1\fR ( a \s-1CISCO\s0
|
|
Packit |
667938 |
Catalyst 5000) with Community string \fBpublic\fR. We are interested in monitoring
|
|
Packit |
667938 |
traffic, and the \s-1CPU\s0 load. Let's begin.
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
The first thing we do in setting up \s-1MRTG\s0 is making a default config file.
|
|
Packit |
667938 |
Get to a cmd prompt and change to the \fIc:\emrtg\-2.17.7\ebin\fR directory. Type the
|
|
Packit |
667938 |
following command:
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
.Vb 1
|
|
Packit |
667938 |
\& perl cfgmaker public@10.10.10.1 \-\-global "WorkDir: c:\ewww\emrtg" \-\-output mrtg.cfg
|
|
Packit |
667938 |
.Ve
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
This creates an initial \s-1MRTG\s0 config file for you. Note that in this file all interfaces
|
|
Packit |
667938 |
of your router will be stored by number. Unfortunately, these numbers are likely to change whenever you
|
|
Packit |
667938 |
reconfigure your router. In order to work around this you can get \fIcfgmaker\fR to produce a configuration
|
|
Packit |
667938 |
which is based on Ip numbers, or even Interface Descriptions. Check cfgmaker
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
If you get an error message complaining about \fBno such name\fR or \fBno
|
|
Packit |
667938 |
response\fR, your community name is probably wrong.
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
Now, let's take a look at the mrtg.cfg file that was created.
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
In Perl, a \f(CW\*(C`#\*(C'\fR is a comment, synonymous with \f(CW\*(C`REM\*(C'\fR in \s-1DOS.\s0
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
Add the following to the top of the mrtg.cfg file:
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
.Vb 1
|
|
Packit |
667938 |
\& WorkDir: c:\ewww\emrtg
|
|
Packit |
667938 |
.Ve
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
This is where the web pages are created, usually a web root.
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
.Vb 6
|
|
Packit |
667938 |
\& ######################################################################
|
|
Packit |
667938 |
\& # Description: LCP SUWGB
|
|
Packit |
667938 |
\& # Contact: Administrator
|
|
Packit |
667938 |
\& # System Name: LC\-Bridge
|
|
Packit |
667938 |
\& # Location: Here
|
|
Packit |
667938 |
\& #.....................................................................
|
|
Packit |
667938 |
.Ve
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
TargetDevice's \s-1IP\s0 Address:Interface Number:Community:IP Address
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
.Vb 1
|
|
Packit |
667938 |
\& Target[10.10.10.1.1]: 1:public@10.10.10.1
|
|
Packit |
667938 |
.Ve
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
This is the interface speed (Default is 10 megabits; for 100Mbit devices use 12500000 and so on...)
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
.Vb 1
|
|
Packit |
667938 |
\& MaxBytes[10.10.10.1.1]: 1250000
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& Title[10.10.10.1.1]: LC\-Bridge (sample.device): ether0
|
|
Packit |
667938 |
.Ve
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
This section determines how the web page headers will look
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
.Vb 9
|
|
Packit |
667938 |
\& PageTop[10.10.10.1.1]: Traffic Analysis for ether0
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& System:LC\-Bridge inAndover
|
|
Packit |
667938 |
\& Maintainer:Administrator
|
|
Packit |
667938 |
\& Interface:ether0(1)
|
|
Packit |
667938 |
\& IP:sample.device(10.10.10.1)
|
|
Packit |
667938 |
\& Max Speed:
|
|
Packit |
667938 |
\& 1250.0 kBytes/s (ethernetCsmacd)
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& Target[10.10.10.1.2]: 2:public@10.10.10.1
|
|
Packit |
667938 |
\& MaxBytes[10.10.10.1.2]: 1250000
|
|
Packit |
667938 |
\& Title[10.10.10.1.2]: LC\-Bridge (): ulink0
|
|
Packit |
667938 |
\& PageTop[10.10.10.1.2]: Traffic Analysis for ulink0
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& System:LC\-Bridge inAndover
|
|
Packit |
667938 |
\& Maintainer:Administrator
|
|
Packit |
667938 |
\& Interface:ulink0(2)
|
|
Packit |
667938 |
\& IP:()
|
|
Packit |
667938 |
\& Max Speed:
|
|
Packit |
667938 |
\& 1250.0 kBytes/s (ethernetCsmacd)
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& #\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
|
|
Packit |
667938 |
.Ve
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
And that's a very basic \s-1MRTG\s0 config file. You can run this and see your
|
|
Packit |
667938 |
results by going into the \fIc:\emrtg\-2.17.7\ebin\fR directory and typing:
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
.Vb 1
|
|
Packit |
667938 |
\& perl mrtg mrtg.cfg
|
|
Packit |
667938 |
.Ve
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
It is normal to get errors for the first two times you run this command. The
|
|
Packit |
667938 |
errors will alert you about the fact that there have not been any log files
|
|
Packit |
667938 |
in existence before.
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
If you take a look at those web pages they are not very exciting (yet). You need
|
|
Packit |
667938 |
to have the \s-1MRTG\s0 files run every five minutes to produce the desired results.
|
|
Packit |
667938 |
Just run it again after a few minutes. You should now be able to see the first
|
|
Packit |
667938 |
lines in your graphs.
|
|
Packit |
667938 |
.SH "MAKE MRTG RUN ALL THE TIME"
|
|
Packit |
667938 |
.IX Header "MAKE MRTG RUN ALL THE TIME"
|
|
Packit |
667938 |
Starting \s-1MRTG\s0 by hand every time you want to run it is not going to make you
|
|
Packit |
667938 |
happy I guess.
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
There is a special option you can set in the \s-1MRTG\s0 configuration file so
|
|
Packit |
667938 |
so that \s-1MRTG\s0 will not terminate after it was started. Instead it
|
|
Packit |
667938 |
will wait for 5 minutes and then run again.
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
Add the option
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
.Vb 1
|
|
Packit |
667938 |
\& RunAsDaemon: yes
|
|
Packit |
667938 |
.Ve
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
to your mrtg.cfg file and start it with:
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
.Vb 1
|
|
Packit |
667938 |
\& start /Dc:\emrtg\-2.17.7\ebin wperl mrtg \-\-logging=eventlog mrtg.cfg
|
|
Packit |
667938 |
.Ve
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
If you use \fBwperl\fR instead of \fBperl\fR, no console window will show. \s-1MRTG\s0 is now
|
|
Packit |
667938 |
running in the background. If it runs into problems it will tell you so
|
|
Packit |
667938 |
over the EventLog. To stop \s-1MRTG,\s0 open the Task Manager and terminate the
|
|
Packit |
667938 |
\&\fBwperl.exe\fR process. If mrtg has anything to tell you these messages
|
|
Packit |
667938 |
can be found in the event log.
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
If you put a shortcut with
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
.Vb 2
|
|
Packit |
667938 |
\& Target: wperl mrtg \-\-logging=eventlog mrtg.cfg
|
|
Packit |
667938 |
\& Start in: c:\emrtg\-2.17.7\ebin
|
|
Packit |
667938 |
.Ve
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
into your start-up folder, \s-1MRTG\s0 will now start whenever you login to your \s-1NT\s0
|
|
Packit |
667938 |
box.
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
If you do not want to log into your box just to start \s-1MRTG.\s0 Have a look
|
|
Packit |
667938 |
at http://www.firedaemon.com/mrtg\-howto.html which describes a free tool to
|
|
Packit |
667938 |
start any program as a Service. The pages gives specific instructions for
|
|
Packit |
667938 |
\&\s-1MRTG\s0 users.
|
|
Packit |
667938 |
.SH "HOW TO SETUP MRTG AS A WINDOWS SERVICE"
|
|
Packit |
667938 |
.IX Header "HOW TO SETUP MRTG AS A WINDOWS SERVICE"
|
|
Packit |
667938 |
.SS "Additional Prerequisites"
|
|
Packit |
667938 |
.IX Subsection "Additional Prerequisites"
|
|
Packit |
667938 |
.IP "\(bu" 4
|
|
Packit |
667938 |
\&\s-1MRTG\s0 must be installed and fully configured on the target system. In the
|
|
Packit |
667938 |
following exercise the assumption is that \s-1MRTG\s0 is installed under c:\emrtg\e
|
|
Packit |
667938 |
and all the sample files use this location.
|
|
Packit |
667938 |
.IP "\(bu" 4
|
|
Packit |
667938 |
Microsoft Tools \fB\s-1SRVANY\s0.exe\fR (Applications as Services Utility) and
|
|
Packit |
667938 |
\&\fB\s-1INSTSRV\s0.exe\fR (Service Installer) \- Those files can be downloaded from
|
|
Packit |
667938 |
Microsoft as a part of Windows 2000 Resource Kit at
|
|
Packit |
667938 |
<http://www.microsoft.com/windows2000/techinfo/reskit/tools/default.asp>.
|
|
Packit |
667938 |
They are also available from other locations such as
|
|
Packit |
667938 |
<http://www.electrasoft.com/srvany/srvany.htm>,
|
|
Packit |
667938 |
<http://www.iopus.com/guides/srvany.htm>, etc. Detailed instructions on how
|
|
Packit |
667938 |
to use this package are available at
|
|
Packit |
667938 |
<http://support.microsoft.com/kb/q137890/>. In order to follow the steps in
|
|
Packit |
667938 |
this HOW-TO you \fB\s-1MUST\s0\fR obtain both executables.
|
|
Packit |
667938 |
.IP "\(bu" 4
|
|
Packit |
667938 |
You must have administrative rights on the target system.
|
|
Packit |
667938 |
.SS "Preparation"
|
|
Packit |
667938 |
.IX Subsection "Preparation"
|
|
Packit |
667938 |
Please complete the following steps before starting the installation:
|
|
Packit |
667938 |
.IP "\(bu" 4
|
|
Packit |
667938 |
Copy \fBsrvany.exe\fR and \fBinstsrv.exe\fR to c:\emrtg\-2.17.7\ebin\e (your \s-1MRTG\s0 bin directory).
|
|
Packit |
667938 |
.IP "\(bu" 4
|
|
Packit |
667938 |
Create a file called \fBmrtg.reg\fR anywhere on your system and paste the
|
|
Packit |
667938 |
following content into it:
|
|
Packit |
667938 |
.Sp
|
|
Packit |
667938 |
.Vb 1
|
|
Packit |
667938 |
\& Windows Registry Editor Version 5.00
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& [HKEY_LOCAL_MACHINE\eSYSTEM\eCurrentControlSet\eServices\eMRTG\eParameters]
|
|
Packit |
667938 |
\& "Application"="c:\e\eperl\e\ebin\e\ewperl.exe"
|
|
Packit |
667938 |
\& "AppParameters"="c:\e\emrtg\-2.17.7\e\ebin\e\emrtg \-\-logging=eventlog c:\e\emrtg\-2.17.7\e\ebin\e\emrtg.cfg"
|
|
Packit |
667938 |
\& "AppDirectory"="c:\e\emrtg\-2.17.7\e\ebin\e\e"
|
|
Packit |
667938 |
.Ve
|
|
Packit |
667938 |
.SS "Service Installation"
|
|
Packit |
667938 |
.IX Subsection "Service Installation"
|
|
Packit |
667938 |
Once again, assuming that \s-1MRTG\s0 is already fully installed and configured on
|
|
Packit |
667938 |
the target system under c:\emrtg\e the following steps are necessary to setup
|
|
Packit |
667938 |
\&\s-1MRTG\s0 as a service.
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
Using the command prompt go into the temporary directory where you unzipped
|
|
Packit |
667938 |
the package. When there type the following command to create a service
|
|
Packit |
667938 |
named \*(L"\s-1MRTG\*(R"\s0 in the Windows Services management console:
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
.Vb 1
|
|
Packit |
667938 |
\& instsrv MRTG c:\emrtg\ebin\esrvany.exe
|
|
Packit |
667938 |
.Ve
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
Now you need to create the \fBApp*\fR entries required for the new service. You
|
|
Packit |
667938 |
can do this by either right-clicking on the mrtg.reg file and selecting
|
|
Packit |
667938 |
\&'merge' or by running the following command:
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
.Vb 1
|
|
Packit |
667938 |
\& regedit /s mrtg.reg
|
|
Packit |
667938 |
.Ve
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
After setting up the registry entry it is time to point it to your \s-1MRTG\s0
|
|
Packit |
667938 |
installation. If you have installed \s-1MRTG\s0 under \fIc:\emrtg\e\fR, you can skip this
|
|
Packit |
667938 |
step. Open your registry editor (Start \-> Run \-> regedt32), and locate the
|
|
Packit |
667938 |
\&\fB[HKEY_LOCAL_MACHINE\eSYSTEM\eCurrentControlSet\eServices\eMRTG]\fR key. Make
|
|
Packit |
667938 |
sure that the \fBImagePath\fR variable is correctly pointing to \fBsrvany.exe\fR
|
|
Packit |
667938 |
located in your \s-1MRTG\s0 bin directory (for example c:\emrtg\ebin\esrvany.exe).
|
|
Packit |
667938 |
Next you have to expand the \s-1MRTG\s0 tree, and go to the
|
|
Packit |
667938 |
\&\fB[HKEY_LOCAL_MACHINE\eSYSTEM\eCurrentControlSet\eServices\eMRTG\eParameters]\fR
|
|
Packit |
667938 |
key. Under Parameters make sure that all the \fBApplication\fR variables are
|
|
Packit |
667938 |
setup properly.
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
At this point you are ready to run the service. The only thing left to do
|
|
Packit |
667938 |
is to start the \s-1MRTG\s0 service in the Services management console. After you
|
|
Packit |
667938 |
do this, you should see two new processes running on your system: srvany.exe
|
|
Packit |
667938 |
and wperl.exe. Make sure to stop any previously running \s-1MRTG\s0 processes to
|
|
Packit |
667938 |
avoid conflict.
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
Note that it is imperative to set the \fBRunAsDaemon: yes\fR option or the
|
|
Packit |
667938 |
service will stop after just one single run!
|
|
Packit |
667938 |
.SH "EXAMPLE"
|
|
Packit |
667938 |
.IX Header "EXAMPLE"
|
|
Packit |
667938 |
Now lets look at a config file to monitor what we wanted to on our mythical
|
|
Packit |
667938 |
Cisco Cat 5000 \*(-- utilization on ports 3, 5, 10, and 24, and the \s-1CPU\s0 Load,
|
|
Packit |
667938 |
which will show us nonstandard mrtg configurations as well as more options..
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
.Vb 2
|
|
Packit |
667938 |
\& WorkDir: c:\ewww\emrtg
|
|
Packit |
667938 |
\& RunAsDaemon: yes
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& ######################################################################
|
|
Packit |
667938 |
\& # Description: LCP SUWGB
|
|
Packit |
667938 |
\& # Contact: Administrator
|
|
Packit |
667938 |
\& # System Name: LC\-Bridge
|
|
Packit |
667938 |
\& # Location: Here
|
|
Packit |
667938 |
\& #.....................................................................
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& Target[10.10.10.1.1]: 3:public@10.10.10.1
|
|
Packit |
667938 |
\& MaxBytes[10.10.10.1.1]: 1250000
|
|
Packit |
667938 |
\& Title[10.10.10.1.1]: LC\-Bridge (sample\-device): ether0
|
|
Packit |
667938 |
\& PageTop[10.10.10.1.1]: Traffic Analysis for ether0
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& System:LC\-Bridge inAndover
|
|
Packit |
667938 |
\& Maintainer:Administrator
|
|
Packit |
667938 |
\& Interface:ether0(3)
|
|
Packit |
667938 |
\& IP:sample\-device(10.10.10.1)
|
|
Packit |
667938 |
\& Max Speed:
|
|
Packit |
667938 |
\& 1250.0 kBytes/s (ethernetCsmacd)
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& #\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& Target[10.10.10.1.2]: 5:public@10.10.10.1
|
|
Packit |
667938 |
\& MaxBytes[10.10.10.1.2]: 1250000
|
|
Packit |
667938 |
\& Title[10.10.10.1.2]: LC\-Bridge (): ulink0
|
|
Packit |
667938 |
\& PageTop[10.10.10.1.2]: Traffic Analysis for ulink0
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& System:LC\-Bridge inAndover
|
|
Packit |
667938 |
\& Maintainer:Administrator
|
|
Packit |
667938 |
\& Interface:ulink0(5)
|
|
Packit |
667938 |
\& IP:()
|
|
Packit |
667938 |
\& Max Speed:
|
|
Packit |
667938 |
\& 1250.0 kBytes/s (ethernetCsmacd)
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& #\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& Target[10.10.10.1.1]: 10:public@10.10.10.1
|
|
Packit |
667938 |
\& MaxBytes[10.10.10.1.1]: 1250000
|
|
Packit |
667938 |
\& Title[10.10.10.1.1]: LC\-Bridge (sample\-device): ether0
|
|
Packit |
667938 |
\& PageTop[10.10.10.1.1]: Traffic Analysis for ether0
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& System:LC\-Bridge inAndover
|
|
Packit |
667938 |
\& Maintainer:Administrator
|
|
Packit |
667938 |
\& Interface:ether0(10)
|
|
Packit |
667938 |
\& IP:sample\-device(10.10.10.1)
|
|
Packit |
667938 |
\& Max Speed:
|
|
Packit |
667938 |
\& 1250.0 kBytes/s (ethernetCsmacd)
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& #\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& Target[10.10.10.1.2]: 24:public@10.10.10.1
|
|
Packit |
667938 |
\& MaxBytes[10.10.10.1.2]: 1250000
|
|
Packit |
667938 |
\& Title[10.10.10.1.2]: LC\-Bridge (): ulink0
|
|
Packit |
667938 |
\& PageTop[10.10.10.1.2]: Traffic Analysis for ulink0
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& System:LC\-Bridge inAndover
|
|
Packit |
667938 |
\& Maintainer:Administrator
|
|
Packit |
667938 |
\& Interface:ulink0(24)
|
|
Packit |
667938 |
\& IP:()
|
|
Packit |
667938 |
\& Max Speed:
|
|
Packit |
667938 |
\& 1250.0 kBytes/s (ethernetCsmacd)
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& #\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
|
|
Packit |
667938 |
\&
|
|
Packit |
667938 |
\& # Router CPU load %
|
|
Packit |
667938 |
\& Target[cpu.1]:1.3.6.1.4.1.9.2.1.58.0&1.3.6.1.4.1.9.2.1.58.0:public@10.10.10.1
|
|
Packit |
667938 |
\& RouterUptime[cpu.1]: public@10.10.10.1
|
|
Packit |
667938 |
\& MaxBytes[cpu.1]: 100
|
|
Packit |
667938 |
\& Title[cpu.1]: CPU LOAD
|
|
Packit |
667938 |
\& PageTop[cpu.1]: CPU Load %
|
|
Packit |
667938 |
\& Unscaled[cpu.1]: ymwd
|
|
Packit |
667938 |
\& ShortLegend[cpu.1]: %
|
|
Packit |
667938 |
\& XSize[cpu.1]: 380
|
|
Packit |
667938 |
\& YSize[cpu.1]: 100
|
|
Packit |
667938 |
\& YLegend[cpu.1]: CPU Utilization
|
|
Packit |
667938 |
\& Legend1[cpu.1]: CPU Utilization in % (Load)
|
|
Packit |
667938 |
\& Legend2[cpu.1]: CPU Utilization in % (Load)
|
|
Packit |
667938 |
\& Legend3[cpu.1]:
|
|
Packit |
667938 |
\& Legend4[cpu.1]:
|
|
Packit |
667938 |
\& LegendI[cpu.1]:
|
|
Packit |
667938 |
\& LegendO[cpu.1]: Usage
|
|
Packit |
667938 |
\& Options[cpu.1]: gauge
|
|
Packit |
667938 |
.Ve
|
|
Packit |
667938 |
.PP
|
|
Packit |
667938 |
This is a nice example of how to monitor any \s-1SNMP\s0 device if you know what \s-1OID\s0
|
|
Packit |
667938 |
you want to use. Once again, for an explanation of the more advance features of
|
|
Packit |
667938 |
mrtg, please see the rest of the documentation.
|
|
Packit |
667938 |
.SH "AUTHORS"
|
|
Packit |
667938 |
.IX Header "AUTHORS"
|
|
Packit |
667938 |
Tobi Oetiker <tobi@oetiker.ch>,
|
|
Packit |
667938 |
David S. Divins <ddivins@moon.jic.com>,
|
|
Packit |
667938 |
Steve Pierce <MRTG@HDL.com>,
|
|
Packit |
667938 |
Artyom Adjemov <one.bofh@gmail.com>,
|
|
Packit |
667938 |
Ilja Ivanov <ivanov@bseu.by>
|
|
Packit |
667938 |
Karel Fajkus <http://fajkus.cz/>
|