Vipra

The Vipra application is a topic modeling based search system with a frontend web application, a backend REST service and a maintenance tool for data import and modeling. It attempts to leverage automatically discovered topic informations in document collections to ease collection browsing and organization. The search system relies on ElasticSearch and Apache Lucene.

This application was created by Eike Cochu for his master's degree thesis in computer science, 2015-2016 at the Freie Universität in Berlin, Germany.

Components

• vipra-backend: Backend application that connects to the database, filebase and search engine.
• vipra-cmd: Backend utility tool to import and manage backend services.
• vipra-ui: Frontend user interface that connects to the backend REST service.
• vipra-util: Shared libraries and classes for backend applications and utility tools.

Installation

1. If MongoDB or ElasticSearch run on different servers that the JavaEE application server, then the configuration files need to be changed. Change config.properties file
2. in vipra.war: Open vipra.war in an archive program, navigate to /WEB-INF/classes and edit config.properties file appropriately.
3. in vipra-cmd.jar: Open vipra-cmd.jar and edit config.properties file appropriately.
4. Test connection by running ./vipra -t
5. Copy vipra.war to your JavaEE application server

Development

Requirements

Run dependencies

• Java (8+)
• MongoDB (2.6+)
• ElasticSearch (2.1+)
• DynamicDTM
• JavaEE Application Server, e.g. Tomcat (8+)

Additional build dependencies

• Maven (3+)
• Gulp (3.9+)
• Bower (1.7+

Build

1. Clone this repository to ./vipra
2. Navigate to ./vipra
3. Execute ./build.sh to build all projects
4. Copy vipra-backend/target/vipra.war to your JavaEE application server
5. Test connections by running ./vipra -t