A persistence solution for Eiffel events. This repository is different than Eiffel Vici. This repository accepts live view of Eiffel events. The MongoDB, at backend, has trigger events. Whenever any event is added into the collection named "eiffel-events", the visualization is updated.
[Note]: All the events must be inserted in the collection named "eiffel-events" only one by one. You cannot insert more than one event at one time, due to the fact that it is a live visualization. This is also a major difference between original Eiffel Vici (https://github.com/eiffel-community/eiffel-vici) and Eiffel-store (this repository). Original Eiffel Vici takes a big JSON file full of Eiffel events as an argument and build a one-time visualization which is not a "Live Visualization". This repository takes Eiffel event one by one and build visualization gradually.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
- Clone the repository and open the shell and go to 'Visualization' folder.
- Run the following command in the 'Visualization' folder:
meteor
It can ask to install some nmp plugins, it is fine. Read through the error messages and install the missing plugins. If everything went fine, you will be able to see the app running on the following link:
localhost:3000
- Access the local instance of "mongo db" mostly running on 3001 port. The name of DB is "meteor". You can select some GUI tool to access database. If database is empty, follow step number 4.
- Create the following four collections (case-sensitive):
eiffel-events
eventfilter
events
eventsequences
tablerows
The app (localhost:3000) is ready to use, but nothing will appear on screen as there are no events in db. You have two options:
- Publish your events from CI to RabbitMQ Bus and connect RabbitMQ bus with Eiffel-store through MongoDB. Check the section "Connection to RabbitMQ Server" below.
- Copy-paste dummy events (one by one) from JSON file provided in this repository with the named "eiffelevents.json" to mongo db collection name "eiffel-events" in "meteor" database (Check Point Number 3 Above).
The Eiffel-store visualization is live. Insert Eiffel event into the collection named "eiffel-events" and refresh the webpage (localhost:3000) and you will see visualization. Keep inserting the events and visualization will keep linking events.
Your CI (e.g., Jenkins or Gerrit) can publish Eiffel events on your RabbitMQ Bus and you can connect RabbitMQ Bus with Eiffel-store by using the a small java code, written by me, on https://github.com/azeem59/rabbitmq-eiffel-store. This is a bridge between RabbitMQ Bus and Eiffel-store. By running this code, you can just publish events on RabbitMQ Bus and it will automatically appear in the Eiffel-store app. This code may have some errors. Please feel free to update the code or write your own bridge between RabbitMQ Bus and Eiffel-store