eHive installation and setup

eHive dependencies

eHive system depends on the following components that you may need to download and install first:

Perl 5.10 or higher
A database engine of your choice. eHive keeps its state in a database, so you will need
1. a server installed on the machine where you want to maintain the state of your pipeline(s) and
2. clients installed on the machines where the jobs are to be executed.
At the moment, the following database options are available:
- MySQL 5.1 or higher
- SQLite 3.6 or higher
- PostgreSQL 9.2 or higher
Perl DBI API version 1.6 or higher -- Perl database interface that has to include a driver for the database engine of your choice above.
Perl libraries for visualisation (optional but recommended). They can be found on CPAN:
- GraphViz (needed for generate_graph.pl and the GUI)
- Chart::Gnuplot (needed for generate_timeline.pl)

Installing EnsEMBL core and eHive code

Create a directory for EnsEMBL repositories:

It is advised to have a dedicated directory where EnsEMBL-related packages will be deployed. Unlike DBI modules that can be installed system-wide by the system administrator, you will benefit from full (read+write) access to the EnsEMBL files/directories, so it is best to install them under your home directory. For example,

        $ mkdir $HOME/ensembl_main

Set a variable pointing at this directory:

using bash syntax:

        $ export ENSEMBL_CVS_ROOT_DIR="$HOME/ensembl_main"
                #
                # (for best results, append this line to your ~/.bashrc or ~/.bash_profile configuration file)

using [t]csh syntax:

        $ setenv ENSEMBL_CVS_ROOT_DIR "$HOME/ensembl_main"
                #
                # (for best results, append this line to your ~/.cshrc or ~/.tcshrc configuration file)

Change into your EnsEMBL codebase directory:

        $ cd $ENSEMBL_CVS_ROOT_DIR

Check out the EnsEMBL repositories by cloning them from GitHub:

EnsEMBL core API:

    git clone https://github.com/Ensembl/ensembl.git

eHive code:

    git clone https://github.com/Ensembl/ensembl-hive.git

Add new packages to the PERL5LIB variable:

using bash syntax:

        $ export PERL5LIB=${PERL5LIB}:${ENSEMBL_CVS_ROOT_DIR}/ensembl/modules
        $ export PERL5LIB=${PERL5LIB}:${ENSEMBL_CVS_ROOT_DIR}/ensembl-hive/modules
                #
                # (for best results, append these lines to your ~/.bashrc or ~/.bash_profile configuration file)

using [t]csh syntax:

        $ setenv PERL5LIB  ${PERL5LIB}:${ENSEMBL_CVS_ROOT_DIR}/ensembl/modules
        $ setenv PERL5LIB  ${PERL5LIB}:${ENSEMBL_CVS_ROOT_DIR}/ensembl-hive/modules
                #
                # (for best results, append these lines to your ~/.cshrc or ~/.tcshrc configuration file)

Add eHive scripts' path to the PATH variable (optional but useful) :

using bash syntax:

        $ export PATH=$PATH:$ENSEMBL_CVS_ROOT_DIR/ensembl-hive/scripts
                #
                # (for best results, append this line to your ~/.bashrc or ~/.bash_profile configuration file)

using [t]csh syntax:

        $ set path = ( $path ${ENSEMBL_CVS_ROOT_DIR}/ensembl-hive/scripts )
                #
                # (for best results, append this line to your ~/.cshrc or ~/.tcshrc configuration file)