Skip to content
constcast edited this page Apr 17, 2011 · 1 revision

Installation

Here we describe the installation steps required for Vermont and its management infrastructure. We assume, that source code of both systems is already available in directories ''vermont'' and ''vmanager'', the download is described here.

Vermont

  • The following tools and libraries are needed for Vermont (in their development version, i.e. including header files):
    • gcc
    • cmake
    • libpcap
    • libpcre3
    • postgresql (>= 8.3, optional)
    • mysql (optional)
    • libboost
    • libxml2
    • libpq (optional)
    • libsctp (optional)
    • libpcap-mmap (optional)
  • Go into directory ''vermont'' and execute ''cmake .'' to check for unresolved dependencies for compilation of Vermont.
  • If Vermont needs to be compiled using the memory-mapped version of PCAP, please download and compile the library in directory ''../libpcap-mmap'' relative to the root of its Vermont’s source code directory.
  • Edit compilation parameters, most convenient way is by executing ccmake .
  • Compile Vermont with make (on a multiple core system, ''make -jX'' triggers a parallel build with X parallel processes)
  • Execute Vermont with example configuration and a little more information than usual (parameter -d): ''./vermont -f configs/example.xml -d''

Vermont Management

The management tool is optional and does not need to be installed in order to run Vermont.

  • The following tools and libraries are needed for the Vermont management system:

    • python (>= 2.5)
    • apache2
    • libapache-mod-python
    • python-4suite-xml
    • python-pydot
    • graphviz
    • rrdtool
    • python-cheetah
    • python-dns
  • Execute target creation script in source code root directory: ''bash build_target.sh''

  • Components manager (target/manager), controller (target/controller) and the webinterface (target/webinterface) are now ready-to-use in their described directories

  • Edit configuration files for each of the components and distribute the controller to hosts

  • Edit Apache configuration to include the Vermont webinterface in the web site. An example configuration is located in ''target/webinterface/apache-config.sample''

  • Run the controller:

    • go to application directory (target/controller)
    • edit vermontcontroller.conf
    • run 'python VermontController.py vermontcontroller.conf
  • Run the manager:

    • go to application directory (target/manager)
    • edit vm.conf
    • run 'python VermontManager.py vm.conf'
  • Access webinterface via http://<servername>/<directory_to_webinterface>/start.py