Skip to content

eXist-db/usermanager

eXist-db User Manager app

Rewrite of original eXist-db user manager that came as a plugin of dashboard.

UserManager 2 comes as a standalone application and is not dependent on dashboard any more.

User Manager is accessible for users of the 'dba' group exclusively.

Installation

Use the eXist-db Package Manager to install the app from public repo. This will always the latest and greatest.

Development Setup

Note: this section is only relevant if you like to build User Manager yourself to apply your own modifications.

This app requires NodeJS and Polymer CLI for creating optimized production builds of the application.

For development purposes you can simply call ant to create a xar.

  1. make sure you have NodeJS installed. See 'notes on setting up nodejs' below for help.
  2. execute npm install to load dependencies
  3. excecute polymer to make sure you have Polymer CLI installed (should be 1.3.1 or up). If you need to install it first execute npm install -g polymer-cli
  4. execute bower install

Tooling

If you have installed NodeJS you can make use of following gulp commands:

gulp watch - will watch your local files and auto-deploy to the db when changed. gulp deploy to push all local files to the db.

Note: you must have installed the xar application once in the database before running these commands. gulp will not create the app in the db itself but just update it if it's there.

Building

To create an optimized build execute:

ant production-xar

Notes on setting up nodejs

Note: This is a one-timer - you can skip this step if you got mpm on your system already.

Though not strictly required for development it is recommended that you have an installation of nodejs on your system. It is recommended to use 'nvm' to install nodejs as this eases the process of installation and allows to keep different versions of it on your system without conflicts.

Nodejs is used within this project to drive the gulp tasks and handle client-side dependencies with bower.

Please refer to the nvm page for installation instruction or use an installation method described on the nodejs.org homepage.