Home

Smart Connector

User Manual

• Dependencies
• Build from source
• Run
• Quick Start

Dependencies

Smart Connector runs on Java, tested with OpenJDK 1.7, requires Leiningen 2.0+ in order to build the project from source. For running one of the resulting binaries only the JRE is required.

• Leiningen

Build from source

git clone --recursive https://github.com/ecelis/iridescence.git
cd iridescence
./build.sh

If everything goes well run the development server and browse to http://127.0.0.1:3000

cd webui
lein ring server-headless

build.sh by default cleans and build Smart Connector, it also takes the clean sub-command, to clean only.

Run

Smart Connector can run either as stand alone application from a jar file or deployed to a Java Application Server such as JBoss, Tomcat, etc.

After a succesfull build in the webui/target directory will be two .jar files, iridescence_standalone.jar and iridescence.war, stand alone application and for deploy to Java application server.

Stand alone application

java -jar iridescence_standalone.jar

Deploy to Tomcat

cp iridescence.war $CATALINA_HOME/webapps
cd $CATALINA_HOME/bin
./startup.sh

Configurable options

The stand alone application reads some environment variables that can change default settings.

• PORT default 3000, set the TCP port to listen

  PORT=8080 java -jar iridescence_standalone.jar

Quick Start

1. Browse http://127.0.0.1:3000
2. Click on the Adapter
3. Select adapter (the red shape)