eHive installation and setup

1. Perl 5.10 or higher
2. 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
3. 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.
4. 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)

Check out the repository by cloning it from GitHub:

        $ git clone -b version/2.1 https://github.com/Ensembl/ensembl-hive.git

This will create ensembl-hive directory with all the code and documentation.

Optional configuration of the system:

You may find it convenient (although it is not necessary) to add "ensembl-hive/scripts" to your $PATH variable to make it easier to run beekeeper.pl and other useful Hive scripts.

• 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)
  

Also, if you are developing the code and not just running ready pipelines, you may find it convenient to add "ensembl-hive/modules" to your $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)