<< Back to GIL Documentation

Building GIL

This document describes the process of building GIL from source.

Prerequisites

Java JDK 6	Is the Java development toolkit necessary for building GIL.	Download
Git	Is the Source Code Management tool to retrieve the code from GitHub where the GIL source is hosted.	Download
Apache Ant	Ant build tool or NetBeans below is necessary to build GIL. The Ant installation instructions can be found here	Download
NetBeans 6.8	NetBeans is not necessary for building GIL but it works fine if you prefer an IDE instead of the command line. Actually the NetBeans installation installs Ant and uses it behind the scenes.	Download

Build using Ant

1. Get the source from GitHub, either by creating a fork from the project page and run 'git clone git@github.com:yourUsername/yourFork' locally, or just download the source.
2. Direct your command line to the GIL root folder that should contain the 'build.xml' file.
3. Type 'ant distribute'. This will build GIL, the javadoc and run unit tests. Finally a distributable as a zip archive is built in the 'dist' folder, named gil-x.x.zip.

Build using NetBeans 6.8

1. Get the source from GitHub, either by creating a fork from the project page and run 'git clone git@github.com:yourUsername/yourFork' locally, or just download the source.
2. Start NetBeans and select 'Open Project...' from the 'File' menu. And locate the GIL folder and open the GIL project.
3. Select the 'Files' tab in the projects window. If not visible, select 'Files' from the 'Windows' menu.
4. Locate the 'build.xml' in the GIL root folder. Right click on the file and select 'Run Target' and 'distribute'.

   This will build GIL, the javadoc and run unit tests. Finally a distributable as a zip archive is built in the 'dist' folder, named gil-x.x.zip.

Build the GILExample using Ant

This will build a running example with fake adapters. First of all the GIL framework must be built following either description above.

1. Direct your command line to the GILExample root folder that should contain the 'build.xml' file.
2. Type 'ant jar'. This will build the GILExample.
3. Direct your command line to the 'dist' folder and type 'java -jar GILExample.jar' to run the example.

   This will start GIL with fake adapters for the external system side and the process model side. Values will be transferred and sim commands will be executed. Direct your browser to http://localhost:9980/index.html to access the GIL Web interface.