Skip to content

docs: refresh supported platforms and current LEMP installation guides - #248

Open
somethingwithproof wants to merge 5 commits into
developfrom
docs/manuals-refresh-develop
Open

somethingwithproof wants to merge 5 commits into
developfrom
docs/manuals-refresh-develop

Conversation

@somethingwithproof

Copy link
Copy Markdown
Member

Refresh the development manual's installation, upgrade, and platform guidance. Replace obsolete OS examples, document current PHP/Composer requirements and the native Windows packaging limitation, preserve older Linux guide URLs, and correct backup, scheduler, permissions, and proxy instructions.

The LEMP guides now distinguish Rocky Linux 9 module streams from Rocky Linux 10 AppStream packages. Add a dedicated nginx/PHP-FPM guide for Ubuntu Server 26.04 LTS and 26.10, with versioned FPM services and sockets. Link both paths from the manual index and record vendor lifecycle sources.

Validation:

  • Package installation, required CLI extensions, and FPM configuration checks passed in ARM64 containers for Rocky Linux 9.8, Rocky Linux 10.2, Ubuntu 26.04.1 LTS, and Ubuntu 26.10.
  • Both nginx examples and the Apache example passed configuration checks. These checks do not constitute a full Cacti deployment test.
  • Local file and heading links passed across all 136 Markdown pages. Markdown style checks passed for the refreshed platform and migration guides; repository spelling and diff whitespace checks passed.

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>
@somethingwithproof
somethingwithproof requested review from TheWitness, bmfmancini and xmacan and removed request for TheWitness and bmfmancini October 26, 2026 22:50
@somethingwithproof somethingwithproof self-assigned this Oct 26, 2026
Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>
Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>
@somethingwithproof

Copy link
Copy Markdown
Member Author

The Galera clustering section drops the ENGINE=InnoDB conversion lines for poller_output_boost_local_data_ids and processes, but both are still ENGINE=MEMORY in cacti.sql - MEMORY tables do not replicate under Galera, which is exactly what this section prevents. Please restore both lines. (automation_ips is also absent from the list - pre-existing.) The rest of the PR is accurate.

Cacti protects bin/ and tests/ with .htaccess files that nginx does not
read, and both guides deploy a full source tree, so the PHP handler
would run test probes for anonymous clients. Add both directories to
the deny rules in the Ubuntu and Enterprise Linux guides.

Also install git, unzip and php-pecl-zip on Rocky so Composer can fetch
dependencies, link the proxy guidance to its section, and point the
mysqldump references at the MySQL 8.4 manual.

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

sonarqubecloud Bot commented Nov 9, 2026

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant