FirstTimeInstallation

This installation tutorial is based on installation of the ANDS Services on a CentOS 6 operating system. ANDS envisages that all the open source software in the software stack will be compatible with various other Linux distributions, but does not support/provide installation notes for these operating systems.

ANDS recommends using the Nectar Research Cloud as a testing platform for deploying the software stack. A preconfigured image may be available in the near future -- please contact us if you are interested in helping out!

1. Initial System configuration

From a stock Centos 6 installation, run a yum update to ensure that the kernel and system libraries are up-to-date.

The ANDS software dependencies are easily resolved by configuring 3rd-party software repositories including EPEL and REMI:

• Download the latest version of the EPEL RPM from: http://mirror.optus.net/epel/6/i386/repoview/epel-release.html
• Download the latest version of the REMI RPM from: http://blog.famillecollet.com/pages/Config-en
• Download the latest version of JPackage from: http://www.jpackage.org/
• Install these RPMs using rpm -Uvh <filename>.rpm

Example:

wget http://dl.fedoraproject.org/pub/epel/6/i386/epel-release-6-7.noarch.rpm
wget http://rpms.famillecollet.com/enterprise/remi-release-6.rpm
rpm -Uvh http://mirrors.dotsrc.org/jpackage/6.0/generic/free/RPMS/jpackage-utils-5.0.0-7.jpp6.noarch.rpm
rpm -Uvh remi-release-6*.rpm epel-release-6*.rpm jpackage-utils*.rpm

Now edit the /etc/yum.repos.d/remi.repo file and under the [remi] block set enabled=1and add the line exclude=mysql*

Now would be a good time to do some system housekeeping:

yum update

Thats step 1 complete!

---

2. Installing additional software dependencies

Apache Web Server (httpd)

Install httpd, php and other required libraries by executing:

yum install httpd php-pgsql php-mbstring php-xml php-devel php-pdo

This should give you a basic Apache installation with configuration files in /etc/httpd/ and a default web root of /var/www/ (web files in /var/www/htdocs/). It also installs the most recent PHP version in the REMI repository (currently PHP 5.3). ANDS Online Services requires PHP 5.x.

PostgreSQL Database Server

Install the latest version of PostgreSQL (currently tested against version 9.1) using the instructions here

Example:

wget http://yum.postgresql.org/9.1/redhat/rhel-6-i386/pgdg-centos91-9.1-4.noarch.rpm
rpm -ivh pgdg-centos91-9.1-4.noarch.rpm
yum install postgresql91 postgresql91-server

Next, install the server software:

yum install postgresql91 postgresql91-server

This will install PostgreSQL server. The default location of the data directory (which also contains the server configuration files) is /var/lib/pgsql/9.1/data

Tomcat 6 (java application server)

yum install java
yum install tomcat6
yum install ant ant-contrib   # used to build the ANDS web applications

This will install tomcat6 with configuration files in /etc/tomcat6/ and web apps deployed from /var/lib/tomcat6/

SOLR Indexer

Visit http://lucene.apache.org/solr/mirrors-solr-latest-redir.html to get the latest SOLR distribution (currently tested against SOLR 3.6, experimental testing against SOLR 4 has begun). Extract this into /usr/local/solr36

Example:

cd /usr/local/
wget http://apache.mirror.uber.com.au/lucene/solr/3.6.0/apache-solr-3.6.0.tgz
tar xfz apache-solr-3.6.0.tgz
mv apache-solr-3.6.0 solr36

SOLR 3.6 is now installed in /usr/local/solr36/

Gearman (background task daemon)

• Follow the instructions contained http://www.webtatic.com/ here to install the webtatic repository. It is disabled by default, which is just as well as it often contains bleeding-edge software.
• Install gearmand and php-pecl-gearman using the repository

Example:

rpm -Uvh http://repo.webtatic.com/yum/centos/6/latest.rpm
yum install gearmand php-pecl-gearman --enablerepo=webtatic