Welcome to the scotty Tcl extension for network management
by Juergen Schoenwaelder and many contributors. Maintained by FlightAware LLC
Introduction
You are looking at the source tree of scotty, a software package
which allows to build IPv4 network management applications using Tcl
and Tk. It consists of two Tcl extensions: Tnm and Tkined, two
related applications: scotty a Tcl interpreter with Tnm preloaded
and tkined a interactive gui network diagramm editor and monitor.
scotty license terms can be found in tnm/license.terms which
is essentially identical to the
Tcl/Tk license.
Tnm extension
The Tnm Tcl extension provides the following features:
- Access to Internet protocols: ICMP, DNS, UDP, SUN RPC, SNMP, NTP.
- Facilitates writing special purpose SNMP agents in Tcl and parse and access SNMP MIB definitions.
- Access the local network databases: hosts, networks, protocols, services, sunrpcs.
- Schedule jobs that are to be done regularly.
- Realize event driven programming on network maps.
- IP address and networks calculation.
- Write messages to the system logger.
tkined and the Tkined extension
tkined is a network editor which allows to draw maps showing your
network configuration. The most important feature of tkined is its
programming interface which allows network management applications to
extend the capabilities of tkined. scotty packages several
applications which allow for network autodetection, node monitoring,
geolocation and others.
About and Status
This source distribution is targetted at the current available (February 2017) toolchains and Tcl versions. The default is to build shared libraries with Tcl stubs support.
tkined is working fine on all tested platform, except for Debian
jessie 32 bit, where it hangs on the first invocation of ined.
Scotty currently is only operating correctly on 32 bit platforms. There are several known bugs which surface when running on 64 bit.
Note that the organisation of the source tree has been modified heavily, to account for current policies of extension building. Each extension is given its own subdirectory, where they can be built independently.
Tnm tests have been updated and problems singled out and documented
in the tnm/TODO file. Running make test should succeed without
failures, except DNS tests which depend on specific network setup and
availability and might fail on your site.
The current versions are Tnm 3.1.3 and Tkined 1.6.0. Due to the large number of files that need to be updated to a new version, there are helper scripts tnm.patch and tki.patch in the root directory that perform the heavy lifting for you. If you change any file containing the version numbers check whether these files need updating.
Obtaining and Installing scotty
scotty is freely available in source form from several locations. The historical homepage does not exist anymore. FlightAware has done significant maintenance of the software. The FlightAware version is available from: https://github.com/flightaware/scotty
This particlar version, motivated by FlightAware, adapts the build system to recent versions of operating systems and Tcl/Tk versions and is available from: https://github.com/jorge-leon/scotty
Tested Operating Systems
- Debian GNU/Linux 7.11 (wheezy), 8.7 (jessie) *
- Ubuntu 16.10 (yakkety) *
- Alpine Linux (Note: temporarily unavailable)
- Slackware Linux 14.2
- FreeBSD 10.3 * and 11
- NetBSD 7.0.2
- MacOSX 10.10.5 (Yosemite)
- Oracle Solaris 11.3
Note: operating systems marked with an * have the best support and test coverage. See tnm/TODO and tkined/TODO for a list of known problems.
Tested Tcl/Tk Versions
- 8.5.11 (Debian wheezy)
- 8.5.17 (Debian jessie)
- 8.6.2 (Debian jessie)
- 8.6.4 (MacOSX)
- 8.6.5 (Slackware)
- 8.6.6 (FreeBSD, Ubuntu, Alpine, Solaris)
Compilation Requirements
- Tcl/Tk development files.
- OS specific (libc) development files.
- C compiler:
- GCC
- Clang on FreeBSD
- Make:
- GNU Make
- PMake on FreeBSD
- GNU autoconf
- On Alpine Linux (musl libc):
- The libtirpc-dev package.
- pkg-config (to find libtirpc)
Obtain, Compile, Install
Clone the repository or download the source as zip archive and unpack to any destination directory of your liking.
There is a convenience Makefile in the top level directory, which
automates build, install and uninstall for the tested platforms. Just
run make and it will help you. See the file PORTS for platform
specific details.
The following are detailed build instructions.
Enter the tnm directory and run the almost common place:
./configure
make
sudo make install
sudo make sinstall
Then enter the tkined directory and run:
./configure
make
sudo make install
After this, you should be able to start scotty via scotty.3.0.x
where 'x' is the respective sub sub version number and tkined as
tkined.
OS X Install
The OS X configure commands most likely require --prefix=/usr/local and --exec-prefix=/usr/local options. OS X now prevents installation in /usr/lib and /usr/bin in the System Integrity Protection implementation. TEA trys to figure out the install paths from the TCL install. If you are using the OS X TCL, then these directories will not be writable.
Uninstall
You can uninstall the Tnm extension and scotty by running make uninstall in the tnm directory.
The Tkined extension and tkined are uninstalled by running make uninstall in the tkined directory.
Documentation
Man files are installed in the respective system locations after
install. To see what is available see the respective doc
subdirectory in tnm and tkined.
For a starter, look at Tnm(n) which gives an overview over the Tcl commands provided by the Tnm extension and the tkined(1) page which describes the Tkined network editor. A short description of the API which is used to write new applications for the Tkined editor is available in the ined(n) man page.
An overview about the Tnm extension has been presented at the 3rd Tcl/Tk workshop in 1995. A PostScript copy of this paper is available at http://www.ibr.cs.tu-bs.de/users/schoenw/papers/tcltk-95.ps.gz.
Some more general experience from doing this project over several years were presented at the 1st European Tcl/Tk User Meeting in 2000. A PostScript copy of this paper is also available at http://www.ibr.cs.tu-bs.de/users/schoenw/papers/tcltk-eu-2000.ps.gz
Mark Newnham has collected some information about scotty at his sourceforge project wiki: https://sourceforge.net/p/tkined-scotty/wiki/Home
The Tclers Wiki has some pages about scotty, here the link to the most informative: Tnm/Scotty/TkInEd.
The (almost) original README file can be found in the tnm sub
directory. Original build/install was done inside the platform
specific directories, you will find a INSTALL instructions file in
tnm/unix.
The Tkined library and applications have their own change logs in
tkined/changes and tkined/apps/changes.
The file PORTS holds notes about building scotty on different
platforms, tnm/TODO and tkined/TODO list bugs and improvement
ideas for the respective extension, including platform specific ones.
Credits
Jürgen has listed meticulously all contributors and benefactors at
the end of the original tnm/README.md file.
Lionel Sambuc has provided all needed bits to compile scotty on MINIX3.
History
According to tnm/changes scotty was released on 1993-07-19 as
version 0.5, this change log file reports until 2001-12-08.
In 2005 Jürgens seems to have imported the CVS repository to SVN at Jakobs University, with the last check in on 2010-09-07.
DavidMcNett at FlightAware imported scotty into GitHub, 'Initial import of sc-scotty from Karl' (Lehenbauer). Since then, there were small commits every one to two years on this repository.
Mark Newnham imported scotty to GitHub and then in 2015-03-14 to
sourceforge. He has mainly worked on the "Front End" tkined.
Upgraded to the latest TEA version and improvements in UDP and DNS 2017-02-14 by Georg Lehner [email protected].
Ressources remaining from the founders time:
- Braunschweig university scotty page.
- Jürgens SVN repository at Jacobs University.
Mailing list archive at Braunschweig university.
Some pages on the Tclers Wiki, discussing the status at different points of time: