Package: sinfonier-api
# Sinfonier API![Figure 1 - Sinfonier Simple View](docs/images/SinfonierSimple.png "Figure 1 - Sinfonier Simple View")Sinfonier API was develop to manage [Sinfonier Backend](https://github.com/sinfonier-project/sinfonier-backend) and deal with Apache Storm cluster. This software is part of [Sinfonier-Project](http://sinfonier-project.net)Sinfonier:> Sinfonier is a change in the focus in respect to current solutions in the area of processing information in real-time. We combine an easy-to-use interface, modular and adaptable, and we integrate it with an advanced technological solution to allow you to do the necessary tune up suitable for your needs in matters of information security.Apache Storm:> Apache Storm is a free and open source distributed realtime computation system. Storm makes it easy to reliably process unbounded streams of data, doing for realtime processing what Hadoop did for batch processing. Storm is simple, can be used with any programming language, and is a lot of fun to use!# Description* Compile modules* Manage Sinfonier Backend classpath* Start/Stop Storm toplogies* Storm Log management# Installation## OS dependencies**Centos**:```bash$ sudo yum install python-crypto```**Debian / Ubuntu**:```bash$ sudo apt-get install python-crypto```## Python dependencies```bash$ sudo pip install -r requirements.txt```# Configuration## Associated servicesIn `config.py`:**MONGO CONFIG**```pythondefine("port", default=8899, help="run on the given port", type=int)define("concurrency", default=0, help="num of proceess", type=int)define("mongo_host", default="localhost", help="sinfonier database host")define("mongo_database", default="sinfonier", help="mongo database name")define("mongo_collection", default="topologies", help="mongo collection name")```**STORM CLUSTER GLOBAL CONFIG**```pythondefine("storm_binary", default="<STORM_PATH>/bin/storm", help="storm binay")define("storm_global_jar_path", default="/var/storm/lastjar/", help="storm binary path")define("storm_global_jar_bin", default="sinfonier-community-1.0.0.jar", help="storm binay")```**TOPOLOGIES CONFIG**```pythondefine("storm_topology_path", default="/var/storm/topologies/", help="storm xml path")define("storm_topology_config_path", default="/config/", help="storm topology config folder")define("storm_topology_data_path", default="/data/storm/topologies/", help="topologies data path")define("storm_topology_jar_path", default="/jar/", help="storm topology config folder")```**FOLDER STRUCTURE**/var/storm/topologies/{topologyName}/config/{topologyName}.xml**MAVEN CONFIG**```pythondefine("maven_binary", default="<MAVEN_PATH>/bin/mvn", help="maven binay")define("maven_sinfonier_pom", default="/var/storm/src/sinfonier_backend/pom.xml", help="maven pom")define("maven_sinfonier_m2_pom", default="/var/storm/src/sinfonier_backend/m2-pom.xml", help="maven m2-pom")```**STORMBACKEND**```pythondefine("backend_working_path", default="/var/storm/src/sinfonier_backend/", help="backend path")define("backend_python_path", default="/var/storm/src/sinfonier_backend/multilang/resources/", help="backend python path")define("backend_java_path", default="/var/storm/src/sinfonier_backend/src/jvm/com/sinfonier/", help="backend java path")define("backend_java_path_drains", default="/var/storm/src/sinfonier_backend/src/jvm/com/sinfonier/drains/", help="backend drains")define("backend_java_path_bolts", default="/var/storm/src/sinfonier_backend/src/jvm/com/sinfonier/bolts/", help="backend bolts")define("backend_java_path_spouts", default="/var/storm/src/sinfonier_backend/src/jvm/com/sinfonier/spouts/", help="backend spouts")```**API TEMPLATES**```pythondefine("backend_template_path", default="/opt/sinfonier-api/templates/", help="API templates")```**GIST CREDENTIALS**```pythondefine("gist_api_token",default="<YOUR_GIST_TOKEN>",help="gist api token")define("gist_username",default="<GIST_USER>",help="gist username")```## LoggingYou can customize the logging path setting the environment var:```bash# export SINFONIER_LOG="/var/log/sinfonier-log"```**Make sure the log folder exits**, if not, app will crash.# Deploy## From source```bash$ cd /opt$ git clone https://github.com/sinfonier-project/sinfonier-api.git$ python sinfonierapicore.py```## From Pypi (RECOMENDED)```bash# pip install sinfonier-api# sinfonier-api```## Using Docker```bash# docker build -t sinfonier:api .Sending build context to Docker daemon 816.6 kBStep 1 : FROM python:2.7---> a047e3d0ae2bStep 2 : MAINTAINER Sinfonier Project---> Using cache---> be5b52b240e5....# docker run -t sinfonier:api```## Project leads* Francisco J. Gomez @ffranz https://github.com/ffr4nz/* Alberto J. Sanchez @ajsanchezsanz https://github.com/ajsanchezsanz## Committers* Eva Suarez @EvaSuarez22* Pedro J. Martinez @pejema44* Daniel García (cr0hn) - @ggdaniel## Contributors## LicenseApache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0## References* http://www.tornadoweb.org/en/stable/* http://storm.apache.org/* https://maven.apache.org/