Skip to content
Lightweight Open Source Business Intelligence and reporting tool for PostgreSQL, MySQL, SQL Server, Oracle Database & BigQuery
Branch: master
Clone or download
Pull request Compare This branch is 366 commits ahead of widestage:master.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode
config Finish renaming widestage to urungi Sep 18, 2018
dist Update FontAwesome to 4.7.0 Mar 8, 2019
email_templates Add htmlhint and fix htmlhint errors Mar 11, 2019
language Add french translation and a language selector Jan 31, 2019
migrations
public Set pagination cursor as a pointer. Mar 20, 2019
script
server Add a countDistinct aggregation. Mar 20, 2019
shared Fix layers integrity and remove useless properties Feb 18, 2019
test SQL test updated according to fix-SQL previous patch. Mar 20, 2019
views
.editorconfig
.eslintignore
.eslintrc.js Remove global variable app Mar 11, 2019
.gitignore
.htmlhintrc
.stylelintrc.js
.travis.yml Cleanup .travis.yml and set explicit nodejs versions Mar 1, 2019
README.md
app.js Fix layers integrity and remove useless properties Feb 18, 2019
gulpfile.js
license.txt
migrate-mongo-config.js
package-lock.json
package.json
server.js Extract express app code from server.js to app.js Oct 19, 2018

README.md

Urungi

Lightweight Business Intelligence tool for reporting MongoDB, PostgreSQL, MySQL and others, see Supported databases

Supported databases

  • MongoDB
  • PostgreSQL
  • MySQL
  • MS SQL Server
  • Oracle
  • Google Big Query

Requirements

MongoDB is used to store Urungi metadata, you have to install it even if you are not going to explore MondoDB data.

Installation

  1. Install the requirements listed above

  2. Clone the github repository

    git clone https://github.com/biblibre/urungi.git
    cd urungi
    
  3. Download and install dependencies

    npm ci
    

Configuration

Urungi uses config to manage its configuration files.

You can change the configuration by creating a file in config/ directory named local-{env}.js (where {env} is one of: production, development) and overriding any properties defined in config/default.js

More info at https://github.com/lorenwest/node-config/wiki/Configuration-Files

Oracle connections

If you are going to use oracle connections, first you need to install in your server the Oracle instant client and then run:

npm install oracledb

More info at https://github.com/oracle/node-oracledb

Starting up the Urungi server

  1. Launch the server

    npm start
    
  2. Point your browser to your ip/server name (eg. http://localhost:8080)

  3. Enter the credentials

    • Username: administrator
    • Password: urungi
  4. Enjoy!!!

Upgrade

To upgrade Urungi to the latest version, follow these steps:

  1. Update sources

    git pull --rebase
    
  2. Update dependencies

    npm ci
    
  3. Update database

    npx migrate-mongo up
    
  4. Restart the server

Tests

Build Status

To run the tests:

npm test

Some tests need SQL databases to connect to. To run those tests, copy config/test.js to config/local-test.js and modify the configured datasources accordingly. If database servers are not available, tests will be skipped.

License

GPL 3.0

You can’t perform that action at this time.