WIP snapshot before drive cleanup 2026-10-03
This commit is contained in:
parent
4373e9383e
commit
e666e7bf3c
1 changed files with 2828 additions and 1 deletions
89
plans/qa/2026-10-03-libsql-dryrun.md
Normal file
89
plans/qa/2026-10-03-libsql-dryrun.md
Normal file
|
|
@ -0,0 +1,89 @@
|
|||
# libSQL migrator dry-run (WP-K) — PASS
|
||||
|
||||
**Date:** 2026-10-03T06:24–06:26Z
|
||||
**Host:** NS1 `70.88.205.138` (`NS1.GEORGELAMBERT.ORG`)
|
||||
**Role:** Engineer (safe dry-run only)
|
||||
**Result:** **PASS**
|
||||
|
||||
## Constraints honored
|
||||
|
||||
- Did **not** modify `/var/lib/timestamping-svc/data/blockchain.db` or any Go timestamping DB (stat-only; mtime 2026-09-25).
|
||||
- Did **not** set `BUSINESS_STORE=libsql` (or any `LIBSQL_*`) on `zappier-edge.service`.
|
||||
- Did **not** delete/truncate live `/opt/verae/zappier-edge/billing.db`.
|
||||
- All migrator I/O under `/tmp/libsql-dryrun-20261003T062452Z/` copies only.
|
||||
|
||||
## Workspace
|
||||
|
||||
| Item | Path |
|
||||
|------|------|
|
||||
| Dry-run dir | `/tmp/libsql-dryrun-20261003T062452Z/` |
|
||||
| Source copy | `…/source-billing.db` (90112 bytes) |
|
||||
| Dest libSQL file | `…/dest.db` (`file:/tmp/libsql-dryrun-20261003T062452Z/dest.db`, 94208 bytes) |
|
||||
| Migrator | `/opt/verae/zappier-edge/dist/db/migrate-to-libsql.js` (same content/mtime as `/tmp/zappier-edge-work`) |
|
||||
| Runner | `…/run-migrate.mjs` (uses opt `node_modules`; chdir to `/opt/verae/zappier-edge`) |
|
||||
| JSON report | `…/migrate-report.json` |
|
||||
|
||||
`/tmp/zappier-edge-work` had no `node_modules`; used live opt install for `@libsql/client` + `better-sqlite3`. Migrator source identical in both trees.
|
||||
|
||||
## Commands
|
||||
|
||||
```bash
|
||||
# 1) Checkpoint + consistent copy (as verae-zapier → /tmp dry-run dir)
|
||||
sudo -u verae-zapier sqlite3 /opt/verae/zappier-edge/billing.db "PRAGMA wal_checkpoint(TRUNCATE);"
|
||||
# → 0|0|0
|
||||
sudo chmod 777 /tmp/libsql-dryrun-20261003T062452Z
|
||||
sudo -u verae-zapier python3 -c "import sqlite3; s=sqlite3.connect(\"/opt/verae/zappier-edge/billing.db\"); d=sqlite3.connect(\"/tmp/libsql-dryrun-20261003T062452Z/source-billing.db\"); s.backup(d); d.close(); s.close()"
|
||||
sudo chown marchon:marchon /tmp/libsql-dryrun-20261003T062452Z/source-billing.db
|
||||
|
||||
# 2) Run migrator (node ESM runner → migrateBillingDbToLibsql)
|
||||
cd /opt/verae/zappier-edge
|
||||
node /tmp/libsql-dryrun-20261003T062452Z/run-migrate.mjs
|
||||
```
|
||||
|
||||
## Row counts
|
||||
|
||||
| Table | Live billing.db | Source copy | Dest libSQL | Match |
|
||||
|-------|-----------------|-------------|-------------|-------|
|
||||
| customers | 4 | 4 | 4 | yes |
|
||||
| usage_entries | 6 | 6 | 6 | yes |
|
||||
| channel_rates | 108 | 108 | 108 | yes |
|
||||
| channel_rate_meta | 1 | 1 | 1 | yes |
|
||||
| tiers | 3 | 3 | 3 | yes |
|
||||
| price_endpoints | 11 | 11 | 11 | yes |
|
||||
| invoices | 0 | 0 | 0 | yes |
|
||||
| invoice_lines | 0 | 0 | 0 | yes |
|
||||
|
||||
Customers on dest: `cust-platform`, `cust_1`, `cust_2`, `cust_3`.
|
||||
|
||||
## Chain / tip hashes
|
||||
|
||||
| Phase | ok | length | tipHash |
|
||||
|-------|----|--------|---------|
|
||||
| before (source copy via `verifyUsageLedgerChain`) | true | 6 | `8d58a2986f46a9775712354234d44075eea1257226f93f9fb33a19b444ddebd5` |
|
||||
| after (dest via `LibsqlBusinessStore.verifyUsageChain`) | true | 6 | `8d58a2986f46a9775712354234d44075eea1257226f93f9fb33a19b444ddebd5` |
|
||||
| live billing.db (post-run read) | — | 6 | `8d58a2986f46a9775712354234d44075eea1257226f93f9fb33a19b444ddebd5` |
|
||||
|
||||
Genesis `prev_hash` = 64 zeros; tip id = 6. Before tip === after tip; lengths match.
|
||||
|
||||
## Dual-run / safety post-checks
|
||||
|
||||
| Check | Result |
|
||||
|-------|--------|
|
||||
| `sourcePreserved: true` (migrator report) | PASS |
|
||||
| Source copy still 90112 bytes after migrate | PASS |
|
||||
| Live `billing.db` still 90112 bytes; counts 4/6; same tip | PASS |
|
||||
| `BUSINESS_STORE` / `LIBSQL_*` absent from unit + not applied | PASS |
|
||||
| zappier-edge `/health` still 200 | PASS |
|
||||
| blockchain.db untouched (mtime 2026-09-25, ~31MB) | PASS |
|
||||
| booksJson | `absent` (path not provided; stub skip) |
|
||||
|
||||
## Pass/fail
|
||||
|
||||
**PASS** — WP-K migrator dry-run on a WAL-checkpointed copy of live `billing.db` → `file:…/dest.db` succeeded with matching row counts and identical usage ledger tip hash. Live service remains on sqlite-file BusinessStore; no cutover.
|
||||
|
||||
## Non-goals (explicitly not done)
|
||||
|
||||
- No `BUSINESS_STORE=libsql` flip
|
||||
- No rsync/deploy of edge
|
||||
- No books.json prepaid import (schema stub)
|
||||
- No JetStream / multi-host work
|
||||
Loading…
Reference in a new issue