Debian Codegraph @

contrib/mrtg-dynip/FAQ

raw
1 FAQ for mrtg-dynip version 0.41b
2
3 0. What are the problems that gave rise to mrtg-dynip?
4 0.1 What is dynamic IP
5 0.2 What is static or fixed IP
6 0.3 What is SNMP and what information can it provide?
7 0.4 What is MRTG?
8 0.5 Can the configuration file MRTG runs on remain unchanged?
9 1. What does mrtg-dynip do?
10 1.1 Can mrtg-dynip act as a front end to MRTG?
11 1.2 Can mrtg-dynip monitor modem banks?
12 2. What do I need to run mrtg-dynip and where can I get it?
13 3. What platforms does mrtg-dynip run on?
14 4. Are there special considerations to running mrtg-dynip?
15 4.1 How do I make mrtg-dynip executable?
16 4.2 How can I ensure mrtg-dynip can write to directories and files
17 5. How do I prevent errors and interpret error messages?
18 5.0 What problems external to mrtg-dynip affect it?
19 5.0.1 Why am I getting losts of weird email from cron?
20 5.0.2 Why does the mrtg-dynip log have weird messages from snmp
21 modules?
22 5.1 Why doesn't my email address and web page link show?
23 5.2 I have configured everything, yet my index page does not update
24 5.3 Your crontab example looks really odd, please explain.
25 6. Why do the in and out graphs closely follow each other in my modem bank
26 graphs?
27 7. I cannot find a solution to my problem in the docmentation and web
28 sites. What support exists and is there a mailing list?
29
30
31 0. What are the problems that gave rise to mrtg-dynip?
32
33 The initial problem that gave rise to the creation of mrtg-dynip is that
34 MRTG relies on snmp target numbers having a fixed association with file
35 names representing physical interfaces. In environments where the snmp
36 target number of a physical interface can vary, such as in a PPP dial in
37 environment, it is necessary to ensure that file names associated with real
38 physical interfaces are associated with the current snmp target number for
39 the device. This is what mrtg-dynip does.
40
41 0.1 What is dynamic IP
42
43 To someone dialling in, dynamic IP means when they dial a rotary
44 number they do not get a consistent IP address. To the service provider it
45 means a unique IP number is assinged to each telephone line/modem/port.
46
47 0.2 What is static or fixed IP
48
49 To someone dialling in, static or fixed IP means that their user name is
50 approved to use a unique IP address, whether they dial into a rotary for a
51 modem bank or into a non rotary number. To the service provider, it means
52 if someone is dialling into a rotary for a modem pool, they allow the modem
53 port use a unique approved IP number for that user, that overrides the IP
54 address used when a dial in user does not request a fixed or static IP.
55
56 0.3 What is SNMP and what information can it provide?
57
58 SNMP stands for Simple Network Management Protocol. Like much relating to
59 the Internet, it is described by a set of Internet Engineering Task Force
60 documents known as RFCs (Requests for Comments). SNMP is a means by which
61 network linked devices can have a wide variety of device status information
62 reported from them, and have action performed on them, according to known
63 protocols.
64
65 0.4 What is MRTG?
66
67 MRTG stands for 'Multi Router Traffic Grapher'. Among much else, it provides
68 a means for graphing traffic quantity information through various
69 interfaces, typically routers, in web acessible means, using information
70 reurned from SNMP requests.
71
72 0.5 Can the configuration file MRTG runs on remain unchanged?
73
74 Not in environmants that the SNMP target number varies for physical
75 interface devices you are interested in gathering information on.
76
77 1. What does mrtg-dynip do?
78
79 #Mrtg-dynip is a contribution to mrtg, enabling mrtg to generate multi
80 #interface traffic graphs for IP interfaces on hosts that do not provide
81 #consistent SNMP target numbers for their interfaces. Such IP interfaces
82 #include IP active serial interfaces attached to modems in a PPP dial in
83 #environment. The hosts must run snmp agents. For completeness, information
84 #about interface devices with unvarying SNMP target numbers, such as
85 #ethernet cards, can be configured to be included.
86
87 #Mrtg-dynip's configuration is simplest where static (or fixed) IP is not
88 #used for dial into a rotary modem pool.
89
90 #Mrtg-dynip can be considred to have sophisticated modem bank monitoring
91 #capacity, when the modems carry PPP or SLIP traffic.
92
93 #Regenerates a named 'mrtg.cfg' file to ensure snmp data remains with a
94 #consistent IP number, or overridable IP number of a real physical device
95 #in a dial in IP environment, rather than with an interface name which
96 #can get assinged to different real physical devices, and runs mrtg on
97 #the generated file.
98
99 #Generates a web index file of stats web pages.
100
101 #Please see the section 6 of this FAQ for this version for information on
102 #for differences in interpreting graphs between some devices
103
104 1.1 Can mrtg-dynip act as a front end to MRTG for traffic graphing?
105
106 In a sense yes for interface or router traffic, but this is not ADVISABLE or
107 necessarily efficient, see above. Future versions may make mrtg-dynip more
108 suitable as a front end to MRTG for some purposes, see the TODO file.
109
110 2. What do I need to run mrtg-dynip?
111
112 You need the contribution to MRTG called mrtg-dynip. Latest version
113 available from http://www.heenan.ironbark.id.au/mrtg-dynip.
114
115 MRTG needs to be successfully installed. MRTG can be obtained from
116 http://www.ee.ethz.ch/~oetiker/webtools/mrtg/mrtg.html. MRTG itself needs
117 the GD graphics library, see the MRTG package for details.
118
119 3. What platforms does mrtg-dynip run on?
120
121 mrtg-dynip should run on all platforms MRTG runs on, including Windows NT.
122 Mrtg-dynip's comments are oriented towards running on UNIX style systems.
123 such as Linux. There are some comments on configuring directoy names for
124 Windows NT. Issues involved in differences between running Perl scripts on
125 UNIX systems and NT systems should be known to you, if you run run MRTG on
126 an NT machine.
127
128 4. Are there special considerations to running mrtg-dynip?
129
130 Not really. You must of course ensure mrtg-dynip is executable and can
131 write to directories and files it needs to when executed.
132
133 4.1 How do I make mrtg-dynip executable?
134
135 In UNIX the command
136 chmod 744 mrtg-dynip
137 will make the file executable to the owner of the file
138
139 4.2 How can I ensure mrtg-dynip can write to directories and files
140
141 You need to ensure directories (and files if they exist already) have
142 appropriate write permissions. This is beyond the scope of this FAQ.
143 Basically if you have mrtg working, you will be able to get mrtg-dynip
144 working.
145
146 5. How do I prevent errors and interpret error messages?
147
148 Please see section 4 above. Set up log file generation as indicated in the
149 install file. With regard to starup error messages from rateup, see MRTG.
150 Confirm SNMP agents are running correctly. After a reboot I have found it
151 sometimes necesary to stop and restart the snmp daemon. Changing order
152 around in startup file may have fixed this problem. I have found running
153 mrtg-dynip manually outside its crond schedule may alter graph data,
154 starting anew on some.
155
156 5.0 What problems external to mrtg-dynip have been experienced?
157
158 Such is the burden of the system adminstrator to be the victim of cryptic
159 error messages
160
161 5.0.1 Why am I getting losts of weird email from cron?
162
163 Check you only have one crond running. If more than one is running then
164 expect weird mesages and data loss.
165
166 5.0.2 Why does the mrtg-dynip log have weird messages from snmp modules?
167
168 If you think your configuration is correct, try killing your snmp daemon,
169 restarting it and wait to see if the messages come up again before worrying
170 about the messages.
171
172 5.2 Why doesn't my email address and web page link show?
173
174 Did you remove the comment symbol '#' in the configuration file?
175
176 5.3 I have configured everything, yet my index page does not update
177
178 The default option is to die if there are any response problems. Try
179 changing the $suicidal option. Examine the log file.
180
181 5.4 Your crontab example looks really odd, please explain.
182
183 First the script gets mrtg to run on the regenerated 'mrtg-dynip.cfg' file.
184 The crontab entry is designed to send any error mwessages from standard
185 output and error to a log file with a date and time indicator. If you don't
186 do this you may end up perplexing/annoying/frightening those on the root
187 email distribution list (who are automatically emailed unredirected standard
188 output and error from cron jobs), if you run the script as user root. The
189 error messages can be confusing to those inexperienced with mrtg and snmp,
190 and can be lengthy and frequent!
191
192 6. Why do the in and out graphs closely follow each other in my modem bank
193 graphs?
194
195 This has to do with the way information is reported by by the snmp agent for
196 the interface devices. On mainstream ISDN router devices, 'in' appears to
197 indicate incoming packets on one side and 'out' appears to be outgoing
198 packets on the same side.
199
200 For some interfaces, 'in' appears to indicate incoming packets to both sides
201 and 'out' appears to mean the forwarded packet out of the interface from
202 either sides.
203
204 It appears as snmp counts both sides of an interface for counting on some
205 devices but one side for other devices. This problem needs to be sorted
206 out.
207
208 7. I cannot find a solution to my problem in the docmentation and web
209 sites. What support exists and is there a mailing list?
210
211 This depends on the problem. For problems to do with mrtg there is an
212 active mailing list and extensive archive. For problems specific to
213 mrtg-dynip please send an email to me at [email protected].
214 I will set up a mailing list if necessasry.