Installation: Difference between revisions
(→Java) |
No edit summary |
||
| (12 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
On this page you find install instructions for Alida in C++ | On this page you find install instructions for Alida in Java.<br> | ||
For information about the C++ implementation refer to the C++ page to be found [[CPlusPlus|here]]. | |||
== Java == | == Installing and Using Alida's Java version == | ||
There are different ways how to get and install Alida which are listed and explained below. Just select the option fitting to your needs and follow the instructions. | |||
=== Trying Alida: Alida's binary distribution === | |||
of the extracted files. | If you would like to see how Alida, its operator runners and Grappa work the easiest is to download and run its binary distribution from the Maven repository server: [https://moon.informatik.uni-halle.de/archiva/#artifact/de.unihalle.informatik.Alida/alida/2.7 Alida 2.7 on Maven repository server] | ||
Download the binary zip archive from the Artifacts section and extract the zip file to a directory of your choice.<br> | |||
Then change to that directory of the extracted files. | |||
<p> | <p> | ||
You can start | You can start Grappa (on Linux systems) using | ||
<pre> | <pre> | ||
tcsh | tcsh ./runAlida.tcsh | ||
</pre> | </pre> | ||
| Line 14: | Line 19: | ||
<pre> | <pre> | ||
bash | bash ./runAlida.bash | ||
</pre> | </pre> | ||
If you grant execute permissions to these scripts you can start them directly, e.g. | If you grant execute permissions to these scripts you can start them directly, e.g. | ||
<pre> | <pre> | ||
./runAlida.tcsh | |||
</pre> | </pre> | ||
If you in addition modify the variable ALIDA_HOME in these scripts you can start them from | If you in addition modify the variable ALIDA_HOME in these scripts you can start them from any directory. | ||
any directory. | |||
To | To run the graphical user interface to configure and start operators you may use | ||
<pre> | <pre> | ||
./runAlida.tcsh guioprunner | |||
</pre> | </pre> | ||
The command line interface is invoked, e.g., via | The command line interface is invoked, e.g., via | ||
<pre> | <pre> | ||
./runAlida.tcsh oprunner -h | |||
</pre> | </pre> | ||
which displays the help message. | which displays the help message. | ||
=== Using Alida as a library in your own code === | |||
For using Alida as a library in your own code the most easy way to fulfill all requirements and dependencies is to use Maven.<br> Since Alida version 2.4 we offer a template Maven project which you can use as a starting point for your work: | |||
* Maven-Template Project: [http://www2.informatik.uni-halle.de/agprbio/alida/downloads/alida-project-template-maven-1.2-src.zip zip]<br> | |||
Just unzip the archive to a directory of your choice and follow the instructions in the README file included.<br> The project already defines all repositories and dependencies required to use Alida's functionality. | |||
=== Building Alida from the Github sources and Contributing === | |||
If you would like to build Alida by yourself, e.g., for modifying or extending core functionality you should build and install Alida from the Github sources. | |||
==== | ==== Building Alida from the sources ==== | ||
For compiling Alida you need to have installed the following software on your computer: | |||
* JDK 1.8 | |||
* Maven 3.x or higher | |||
For building Alida follow the instructions below: | |||
<pre> | * clone Alida's repository on Github:<pre>git clone https://github.com/alida-hub/alida.git</pre> | ||
* compile the sources by running Maven as follows: <pre> mvn compile </pre> | |||
* for running included unit tests run: <pre> mvn test </pre> | |||
* to package a new release or snapshot run: <pre> mvn package </pre> | |||
Further information about how to build and package sources using Maven can be found on [https://maven.apache.org/ Maven's webpage].<br> | |||
Particulary the section [https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html Maven in 5 Minutes] might be of interest for beginners. | |||
If you prefer to use an IDE like Eclipse you can easily import the Alida project into your workspace.<br> | |||
Note that you need to install the 'm2e' extensions in Eclipse first. | |||
Given that Maven is correctly installed in Eclipse just select 'File' -> 'Import...' and then under 'Maven' the item 'Existing Maven projects',<br> and select as root directory for the import the directory to where you cloned Alida's sources.<br> For all other settings you can just stick to the defaults. | |||
==== Contributing to Alida ==== | |||
The easiest way to contribute to Alida is by making use of pull requests on Github. | |||
You can find documentation about pull requests and how to create them on [https://help.github.com/articles/proposing-changes-to-a-project-with-pull-requests/ Github]. | |||
. | |||
Latest revision as of 13:39, 21 July 2016
On this page you find install instructions for Alida in Java.
For information about the C++ implementation refer to the C++ page to be found here.
Installing and Using Alida's Java version
There are different ways how to get and install Alida which are listed and explained below. Just select the option fitting to your needs and follow the instructions.
Trying Alida: Alida's binary distribution
If you would like to see how Alida, its operator runners and Grappa work the easiest is to download and run its binary distribution from the Maven repository server: Alida 2.7 on Maven repository server
Download the binary zip archive from the Artifacts section and extract the zip file to a directory of your choice.
Then change to that directory of the extracted files.
You can start Grappa (on Linux systems) using
tcsh ./runAlida.tcsh
or
bash ./runAlida.bash
If you grant execute permissions to these scripts you can start them directly, e.g.
./runAlida.tcsh
If you in addition modify the variable ALIDA_HOME in these scripts you can start them from any directory.
To run the graphical user interface to configure and start operators you may use
./runAlida.tcsh guioprunner
The command line interface is invoked, e.g., via
./runAlida.tcsh oprunner -h
which displays the help message.
Using Alida as a library in your own code
For using Alida as a library in your own code the most easy way to fulfill all requirements and dependencies is to use Maven.
Since Alida version 2.4 we offer a template Maven project which you can use as a starting point for your work:
- Maven-Template Project: zip
Just unzip the archive to a directory of your choice and follow the instructions in the README file included.
The project already defines all repositories and dependencies required to use Alida's functionality.
Building Alida from the Github sources and Contributing
If you would like to build Alida by yourself, e.g., for modifying or extending core functionality you should build and install Alida from the Github sources.
Building Alida from the sources
For compiling Alida you need to have installed the following software on your computer:
- JDK 1.8
- Maven 3.x or higher
For building Alida follow the instructions below:
- clone Alida's repository on Github:
git clone https://github.com/alida-hub/alida.git
- compile the sources by running Maven as follows:
mvn compile
- for running included unit tests run:
mvn test
- to package a new release or snapshot run:
mvn package
Further information about how to build and package sources using Maven can be found on Maven's webpage.
Particulary the section Maven in 5 Minutes might be of interest for beginners.
If you prefer to use an IDE like Eclipse you can easily import the Alida project into your workspace.
Note that you need to install the 'm2e' extensions in Eclipse first.
Given that Maven is correctly installed in Eclipse just select 'File' -> 'Import...' and then under 'Maven' the item 'Existing Maven projects',
and select as root directory for the import the directory to where you cloned Alida's sources.
For all other settings you can just stick to the defaults.
Contributing to Alida
The easiest way to contribute to Alida is by making use of pull requests on Github.
You can find documentation about pull requests and how to create them on Github.
