| 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. |