docs: document preview support for systemd

[jason-lynch]

Summary

Adds a page to our docs that describes the preview support for systemd using the RPM files attached to our releases.

Testing

Create a test release with:

make goreleaser-test-release

Then, start one or more VMs using the template in the lima directory, e.g.:

limactl start -y --name=rpm-test-1 lima/lima-template.yaml

Now, when you connect to the new machine, you'll find that your home directory is mounted inside the VM. The path will change depending on where the control plane repo is on your host machine, the VM architecture, and the specific git commit that you've built, but in general the installation should look like:

# connect to the machine
limactl shell rpm-test-1

sudo su -

rpm -i /Users/jasonlynch/workspace/pgEdge/control-plane/dist/pgedge-control-plane_0.6.2-SNAPSHOT-a8765012_linux_amd64.rpm

# Or to upgrade an existing installation
rpm -U /Users/jasonlynch/workspace/pgEdge/control-plane/dist/pgedge-control-plane_0.6.2-SNAPSHOT-a8765012_linux_amd64.rpm

From there, you can follow the other instructions in the doc to install prerequisites, configure, and start the control plane.

PLAT-511

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: e459ea0d-6740-4dfb-a38e-694e445c0ab7

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

📝 Walkthrough

Walkthrough

These changes introduce documentation for installing pgEdge Control Plane via RPM packages on Linux systems without Docker. A new installation guide was added along with index and navigation updates to reflect this preview feature.

Changes

Cohort / File(s)	Summary
Documentation Index & Navigation Updates docs/installation/index.md, docs/installation/installation.md, mkdocs.yml	Added index entry and navigation link for new RPM-based installation guide; minor editorial revision.
New Installation Guide docs/installation/systemd.md	New documentation page covering RPM package installation, systemd configuration, cluster initialization via HTTP endpoints, and upgrade procedures for pgEdge Control Plane on RPM-based Linux.

Poem

🐰 A new path through the Linux trees,
No Docker needed, RPM with ease!
Systemd spins while logs appear,
The Control Plane draws ever near,
Preview magic, systems cheer!

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 inconclusive)

Check name	Status	Explanation	Resolution
Description check	❓ Inconclusive	The PR description provides a summary and testing instructions, but is missing several template sections: Changes section, Checklist items, and Notes for Reviewers.	Complete the PR description by adding a Changes section with bulleted list of modifications, filling out the Checklist items, and optionally adding Notes for Reviewers to help with review.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'docs: document preview support for systemd' clearly and concisely summarizes the main change: adding documentation for systemd preview support in the Control Plane installation guide.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/PLAT-511/systemd-docs

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[codacy-production]

Up to standards ✅

🟢 Issues 0 issues

Results:
0 new issues

View in Codacy

_{TIP This summary will be updated as you push new changes. Give us feedback}

[jason-lynch]

@coderabbitai review

[coderabbitai]

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

[coderabbitai]

Actionable comments posted: 2

🧹 Nitpick comments (1)

docs/installation/index.md (1)

11-11: Polish wording for clarity.

Line 11 reads a bit awkwardly (“Currently only supports…”). A small wording tweak improves readability.

✏️ Suggested edit

-* [Installing via System Packages](systemd.md) covers installing the Control Plane via system packages, without Docker. This is a **preview feature** and is not recommended for production use. Currently only supports installation through RPMs.
+* [Installing via System Packages](systemd.md) covers installing the Control Plane via system packages, without Docker. This is a **preview feature** and is not recommended for production use. Currently, it supports installation through RPMs only.

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@docs/installation/index.md` at line 11, Reword the awkward sentence in the
list item that begins "* [Installing via System Packages](systemd.md)..." to
improve clarity; replace "Currently only supports installation through RPMs."
with a clearer variant such as "Currently supports RPM-based installations
only." so the phrasing flows naturally and reads consistently with the preceding
clause about preview status.

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/installation/installation.md`:
- Line 5: Replace the non-descriptive anchor text "[here](../using-ha/index.md)"
with a meaningful, accessible label that describes the target, e.g.,
"High-Availability Deployment Best Practices" (keep the existing URL
../using-ha/index.md); update the markdown link in the installation.md sentence
so the link text clearly conveys what the reader will find.

In `@docs/installation/systemd.md`:
- Around line 130-147: Update the example JSON block and curl payload to use the
API's expected field name server_urls (an array) instead of server_url, and
adjust the surrounding text to indicate an array of server URLs is required;
specifically change the JSON token payload and the --data body for the POST to
/v1/cluster/join to include "server_urls": ["http://198.19.249.2:3000"] so the
init/join API receives an array as documented.

---

Nitpick comments:
In `@docs/installation/index.md`:
- Line 11: Reword the awkward sentence in the list item that begins "*
[Installing via System Packages](systemd.md)..." to improve clarity; replace
"Currently only supports installation through RPMs." with a clearer variant such
as "Currently supports RPM-based installations only." so the phrasing flows
naturally and reads consistently with the preceding clause about preview status.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 86e9a8b2-76b8-42f0-8a73-3304293f6fd2

📥 Commits

Reviewing files that changed from the base of the PR and between e81f943 and 41034d1.

📒 Files selected for processing (4)

• docs/installation/index.md
• docs/installation/installation.md
• docs/installation/systemd.md
• mkdocs.yml

[tsivaprasad]

Can we update this section like below?

# Detect architecture
ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')

# Set the version to install (replace with the latest release version)
VERSION="0.7.0"

# Download the RPM
curl -LO "https://github.com/pgedge/control-plane/releases/download/v${VERSION}/pgedge-control-plane_${VERSION}_linux_${ARCH}.rpm"

# Install the RPM
rpm -i pgedge-control-plane_${VERSION}_linux_${ARCH}.rpm

[jason-lynch]

I've made this change. I formatted the version a little differently with the v prefix (VERSION="v0.7.0") so it gets picked up by our release automation, which updates the version numbers in our docs.