Installation

Installing lymph itself (for Python 2.7 or 3.4) is as simple as:

pip install lymph

Yet, in order to make full use of lymph you’ll also need to install lymph’s dependencies: ZooKeeper (for service discovery) and RabbitMQ (for events) and have them running.

If these are already set up, you can skip straight and continue the next chapter.

Installing dependencies

The RabbitMQ server’s default configuration is enough for development and testing. For detailed information on how to configure ZooKeeper refer to the ZooKeeper webpage and the Getting Started Guide. However, it’s default configuration should also be enough.

On Ubuntu

If you haven’t already install Python essentials:

$ sudo apt-get install build-essential python-dev python-pip

Install and start ZooKeeper using:

$ sudo apt-get install zookeeper zookeeperd
$ sudo service zookeeper start

ZooKeeper’s configuration file is located at /etc/zookeeper/conf/zoo.cfg.

Install and start the RabbitMQ server:

$ sudo apt-get install rabbitmq-server
$ sudo service rabbitmq-server start

On OSX

Install RabbitMQ and ZooKeeper:

$ brew install rabbitmq zookeeper

ZooKeeper’s configuration file is located at /usr/local/etc/zookeeper/zoo.cfg.