how-to block ads
|
d_l
Barsoom
Premium,MVM
join:2002-12-08
Reno, NV
| DSL stats collection script for a 3546 in WinXP
These are setup instructions to run a Perl script under Windows which will collect DSL line stat data from a Cayman 3546, parse the data, and then write the data to a text log file in the following format:
1078029429,6016,608,7161,894,12.5,16.0,31.0,15.5,16.0,12.0,0,0,1,0,1,0
1078029730,6016,608,7161,894,12.5,16.0,31.0,15.5,16.0,12.0,0,0,3,0,3,0
1078030030,6016,608,7161,894,12.5,16.0,31.0,15.5,16.0,12.0,0,0,7,0,6,0
The timestamp is called "epoch" time. It's the number of seconds since: 00:00:00 1970-01-01 UTC. A method for plotting the results such as a spreadsheet or MRTG is left up to the user.
For Windows XP users, the Perl script will run under Cygwin which provides a Linux-like environment in a Windows DOS box.
More information about Cygwin can be found at the »www.cygwin.com/ web page.
If for some reason you later decide to uninstall Cygwin, there is no uninstall procedure in the Add or Remove Programs section. Basically you would just need to delete the Cygwin directories manually. Cygwin doesn't embed itself into your registry too deeply, but it does add a few entries. You can either manually edit your registry to remove them, run a registry cleaner program, or leave them be and other than a little clutter they shouldn't bother you.
These are the items that would need to be deleted:
• Cygwin shortcuts on the Desktop and Start Menu
• The registry tree `Software\Cygnus Solutions' under HKEY_LOCAL_MACHINE and/or HKEY_CURRENT_USER.
• Anything under the Cygwin root folder, `C:\cygwin' by default.
• Anything created by setup in its temporary working directory.
____________________________________________________________________________________________
WARNING: Before proceeding any farther, your Windows login name must NOT have any blank spaces within it. UNIX shells (and thus Cygwin) use the space character as a word delimiter. In particular, the environment variables 'USER' and 'HOME' are set for you in /etc/profile. By default these derive from your Windows logon name. A work around for blank spaces exists, but is beyond the scope of these instructions.
WARNING: The Cygwin Setup program will prompt you for a "root" directory. The default is `C:\cygwin', but you can change it. You are urged not to choose something like 'C:\' (the root directory on the system drive) for your Cygwin root because of the potential for corruption by other operating programs.
Well now that you have been alarmed by two warnings, the rest is relatively easy. 
The first step if you don't already have it is to install Cygwin. You start the install by browsing to:
»www.cygwin.com/setup.exe
This will install a small GUI loader program (263KB) in a folder of your choosing.
Once the Cygwin Setup program has been downloaded, you can exit your browser, and run the Setup program. Then just follow the instructions. When it asks you about whether to install for you or the entire computer, check the entire computer and when asked about Unix or NT/Dos, pick Unix.
When picking mirrors to download from, find the one: mirrors.kernel.org. It is very fast, especially for those on the West Coast.
Once you get to the section where you select the packages, click on the "View" button at the top, and it'll change to view "Full". Leave all the defaults selected, then scroll down to the two Perl interpreters in the selections and left click each one once once to select them, then click the "Next" button to continue. It will have to download quite a bit and then it will install all the items (119 MB). The size of the 119 MB installation package can be reduced by about half with a careful selection of the components to be installed.
Cygwin Setup is not the most intuitive interface. I royally screwed this up when I first installed it  , but it can be used to keep, install, reinstall, uninstall, and upgrade components at a later date by simply left-clicking on the item repeatedly under the "New" column and then applying the "Next" button.
You only need to install the binary packages. Don't install the source ones unless you want to fill your hard drive even more than is necessary.
____________________________________________________________________________________________
The zip file will contain two files:
cayman_stats_telnet.pl
caymanrc
You should extract them into your home directory in cygwin which would be in: drive:\install_dir\home\username (where username is your computer login name in WinXP).
The cayman_stats_telnet.pl is the Perl script file that gathers and parses the Cayman line stats data. The caymanrc file is an example config file. It is set to collect all possible line stats every 10 minutes by default. You have to edit caymanrc with Notepad:
• to match the proper password and IP settings for your Cayman;
• to set the proper location for your log file (specified by a "unix-like" path, ie., /home/username/cayman.log);
• to change which stats are collected unless you want all of them;
• and to change the collection time interval unless you want every 10 minutes.
Then to run a one-time test start the Cygwin program by running the Cygwin.bat file in your Cygwin directory or by running the Cygwin Bash Shell under Start>Programs>Cygwin and then enter the following line at the $ sign prompt:
./cayman_stats_telnet.pl -conf ./caymanrc -runonce
Here's an example output, it should look something like this:
$ ./cayman_stats_telnet.pl -conf ./caymanrc -runonce
crc_counts_near: 1610
current_rate_up: 608
out_power_down: 16.0
noise_margin_down: 10.0
current_rate_down: 6016
hec_counts_near: 1278
maximum_rate_up: 881
maximum_rate_down: 7520
fec_counts_near: 0
attenuation_up: 15.5
out_power_up: 12.0
noise_margin_up: 16.0
fec_counts_far: 0
hec_counts_far: 2
attenuation_down: 30.5
crc_counts_far: 0
If you can get that (don't worry about the output order of the values at this point), then try entering this now:
./cayman_stats_telnet.pl -conf ./caymanrc
with no -runonce option. The above script will fork, and it will write to your log file at each interval you specified (in seconds, e.g. 300 for 5 mins). This script will continue to run in background if minimized on your taskbar. The only way to stop it later is to use task manager to kill Perl and maybe bash. (this isn't a fully polished procedure )
There is one possible problem in your Cayman router log. It will record these telnet accesses and end up filling the log with something this:
Sun Feb 29 05:12:13 2004(UTC) L4 TS: "admin" logging in from host 192.168.1.101
Sun Feb 29 05:12:14 2004(UTC) L4 TS: "Admin" completed login: Full Read/Write access
Sun Feb 29 05:17:14 2004(UTC) L4 TS: "admin" logging in from host 192.168.1.101
Sun Feb 29 05:17:14 2004(UTC) L4 TS: "Admin" completed login: Full Read/Write access
Subsequent entries will "push something off" the log to make room, so if you are depending on your router log to record any important events they may be pushed out.
Perl script written by deblin 
These instructions were extracted from IM conversations with deblin compiled/edited by d_l | |
FatJack
Premium
join:2001-06-26
Barnwell, SC | Re: DSL stats collection script for a 3546 in WinX
Wow thanks D_L for the help in logging this info. Hope we can get our Cayman fixed | |
removed
Crisis Management Squad
Premium,VIP
join:2002-02-08
Houston, TX
clubs:
| reply to d_l
It works on 2000 and 2000 Advanced Server as well. I don't think your version of Windows has much to do with it.
Apparently my Cayman has been acting up as well. It's strange that I have yet to notice it.
--
AIM | irc.removed.us - #dslr | Houston Police Radio! | |
DyerUser
Premium
join:2004-01-29
Dyer, IN
 ·AT&T Yahoo
| said by removed :
Apparently my Cayman has been acting up as well. It's strange that I have yet to notice it.
Mine had been acting up as well, though I was only noticing an occasional restart. I only realized because of a post by Beach Boy in the SBC Ameritech forum.
Actually, in looking at a number of 3546 threads in a few different forums, I suspect that there is some type of issue with all of them, but if someone has a very quiet line, they won't necessarily notice. I think that it will only become an issue when there is something that creates noise in the line.
If the line is naturally noisy, then it will be almost constant problems, but if the noise is very intermittent, then it is only a problem if the intermittent noise happens to hit when someone is at a low spot in their decay cycle. (In my experience, I was surfing fine at a noise margin of 1.5. I even did successful, decent speed tests at 1.5)
And without some type of monitor like d_l offered above, I suspect that those intermittent problems will be almost impossible to locate because not only are they local issues (is the air conditioner too close to the incoming phone line? was there a storm coming?) but the problem won't happen every time the local event does, only when the local event corresponds with an excessively low noise margin.
I think it would be great if some others who are not having problems with their 3546s could monitor their stats for a few days. I'd suggest adding your data not to this thread but to »Need some help from the Cayman gurus!! because that is where we already have a number of graphs and some raw data files. | |
dgilbert
Good Bye My Friend
Premium,MVM
join:2002-06-15
none
clubs:
| reply to d_l
i am going to set this up on mine today.
you guys did a great job putting this together. i asked the mods to sticky this thread so others will be sure to see it.
--
If you can read this, thank a teacher..........and since it's in English, thank a soldier. | |
d_l
Barsoom
Premium,MVM
join:2002-12-08
Reno, NV
| If someone finds the 119 MB download too big with all the unnecessary "auxiliary" Cygwin files, I think this might be able to be reduced to about +50-60 MB by de-selecting some of the modules, but I don't know which ones can be ditched. In the Cygwin Setup, I tried first de-selecting all modules, then selecting only the two Perl interpreters hoping that it might use dependencies to re-select any that were needed (this was deblin 's suggestion). This got the installation down to ~47 MB, but it didn't run. The bash module had been left out. So at a minimum, the Perl script needs the two Perl sections, all the Cygwin modules, and the bash module.
Isn't the stats page on the 3220 very similar in layout to that of the 3546 for COS version 6.3? If the CLI commands to get to that page on the 3220 are the same as the 3546 and the layout is the same or very similar, then the Perl script should work on the 3220 as well. | |
dgilbert
Good Bye My Friend
Premium,MVM
join:2002-06-15
none
clubs:
| yes, the 3220 running 6.3 is the exact same as a 3546 running 6.3, but slightly different than one running 6.4. once i have this setup, i will have it poll my 3547 and my 3220 to see how it works.
--
If you can read this, thank a teacher..........and since it's in English, thank a soldier. | |
d_l
Barsoom
Premium,MVM
join:2002-12-08
Reno, NV
| reply to removed
This Perl script should run on any version of Windows after 95, but I didn't know where some of the components would install such as the home directory, "\home\username", and I didn't test it on any OS other than WinXP. I didn't want to make promises for set ups that might not work. | |
klui
join:2001-11-08
San Jose, CA
3 edits |  reply to d_l
 cayman_stats···t.pl.zip 690 bytes
Patch to not relogin if interval is less than 15 minutes
(cayman_stats_telnet.pl.diff) |
This is a unified diff file. Use patch(1) to patch the original like this:
cd _to_where_your_.pl_file_is
patch --verbose --backup < cayman_stats_telnet.pl.diff
| |
|
