Install script and sub-directories for AberOWL
Groovy Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


This repository contains a collection of install scripts and subdirectories for setting up the AberOWL framework.

What is AberOWL?

AberOWL is a framework for ontology-based access to biological data.


Documentation is available at



Redis is an in-memory database that persists on disk, and allows for fast ontoloy indexing.

You can either install this using your package manager, or follow these simple steps below to compile Redis from source.

tar xvzf redis-stable.tar.gz
cd redis-stable

And then just simply start Redis with the following command.

redis-server restart

node, node.js and npm

Node.js is a JavaScript platform for server-side programming, and npm is a JavaScript package manager.

Ubuntu 14.04 comes bundled with a distro-sable version of node, node,js and npm that can be installed directly from the default repositories.

Simply run.

sudo apt-get install nodejs nodejs-legacy npm


Groovy is an alternative language for the JVM with a concise Java-friendly syntax, dynamic and static features, powerful DSL capabilities. AberOWL requires a Groovy version above version 2. If your package manager includes an ancient version of Groovy, you can easily use the sdkman tool to install a recent version:


Apache is a popular open-source web server.

To install apache, use this command.

sudo apt-get install apache2


AberOWL is being actively developed, and you can clone its repository.

Clone the repository:

git clone

And then use the preconfigured install script to automatically set up the service:


You will then need to reverse proxy the servers through apache. You can do this by editing the apache config file.

The relevant one is usually found at /etc/apache2/sites-enabled/000-default.conf.

You need to add:

ProxyPassReverse /service/
ProxyPass /service/

ProxyPass /
ProxyPassReverse /

Then, you need to add the module proxy to apache:

sudo a2enmod proxy

Note that the order is important. Apache must be restarted after changes.

sudo service apache2 restart


Everything should work by default, however listed are a few configuration points throughout the applications:


  • Configure the location of the AberOWL-server API endpoint using the ABEROWL_API constant at the top of each RemoteOntologyDiscover.groovy and RemoteOntologyUpdate.groovy


  • The port listened on can be changed at the top of AberOWLServer.groovy. Note that changes will have to be accounted for in the Apache configuration.


  • The port listened on can be changed at the top of bin/www. Note that changes will have to be accounted for in the Apache configuration.


Once you are in the aberowl-meta directory, To run the server simply run:

cd aberowl-server ;  groovy AberOWLServer.groovy [PORT]

Where [PORT] is the port for the AberOWL service to listen on e.g. 9999.

To run the web front-end:

cd aberowl-web ; bin/www

[obsolete and replaced by Jenkins scripts] To run the sync, follow these commands:

cd aberowl-sync ; groovy RemoteOntologyDiscover.groovy && groovy RemoteOntologyUpdate.groovy


You can open an issue on our issues page, or ask directly on our mailing list.


Code released under the Apache 2.0 license. For more information, please see the LICENSE file.