File: CHANGES

package info (click to toggle)
cricket 1.0.5-21
  • links: PTS
  • area: main
  • in suites: stretch
  • size: 1,936 kB
  • sloc: perl: 8,276; ansic: 329; sh: 162; makefile: 63; sql: 16
file content (1056 lines) | stat: -rw-r--r-- 38,732 bytes parent folder | download | duplicates (8)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
New features, fixes in version 1.0.5

	Cricket 1.0.5 is essentially a minor bugfix release.

	An error with case dependance with new style views was eliminated.

	A "label" tag was added to the "view" dictionary. This eliminates
	the need for using spaces in view names. It also allows the Cricket
	admin to alias different targetTypes to the same name in the
	HTML menu -- use this feature wisely!

	systemPerfConf.pl was reverted back to using our own SNMP_Session
	based SNMP interface, and interfaces detection was added [Mike Han]

	The distributed sample-config/Defaults has width-hint and
	height-hint commented out, to cut down on squashed graphics.

	The handling of NaN was standardized throughout the code.
	To check for NaN, use isNaN from Common::Util.

	All text files now have LF line endings. In the 1.0.4 release,
	a number of files were inadvertantly changed to have CRLF line
	endings.

	A small bug in threshold monitoring was identified and fixed
	by Jase MacLeod.

	Error reporting by the monitor subsystem has been reviewed and
	made more extensive, based on a patch by Andrew Clark.
	If you have scripts that look for the text string "Skipping",
	you are well advised to look for "Monitor" instead, and review
	your scripts while you're at it.

	We now support s390x-linux, thanks to Shane Stixrud. [Patch
	#877924]

New features, fixes in version 1.0.4

	Added span option for monitor-thresholds of all types [Patch #838250].

	Added new option to log entry format [Patch #565877].

	Added new META monitor thresholds action [Patch #821255].

	Added support for sparc64-netbsd from Edwin Mons [Patch #803408].

	Documented the "use-gprint" target option [Bug #667178].

	Documented the "show-path" target option [Bug #667179].

	Added support for optionally logging the full path to a datasource
	in collector output. By setting $gLogFullPath=1 in cricket-sonf.pl
	you will get e.g. "Switches/Cat4000/core/FastEthernet0_1" instead
	of just "FastEthernet0_1" in your logs.

	Added a new "hidden" tag to the "target" dictionary. When this is
	set to a true value the target will be skipped by the grapher to
	enable you to display the data combined in an "mtarget" instead.
	[Patch #697737]

	Support for package qualification in func data source fetching
	(patch #772097).

	Support for RRD version 0003 files on some architectures; the
	last update microsecond value is not actual available in Cricket
	(and hence not published in the grapher Summary) but it is
	accommodated (so that functions like getDSCurrentValue that
	essentially use pointer arithmetic to jump around the binary RRD
	files will work).

	Fix for bug #666675; the "floating point comparison perl 5.8"
	issue. The most prominent symptom of this issue is the message
	"Current values not available: Something is wrong with the
	header of this file" in the grapher summary panel.

	Documentation for the failures monitor threshold. Permit
	conditioning a failures monitor threshold on a range.

	Fix to loading WMI Scripting constants library in wbem.pm.
	Should allow using WMI on WinXP.

	Minor fixes to Monitor.pm: detection of NaN/nan, LogToFile
	duplicate line detection, and new SNMP VarBind (9) to send
	value in trap. [patch #592165, #592163]

	An experimental new feature allows you to use the Cricket
	target name as the rrd datasource name. Some caveats apply:
	 - if you use COMPUTE datasources, you will have to manually
	   edit your config tree, and update all rrd-cdef rules to
	   match the new reality. Do not switch on long ds names
	   unless you're prepared to do this! In particular, users
	   of the NT perfmon tree should not yet enable this.
	 - RRD ds names are limited to 19 characters. Cricket datasource
	   names longer than 15 characters are edited automatically to
	   ensure the RRD ds name remains unique. You can use the
	   Common::Util::mungeDsName routine in your own code to generate
	   compatible munged names (or use target names under 16
	   characters to avoid the issue altogether).
	The feature is enabled by putting
	   $gLongDSName=1
	in their cricket-conf.pl

	Introducing the view dictionary! Views are now separate config
	tree entries. Going forward, the view tag in the targettype
	dictionary should specify a comma-delimited list of views that
	are defined in separate view entries. View entries support all
	non-datasource specific graph tags (aka graph --default-- tags)
	and view specific tags. The most important view specific tag is
	'elements' which specifies a comma-delimited or space-delimited
	list of data sources. Note that this change should not break
	existing config trees because the old targettype view tag syntax
	is still supported.

	listInterfaces has been updated (users of the contributed
	web site may recognize listInterfaces+). When upgrading from
	previous versions of Cricket, it is recommended that you
	review any scripts that call listInterfaces.

	The URL style is now selectable from cricket-conf.pl. Options
	are "classic" (what Cricket 1.0.3 did, default), "relative"
	(which uses relative URLs, for reverse proxy) and "pathinfo"
	(passes the target name as part of the URL path, which allows
	for using Apache <Location> access restrictions).

	It is possible to mark NaN samples in the graph with a colored
	background. This is enabled via the view tag paint-nan (boolean value).
	WARNING: do not enable this if you use the STACK draw-as
	type anywhere in your graphs.

	Added an alternate SNMP interface, using net-snmp. See
	lib/alternate/snmpUtils.pm. Not recommended in its current
	incarnation for users of SNMP traps and threshold monitoring.
	On some systems, using it may speed up Cricket by 10-15%.

	Fix mtargets bugs w.r.t. MiXeD CaSe names (hopefully for good)
	[bug #521367]

	Fix graph scaling with explicit "bytes=false", which was
	misinterpreted by the graphing code.

	Updated getFormat.c from John Woolner [Patch #454472].

New features, fixes in version 1.0.3

	The many disk accesses to the config database that collector
	uses are causing the collector to run slowly on sites with
	huge config trees. Starting with 1.0.3, the entire config
	tree is slurped into memory. This causes a significant speedup
	at the expense of collectors memory size. The database access
	method can be set to "lookup" in cricket-conf.pl to revert
	to the old behavior if collector memory footprint is of greater
	concern to you than its hammering on the disk.

	A new way of configuring Cricket has been added. It is now
	possible to create a file called cricket-conf.pl, which can
	either reside in the same directory as the grapher.cgi
	and collector scripts, or in /usr/local/etc. This should
	eliminate the need to edit grapher.cgi, and make life easier
	for people running Cricket on NT. The change should be
	backwards compatible, please file a bug on Sourceforge if it
	is not. A sample file is provided as cricket-conf.pl.sample.

	The implementation of the MAIL action tag for monitor thresholds
	is complete. New VarBinds added for SNMP trap monitor thresholds.
	Added a new monitor threshold type, quotient. Revised and extended
	monitor threshold documentation. Added "exact" monitor type.

	A new config option, show-path, was added that allows the
	display of the current path in the config tree with clickable
	links for easier backtracking. Defaults to "no".

	Support for SNMP version 2, as well as for the additional
	options that SNMP_Session now offers has been added to
	the sample-config/Defaults file. For existing installations,
	it is recommended you install the sample-config/Defaults into
	your cricket-config and merge your local changes in.
	If you do this, or if you install Cricket from scratch, you
	should use SNMP_Session version 0.80 or higher (it is
	recommended to upgrade SNMP_Session regardless, there were
	some rare but hard to diagnose bugs in versions prior to 0.78).
	The defaults are
		snmp-timeout = 2.0
		snmp-retries = 5
		snmp-version = 1
	If you know what you're doing, you could reduce the number of
	retries or the timeout, but this is not recommended. Existing
	Cricket users should first evaluate the effectiveness of
	the dead-SNMP-host detection that's new with 1.0.3 before
	mucking with the SNMP settings.

	Support for Windows Management Instrumentation on the Windows
	2000 Platform. Refer to doc/win2kwmi.html.

	The SNMP code now has intelligence built in to quickly
	skip a device that is down or otherwise doesn't respond.
	After two successive timeouts from the same host in one
	collector run, that host is considered down and subsequent
	targets on that device will be marked 'U' without checking.
	This avoids the syndrome where one device with a lot of
	targets can significantly slow down your collection
	process. If you need, you can increase MAXTRIES in
	lib/snmpUtils.pm. [patch #402839]

	The top level Defaults now sets rrd-min to 0 rather than
	undef. The default rrd-ds-type now is DERIVE instead of
	COUNTER. These changes prevent spikes in graphs. For the
	intrepid, Cricket can now monitor snmp-uptime in conjunction
	with using COUNTER (usage of snmp-uptime is not recommended
	unless you understand all possible causes of SNMP counter
	rollover; not all agent resets can be detected). [bug #209530]

	squid-proxy subtree Defaults file has changed. One
	more variable is being polled now (CurrentLRUExpiration)
	so you'll need to either recreate your old RRDs, or
	use add_ds from the RRD distribution's contrib directory
	to add a datasource to your existing RRD files.

	Some internal changes were made that should not be user
	visible (except perhaps by running faster in some cases).
	Most notably, the internal database types "D:" and "n:" are
	no longer generated.

	All files were made consistent in their indentation. We now
	use soft tabs exclusively, with a tab size of 4.

	RPN now allows negative constants, like in this magic which
	inverts a percentage from 0-100 to 100-0:
		100,-,-1,*
	Fixes bugs #472862 & # 450391.

	Portability: Some failures on AIX have been eliminated.
	More hardware platforms are supported by lib/RRD/Format.pm.

New features, fixes in version 1.0.2 (18-May-00):

	Fixed bug #104757, $clmxCode/max-color bugs.

New features, fixes in version 1.0.1 (18-May-00):

	Various small bugs fixed, related to mixed case names.

	Documentation split into smaller files and reviewed.

	First release from Sourceforge's CVS server.

	Assorted bugs and patches that were also integrated:

	bug 212204 compile: add config-dir name to output
	bug 202221 Fix for display of scaled values in mtargets
	bug 202262 Summary should show up at bottom (optionally)  [feature]
	bug 202266 mtargets and targets and multi-target2  [doc clarification]
	bug 202455 need to quote url passed to test-url
	bug 205504 collect-subtrees / subtree-times  [feature]
	bug 205559 integrate functions of run-subtree into collector
	bug 205560 collector log rolling for .time files
	bug 205595 Collector optimizations
	bug 206305 Persistent monitoring toggle
	patch 400218 cricket-0.72-current_path.patch
	patch 400282 cricket-0.72-showmax.patch (docs changes)
	patch 400431 lib/RRD/Format.pm had incorrect regex for supported
		archname (similar to bug 206166, and a couple of others)

New features, fixes in version 0.72 (23-Jan-00):

	Fixed a typo in one of the "fixed" split lines from the
	last release.

	Fixed a typo that makes scaled mtargets work right.

	Fixed the height-hint in the root Defaults file to match
	the height used by rrdtool-1.0.10.

	Fixed y-min/y-max code, hopefully once and for all.

	Directories named 'CVS' (exactly) in the config tree
	are ignored now.

	Collect-subtrees now makes the log directory if necessary.

	Minor documentation fixes to reference.html.

	Cleared up warnings when inst-names tag is missing.

New features, fixes in version 0.71 (09-Jan-00):

	This release has a minimal number of patches to fix
	the most pressing bugs reported to me in the last 4 months.

	It works with RRD Tool 1.0.10. You must upgrade your RRD Tool
	install to this version to use Cricket 0.71. (This is because some
	critical bugs have been fixed recently in RRD Tool.)

	If this version of Crikcet proves to be stable, it will be
	renamed 1.0. Future development will take place in 1.0.x
	releases, culminating in a 1.1 release. In general, three-digit
	releases will be development, two digit releases production.

	Here are the patches that have been applied to Cricket 0.70:
		Minor documentation fixes.
		A new avg() function to go with the sum() function.
		Scaling works right in multitargets now.
		Event names are case insensitive, as documented now.
		Comma and colon delimited lists now ALWAYS allow
			whitespace. Previously, rrd-tune was broken because
			of a split() that was too restrictive. All of these
			have been fixed.
		Cricket no longer gives RRD Tool input that crashes it.
		Support for various architectures added to Format.pm.
		Lots of changes to Monitor.pm, but it's still not ready for
			production use. Sorry.
		http-performance tests a slightly different URL

New features, fixes in version 0.70 (11-Aug-99):

	ATTENTION: You must use RRD Tool 1.0.x with Cricket 0.70
	and higher. Cricket now defaults to making PNG pictures,
	if you are using a 4.0 browser or better. If you really
	want GIFs (which are big and slow, now that GD has been
	lobotomized by Dr. Unisys), then you need to investigate
	the graph-format tag in the graph dictionary.

	Frobbed the quoting magic some. I think it was broken before.
	I think it is less broken now. If you see odd behavior, suspect
	quoting problems.

	Integrated a patch from Shannon Reis <sreis@fastlane.net>
	that adds avg/max display in. This adds an additional
	call to RRDs::graph. If you want it the old way, check
	out the tag named show-avg-max in the graph dict.

	backed out change related to lower-casing the
	target names in the targets and mtargets tags. What
	was I thinking?

	usrModemUsage script no longer tries to use
	common.pm.

	removed useless and confusing reference to domain
	in the routers subtree.

	made warnings work right in util/* again. Oops.

	made the mapping routines use collect=false when
	called from the collector. Note: if you set collect
	to 'false', the target will still show up in the grapher
	and if necessary, the instance will be mapped. This
	could cause warnings in the grapher, but they can be
	ignored.

New features, fixes in version 0.69 (16-Jul-99):

	A bunch of namespace fixes:
	The collector can again make directories when necessary.
	Instance mapping works. Lots of other fixes...

	Monitoring is now documented, and seems to work.
	Please read the description of the tag named
	'monitor-thresholds' and discuss this stuff on the
	mailing list. Javier Muniz, who wrote it, will be available
	to help us learn about it in the coming weeks.

	The new unknown-is-zero tag in the targets dictionary
	makes it possible to add together graphs which have unknown
	regions and not have the unknown regions blot out the entire
	graph.

New features, fixes in version 0.68 (09-Jul-99):

	Made it possible to use mixed case in mtargets and targets
	specifications.

	Integrated patch that makes y-min and y-max datasource-level.

	Added patches to make it work under NT (again).

	Significant changes to namespace usage to
	make it work under mod_perl. Search for mod_perl
	in reference.html for more info.

	Fixed sum() to work right.

	Fixes to make it work (sorta) under mod_perl.

	Fixed a minor bug related to iterating over
	results from the table walks done during
	instance mapping.

	Made the error message for an unmatched quote
	include the file and line number.

New features, fixes in version 0.67 (09-Jun-99):

	Fix: Added quoting to the inst tag to protect the
	argument of map() from eval.

	Fix: made overzealous warning from Perl
	(in Log.pm) go away.

	Fix: A vector instance with one element is now
	correctly treated like a fixed-instance scalar.
	If you didn't understand that, don't worry. What
	it means is that Cricket will Do the Right Thing.

	Fix: missed a conversion of expandString. Instance
	mapping now works again.

New features, fixes in version 0.66 (03-Jun-99):

	Fix: instance names are correctly shown in the title
	after visiting the instance seletor widget.

	New feature: target tag collect=false tells the
	collector to skip that target.

	Fix: all dictionaries are expanded with respect
	to the target dictionary, which seems to be more in
	line with how people thought it would behave.
	I'm not certain how people are going to use this,
	but if it makes people less confused, it's good, I
	guess.

	New feature: events. You can mark a graph with a
	vertical rule of any color to mark the time something
	of interest happened. Check out the new events target
	tag, and the event dictioanry. This requires Date::Parse,
	but you should have that anyway. If not, go to CPAN
	and get it.

	New feature: eval's during expansion. You can surround
	code you want eval'd with {} in a tag, and that will
	happen immediately after expansion. So this:
		snmp-port-2 = "%snmp-port% + 1"
	results in snmp-port-2 getting set to 162 (i.e. 161 + 1).
	Useful functions to make use of this will be coming
	to a release near you soon. In particular, there
	will be a snmpget() and a snmpwalk() that behave
	in ways that help make the config tree more compact.

	New feaute: directories can have descriptions which
	show up in directory selection list. See
	target tag directory-desc.

	SLIGHTLY INCOMPATIBLE CHANGE: I renamed the meta
	tag, since it makes more sense to call it
	'head-html' where it is used. Compare your existing
	root Defaults file to the one in sample-config
	and you'll see the change. See the docs for how you
	might use this to use stylesheets to override my
	terrible sense of style.

	Converter completely removed. If you have RRD files
	in pre 0.99 format, you'll need to use Cricket 0.65
	to convert them, then upgrade to later versions.

	The white in cricket-sm.gif is now transparent. And
	it's 20 bytes smaller. Cool.

	Added a new subtree for monitoring news servers.

	grapher.cgi will no longer fail on negative data.
	We now compute the si_unit using abs($value).

	Expansion is now working correctly in the target
	selector widget.

	There's a new trap subroutine in snmpUtils that
	makes it possible to specify OIDs in outgoing traps.

New features, fixes in version 0.65 (19-May-99):

	This is the paper-bag-over-my-head release.

	This fixes a big bug in the config tree system
	that made it unable to understand config trees
	deeper than two levels.

	There are also some minor fixes to ignore RCS
	files correctly.

New features, fixes in version 0.64 (18-May-99):

	Sorry I got a bit verbose this time... a lot of
	infrastructure stuff has been happening recently. Keep
	reading all the way... there are some incompatible
	changes in this release.

	This version was tested with RRD Tool 0.99.29.1.
	It should work with other 0.99.x releases of RRD Tool
	also.

	You need to have the Perl module named DB_File
	installed to use this release. It's relatively
	standard, but if you don't have it, go get it
	from CPAN. (See doc/beginner.txt for more info on
	CPAN.) You can check to see if you have it by executing:

		perl -MDB_File -e 'print $DB_File::VERSION, "\n"'

	New feature: Cricket operates off of a compiled
	form of the config tree, which is stored in a file
	named config.db in the root of your config tree.
	The collector will recompile this as necessary,
	but when you are making interactive changes to the
	config tree, you need to remember to recompile it
	yourself -- the grapher does not have the permissions
	it needs to recompile it. The grapher will set the
	variable auto-error with a warning about the out-of-date
	compiled form. If you have added that variable to your
	page-footer tag, you'll at least get a reminder message.
	(search for auto-error in sample-config/Default for
	an example).

	To recompile the config tree manually, run:
		$HOME/cricket/compile -base <config-tree-base>
	If your config tree is in ~/cricket-config, you can omit
	the -base argument, since that is the default.

	New feature: ds-sources can now return text information
	after an floating point number, and Cricket will correctly
	ignore the text and use only the number. See the EXEC
	example in the docs for how this might be useful.

	New feature: you can defeat the cache by hand editing the
	URL that points to the target display page. Add '&cache=no'
	onto the end of the URL. This is helpful when you are
	making changes to the graph dictionary, and you want to
	regenerate the graphs on demand to see your changes.
	Remember, however, that you still need to recompile the
	Config Tree after each change.

	INCOMPATIBLE CHANGE: collect-subtree is now named
	collect-subtrees. It reads a file named subtree-sets
	which is slightly different format. For one, you need
	to replace the "subtree foo" lines with "set foo". You
	also need to nae subtrees by their full path relative
	to the root of the config tree. For instance,
	"router-interfaces" becomes "/router-interfaces".

	INCOMPATIBLE CHANGE: the URLs used by the grapher
	are a bit different now. If you have saved bookmarks
	that jump into certain parts of the config tree,
	they might not work now. Check them, and fix them
	if necessary. (The target parameter is no longer
	rooted at the Unix root.)

	New subtrees: usr, for monitoring USR modem chassis.

	New utilities: generate-statics and pmlines.pm, a more
	flexible replacement for PM3lines. Note that the portmaster
	subtree may not be in sync with the utility anymore...
	I'm not a portmaster user, so I'm relying on patches from
	you guys.

	generate-statics is a cool little tool to take snapshots
	of the GIFs. Read about it in the util/README file.

	New feature: graph dict tag rrd-graph-args allows
	you to send arguments directly in to RRD Tool, which
	Cricket does not already send for you. A notable use
	of this would be to set colors on the graphs to something
	other than the default. See the docs for more info.

	I made the page-footer easier to override in subtrees.
	If you want to put something in the center pane
	replace the tag named contact with your stuff.

	New feature: if mtargets-ops is "sum()", it is replaced
	with the right number of plusses.

	Grapher.cgi is a big mother, and it takes a long time
	for Perl to parse it. It now redirects image requests
	through mini-graph.cgi, which is a tiny mother, which
	is fast to parse. This makes your webserver spend less
	time parsing Perl and more time spraying GIFs, which
	is a Good Thing. This may not work on NT. If not,
	comment out the line in grapher.cgi with "mini-graph.cgi"
	in it. (It's a substitution on the variable $me.)
	Please send patches to make this work on NT. :)
	You may need to add a new link in ~/public_html/cricket
	to point to mini-graph.cgi.

New features, fixes in version 0.63 (02-Apr-99):

	INCOMPATIBLE CHANGE: If you have installed previous
	versions, you need to compare your targetType
	lines to the ones in the sample-config tree and fix them.
	Basically, tags are no longer allowed to appear
	multiple times, instead they must appear once
	with a comma-delimited list inside quotes.

	Jeff Jensen gave us the kick butt routing subtree,
	which lets you watch BGP updates with Cricket.

	The paper I wrote for NetA 99 is in doc/neta-paper.

	A new smaller rrdtool.gif Tobi gave me a long time
	ago which I forgot to add.

	Various bugfixes to jpj's new mtargets thing.

	Fixed a goofy bug which made view get set wrong
	when there were targets with and without a view
	in the same directory.

	collect-subtrees processes all subtree sets if it
	was given no arguments. Also cleaned up an error
	message.

	We now set --base correctly when drawing graphs.
	We decide how to set it based on the bytes tag
	in the graph dictionary.

	Unspecified bug in VRULE generation for yearly graphs
	fixed. Russ is the man.

New features, fixes in version 0.62 (27-Mar-99):

	Fixed some bugs in getFormat.c that the Compaq (cough)
	Alpha let us notice. It now creates output suitable to
	cut and paste into lib/RRD/Format.pm. Yippee.

	atm-interfaces subtree was contributed by Alan.

	grapher.cgi is friendlier about a missing VERSION
	file. But you really _should_ still have it in the
	same directory that grapher.cgi is in.

	Added the new disable-short-desc tag, which
	can make more room in the target selection table
	by skipping the description column.

	Fixed the README to reflect a recursive diff for submitting
	patches. (jpj)

	Updated or created documentation for targets,
	targets-short-desc, targets-long-desc, mtargets,
	and mtargets-ops. (jpj)

	Implemented support for graphing multiple targets on
	the same graph using the mtargets tag. (jpj)

	Implemented basic support for graphing of arithematic
	operations on targets.  You can now graph the sum of
	multiple targets, as well as other operations! (jpj)

New features, fixes in version 0.61 (07-Mar-99):

	Interlaced now works as specified in the manual.
	Previously you had to use "interleaved", which is
	not what the docs said.

	You can specify the time at which a given measurement
	was taken. Search for XXX@YYY in the reference docs.

	Minor efficiency change in collector.

	Cricket can now send traps with the data it is collecting
	inside. This is useful if you happen to be running
	Netcool, and you've set things up correctly to
	escalate alerts holding data that violates
	certain thresholds. However, it is implemented to be
	flexible enough to later let us send data other places.
	See the docs for tag copy-to for more info.

	As part of the copy-to implementation, snmpUtils now
	knows how to send SNMP traps. Cool.

New features, fixes in version 0.60 (05-Mar-99):

	CHANGE REQUIRING YOUR INTERVENTION!!!
	Old versions of Cricket might not have set rrd-min
	and rrd-max correctly in your RRD files. In this
	version of Cricket, the values come from the
	datasource dictionary, and from the target dictionary.
	If they are present in the target dictionary, they override
	the ones in the datasource dictionary. Check
	your config now to make certain it's doing what you
	want, and then run rrd-tune to apply the values
	to your existing RRD's.

	support for Portmasters, via an EXEC script.

	support for FreeBSD.

	removed unused call to localtime from grapher.cgi

	listInterfaces no longer lets colons creep into target
	names.

	rrd-dump truncates C strings correctly now.

	More control over multitargets with targets-desc-long
	and targets-desc-short. (Thanks, jpj.)

	Datasource descriptions are now displayed in the order
	they occur on the graphs.

New features, fixes in version 0.59 (15-Feb-99):

	grapher now handles blank long-desc gracefully.

	grapher will attempt to put up an error message
	in a GIF (failed.gif) when it cannot give you
	a graph.

	Minor fix in options to handle unset $HOME better.

	Grapher debug level defaults to 'info' again.

	Multi-target supports instances now. The separator
	in the targets tag is now ";". This is not a backwards
	compatible change; if you were using targets before,
	you need to change it now. It's all still undocumented
	but it getting stable enough to document it.

	Fixed bug reated to inst not getting set and
	causing a warning.

	FAQ updated... keep those "dumb" questions coming! The
	only dumb question is one we don't document and learn
	from!

	RRD::Format now supports Linux again, and there's
	a nifty tool from Ed that makes it a no-brainer
	to port to new OS's. See the comments in RRD::Format.

New features, fixes in version 0.58 (05-Feb-99):

	FINALLY: Support for RRD 0.99.* (tested with 0.99.7)
	(only the RRDs (shared library) module, at this time)

	NOTE: You MUST edit your RRA definitions, if you will
	be creating new RRD's. (Do it now before you forget!!!)
	You need to add the x-files-factor into the RRA definition
	after the consolidation function. See the comments in the
	root Defaults file. (New users can simply copy sample-config
	as usual.)

	Collector will do auto-conversion from old-format RRD files,
	for all you old-timers. It works like this; run 'collector'
	by hand once with the option '-convert'. Any RRD files that
	need to be converted will be. You can run with '-convert' as
	often as you want -- it will only do the conversion once.
	You can also convert a file on demand using util/convert-file.
	The old files are left in the same directory as "foo.rrd.old".
	Using find to remove them would save a lot of disk space --
	if you trust the converter. :) The command is:

		find ~/cricket-data -name '*.old' -exec rm {} \;

	collect-subtrees now takes a -cf arg, which you can
	use to tell it to look at a different subtrees file.

	Fixed incorrect HTML entity in sample-configs/rotuers/Defaults.

	Cricket's version is now available in the HTML dictionary,
	in both it's long and short forms. You can see it in action
	in the newest root Defaults file, which puts the version number
	in the footer.

New features, fixes in version 0.57 (02-Feb-99):

	Sample config tree now contains Cricket logo and the RRD
	logo. You should definately upgrade your root Defaults file...
	the logos look cool!

	Changes cached expiration system to be real-time. This means
	no evil cron job (yeah), no permissions problems (yeah) and
	no possibility of incorrectly cached graphs. I think.

	Expansions on the target list pages are now handled
	correctly.

	Short-desc is used now in the aggregates and at the
	top of target pages.

	New tag: bytes, which tells si_unit to calculate the prefix
	using powers of 2 instead of 10. "bytes" is set to true for
	ifInOctets and ifOutOctets in the sample tree now.

	Ignores files like "#foo#", which emacs can leave behind
	as backups.

	Datasources were not actually case insensitve like the
	docs claimed they were. Now they are. (Rumor has it they
	aren't everywhere yet...)

	Fixed bugs related to instance lists with variable expansions
	in them. Also a bug related to quoting these guys.

	Fixed bug in the way micro symbol was displayed.

	RRD::Format now supports arch i86pc-solaris and MSWin32-x86.

	listInterface will quote more lines that need it (i.e.
	empty or whitespace only lines).

New features, fixes in version 0.56 (15-Jan-99):

	Documentation updated in various ways, including
	new features, new info on purging the GIF cache, and
	fixed typos.

	Made RRD::Format cross-architecture. Supports
	sun4-solaris and i386-linux. For tips on
	porting to other archtectures, see lib/RRD/Format.pm.

	Reworked Makefile to make a more better tarfile (writeable
	files, and no garbage in lib).

	Added a "rand" parameter to image URLs so that Netscape
	will let RRD decide what things should be cached. Search
	for "rand" in grapher.cgi to shut this off, if you are
	annoyed by the slightly longer load times.

	Added a caching mechanism to the graph drawing routine.
	The cache dir can be changed easily by editing the beginning
	of grapher.cgi. It will never hold more than 5 minutes worth
	of graphs, so /tmp should be appropriate. Clearing the
	cache is done by running grapher.cgi from cron with certain
	options. Search for "cache" in the documentation.

	Made collect-subtree strip leading whitespace from
	subtree names correctly.

	Taught listInterfaces and router-interfaces subtree
	about sub-interfaces. It turns out that some interfaces,
	like those related to PVC's on frame relay circuits,
	will not tell you the packet or error counts. So
	listInterfaces tries to mark those as "sub-interface"
	type interfaces, so that we don't try to fetch things
	that we can't get.

	New feature: inst-names will let you name the instances
	in a vector instance list. See documentation for details.

	New feature: the graph dict tag si-units=false will
	let you disable si_unit(), which turns 2000 in 2k. The
	scales of the graph will still have the SI transformation
	done to them.

	The instance selector widget is now formatted as a
	5 column table.

New features, fixes in version 0.55 (07-Jan-99):

	Various fixes to make it work better on NT.
	Documentation expanded.
	listInterfaces handles quoting right.
	Squid OIDs revisited. (Still might not be right...)
	Changed the layout of the time-navigation links some.
	Other minor bugfixes to the grapher and collector.

New features, fixes in version 0.54 (21-Dec-98):

	Made collect-subtree work right when there are two or more
	different users running it on the same machine. Also made
	it scan logs for errors.

	Made the collector more robust when making new RRD files.
	It reports useful stats again (# targets, amount of wall
	clock time).

	Fixed a stupid bug in RPN.pm that made it impossible to
	divide.

	Made grapher.cgi work with installs where RRD.pm
	needs to be installed in the local lib directory for
	some reason. Fixed bug in graphParam. Layed out datasources
	more nicely in HTML summary.

	Made regexp-based instance mapping work. Included
	an interesting example of how to use this feature.
	See sample-config/Defaults, and search for ^map.

	Added new switches subtree, which polls interesting things
	from a switch. This is relatively untested -- we use it here,
	but not in the exact form I am shipping. Please try it out
	and give me feedback.

	Resolved some questions in the docs.

	Added a new file datasource type. See docs for more info.

New features, fixes in version 0.53 (10-Dec-98):

	Fixed a bug in collector regarding creating new
	RRD files with more than one DS. This bug has been in
	since 0.50.

	Worked on the documentation some more, including more
	information about the graph dictionary.

New features, fixes in version 0.52 (10-Dec-98):

	SMRTG is now named Cricket. The website changed.

	There's a configure script that will take care
	of you if your Perl is not where mine is.

	Once RRD tool supports the -i (--interlaced) feature
	(a patch has been sent to Tobias) you will be
	able to use the "interlaced" attribute of the
	"graph --default--" dictionary to control the
	encoding of the GIF.

New features, fixes in version 0.51 (8-Dec-98):

	fixes to the squid-proxy subtree (already!)
	fixes to the http-performance tree
	actually implemented locking in collect-subtrees

	grapher.cgi:
		new feature lets you set the upper and lower bounds
		on graphs which have occasional spikes that you don't
		want to see. Set "y-max" to (for example) 3.0 to
		trim peaks higher than 3.0. Setting y-max or
		y-min will disable auto-scaling, so only use it when
		you mean it!

New features, fixes in version 0.50 (4-Dec-98):

	sample-config:
		squid-proxy subtree added

	all RRD users converted to use RRD module instead of talking
	over pipe.

	more complete documentation

New features, fixes in version 0.49 (21-Nov-98):

	sample-config
		lots of things added to show off various features

	grapher.cgi:
		new 'precision' attribute of graph dictionary lets you
		control the precision of the HTML summary for that
		datasource. Set it to "integer" for things which should
		be rounded to the nearest integer (like the number of
		modems in use).

		new "space" tag in graph dict that will let you
		override the space printed before units. (Useful
		for things like the degree mark.)

		case-sensitivity bugfixes related to datasource
		descriptions.

New features, fixes in version 0.48 (12-Nov-98):

	util/listInterfaces
		Now outputs ready-to-use SMRTG config files. (Thanks David!)

	util/ciscoDiscover
		An interesting contribution from Ed Bugg, which isn't
		quite working for me yet.

	limited multi-target support:
		if you have a target with a "targets" attribute in it,
		it is considered a multi-target. No data is collected
		for it, and when it is displayed, the grapher puts
		each of the graphs up one after another.

	grapher.cgi:
		scales and values in HTML and add prefixes to your
		units.

		shows fewer graphs by default, but gives you choices
		about which to show one you are looking at a graph.

	collector:
		easier to mess with the logging level. Use "-loglevel debug"
		to debug your config. Other options are 'info', 'warn',
		and 'error'.

New features, fixes in version 0.47 (8-Nov-98):

	THANKS:
		added a place to keep track of the help people
		are giving me... you guys make this process work!
		Keep it up!

	collect-subtrees:
		a replacement for the crufty old wrap-collector
		script. This understands the concept of subtree-sets, which
		makes it much easier to parallelize SMRTG (which you need
		to do if you are trying to poll thousands of targets).

	sample-config:
		new http-performance subtree which makes if possible
		for SMRTG to monitor webservers (and FTP servers too!)

	documentation:
		a few more tidbits, still need volumes more
		a tiny fix to the README -- the crontab entry was missing 55!

	collector:
		a bugfix related to making new RRD's

	grapher.cgi:
		now works on Netscape's webserver too!

New features, fixes in version 0.46 (4-Nov-98):

	collector
		handles oids right, for real this time. (really!)

	common:
		handleTarget is abstracted better to make adding new
		commands (like rrd-tune, see below) easier.

	grapher.cgi:
		pays attention to the size hints now (fixed bug)

		new long-desc and short-desc attributes of targets
		let you add text to the web pages describing the targets.

		new desc attribute for a datasource causes a description
		of the datasources to be added to the end of the graph page.

		we now use RRD::File to dig out the current values
		for the graphed variables.

		new attribute in graph dict called "unit". Uses this
		as the first choice in the summary -- will fall back to
		y-axis. See sample-config/routers/Defaults for an example.

	There is a new tool in util called rrd-tune. It traverses
	a config tree and tunes each RRD to the current settings
	for min, max, xff, and hearbeat. (Takes same args as collector).
	Run this on a target (or it's whole subtree, for now) after making
	a change to it's config.

New features, fixes in version 0.45 (30-Oct-98):

	Miniscule bit of Documentation!

	ConfigTree.pm
		more consisten --default-- behavior: works right across
			all TagValue items
		handles missing quotes (and other errors) slightly better
		now possible to nuke a key that you inherited

	grapher.cgi
		no longer uses path_info, since this doesn't seem to work
			with all webservers. (Thanks to David Koski
			<dkoski@noc.ns.itd.umich.edu> for his help diagnosing
			this.)

	collector
		handles raw oids in datasources correctly now
		fails gracefully in many more situations where
			the config tree is missing data

This file started with version 0.45.