forked from ssinyagin/gerty
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
124 lines (75 loc) · 2.76 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
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
DOCUMENTATION
-------------
See the Wiki for a short concept overview:
http://github.com/ssinyagin/gerty/wiki
User guide:
http://github.com/ssinyagin/gerty/blob/master/doc/gerty_userguide.markdown
Architecture and design:
http://github.com/ssinyagin/gerty/blob/master/doc/gerty_architecture.markdown
Software documentation:
http://github.com/ssinyagin/gerty/blob/master/doc/gerty_job_configuration.markdown
http://github.com/ssinyagin/gerty/blob/master/doc/gerty_siteconfig_configuration.markdown
http://github.com/ssinyagin/gerty/blob/master/doc/gerty_devclass_configuration.markdown
http://github.com/ssinyagin/gerty/blob/master/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
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
-----
* replace external SSH and Telnet programs with Net::SSH2 and Net::Telnet
* write a man page
* automate backup for Cisco files, like "vlan.dat"
(suggested by Viktor Steinmann <[email protected]>)
* write "Gerty Developer Guide"
* update documentation on Netconf, SNMP, TL1
* update documentation on DBLink and action postprocessing
Author:
-------
Stanislav Sinyagin
CCIE #5478
+41 79 407 0224