Skip to content

CLOS-4253: Document that SQLite WAL journal mode is unsupported for lvestats2.db #325

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
prilr wants to merge 1 commit into
base: master
Choose a base branch
from
Open

CLOS-4253: Document that SQLite WAL journal mode is unsupported for lvestats2.db #325

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions docs/cloudlinuxos/cloudlinux_os_components/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -81,6 +81,12 @@ Settings of old <span class="notranslate">lve-stats</span> (ver. 0.x) are import

SQLite database file is located in <span class="notranslate">`/var/lve/lvestats2.db`</span>, data from old <span class="notranslate">lve-stats</span> (ver. 0.x) are being migrated automatically in the background. Migrating process can last 2-8 hours (during this time lags are possible when admin is trying to check statistics, at the same time users will not be affected). Migrating the latest 30 days, <span class="notranslate">SQLite DB</span> stable migration is provided.

:::warning
The <span class="notranslate">SQLite</span> `WAL` journal mode is **not supported** for <span class="notranslate">`/var/lve/lvestats2.db`</span>. The <span class="notranslate">LVE Stats</span> daemon runs as `root` and is the only writer, while statistics are read by unprivileged, per-user (CageFS-isolated) processes such as <span class="notranslate">`cloudlinux-statistics`</span> and <span class="notranslate">`lveinfo`</span>. In `WAL` mode <span class="notranslate">SQLite</span> must write the `root`-owned <span class="notranslate">`-shm`</span> sidecar file even for read-only queries, so those non-root readers fail with `attempt to write a readonly database`.

Only the default `DELETE` journal mode is supported. If you previously set <span class="notranslate">`PRAGMA journal_mode=WAL`</span> on the database, the daemon automatically resets it back to `DELETE` on startup — run <span class="notranslate">`service lvestats restart`</span> to apply the fix.
:::

Currently, the new <span class="notranslate">lve-stats</span> supports all databases available in CloudLinux OS.

:::tip Note
Expand Down