Clone wiki

Ubicon / Home


Ubicon is a platform for ubiquitous and social networking. The system provides several applications organized in different event categories:

  • MyGroup: A ubiquitous system for supporting social networking in working groups
  • Conferator: A social conference guidance system, managing your contacts and conference schedule
  • AirProbe: A system for collecting information on air pollution being applied by the EveryAware EU project
  • WideNoise: A noise pollution collection system being applied by the EveryAware EU project

Start for Developers

The following technologies are in use:

  • Open or Oracle JDK 7
  • Tomcat 7
  • MySQL 5.5/5.6
  • Maven Integration (m2e)
  • Eclipse IDE for Java EE Developers or IntelliJ IDEA
  • Spring IDE Core
  • Lombok

Full installations guidelines for developers

  • Make sure that you have installed Java JDK and JRE
  • Install MySQL Server and MySQL Workbench according instructions for your OS
  • Download, install and start Tomcat. After starting check if the page localhost:8080 is working properly.
  • Install Eclipse or IntelliJ IDEA and integrate Spring IDE Core, Maven and Tomcat.
  • Download lombok.jar from Project homepage and run java -jar lombok.jar . Choose the IDE(eclipse or idea) that you use and press 'install/update' and restart the IDE . Usually it's not necessary to add lombok.jar to the project.

    Advice for Windows User

    I recommend windows user to install XAMPP to manage MySQL Server and Tomcat.

    Making Project run

    • Integrate Mercurial to your IDE for checking out the project.
    • Go to Mercurial Repositories and create repository.
    • Enter URL:, where YOURUSERNAME is your Bitbucket-login and give your password (Bitbucket password), press 'Finish'.
    • Than clone the repository that you created
    • Next import Maven-project of the checked out project (Choose 'Existing Maven Projects', select all maven projects and press 'Finish').
    • Next build Maven Project: click with the right mouse button on eu.ubicon, choose 'Run as -> Maven Build...'. In the window in the field 'Goals' type 'clean install'(you may choose an option 'Skip Tests'), press 'Apply' and than 'Run'.

Assume, you have the software listed above running, you need to perform the following steps:

  • Replace existing context.xml in conf directory of your Tomcat with the one from the repository (please, adjust settings if needed): eu.ubicon.webapp/src/main/webapp/META-INF/context.example.xml
  • set tomcat users in conf/tomcat-users.xml (show the example below it how a tomcat's user can be create)
  • increase the tomcat upload file size limit to 102428800 Byte in /PATH/TO/YOUR/TOMCAT/webapps/manager/WEB-INF/web.xml
  • Create Ubicon-user in your database:

mysql> CREATE USER 'ubicon'@localhost IDENTIFIED BY 'ubicon';

mysql> exit;

  • Initialize the database (In this step you can use MySQL Workbench):

$ /usr/local/mysql/bin/mysql -u root -p < /PATH/TO/YOUR/WORKSPACE/eu.ubicon/eu.ubicon.database/src/main/resources/scripts/mysql_create_ubicon_database.sql

$ /usr/local/mysql/bin/mysql -u root -p -D ubicon < /PATH/TO/YOUR/WORKSPACE/eu.ubicon/eu.ubicon.database/src/main/resources/scripts/mysql_create_tables.sql

$ /usr/local/mysql/bin/mysql -u root -p -D ubicon < /PATH/TO/YOUR/WORKSPACE/eu.ubicon/eu.ubicon.database/src/main/resources/scripts/mysql_create_initial_data.sql

  • Create database for the test system:

$ /usr/local/mysql/bin/mysql -u root -p < /PATH/TO/YOUR/WORKSPACE/eu.ubicon/eu.ubicon.database/src/main/resources/scripts/mysql_create_test_database.sql

$ /usr/local/mysql/bin/mysql -u root -p -D ubicon_junit < /PATH/TO/YOUR/WORKSPACE/eu.ubicon/eu.ubicon.database/src/main/resources/scripts/mysql_create_tables.sql

$ /usr/local/mysql/bin/mysql -u root -p -D ubicon_junit < /PATH/TO/YOUR/WORKSPACE/eu.ubicon/eu.ubicon.database/src/main/resources/scripts/mysql_create_initial_data.sql

  • Grant the user the priviligies for working with the database:

$ /usr/local/mysql/bin/mysql -u root -p

mysql> GRANT SELECT, INSERT, UPDATE, DELETE ON ubicon.* TO 'ubicon'@'localhost';

mysql> GRANT SELECT, INSERT, UPDATE, DELETE ON ubicon_junit.* TO 'ubicon'@'localhost';

  • run maven clean install to build the application.