11 Commits
Author SHA1 Message Date
Thomas Vincent 57b8088e13 docs: comprehensive validation audit, Spine poller overhaul, and technical refactor (#229)
* docs: comprehensive audit, Spine poller overhaul, and technical refactor

- Overhaul Spine documentation (Spine.md) with complete end-to-end guide: architecture, prerequisites for modern distros (EL8/9 CRB, Ubuntu 22/24, Debian 11/12, FreeBSD), SUID root permissions, secure spine.conf setup (0640), Web UI configuration (Paths, Poller type, Data Collectors tuning), MySQL max_connections sizing, and troubleshooting.
- Fix broken links and anchors (Hardening, SNMP data queries, Hook API references).
- Fix broken image reference in Sites.md (add-site.JPG -> add-site.png).
- Fix syntax errors in documentation PHP code blocks, including invalid parenthesization, missing SQL execute quotes, and malformed comments in FAQ.
- Fix DevOps installation commands: use config.php.dist, correct systemctl service names for MySQL/MariaDB/PHP-FPM, remove nonexistent php-json, add missing composer install, and correct Debian/Ubuntu systemd environment path.
- Correct grammatical errors, repeated words, and typos across all markdown documents.
- Remove obsolete unreferenced duplicate installation guides.

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>

* docs: correct reviewed examples and guidance

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>

* docs: correct guidance that disagrees with the Cacti source

Verified each claim against include/global_arrays.php, lib/auth.php,
lib/functions.php, host_templates.php and the Spine config parser. The
notable ones: api_plugin_safe_exec() does not exist on either branch,
Spine reads DB_Pass rather than DB_Password, and the CDEF special data
source table was missing five entries and renamed four others.

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>

* docs: wrap Spine prose and fence the connection sizing formula

The formula's bare asterisks rendered as emphasis, dropping the multiplication signs.

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>

* chore: refresh copyright year in scripts and issue templates

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>

---------

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>
2026-09-08 09:41:21 -04:00
TheWitness 660f054809 QA: Update Copyrights 2025-11-18 17:01:31 -05:00
TheWitness 08efd1fa30 QA: Updating Copyrights to 2024 2024-03-16 05:04:49 +05:30
Mark Brugnoli-Vinten 5b637afcf2 Script updates 2023-07-22 23:13:45 +01:00
Mark Brugnoli-Vinten 80be2916f5 Update copyright year for 2023 2023-01-03 23:43:28 +00:00
TheWitness 572671ef19 Update plugin information to remove docs.cacti.net 2021-01-17 15:40:28 -05:00
TheWitness f669f4db39 Reorganize on more How-To
This is just about all the how-to's in one area now.
2021-01-17 14:46:13 -05:00
TheWitness 5817af466f Updating attachments and where to find. 2021-01-17 11:53:20 -05:00
jpobeda 9dbb6aee33 The latest 3 missing walkthrough
https://docs.cacti.net/manual:100:3a_advanced_topics.3d_script_data_query_walkthrough#script_data_query_walkthrough
https://docs.cacti.net/manual:100:3a_advanced_topics.3a_snmp_data_queries#walkthrougha_new_snmp_data_query
https://docs.cacti.net/manual:100:3a_advanced_topics.3b_snmp_data_query_walkthrough#snmp_data_query_walkthrough

Several images and 2 XML resources.

I added these 3 as subitems on the Data Query Menu, but feel free to re-arrange them after the merge.
2018-10-26 17:52:17 +01:00
Tony Roman f9ca6d63e0 Fix up build process
- Fixed build script to correctly detect pandoc and lua requirements
 - Fixed lua script syntax
2018-10-05 11:22:59 -04:00
Tony Roman 37196a02c0 Initial documentation html build script
- Build script using `pandoc` with custom CSS to generate
   standalone HTML5 files
 - Git ignore the `html` output directory
 - TODO: Figure out how to get rid of `pandoc` warnings about titles
2018-10-01 13:10:26 -04:00