Requirements

This Fabric distribution builds on Linux and OS X. Fabric 0.2.2 builds against Jif 3.4.2 and Polyglot 2.6.1. Both are included in the distribution. JDK 7 or later is required; we have tested with the Oracle and the OpenJDK implementations. OpenSSL is used to sign certificates. Fabric is compiled with the Apache Ant build tool.

The following command will install the requisite tools on an Ubuntu 12.04 or 14.04 system:

$ sudo apt-get install openjdk-7-jdk openssl ant

Once the tools are installed, unpack the distribution in a location of your choice and change into the distribution directory:

$ tar zxf fabric-0.2.2.tar.gz

$ cd fabric-0.2.2

Configuring

Before using Fabric, you must configure the scripts in the bin directory. From the top-level directory, run:

$ ant bin

If the configurator is unable to find the JDK, Polyglot, or Jif, it will prompt you to set the appropriate properties in config.properties.

Building

This step is optional. Fabric comes pre-compiled as Jar files in the lib directory. However, if you wish to rebuild Fabric, run ant from the top-level directory:

$ ant

For other useful build targets, run ant -p from the top-level directory.