Lumify

Lumify is an open source big data analysis and visualization platform. Please see http://lumify.io for more details and videos.

Getting Started

To get started quickly, you can try out a hosted installation of Lumify, or download a virtual machine image with Lumify installed and pre-configured.

• Try Lumify Now
• Watch Lumify Videos

Quick Start

1. Install Docker per their instructions: https://docs.docker.com/installation

2. Install node and npm per their instructions: http://nodejs.org/

3. Clone the Lumify repo:

   git clone https://github.com/lumifyio/lumify.git

   This will clone the repo to a lumify directory in your current working directory. This absolute path will be referred to as <cloned_repo_dir> for the remainder of these steps.

4. Install the Lumify npm dependencies:

   cd <cloned_repo_dir>/web/war/src/main/webapp
   npm install -g inherits bower grunt
   npm install -g grunt-cli

5. Update your hosts file:

   • Linux

     echo '127.0.0.1 lumify-dev' >> /etc/hosts

   • OS X

     echo "$(boot2docker ip 2>/dev/null) lumify-dev" >> /etc/hosts

6. Create the docker image:

   cd <cloned_repo_dir>
   docker/build-dev.sh

7. Run the docker image: (This will start ZooKeeper, HDFS, YARN, ElasticSearch, and RabbitMQ)

   docker/run-dev.sh

8. Run the web server. Choose one of the following:

   • Run in the docker image
   • Run locally in an IDE

See docker/README.md for more information on the docker dev image.

See docs/developer.md for more information on developing for Lumify.

See datasets for sample datasets to get started.

Developing / Contributing

If you're a system administrator or developer looking to install your own instance of Lumify or do custom development, please read our Developer Guide.

License

Copyright 2014 Altamira Technologies Corporation

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.