-
Notifications
You must be signed in to change notification settings - Fork 9
/
README
131 lines (82 loc) · 2.78 KB
/
README
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
GERTY
=====
a proper way of doing things that RANCID does... and much more
Project status: preparing for a release.
Originally GERTY was a robot character in the film "Moon" (2009) by
Duncan Jones, with Kevin Spacey's voice.
Gerty is the automation tool for network operation tasks, like:
* Collecting status and configuration data
* Executing remote commands
* Parallel, massive execution
Various management access interfaces are available:
* Telnet/SSH command line
* SNMP
* NETCONF
* TL/1
Usage examples
--------------
* Device configuration backup
* VPLS MAC counts on Juniper MX platform: per-instance and per-VLAN
counts for every routing instance, stored in SQL DB
* 15-minute HDSL line quality statistics (ES, SES, CRCA, LOSWS, UAS)
collected every few hours and stored in SQL DB
* Chassis hardware types, serial numbers, IOS versions for Cisco
devices, stored in SQL, with change history
* Port status, CDP neighbours, UDLD status for Cisco devices, stored in
SQL, with change history
Vendor-specific plugins
-----------------------
The core Gerty package contains only vendor-independent features. All
vendor-specific features are packaged in plugins. Vurrently plugins for
Cisco, Juniper, and some xDSL equipment are available:
https://github.com/ssinyagin/gerty-plugins
DOCUMENTATION
-------------
User guide:
doc/gerty_userguide.markdown
Architecture and design:
doc/gerty_architecture.markdown
Software documentation:
doc/gerty_job_configuration.markdown
doc/gerty_siteconfig_configuration.markdown
doc/gerty_devclass_configuration.markdown
doc/gerty_device_attributes.markdown
Installing from sources:
------------------------
Pre-requisites: autoconf, automake, and a number of Perl modules
git clone https://github.com/ssinyagin/gerty.git
cd gerty
autoreconf
./configure --prefix=/opt/gerty
make
make install
later on, "git pull" would refresh your copy with the latest updates
Installing documentation
------------------------
apt-get install pandoc
sh mkhtml.sh ~/public_html/gerty/
pandoc -s doc/gerty_manpage.markdown --to=man -o /usr/local/man/man1/gerty.1
Ubuntu and Debian pre-requisites:
---------------------------------
apt-get install make libtool autoconf git-core \
libconfig-tiny-perl libconfig-any-perl \
liblog-handler-perl libexpect-perl \
libxml-libxml-perl libnet-snmp-perl \
libdbi-perl
Mailing list
------------
http://chilli.nosignal.org/mailman/listinfo/gerty-users
(thanks to Andy Davidson)
TO DO
-----
* automate backup for Cisco files, like "vlan.dat"
(suggested by Viktor Steinmann <stony@stony.com>)
* write "Gerty Developer Guide"
* update documentation on Netconf, SNMP, TL1
* update documentation on DBLink and action postprocessing
Author:
-------
Stanislav Sinyagin
CCIE #5478
ssinyagin@k-open.com
+41 79 407 0224