How to build Heliosearch from sources

Requirements

1. Git
2. Java 1.7 (JDK)
3. Ant 1.8.x or higher
4. Ant ivy (actually, optional as build script can install it)

There are two options of running heliosearch:

1. Build and run the example
2. Build war file from sources and deploy it to web application server

Common steps

1. Checkout source code from github: git clone [email protected]:Heliosearch/heliosearch.git
2. Go into heliosearch solr directory: cd heliosearch/solr
3. Most build commands require ivy to be installed:

• If you don't have ivy installed, scripts will fail with a meaningful error.
• If you want script to install ivy use the following command: ant ivy-bootstrap
• Otherwise install it manually and continue

1. As heliosearch require some native libraries:
2. Execute: ant compile
3. Go into native directory: cd native
4. Execute make file: ./make.sh (Use cygwin under windows)
5. It will copy native libraries to native/build and example/native directories.
6. Now go back to heliosearch/solr directory and proceed with concrete task

How-To build and run example

Note: after common steps you should be in the heliosearch/solr directory.

1. Just run: ant run-example
2. If everything is successful please try to visit: http://localhost:8983/solr/admin to test that example works. Be sure that you have the following message during start:

!!!!!! Heliosearch native libraries loaded. !!!!!!

How-To build war file

1. Build .war file: ant dist
2. If everything was successful war file should appear in the heliosearch/solr/dist directory.

• The name of the file is something like solr-4.11.0-SNAPSHOT.war

1. It is now possible to deploy the war file to your web application server(Tomcat, JBOSS AS, etc).