Persistence and Admin

Persistence

Strata stores every document with shelf. It reads data from ETS memory and writes the data to DETS files every five seconds. A composite's parent link to its child is recorded in a second table, so create and delete survive a restart along with the document state they touch. See Composing Documents. On load, Strata checks stored data against the expected JSON structure when it loads the data. It rejects damaged or incompatible records.

The storage location is STRATA_DATA_DIR (default: data). The directory contains the atomic document/parent checkpoint store.dets. See Durability and Recovery for backup, restore, and shutdown guidance. See Operations for every setting.

The storage format is not yet stable: a future release may require re-creating data directories. See Limitations.

Admin page

strata_server serves a read-only Lustre admin page at /admin. The page updates every two seconds by default.

Admin page

http://localhost:8000/admin?token=<STRATA_TOKEN>

For each known document it shows:

• the document id;
• stored size;
• last write time;
• number of active connections;
• every present session's name and color.

The admin page is deliberately read-only. It uses the same shared secret as clients, so anyone with the token can see every document id and presence. The page cannot delete documents or close connections. These actions require stronger authentication and activity logs.

The built page is in priv/admin. Set STRATA_ADMIN_DIR to use a different build, or run just admin-build to rebuild it.