about summary refs log tree commit diff
path: root/docs
diff options
context:
space:
mode:
authorPjotr Prins <pjotr.public01@thebird.nl>2026-11-16 10:47:26 +0000
committerPjotr Prins <pjotr.public01@thebird.nl>2026-11-16 10:47:26 +0000
commit025d44ab225a3556aa77b3c0475d017deb03d7e6 (patch)
tree3b703f10cbaa127b0ca23d36075104f239df20e5 /docs
parent278855bd0014094a9d3fcf81ef387e1aa7a89068 (diff)
downloadgenenetwork4-025d44ab225a3556aa77b3c0475d017deb03d7e6.tar.gz
operator checklist: the ravanan build is a patched one, and why
Three local patches, the third of which is the reason a 20-chromosome scatter
now runs 20-wide instead of 1-wide: {"job": ...} versus {"jobs": [...]},
which is slurmrestd's heterogeneous-job form. With the node declaring 30 CPUs
(cold 24.7 s) and the submit fixed (cold 9.4 s), ravanan is within 3x of
gemma-wrapper's 3.1 s for the same rows instead of 33x.
Diffstat (limited to 'docs')
-rw-r--r--docs/www/operator-checklist.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/docs/www/operator-checklist.md b/docs/www/operator-checklist.md
index b6826d7..a6267de 100644
--- a/docs/www/operator-checklist.md
+++ b/docs/www/operator-checklist.md
@@ -443,6 +443,18 @@ Two things that are easy to get wrong, both measured on this box:
   `factory/code/genenetwork/genenetwork4/cwl/gemma/`, so the checkout has to
   be at the commit the binary was built from — otherwise the CWL that runs
   is not the one that was tested.
+* **The ravanan in `env.sh` is a locally patched build.**
+  `/gnu/store/amn5dfh4…-ravanan-0.2.0` comes from
+  `factory/code/ravanan` (commit `6f9031b`) and carries three patches the
+  upstream 0.2.0 lacks: `--slurm-api-endpoint` parsed into a URI, `user-error`
+  printed unconditionally (job scripts have no log level, so their failures
+  were silent), and `{"job": …}` instead of `{"jobs": […]}` on submit. That
+  last one is worth remembering: the plural form is slurmrestd's
+  *heterogeneous* job submission, so every step arrived as a one-component het
+  job holding a whole node, and a 20-chromosome scatter ran strictly 1-wide
+  (cold 24.7 s). With it fixed: 20-wide, cold 9.4 s. Rebuild with
+  `guix build --with-source=ravanan=<checkout> --without-tests=ravanan
+  ravanan` (its own test suite wants node and fails in the sandbox).
 * **ravanan 0.2.0 exists on this box in two variants**, and only one works
   with `--slurm-api-endpoint`. In `/gnu/store/1ydn2bdw…-ravanan-0.2.0`
   (and `20aqba00…`) the option handler converts its argument,