Wiki

Clone wiki

jummp / start

Starting Jummp in Development Mode

This document describes how to start JUMMP in development mode for the first time. For a list of prerequisites, please consult Installation and follow the guidelines below in order to avoid any issues.

Setting up JUMMP core

  • Clone JUMMP
  • Create database user for JUMMP. Please consult your database server's manual on instructions on how to do that.
  • Create a configuration file called .jummp.properties in your home directory. A sample file can be found here.
  • Run grails run-app in the base folder, this will install the required plugins
  • When console logs out "Server running. Browse to http://localhost:8080/jummp" navigate to that resource to configure JUMMP. JUMMP should now be configured correctly.

Creating Users

JUMMP uses Spring Security Core for authentication and authorisation. This entails that the database contains the following tables: * user - for user-related information * role - which defines the roles a user can have * user_role - for defining which user has which role

In JUMMP there are two main roles: 'ROLE_USER' and 'ROLE_ADMIN'. Populate your 'role' table to reflect this i.e. by running

INSERT INTO `role`(`id`, `version`, `authority`) VALUES (1, 0, 'ROLE_USER');
INSERT INTO `role`(`id`, `version`, `authority`) VALUES (2, 0, 'ROLE_ADMIN');

The version column is contains a timestamp, and is used by Grails to detect changes. Now create a user by running the following SQL script

INSERT INTO `user`(`id`, `version`, `account_expired`, `account_locked`, `email`, `enabled`, `password`, `password_expired`, `password_forgotten_code`, `password_forgotten_invalidation`, `registration_code`, `registration_invalidation`, `user_real_name`, `username`) VALUES (0,0,0,0,'your_email@example.com',1,sha2('your_password',256),0,NULL,NULL,NULL,NULL,'Darth Vader','your_username');
INSERT INTO `user_role`(`role_id`, `user_id`) VALUES (1,1);
INSERT INTO `user_role`(`role_id`, `user_id`) VALUES (2,1);

You should now have admin rights.

Updated