Installation

This document walks you through the system, application, and tooling requirements for using Datawire Connect as well as the actual installation process.

Prerequisites

Datawire Connect has basic requirements that all users must meet as well as requirements specific to particular output languages.

Basic Requirements

Datawire Connect requires a modern Linux distribution or Mac OS X. It has been successfully tested on the following:

  • Mac OS 10.10 (Yosemite)
  • Mac OS 10.11 (El Capitan)
  • Ubuntu 14.04 (Trusty)
  • Fedora 22

Datawire Connect also requires the following:

  • Python 2.7+
  • pip
  • tar

Java Requirements

You must have Java installed to use any Java code generated by Datawire Connect. Datawire Connect has been successfully tested with Java 7 and Java 8.

To compile and run the generated code directly from Datawire Connect you must also have Maven installed. Datawire Connect has been successfully tested with Maven 3.1 and Maven 3.3.x. Maven is not required if you wish to use the generated .java files manually either directly or within an IDE.

To use the documentation or package generation feature of Datawire Connect with Java, you must also have Maven installed. Datawire Connect has been successfully tested with Maven 3.1 and Maven 3.3.x.

Note: Javadoc comments will be generated in the source files as part of the code generation process. You may manually run Javadoc on those files to generate HTML documentation without Maven installed.

Python Requirements

There are no additional requirements to use Python code generated by Datawire Connect.

Javascript Requirements

You must have Node.js installed to use any Javascript code generated by Datawire Connect. Datawire Connect has been successfully tested with Node 4.2.1 and is expected to work with any 4.x version of Node.

Installation

To install Datawire Connect, run the following command:

pip install datawire-quark

Datawire Connect also includes core runtimes for each supported language and several runtime integrations that allow communication-related features of Datawire Connect to work in various languages and frameworks. More information about the runtime integrations and how to install them can be found on the next page of this documentation. The Python version of the core runtime is automatically installed by the base Quark installation above and the Java version will be installed automatically when needed, but you may need to manually install the Javascript core runtime if you aren’t using the node runtime integration (if you are, it will be automatically installed when the node runtime integration is installed). To install the Javascript core runtime directly, run the following command:

npm install datawire-quark-core