How to install biomaj?

Requirements: mongodb 3.x , redis

Create your BioMAJ directories:

mkdir data/
mkdir data/conf
mkdir data/lock
mkdir data/db
mkdir data/process
mkdir data/cache
mkdir data/log

Create a Python virtual environment to install BioMAJ and every associated package:

python3 -mvenv envbiomaj

Every time you will want to use BioMAJ you will have to activate the Python virtual environment:

source envbiomaj/bin/activate

Getting out of the virtual environment :


Pip and requests installation:

pip install --upgrade pip
easy_install pip
pip uninstall requests
easy_install requests

Installation of all required packages for BioMAJ (specifications for Ubuntu, it may require adaptations for another OS):

apt-get install libssl-dev libcurl4-openssl-dev python-dev
cd biomaj

Creation of the configuration file and addition of an example to test the BioMAJ installation:

git clone
cd biomaj
#Copy the example of the bank alu:
cp biomaj/tests/ <your path>/data/conf 
#Modify root.dir in the file to match the path of all your data (<your path>/data) and mongodb/redis/smtp connection parameters: 
#For Ubuntu
apt-get install libssl-dev libcurl4-openssl-dev python-dev
cd ..

Specific indications for pycurl (for CentOS):

pip install pycurl== --global-option="--with-nss"

Or for Ubuntu:

easy_install pycurl

If you want more information or if you have ssl issues :

Mongodb installation for ubuntu, short version(more information):

sudo apt-key adv --keyserver hkp:// --recv 0C49F3730359A14518585931BC711F9BA15703C6
echo "deb [ arch=amd64,arm64 ] xenial/mongodb-org/3.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.4.list
sudo apt-get update
sudo apt-get install -y mongodb-org
sudo service mongod start

An other example for mongodb installation for CentOS (Thanks to the Plateforme Auvergne Bioinformatique):

vi mongodb.repo
yum repolist
yum install mongodb-org.x86_64
systemctl status mongod
systemctl start mongod

Installation of the BioMAJ packages:

pip install biomaj-cli
pip install biomaj-daemon
pip install biomaj-user
pip install biomaj-download
pip install biomaj-process
pip install biomaj-cron
pip install biomaj-ftp

For biomaj-watcher :

git clone
cd biomaj-watcher
python develop

You can quickly test your installation with these commands:

# from the biomaj directory or by specifying the location of the file (--config option):
cd biomaj --help --bank alu --update

You are ready to start, go to Tutorial.