diff options
| -rw-r--r-- | docs/genotypes.md | 21 |
1 files changed, 21 insertions, 0 deletions
diff --git a/docs/genotypes.md b/docs/genotypes.md index ce829fc..01b4962 100644 --- a/docs/genotypes.md +++ b/docs/genotypes.md @@ -157,6 +157,27 @@ subset. When the API takes over the alignment, it should subset to the strains by default and offer "include parents and F1s" explicitly, which is what GN2's checkbox does. +## No restart is needed to use a new genotype file + +The path travels in each request and nothing in the server caches a +panel, so pointing a request at a newer file (`BXD.8.geno` instead of +`BXD.geno`, `HET3-ITP.12.geno` instead of `.11`) takes effect on the next +request. Both engines' result caches key on file **contents**, not paths: +`src/rqtl.rs` reads the genotype file and hashes it into the output +filename, and gemma-wrapper names its cached kinship by a content hash -- +so a file that has changed is recomputed, not silently reused. + +What does need a restart: + +- a new binary (any Rust change), and `GENENETWORK4_TEST_TOKEN`, which is + decided when the router is built; +- the process environment: `PATH` and `R_LIBS_SITE` (R/qtl's `Rscript` + and its `qtl`/`optparse`/`stringi`/`stringr` packages), and the values + the process fixes at first use -- `SQL_URI` (the MySQL pool), + `XAPIAN_DB_PATH`/`SEARCH_ENGINE` (the open index handle); +- not `scripts/rqtl_wrapper.R`: it runs as a subprocess per request, so + editing it takes effect immediately. + ## What is still messy `HET3-ITP` has eleven `.geno` versions on disk (`.2` … `.12`) and **no |
