Spine C Based Poller for Cacti
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.travis.yml Travis CI do not run `make test`, yet.... Jan 3, 2017
CHANGELOG Update Changelog name and 1.2 beta 1 Oct 11, 2018
INSTALL Replace INSTALL with spine specific instructions Nov 13, 2018
LICENSE Fix license file issues Jan 3, 2017
Makefile.am spine, not spine.c Feb 3, 2017
Makefile.in Fix license file issues Jan 3, 2017
README.md Resolving Issue #77 Oct 22, 2018
bootstrap Re-instate --install flag for autoreconf command in bootstrap Jan 3, 2017
common.h Update copyright to 2018 Jan 6, 2018
configure.ac fix obsoleted m4s Nov 6, 2018
error.c Resolving issue #70 Sep 3, 2018
error.h Update copyright to 2018 Jan 6, 2018
keywords.c Update copyright to 2018 Jan 6, 2018
keywords.h Update copyright to 2018 Jan 6, 2018
locks.c Update copyright to 2018 Jan 6, 2018
locks.h Update copyright to 2018 Jan 6, 2018
nft_popen.c QA: Softtabs issues Jan 16, 2010
nft_popen.h Initial rename, Add tabs stops and autoindent, fix copyright Sep 10, 2007
package Fix package script to get version from source Mar 13, 2017
php.c Fix all outstanding memory leaks in Spine Aug 11, 2018
php.h Update copyright to 2018 Jan 6, 2018
ping.c Resolving Cacti Issue #1894 Sep 11, 2018
ping.h Update copyright to 2018 Jan 6, 2018
poller.c Additional resolution for Issue #75 Oct 13, 2018
poller.h Update copyright to 2018 Jan 6, 2018
snmp.c Resolving issue #74 Oct 8, 2018
snmp.h Update copyright to 2018 Jan 6, 2018
spine.c Resolving issue #2121 Oct 30, 2018
spine.conf.dist Partially Resolving Issue #72 Sep 25, 2018
spine.h Two additional features of system mib handling an stability Sep 25, 2018
sql.c Two additional features of system mib handling an stability Sep 25, 2018
sql.h Two additional features of system mib handling an stability Sep 25, 2018
util.c Resolving issue #2121 Oct 30, 2018
util.h Resolving issue #64 Aug 10, 2018

README.md

Spine: a poller for Cacti

Spine is a high speed poller replacement for cmd.php. It is almost 100% compatible with the legacy cmd.php processor and provides much more flexibility, speed and concurrency than cmd.php.

Make sure that you have the proper development environment to compile Spine. This includes compilers, header files and things such as libtool. If you have questions please consult the forums and/or online documentation.


1.2.0 Development

PLEASE READ

Feature branch for 1.2.x has been merged into the develop branch. This means things may and will break, but they will eventually be fixed.

DEVELOP branch is currently considered UNSTABLE, use with caution!


Unix Installation

These instructions assume the default install location for spine of /usr/local/spine. If you choose to use another prefix, make sure you update the commands as required for that new path.

To compile and install Spine using MySQL versions 5.5 or higher please do the following:

./configure
make
make install
chown root:root /usr/local/spine/bin/spine
chmod u+s /usr/local/spine/bin/spine

To compile and install Spine using MySQL versions previous to 5.5 please do the following:

./configure --with-reentrant
make
make install
chown root:root /usr/local/spine/bin/spine
chmod +s /usr/local/spine/bin/spine

Windows Installation

CYGWIN Prerequisite

  1. Download Cygwin for Window from https://www.cygwin.com/
  2. Install Cygwin by executing the downloaded setup program
  3. Select Install from Internet
  4. Select Root Directory: C:\cygwin
  5. Select a mirror which is close to your location
  6. Once on the package selection section make sure to select the following (TIP: use the search!):
    • autoconf
    • automake
    • dos2unix
    • gcc-core
    • gzip
    • help2man
    • libmysqlclient
    • libmysqlclient-devel
    • libtool
    • m4
    • make
    • net-snmp-devel
    • openssl-devel
    • wget
  7. Wait for installation to complete, coffee time!
  8. Move the cygwin setup to the C:\cygwin\ folder for future usage.

Compile Spine

  1. Open Cygwin shell prompt (C:\Cygwin\cygwin.bat) and brace yourself to use unix commands on Windows.
  2. Download the Spine source to the current directory: http://www.cacti.net/spine_download.php
  3. Extract Spine into C:\Cygwin\usr\src<spineversion>: tar xzvf cacti-spine-*.tar.gz
  4. Change into the Spine directory: cd /usr/src/cacti-spine-*
  5. Run bootstrap to prepare Spine for compilation: ./bootstrap
  6. Follow the instruction which bootstrap outputs.
  7. Update the spine.conf file for your installation of Cacti. You can optionally move it to a better location if you choose to do so, make sure to copy the spine.conf as well.
  8. Ensure that Spine runs well by running with /usr/local/spine/spine -R -S -V 3
  9. Update Cacti Paths Setting to point to the Spine binary and update the Poller Type to Spine. For the spine binary on Windows x64, and using default locations, that would be C:\cygwin64\usr\local\spine\bin\spine.exe
  10. If all is good Spine will be run from the poller in place of cmd.php.

Known Issues

  1. On Windows, Microsoft does not support a TCP Socket send timeout. Therefore, if you are using TCP ping on Windows, spine will not perform a second or subsequent retries to connect and the host will be assumed down on the first failure.

    If this is a problem it is suggested to use another Availability/Reachability method, or moving to Linux/UNIX.

  2. Spine takes quite a few MySQL connections. The number of connections is calculated as follows:

    • main poller take one connection
    • all threads take one connection each
    • all script servers take one connection each

    Therefore, if you have 4 processes, with 10 threads each, and 5 script servers each your spine will take approximately:

    total connections = 4 * ( 1 + 10 + 5 ) = 64

  3. On older MySQL versions, different libraries had to be used to make MySQL thread safe. MySQL versions 5.0 and 5.1 require this flag. If you are using these version of MySQL, you must use the --with-reentrant configure flag.