{"id":19585904,"url":"https://github.com/cacti/spine","last_synced_at":"2025-04-05T03:04:32.219Z","repository":{"id":26012918,"uuid":"29455546","full_name":"Cacti/spine","owner":"Cacti","description":"Spine C Based Poller for Cacti","archived":false,"fork":false,"pushed_at":"2025-03-23T19:18:30.000Z","size":2112,"stargazers_count":83,"open_issues_count":12,"forks_count":46,"subscribers_count":26,"default_branch":"develop","last_synced_at":"2025-03-29T02:04:11.301Z","etag":null,"topics":["cacti","spine"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"chobie/protoc-gen-php","license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cacti.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-01-19T05:37:02.000Z","updated_at":"2025-03-16T06:07:51.000Z","dependencies_parsed_at":"2023-02-10T19:00:24.316Z","dependency_job_id":"fe1ae6e2-2c1c-486e-a954-0985ec985f29","html_url":"https://github.com/Cacti/spine","commit_stats":null,"previous_names":[],"tags_count":82,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cacti%2Fspine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cacti%2Fspine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cacti%2Fspine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cacti%2Fspine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cacti","download_url":"https://codeload.github.com/Cacti/spine/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247280262,"owners_count":20912967,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cacti","spine"],"created_at":"2024-11-11T07:57:45.135Z","updated_at":"2025-04-05T03:04:32.188Z","avatar_url":"https://github.com/Cacti.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Spine: a poller for Cacti\n\nSpine is a high speed poller replacement for `cmd.php`. It is almost 100%\ncompatible with the legacy cmd.php processor and provides much more flexibility,\nspeed and concurrency than `cmd.php`.\n\nMake sure that you have the proper development environment to compile Spine.\nThis includes compilers, header files and things such as libtool. If you have\nquestions please consult the forums and/or online documentation.\n\n-----------------------------------------------------------------------------\n\n## Unix Installation\n\nThese instructions assume the default install location for spine of\n`/usr/local/spine`. If you choose to use another prefix, make sure you update\nthe commands as required for that new path.\n\nTo compile and install Spine using MySQL versions 5.5 or higher please do the\nfollowing:\n\n```shell\n./bootstrap\n./configure\nmake\nmake install\nchown root:root /usr/local/spine/bin/spine\nchmod u+s /usr/local/spine/bin/spine\n```\n\nTo compile and install Spine using MySQL versions previous to 5.5 please do the\nfollowing:\n\n```shell\n./bootstrap\n./configure --with-reentrant\nmake\nmake install\nchown root:root /usr/local/spine/bin/spine\nchmod +s /usr/local/spine/bin/spine\n```\n\n## Windows Installation\n\n### CYGWIN Prerequisite\n\n1. Download Cygwin for Window from [https://www.cygwin.com/](https://www.cygwin.com/)\n\n2. Install Cygwin by executing the downloaded setup program\n\n3. Select _Install from Internet_\n\n4. Select Root Directory:  _C:\\cygwin_\n\n5. Select a mirror which is close to your location\n\n6. Once on the package selection section make sure to select the following (TIP:\n   use the search!):\n\n   * autoconf\n   * automake\n   * dos2unix\n   * gcc-core\n   * gzip\n   * help2man\n   * inetutils-src\n   * libmysqlclient\n   * libmariadb-devel\n   * libssl-devel\n   * libtool\n   * m4\n   * make\n   * net-snmp-devel\n   * openssl-devel\n   * wget\n\n7. Wait for installation to complete, coffee time!\n\n8. Move the cygwin setup to the C:\\cygwin\\ folder for future usage.\n\n### Compile Spine\n\n1. Open Cygwin shell prompt (C:\\Cygwin\\cygwin.bat) and brace yourself to use\n   unix commands on Windows.\n\n2. Download the Spine source to the current directory:\n\n   [http://www.cacti.net/spine_download.php](http://www.cacti.net/spine_download.php)\n\n3. Extract Spine into C:\\Cygwin\\usr\\src\\\u003cspineversion\u003e:\n\n   `tar xzvf cacti-spine-*.tar.gz`\n\n4. Change into the Spine directory:\n\n   `cd /usr/src/cacti-spine-*`\n\n5. Run bootstrap to prepare Spine for compilation:\n\n   `./bootstrap`\n\n6. Follow the instruction which bootstrap outputs.\n\n7. Update the spine.conf file for your installation of Cacti. You can optionally\n   move it to a better location if you choose to do so, make sure to copy the\n   spine.conf as well.\n\n8. Ensure that Spine runs well by running with `/usr/local/spine/spine -R -S -V 3`\n\n9. Update Cacti `Paths` Setting to point to the Spine binary and update the\n   `Poller Type` to Spine. For the spine binary on Windows x64, and using default\n   locations, that would be `C:\\cygwin64\\usr\\local\\spine\\bin\\spine.exe`\n\n10. If all is good Spine will be run from the poller in place of cmd.php.\n\n## Known Issues\n\n1. On Windows, Microsoft does not support a TCP Socket send timeout. Therefore,\n   if you are using TCP ping on Windows, spine will not perform a second or\n   subsequent retries to connect and the host will be assumed down on the first\n   failure.\n\n   If this is a problem it is suggested to use another Availability/Reachability\n   method, or moving to Linux/UNIX.\n\n2. Spine takes quite a few MySQL connections. The number of connections is\n   calculated as follows: (1 for main poller + 1 per each thread + 1 per each\n   script server)\n\n   Therefore, if you have 4 processes, with 10 threads each, and 5 script\n   servers each your spine will take approximately:\n\n   `total connections = 4 * ( 1 + 10 + 5 ) = 64`\n\n3. On older MySQL versions, different libraries had to be used to make MySQL\n   thread safe. MySQL versions 5.0 and 5.1 require this flag. If you are using\n   these version of MySQL, you must use the --with-reentrant configure flag.\n\n-----------------------------------------------------------------------------\nCopyright (c) 2004-2024 - The Cacti Group, Inc.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcacti%2Fspine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcacti%2Fspine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcacti%2Fspine/lists"}