Files
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

112 lines
3.8 KiB
Bash

#!/usr/bin/env bash
# +-------------------------------------------------------------------------+
# | Copyright (C) 2004-2026 The Cacti Group |
# | |
# | This program is free software; you can redistribute it and/or |
# | modify it under the terms of the GNU General Public License |
# | as published by the Free Software Foundation; either version 2 |
# | of the License, or (at your option) any later version. |
# | |
# | This program is distributed in the hope that it will be useful, |
# | but WITHOUT ANY WARRANTY; without even the implied warranty of |
# | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
# | GNU General Public License for more details. |
# +-------------------------------------------------------------------------+
# | Cacti: The Complete RRDTool-based Graphing Solution |
# +-------------------------------------------------------------------------+
# | This code is designed, written, and maintained by the Cacti Group. See |
# | about.php and/or the AUTHORS file for specific developer information. |
# +-------------------------------------------------------------------------+
# | http://www.cacti.net/ |
# +-------------------------------------------------------------------------+
update_copyright() {
local file=$1
file=${file/$SCRIPT_BASE/}
printf -v line "%60s" "$file"
if [[ -z "$ERRORS_ONLY" ]]; then
echo -n "$line"
line=
fi
old_reg="20[0-9][0-9][ ]*-[ ]*20[0-9][0-9]"
old_data=$(grep -c -e "$old_reg" "$1" 2>/dev/null)
new_reg="2004-$YEAR"
if [[ $old_data -eq 0 ]]; then
old_reg="(Copyright.*) 20[0-9][0-9] "
old_data=$(grep -c -e "$old_reg" "$1" 2>/dev/null)
new_reg="\1 2004-$YEAR"
fi
if [[ $old_data -gt 0 ]]; then
old_data=$(grep -e "$old_reg" "$1" 2>/dev/null)
new_data=$(echo "$old_data" | sed -r s/"$old_reg"/"$new_reg"/g)
if [[ "$old_data" == "$new_data" ]]; then
if [[ -z "$ERRORS_ONLY" ]]; then
echo "$line Skipping Copyright Data"
fi
else
echo "$line Updating Copyright Data"
printf "%60s %s\n" "==============================" "===================="
printf "%60s %s\n" "$old_data" "=>"
printf "%60s %s\n" "$new_data" ""
sed -i -r s/"$old_reg"/"$new_reg"/g "$1"
printf "%60s %s\n" "==============================" "===================="
fi
else
echo "$line Copyright not found!"
fi
}
SCRIPT_DIR=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" &>/dev/null && pwd)
SCRIPT_BASE=$(realpath "${SCRIPT_DIR}/../")/
BAD_FOLDERS="include/vendor \*\*/vendor include/fa cache include/js scripts"
SCRIPT_EXCLUSION=
for f in $BAD_FOLDERS; do
SCRIPT_EXCLUSION="$SCRIPT_EXCLUSION -not -path ${SCRIPT_BASE}$f/\* "
done
YEAR=$(date +"%Y")
EXT="sh sql php js md conf"
ERRORS_ONLY=1
while [ -n "$1" ]; do
case $1 in
"--help")
echo "NOTE: Checks all Cacti pages for this years copyright"
echo ""
echo "usage: copyright_year.sh [-a]"
echo ""
;;
"-E" | "-e")
shift
EXT="$1"
;;
"-A" | "-a")
ERRORS_ONLY=
echo "Searching..."
;;
*) ;;
esac
shift
done
# ----------------------------------------------
# PHP / JS / MD Files
# ----------------------------------------------
SCRIPT_INCLUSION=
SCRIPT_SEPARATOR=
for ext in $EXT; do
if [ -n "$SCRIPT_INCLUSION" ]; then
SCRIPT_SEPARATOR="-o "
fi
SCRIPT_INCLUSION="$SCRIPT_INCLUSION $SCRIPT_SEPARATOR-name \*.$ext"
done
SCRIPT_CMD="find ${SCRIPT_BASE} -type f \( $SCRIPT_INCLUSION \) $SCRIPT_EXCLUSION -print0"
bash -c "$SCRIPT_CMD" | while IFS= read -r -d '' file; do
update_copyright "${file}"
done