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 aber-owl.net.
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.
wget http://download.redis.io/redis-stable.tar.gz tar xvzf redis-stable.tar.gz cd redis-stable make
And then just simply start Redis with the following command.
node, node.js and npm
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.
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: http://www.groovy-lang.org/install.html#_gvm_the_groovy_environment_manager
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 https://github.com/bio-ontology-research-group/aberowl-meta
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
You need to add:
ProxyPassReverse /service/ http://my.domain.name.uk:8080/ ProxyPass /service/ http://my.domain.name.uk:8080/ ProxyPass / http://my.domain.name.uk:3000/ ProxyPassReverse / http://my.domain.name.uk:3000/
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
Code released under the Apache 2.0 license. For more information, please see the LICENSE file.