Skip to content

Commit

Permalink
Add Artful Aardvark Support
Browse files Browse the repository at this point in the history
Adds supporting documentation for Artful Aardvark in the "From Source"
section.
  • Loading branch information
JONBRWN committed May 8, 2018
1 parent 17412c6 commit 6d37f01
Show file tree
Hide file tree
Showing 3 changed files with 54 additions and 9 deletions.
32 changes: 28 additions & 4 deletions book/getting-started/linux-setup.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Setting Up Your Ubuntu Environment for Wallaroo

These instructions have been tested for Ubuntu Trusty and Xenial releases.
These instructions have been tested for Ubuntu Artful, Trusty, and Xenial releases.

There are a few applications/tools which are required to be installed before you can proceed with the setup of the Wallaroo environment.

Expand Down Expand Up @@ -88,7 +88,7 @@ sudo update-alternatives --install /usr/bin/gcc gcc \
In order to install `ponyc` and `pony-stable` via `apt-get` the following keyserver must be added to the APT key management utility.

```bash
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys "D401AB61 DBE1D0A2"
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys D401AB61 DBE1D0A2
```

### Installing ponyc
Expand All @@ -115,7 +115,7 @@ sudo apt-get -V install pony-stable

Wallaroo's Kakfa support requires `libsnappy` and `liblz` to be installed.

### Xenial Ubuntu:
### Artful and Xenial Ubuntu:

```bash
sudo apt-get install -y libsnappy-dev liblz4-dev
Expand Down Expand Up @@ -166,6 +166,19 @@ Machida is the program that runs Wallaroo Python applications. Change to the `ma

```bash
cd ~/wallaroo-tutorial/wallaroo/machida
```

### Compiling on Artful

Due to ponyc's dependence on PIC on Artful Ubuntu, all applications must be compiled with the `PONYCFLAGS="--pic"` flag, like so:

```bash
make PONYCFLAGS="--pic"
```

### Compiling on Trusty and Xenial

```bash
make
```

Expand All @@ -175,10 +188,21 @@ Giles Sender is used to supply data to Wallaroo applications over TCP, and Giles

The Cluster Shutdown tool is used to instruct the cluster to shutdown cleanly, clearing away any resilience and recovery files it may have created.

To compile all three, run
Change to the root Wallaroo directory:

```bash
cd ~/wallaroo-tutorial/wallaroo/
```

### Compiling Giles Sender, Receiver, and the Cluster Shutdown tool on Artful

```bash
make build-giles-all build-utils-cluster_shutdown-all PONYCFLAGS="--pic"
```

### Compiling Giles Sender, Receiver, and the Cluster Shutdown tool on Trusty and Xenial

```bash
make build-giles-all build-utils-cluster_shutdown-all
```

Expand Down
22 changes: 17 additions & 5 deletions book/go/getting-started/linux-setup.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Setting Up Your Ubuntu Environment for Wallaroo

These instructions have been tested for Ubuntu Trusty and Xenial releases.
These instructions have been tested for Ubuntu Artful, Trusty, and Xenial releases.

There are a few applications/tools which are required to be installed before you can proceed with the setup of the Wallaroo environment.

Expand Down Expand Up @@ -120,7 +120,7 @@ sudo apt-get -V install pony-stable

Wallaroo's Kakfa support requires `libsnappy` and `liblz` to be installed.

### Xenial Ubuntu:
### Artful and Xenial Ubuntu:

```bash
sudo apt-get install -y libsnappy-dev liblz4-dev
Expand Down Expand Up @@ -165,12 +165,24 @@ Giles Sender is used to supply data to Wallaroo applications over TCP, and Data

The Cluster Shutdown tool is used to instruct the cluster to shutdown cleanly, clearing away any resilience and recovery files it may have created.

To compile all three, run
Change to the root Wallaroo directory:

```bash
cd ~/wallaroo-tutorial/wallaroo/
make build-giles-all build-utils-cluster_shutdown-all \
build-utils-data_receiver-all
```

### Compiling Giles Sender, Receiver, and the Cluster Shutdown tool on Artful

Due to ponyc's dependence on PIC on Artful Ubuntu, all applications must be compiled with the `PONYCFLAGS="--pic"` flag, like so:

```bash
make build-giles-all build-utils-cluster_shutdown-all PONYCFLAGS="--pic"
```

### Compiling Giles Sender, Receiver, and the Cluster Shutdown tool on Trusty and Xenial

```bash
make build-giles-all build-utils-cluster_shutdown-all
```

## Register
Expand Down
9 changes: 9 additions & 0 deletions book/go/getting-started/run-a-wallaroo-go-application.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,6 +65,15 @@ cd ~/wallaroo-tutorial/wallaroo/examples/go/celsius
make
```

### Compiling for Artful Ubuntu

Due to ponyc's dependence on PIC on Artful Ubuntu, all applications must be compiled with the `PONYCFLAGS="--pic"` flag, like so:

```bash
cd ~/wallaroo-tutorial/wallaroo/examples/go/celsius
make PONYCFLAGS="--pic"
```

Now start up the "Celsius to Fahrenheit" application.

```bash
Expand Down

0 comments on commit 6d37f01

Please sign in to comment.