admin/Cactidocumentation
1
0 Fork 0
mirror of https://github.com/Cacti/documentation.git synced 2026-10-23 03:26:44 +09:00
Code Issues Packages Projects Releases Wiki Activity
Files
cb29d10426a528b12768e2084274eb79638f78fa
Cactidocumentation/README.md
T
Thomas Vincent cb29d10426 docs: fix stale version requirements and dead/insecure links (#208) 
* docs: update stale PHP/MySQL/MariaDB version requirements

- Requirements.md: PHP 5.4 -> 8.1 (matches 1.2.31+ requirement note)
- Requirements.md: MySQL 5.6 -> 5.7, MariaDB 5.5 -> 10.2 (current minimums)
- Requirements.md: MySQL section header updated to >= 5.7 / 10.2
- Requirements.md, Install-Under-CentOS_LAMP.md,
  Install-Under-CentOS_LEMP.md, Installing-Under-Windows.md:
  comment out innodb_file_format and innodb_large_prefix (removed
  in MySQL 8.0 / MariaDB 10.3+)

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

* docs: upgrade http:// links to https:// and fix dead wiki URLs

- Upgrade http:// to https:// in 8 files:
  General-Installing-Instructions.md, Graph-Templates.md,
  How-To-SSH-Tunnels.md, Plugin-Development.md,
  Standards-Code-Formatting.md, Templates.md,
  Upgrading-Cacti-Under-Windows.md
- Replace two dead docs.cacti.net wiki links:
  How-To-SSH-Tunnels.md: old wiki SNMP guide -> Net-SNMP man page
  Plugin-Syslog.md: dead plugin:syslog.config -> plugin_syslog repo

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

* docs: fix technically inaccurate MySQL configuration recommendations

- innodb_additional_mem_pool_size: removed in MySQL 5.7.4 / MariaDB 10.0;
  replaced with removal notice in Requirements.md and comments in
  Install-Under-CentOS_LAMP.md and Install-Under-CentOS_LEMP.md
- max_heap_table_size: clarify ">= 5" means ">= 5% of system RAM"
- innodb_buffer_pool_size: clarify ">= 25" means ">= 25% of system RAM"

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

* docs: add missing required PHP extensions to Requirements.md

Add dom, mysqlnd, pcntl, Phar, and sqlite3 — all declared as required
in composer.json but absent from the module list. pcntl is Linux-only
(process control for the poller).

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

* docs: fix 36 spelling errors across 19 documentation files

Corrections detected by codespell:
- somone->someone, Walkthough->Walkthrough, GUAGE->GAUGE
- asociate->associate, messege->message, therefor->therefore
- get's->gets, Proxys->Proxies, paralelisation->parallelization
- parms->params (6 instances in script data query examples)
- finialise->finalise, buildin->built-in, everytime->every time
- Unistall->Uninstall, resiliant->resilient, build-in->built-in
- requriments->requirements (2 instances), explanitory->explanatory (3 instances)
- fro->for, invole->involve, reulting->resulting
- stauts->status, tge->the

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

* ci: add codespell spelling check workflow for documentation

Adds GitHub Actions workflow that runs codespell==2.4.1 on all Markdown
files on every push/PR to main. Also adds .codespell.cfg to skip binary
and generated files (JSON, shell scripts, HTML, images).

Update .gitignore to allow .github directory (was blocked by .git* glob).

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

* docs: improve voice, consistency, and note formatting across 10 files

- Convert passive/impersonal constructions to active voice
- Standardize NOTE -> Note in blockquotes for consistency
- Reformat inline IMPORTANT/Note callouts as blockquotes
- Fix awkward phrasing in LXC container notes
- Consolidate fragmented note bullets into single blockquote

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

* docs: fix technical accuracy and correct typos across 10 files

- Requirements.md: clarify Composer is for source/develop installs only;
  RRDtool minimum updated to 1.5+ (1.8+ for 1.3.x); php-snmp section
  rewritten to describe selective fallback behavior; SELinux/AppArmor
  advice reworded to recommend policy exceptions over blanket disable
- Spine.md: fix PHP Script Server range (10 -> 15); fix 'senstivive'
  and 'Davices' typos
- Trees.md: fix broken table rows split across lines; 'Sporting' -> 'Sorting'
- Data-Sources.md: restructure storage table to standard 3-column layout;
  fix '19b' unit typo -> '19kb'
- How-To-SNMP-Custom-Script.md: convert bold/backtick commands to proper
  fenced code blocks; fix 'intex' and 'BNSMPD' typos
- Plugins.md: fix 'onfiguration' typo; fix YouTube thumbnail http -> https;
  fix 'Tuturial' typo
- Standards-Security.md: fix 'invalidate' -> 'invalid'
- template_apache_config.md: fix 'apcache2' -> 'apache2'
- device-template-specific-proxmox.md: replace service file edit with
  drop-in approach; remove ProtectSystem=off/ProtectHome=off; add note
  on minimal required systemd overrides
- resource/xml/query_interface_traffic.php: http -> https URL

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

* docs: rename CentOS install guides to Enterprise Linux; fix grammar, logic, and security flaws

- Rename Install-Under-CentOS_LAMP.md → Install-Under-Enterprise-Linux-LAMP.md
- Rename Install-Under-CentOS_LEMP.md → Install-Under-Enterprise-Linux-LEMP.md
- Update README.md ToC links to match new filenames and correct labels

LAMP fixes:
- Title updated to reflect RHEL/Rocky Linux/AlmaLinux coverage
- Fix step numbering: "2.Install" / "3.Enable" missing space after number
- Spine build deps: restructure for EL7/EL8/EL9+ separately; EL8 was
  missing package install after repo enable; EL9+ uses 'crb' not 'powertools'
- SELinux URL: fix quadruple-slash typo; switch to English wiki URL

LEMP fixes:
- Title: "CentOS 7" → "Enterprise Linux (RHEL / Rocky Linux / AlmaLinux)"
- TLS: remove TLSv1 and TLSv1.1 (RFC 8996 prohibited, fails OpenSSL 3.x);
  set ssl_protocols TLSv1.2 TLSv1.3
- Ciphers: remove DH+3DES (Sweet32 / CVE-2016-2183)
- HTTP redirect: uncomment return 301 (comment claiming nginx lacks support
  for 'return' has been wrong since nginx 0.8 / 2009)
- PHP location block: fix 'alias' → 'root' (alias breaks $document_root in
  fastcgi_param SCRIPT_FILENAME); add missing semicolon after index directive
- Cron: poller path was /var/www/html/cacti but install target throughout
  this guide is /usr/share/nginx/html/cacti — align them
- DB: split GRANT...IDENTIFIED BY into CREATE USER + GRANT (IDENTIFIED BY
  on GRANT removed in MySQL 8.0 / MariaDB 10.5.2)
- Fix comment typo: "Compression increases performance0" → remove trailing 0
- SELinux URL: fix quadruple-slash typo

README.md:
- Update section 3.1 and 3.2 links to new filenames
- Correct labels from "CentOS 7" to "Enterprise Linux"
- Fix "Reports Admistrative Interface" → "Administrative"
- Fix "requriments" (×2) → "requirements"

* docs: remove Install-Under-CentOS_LAMP.md (superseded by Install-Under-Enterprise-Linux-LAMP.md)

* docs: remove Install-Under-CentOS_LEMP.md (superseded by Install-Under-Enterprise-Linux-LEMP.md)

* docs: update README ToC links and fix typos

- Update 3.1 and 3.2 links from CentOS to Enterprise Linux filenames
- Correct labels: "CentOS 7" → "Enterprise Linux (RHEL/Rocky/AlmaLinux)"
- Fix "Reports Admistrative" → "Reports Administrative"
- Fix "requriments" (×2) → "requirements"

* docs: fix grammar, logic, and technical errors in remaining install/upgrade guides

Installing-Under-Windows.md:
- Replace php_mysql.dll with php_pdo_mysql.dll (php_mysql removed in PHP 7.0)
- Remove IIS ISAPI steps referencing php8isapi.dll (ISAPI dropped in PHP 8.0);
  replace with FastCGI instructions via php-cgi.exe
- Remove NO_AUTO_CREATE_USER from sql_mode (removed MySQL 8.0, breaks startup)
- sort_buffer_size = 200M → 32M with caveat (per-session; 200M causes OOM under load)
- Fix step numbering gaps: main list 5→8, IIS 3→5, Finishing 5→8
- "you will have to user 8.3 notation" → "use"
- "c:cygwin" → "c:\cygwin" (missing backslash)
- "it's subfolders" → "its subfolders"
- "A anm example" → "An example"
- "verify/udate" → "verify/update"

Installing-Under-Ubuntu-Debian.md:
- Cron user: apache → www-data (apache user does not exist on Ubuntu/Debian)
- CREATE DATABASE: use utf8mb4 directly; remove redundant ALTER DATABASE
- php8.1-mbstring listed twice in apt-get install; deduplicated
- "may received" → "may receive"
- Note php8.1 is EOL; recommend checking current supported release

Upgrading-Cacti-Under-Windows.md:
- Fix all steps numbered 1. → proper sequential numbering (1–10)
- Remove hardcoded MySQL 5.7 path; use generic %MYSQL_HOME% note

Upgrading-Cacti-Under-FreeBSD.md:
- mysqldump: remove contradictory -l / --lock-tables=false flags;
  replace with --single-transaction (correct for InnoDB, no locking)

How-To-SSH-Tunnels.md:
- Add prominent note: SSH -L is TCP-only; standard SNMP uses UDP; this
  guide requires TCP transport configured on snmpd and does not work for
  most network devices
- Fix unclosed code fence after ssh-keygen output block
- Replace rc.local persistence with systemd unit (rc.local is deprecated
  and disabled by default on systemd distros: Ubuntu 16.04+, Debian 9+)
- ssh-keygen: recommend ed25519 over RSA

* docs: correct PHP 8.1 EOL date, Net-SNMP link, and grammar

PHP 8.1 security support ended 31 December 2025, not November 2024. Point the
snmpd.conf link at www.net-snmp.org (the sourceforge.io mirror is bot-blocked).
Fix 'There a two ways extending' to 'There are two ways to extend'.

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

* ci: fix spelling workflow trigger to target develop, not main

The repo's default branch is develop; main hasn't moved since 2023.
The workflow's push/pull_request filters targeted main, so it never
ran on any PR opened against develop.

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

---------

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>
2026-08-16 20:34:31 +01:00

11 KiB
Raw Blame History

Cacti (tm) Documentation

Cacti

Cacti is designed to be a complete graphing solution based on the RRDtool's framework. Its goal is to make a network administrator's job easier by taking care of all the necessary details necessary to create meaningful graphs.

Please see the official Cacti website for information, support, and updates.

Core Developers - Both active and emeritus

Active Developers

Developers working on Cacti, its Architecture, Documentation and Future Releases.

  • Larry Adams (TheWitness)
  • Mark Brugnoli-Vinten (netniV)
  • Jimmy Conner (cigamit)
  • Petr Macek (xmacan)
  • Andreas Braun (browniebraun)
  • Thomas Urban (phalek)
  • Jing Chen (ddb4github)

Contributors to Documentation, QA, Packaging, the Forums and our YouTube page.

  • Sean Mancini (bmfmancini)
  • J.P. Pasnak, CD (Linegod)
  • Chris Bell (Windows) (BSOD2600)
  • Paul Gevers (Debian) (paulgevers)
  • Morten Stevens (Fedora) (mortenstevens)

Members of the original Cacti Group that have since moved on in their careers.

We continue to wish them the best.

  • Ian Berry (raX)
  • Reinhard Scheck (gandalf)
  • Tony Roman (rony)
  • Andy Blyler (ablyler)

Thanks

A very special thanks to Tobi Oetiker, the creator of RRDtool and the very popular MRTG. The users of Cacti - especially anyone who has taken the time to create a bug report, or otherwise help fix a Cacti related problem. Also to anyone who has contributed to supporting Cacti.

Cacti is licensed under the GNU GPL:

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.

Table of Contents

  1. Cacti Installation

    This section contains information on how to install and/or upgrade the Cacti system. It covers requirements, different platforms and the steps needed to get your system working under normal circumstances.

  2. Cacti Overview

    This section describes Cacti components and their purpose as well as providing examples including on how to create Templates in Cacti.

  3. Advanced Operations

    This section covers more advanced material such as using a advanced data collection and replacement variables that can be used within Templates, etc.

  4. Plugin Development

    This section contains all Plugin development related information. Guidelines, hooks, references, etc. More information can be found on the Cacti Forums.

  5. How To's

    This section contains how to's for several topics.

  6. Contributing

    This section contains information on how to contribute to Cacti.

  7. Development Standards

    This section contains the relevant information on how to ensure that any contribution is kept to the same standards that are applied for the Cacti Group. Non-compliance does not automatically mean exclusion of proposed changes.

Known Issues

List of Known issues

Cacti Installation

  1. Requirements

  2. General Installing Instructions

  3. Installing Cacti on Linux

    3.1. Installation Under Enterprise Linux (RHEL/Rocky/AlmaLinux) - LAMP Stack

    3.2. Installation Under Enterprise Linux (RHEL/Rocky/AlmaLinux) - LEMP Stack

    3.3. Installation Under Ubuntu/Debian - LAMP Stack

  4. Installing Under Windows

  5. Upgrading Cacti Under Linux/UNIX

  6. Upgrading Cacti Under Windows

  7. Upgrading Cacti Under FreeBSD

Cacti Overview

  1. Overview

    1.1. Navigating the User Interface

    1.2. Principles of Operation

    1.3. Graph Overview

    1.4. How to Graph Your Network

    1.5. Viewing Graphs

  2. Management

    2.1. Devices

    2.2. Sites

    2.3. Trees

    2.4. Graphs

    2.5. Data Sources

    2.6. Aggregates

  3. Data Collection

    3.1. Data Collectors

    3.2. Spine Data Collection

    3.3. Data Input Methods

    3.4. Data Queries

  4. Templates

    4.1. Device

    4.2. Graph

    4.3. Data Source

    4.4. Aggregate

    4.5. Color

  5. Automation

    5.1. Networks

    5.2. Discovered Devices

    5.3. Device Rules

    5.4. Graph Rules

    5.5. Tree Rules

    5.6. SNMP Options

  6. Presets

    6.1. Data Profiles

    6.2. CDEFS

    6.3. VDEFS

    6.4. Colors

    6.5. GPRINTs

  7. Packaging/Import/Export

    7.1. Import Packages

    7.2. Import Templates

    7.3. Export Templates

    7.4. Create Packages

    7.5. Package Repositories

    7.6. Public Keys

  8. Settings (w/o Auth)

    8.1. General

    8.2. Paths

    8.3. Device Defaults

    8.4. Poller

    8.5. Data

    8.6. Visual

    8.7. Performance

    8.8. Spikes

    8.9. Mail/Reporting/DNS/Proxy

  9. Settings - Auth

    9.1. Local Auth

    9.2. LDAP Auth

    9.3. Basic Auth

    9.4. Domains Auth

  10. Configuration - Users, Groups and Domains

    10.1. Users

    10.2. User Groups

    10.3. User Domains

  11. Configuration - Plugins

  12. Utilities

    12.1. System Utilities

    12.2. Data Debug

    12.3. External Links

  13. Reporting

    13.1. Reports Administrative Interface

    13.2. Reports User Interface

    13.3. Report Items Page

    13.4. Report Preview Page

    13.5. Report Events Page

    13.6. Other Options for Adding Report Items

  14. The Cacti Log

Advanced Operations

  1. Data Collection

    1.1. Command Line Scripts

    1.2. PHP Script Server

    1.3. Spine Data Collection

    1.4. Performance Setting (Boost)

  2. Frequently Asked Questions

  3. Replacement Variables

  4. RRDtool Specific Features

  5. RRDProxy Specific Features

  6. Spikekill

  7. Debugging

  8. Version Specific Release Notes

Plugin Development

  1. Plugin Overview

  2. Plugin Guidelines

  3. Creating Plugins

  4. References

  5. Hook API Reference

Plugins

  1. Supported Plugins

  2. Syslog Plugin documentation

  3. Mactrack Plugin documentation

  4. ReportIt Plugin documentation Older version, pdf format

How Tos

  1. How To Work with Templates

  2. How To Create a Data Input Method

  3. How To Work with Data Queries

  4. How To Work with Existing SNMP Data Queries

  5. How To Work with New SNMP Data Queries

  6. How To Work with Script Data Queries

  7. How To Setup Remote Pollers

  8. How To Determine Template Version

  9. How To Setup SSH Tunnels

  10. Enable SSL for Cacti

  11. Graph a Single SNMP OID

  12. How To Extend snmpd with custom script/data

  13. Change poller interval from 5 minutes to 1 minute

  14. Convert from Package based install to source on Ubuntu/Debian

Video Tutorials

Watch Howto's and Tutorials on the Cacti Official YouTube page if you prefer. If you would have any ideas for videos or would like to contribute let us know !

Cacti Official Youtube Channel

Contributing

  1. Open Source Code

  2. Language Translations

Development Standards

  1. Documentation

  2. Code Formatting

  3. PHP Specific Constructs

  4. File System Layout

  5. Patch Creation

  6. SQL Standards

  7. Security

Template Specific Documentation

This section will be for template specific configuration requirements

  1. Apache Server Template

  2. ESXi/VMWare Template

Device Template Specific Documentation

This section will be for device template specific configuration requirements

  1. Proxmox External Storage Usage with Linux Device Template

Copyright (c) 2004-2026 The Cacti Group

Reference in new issue View Git Blame Copy Permalink