@@ -16,22 +16,22 @@ Alternatively, you can install it manually:
...
@@ -16,22 +16,22 @@ Alternatively, you can install it manually:
cd dgenies
cd dgenies
pip3 install -r requirements.txt
pip3 install -r requirements.txt
python3 setup.py install
python3 setup.py install
### Upgrade
### Upgrade
#### Standalone mode
#### Standalone mode
pip3 install dgenies --upgrade
pip3 install dgenies --upgrade
#### Webserver mode
#### Webserver mode
dgenies clear -c
dgenies clear -c
pip3 install dgenies --upgrade
pip3 install dgenies --upgrade
Then, you need to restart your webserver.
Then, you need to restart your webserver.
### Requirements
### Requirements
D-Genies requires python >= 3.5 to run.
D-Genies requires python >= 3.5 to run.
...
@@ -52,32 +52,32 @@ Some python modules are required (will be automatically installed by the command
...
@@ -52,32 +52,32 @@ Some python modules are required (will be automatically installed by the command
intervaltree==2.1.*
intervaltree==2.1.*
argparse==1.4
argparse==1.4
Markdown==2.6.*
Markdown==2.6.*
Additional modules for webserver mode:
Additional modules for webserver mode:
Flask-Mail==0.9.*
Flask-Mail==0.9.*
peewee==2.10.2
peewee==2.10.2
python-crontab==2.2.*
python-crontab==2.2.*
And if you use a cluster (webserver mode):
And if you use a cluster (webserver mode):
drmaa==0.7.*
drmaa==0.7.*
In webserver mode, you must install `mysqlclient` python module (will not be installed automatically) if you use mysql as RDBM.
In webserver mode, you must install `mysqlclient` python module (will not be installed automatically) if you use mysql as RDBM.
Windows
Windows
-------
-------
We provide an installer to install D-Genies. You can download it [here](https://github.com/genotoul-bioinfo/dgenies/releases/download/v1.0.1/dgenies-1.0.1_setup.exe).
We provide an installer to install D-Genies. You can download it [here](https://github.com/genotoul-bioinfo/dgenies/releases/download/v1.0.1/dgenies-1.0.1_setup.exe).
All requirements are present inside the package, so you don't have to do anything else.
All requirements are present inside the package, so you don't have to do anything else.
### System requirements
### System requirements
You need Windows 7 or newer, 64 bits architecture.
You need Windows 7 or newer, 64 bits architecture.
How to start
How to start
-------------
-------------
...
@@ -90,10 +90,10 @@ simultaneously or if you run it on a server, you must run it in webserver mode.
...
@@ -90,10 +90,10 @@ simultaneously or if you run it on a server, you must run it in webserver mode.
Unix: start with the command below:
Unix: start with the command below:
dgenies run
dgenies run
Optional arguments:
Optional arguments:
`-p <port>` run in a specified port (default: 5000)
`-p <port>` run in a specified port (default: 5000)
`--no-browser` don't start the browser automatically
`--no-browser` don't start the browser automatically
Windows: just click on the launcher in the desktop or into the install folder.
Windows: just click on the launcher in the desktop or into the install folder.
...
@@ -104,7 +104,7 @@ Windows: just click on the launcher in the desktop or into the install folder.
...
@@ -104,7 +104,7 @@ Windows: just click on the launcher in the desktop or into the install folder.
#### Recommended method
#### Recommended method
Flask webserver (which is used in standalone mode) is not recommended in production servers.
Flask webserver (which is used in standalone mode) is not recommended in production servers.
So, we recommend using the WSGY module of Apache (or µWSGI + nginx, not documented here).
So, we recommend using the WSGY module of Apache (or µWSGI + nginx, not documented here).
Once dgenies is installed, you just need to use the `/var/www/dgenies.wsgi` file into your apache
Once dgenies is installed, you just need to use the `/var/www/dgenies.wsgi` file into your apache
...
@@ -117,7 +117,7 @@ Here is an example of configuration file for apache:
...
@@ -117,7 +117,7 @@ Here is an example of configuration file for apache:
With `<dir>`: the folder into save the scripts (must be accessible by cluster nodes).
With `<dir>`: the folder into save the scripts (must be accessible by cluster nodes).
...
@@ -178,7 +178,7 @@ To change this file, please copy it into `application.properties.local` (at the
...
@@ -178,7 +178,7 @@ To change this file, please copy it into `application.properties.local` (at the
### Global
### Global
Main parameters are stored into this section:
Main parameters are stored into this section:
*`config_dir`: where configuration file will be stored.
*`config_dir`: where configuration file will be stored.
*`upload_folder`: where uploaded files will be stored.
*`upload_folder`: where uploaded files will be stored.
...
@@ -299,17 +299,17 @@ The `dgenies` command can be used to do some maintenance staff.
...
@@ -299,17 +299,17 @@ The `dgenies` command can be used to do some maintenance staff.
**Clear all jobs:**
**Clear all jobs:**
dgenies clear -j [--max-age <age>]
dgenies clear -j [--max-age <age>]
`--max-age` (opt): set the max age of jobs to delete (default: 0, for all)
`--max-age` (opt): set the max age of jobs to delete (default: 0, for all)
**Clear all log:**
**Clear all log:**
dgenies clear -l
dgenies clear -l
**Clear crons (webserver mode):**
**Clear crons (webserver mode):**
dgenies clear -c
dgenies clear -c
Gallery
Gallery
-------
-------
...
@@ -318,22 +318,22 @@ Note: gallery is only available in webserver mode.
...
@@ -318,22 +318,22 @@ Note: gallery is only available in webserver mode.
To add a job to the gallery, copy illustrating picture file into the *gallery* folder inside the data folder (*~/.dgenies/data/gallery* as default, create it if not exists). Then use the *dgenies* command:
To add a job to the gallery, copy illustrating picture file into the *gallery* folder inside the data folder (*~/.dgenies/data/gallery* as default, create it if not exists). Then use the *dgenies* command:
<pclass="afterworlff"><supid="fn{{ fnote_tab }}"><ahref="#fn{{ fnote_tab }}"id="ref{{ fnote_tab }}">{{ fnote_tab }}</a></sup> In PAF or MAF format.</p>
<pclass="afterworlff"><supid="fn{{ fnote_tab }}"><ahref="#fn{{ fnote_tab }}"id="ref{{ fnote_tab }}">{{ fnote_tab }}</a></sup> In PAF or MAF format.</p>
{% set fnote_tab = fnote_tab + 1 %}
{% set fnote_tab = fnote_tab + 1 %}
<pclass="afterworlff"><supid="fn{{ fnote_tab }}"><ahref="#fn{{ fnote_tab }}"id="ref{{ fnote_tab }}">{{ fnote_tab }}</a></sup> Fasta file or index built by <ahref="#">our tool</a>.</p>
<pclass="afterworlff"><supid="fn{{ fnote_tab }}"><ahref="#fn{{ fnote_tab }}"id="ref{{ fnote_tab }}">{{ fnote_tab }}</a></sup> Fasta file or index built by <ahref="https://raw.githubusercontent.com/genotoul-bioinfo/dgenies/v{{version}}/src/dgenies/bin/index.py"download="index.py">our tool</a>.</p>
{% set fnote_tab = fnote_tab + 1 %}
{% set fnote_tab = fnote_tab + 1 %}
<pclass="afterworlff"><supid="fn{{ fnote_tab }}"><ahref="#fn{{ fnote_tab }}"id="ref{{ fnote_tab }}">{{ fnote_tab }}</a></sup> From a previous run.</p>
<pclass="afterworlff"><supid="fn{{ fnote_tab }}"><ahref="#fn{{ fnote_tab }}"id="ref{{ fnote_tab }}">{{ fnote_tab }}</a></sup> From a previous run.</p>