mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-02 10:52:22 +00:00
docs(post-install): document the ZRAM swap profile and fix its translations
- Optional Settings: new step for the ZRAM swap profile, with what it does, how it is used and how to verify it - Uninstall Optimizations: add the ZRAM swap profile to the kernel and memory group - Customizable: list the ZRAM swap profile in the Optional category - lang: rewrite the Spanish ZRAM messages and add the missing space after semicolons and the initial capital in the other locales
This commit is contained in:
@@ -61,7 +61,7 @@
|
||||
},
|
||||
{
|
||||
"name": "Optional",
|
||||
"description": "Niche pieces not every host needs: AMD CPU fixes, Fastfetch banner, Figurine 3D hostname, PVE Appliance Manager index refresh, Ceph repository, High Availability services and Log2RAM to reduce SSD wear."
|
||||
"description": "Niche pieces not every host needs: AMD CPU fixes, Fastfetch banner, Figurine 3D hostname, PVE Appliance Manager index refresh, Ceph repository, High Availability services, Log2RAM to reduce SSD wear and a ZRAM swap profile."
|
||||
}
|
||||
],
|
||||
"mixTip": {
|
||||
|
||||
@@ -153,6 +153,23 @@
|
||||
"verifyLabel": "Verify and manage from the shell:",
|
||||
"verifyCode": "# Service state and configured timers\nsystemctl status log2ram\nsystemctl list-timers log2ram*\n\n# Current ramdisk usage — /var/log IS the tmpfs itself\ndf -h /var/log\n\n# Force a sync now (tmpfs → disk); does NOT shrink the tmpfs\nlog2ram write\n\n# Trigger the auto-sync guard on demand (vacuum + sync when usage is high)\n/usr/local/bin/log2ram-check.sh\n\n# Current config: SIZE, mail settings, path\ncat /etc/log2ram.conf\n\n# ProxMenux-specific cron jobs\ncat /etc/cron.d/log2ram /etc/cron.d/log2ram-auto-sync\n\n# Recent Log2RAM activity\njournalctl -u log2ram -n 50 --no-pager"
|
||||
},
|
||||
"zram": {
|
||||
"title": "Enable ZRAM swap profile",
|
||||
"intro": "Creates a compressed swap device in RAM, <code>/dev/zram0</code>, with <code>systemd-zram-generator</code>. Pages that the kernel moves to swap are compressed with zstd and kept in memory, so they are written to RAM before they reach the swap on disk.",
|
||||
"doesLabel": "What it does:",
|
||||
"doesItems": [
|
||||
"Installs <code>systemd-zram-generator</code> if it is missing, and records whether ProxMenux installed it.",
|
||||
"Writes <code>/etc/systemd/zram-generator.conf.d/90-proxmenux.conf</code>: a <code>zram0</code> device sized to one tenth of the host RAM, zstd compression (<code>zstd(level=9)</code> with systemd-zram-generator 1.2.0 or later) and swap priority 32767.",
|
||||
"With that priority the kernel fills ZRAM first. An existing swap on disk keeps its own priority and takes the pages that no longer fit in ZRAM.",
|
||||
"Before changing anything, looks for another ZRAM setup: an active zram swap, a zram line in <code>/etc/fstab</code>, a systemd unit or another generator file. If it finds one, the option stops and leaves that setup as it is.",
|
||||
"Starts <code>dev-zram0.swap</code> and checks that the active device matches the profile. If it does not, the previous state is restored.",
|
||||
"Registers itself in <code>installed_tools.json</code> so it can be reverted from Uninstall Optimizations."
|
||||
],
|
||||
"howUseLabel": "How to use:",
|
||||
"howUseBody": "The option is part of the Customizable flow only; the Automated flow does not apply it. The device is created again at every boot. While it is active, the Memory card of the ProxMenux Monitor shows its capacity, the swap used, the algorithm, the compression ratio and the physical memory it takes.",
|
||||
"verifyLabel": "Verify from the shell:",
|
||||
"verifyCode": "# Active swap devices and their priority\nswapon --show\n\n# ZRAM device: algorithm, size and compressed data\nzramctl\n\n# Profile written by ProxMenux\ncat /etc/systemd/zram-generator.conf.d/90-proxmenux.conf\n\n# State of the swap unit\nsystemctl status dev-zram0.swap"
|
||||
},
|
||||
"autoApplication": {
|
||||
"title": "Automatic Application",
|
||||
"body": "These optional features are applied only when specifically selected during the post-install process. Each feature can be individually chosen based on your specific needs and preferences."
|
||||
|
||||
@@ -84,6 +84,10 @@
|
||||
{
|
||||
"tool": "System Limits Increase",
|
||||
"restores": "Removes /etc/sysctl.d/99-maxwatches.conf, 99-maxkeys.conf, 99-swap.conf, 99-fs.conf and /etc/security/limits.d/99-limits.conf. Reverts PAM limits and systemd DefaultLimitNOFILE, and strips the ulimit -n 256000 line from /root/.profile."
|
||||
},
|
||||
{
|
||||
"tool": "ZRAM swap profile",
|
||||
"restores": "Turns off the swap on /dev/zram0, stops dev-zram0.swap and removes /etc/systemd/zram-generator.conf.d/90-proxmenux.conf. The systemd-zram-generator package is purged only when ProxMenux installed it and no other ZRAM setup is present. If the pages in ZRAM cannot be moved out, the profile stays active and nothing is removed."
|
||||
}
|
||||
]
|
||||
},
|
||||
|
||||
Reference in New Issue
Block a user