From fab4168e813524f8d904cd93e1e4810f9768a09c Mon Sep 17 00:00:00 2001 From: Arun Isaac Date: Fri, 28 Jan 2022 13:38:00 +0530 Subject: Revert "README: Document `guix shell' development process." This reverts commit e0a260b0de55fbea0c507eb0ca5fbdc3c1a825c0. --- README.md | 32 +++++++++++++++----------------- 1 file changed, 15 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index ea473699..2b41a415 100644 --- a/README.md +++ b/README.md @@ -11,27 +11,24 @@ many different populations and many types of molecular, cellular, and physiologi The system is used by scientists and clinicians in the field of precision health care and systems genetics. GN and its predecessors have been in operation since Jan 1994, making it one of the longest-lived web services in biomedical research (https://en.wikipedia.org/wiki/GeneNetwork, and see a partial list of publications using GN and its predecessor, WebQTL (https://genenetwork.org/references/). -## Run +## Install -We recommend you use GNU Guix. GNU Guix allows you to deploy -GeneNetwork2 and dependencies as a self contained unit on any machine. +The recommended installation is with GNU Guix which allows you to +deploy GN2 and dependencies as a self contained unit on any machine. The database can be run separately as well as the source tree (for -developers). +developers). See the [installation docs](doc/README.org). + +## Run + +Once having installed GN2 it can be run through a browser +interface -Make sure you have the -[guix-bioinformatics](https://git.genenetwork.org/guix-bioinformatics/guix-bioinformatics) -channel set up. Then, to drop into a development environment with all -dependencies, run ```sh -guix shell -Df guix.scm -``` -Or, to drop into a development environment in a container, run -``` -guix shell -C --network -Df guix.scm +genenetwork2 ``` -In the development environment, start GeneNetwork2 by running, for -example, +A quick example is + ```sh env SERVER_PORT=5300 \ GENENETWORK_FILES=~/data/gn2_data/ \ @@ -42,12 +39,13 @@ env SERVER_PORT=5300 \ For full examples (you may need to set a number of environment variables), including running scripts and a Python REPL, also see the -startup script -[./bin/genenetwork2](https://github.com/genenetwork/genenetwork2/blob/testing/bin/genenetwork2). +startup script [./bin/genenetwork2](https://github.com/genenetwork/genenetwork2/blob/testing/bin/genenetwork2). Also mariadb and redis need to be running, see [INSTALL](./doc/README.org). +## Development + ## Testing To have tests pass, the redis and mariadb instance should be running, because of -- cgit v1.2.3