mirror of
https://github.com/Cacti/documentation.git
synced 2026-11-02 18:17:38 +09:00
* 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>
112 lines
3.8 KiB
Bash
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
|