Skip to end of metadata
Go to start of metadata

Install software


  • Java 11
    • Set environment variable JAVA_HOME=<path to java jdk directory>
    • Add %JAVA_HOME%\bin to your PATH environment variable
  • Eclipse IDE 2018‑12. Download and run the installer and choose "Eclipse IDE for Java EE Developers."
  • From the Eclipse Marketplace, install the following:
    • Spring Tools 4 from the Eclipse Marketplace
    • EGit 5.2..0
    • Buildship Gradle Integration 3.0
    • Groovy Development Tools 3.3. 0. SNAPSHOT
    • SonarLint
  • Git
  • MariaDB
    • Install with default character encoding UTF8
    • Add the bin directory of MariaDB to the PATH environment variable
    • Set the following environment variables:
      • YONA_DB_URL=jdbc:mariadb://localhost:3306/yona
      • YONA_DB_USER_NAME=<user name of your choice, e.g. root)
      • YONA_DB_PASSWORD=<password of the above user>


Set up Eclipse

Add Java code style

In order to use a consistent code style throughout the sources of Yona you should import the attached code style in your Eclipse. To do this:

  • Download the file YonaCodestyle.xml
  • Import it into Eclipse by going to Preferences -> Java -> Code Style -> Formatter:
  • From your source files you can press Ctrl-Shift-F to format the code

To enable code formatting, go to Preferences -> Java -> Editor -> Save Actions and click the Configure Workspace Settings link:


Select the "Perform the selected actions on save" and "Format source code' and 'Organize imports" check boxes and Additional actions as shown in the screen shot.

Configure Groovy code style

The code formatter for Groovy is quite limited. Configure it this way:

And configure the save actions:

Configure SonarLint

Open the SonarLint Bindings view:

Right-click and choose New server connection

  • Choose SonarQube
  • Choose the token authentication method, log on to the server, generate a token and paste it in Eclipse
  • Name the connection Yona SonarQube
  • Bind all Yona projects to this connection
  • Select the SonarQube project YonaServer

Set up environment

  • Clone the repository

    git clone
  • Create eclipse projects:

    gradlew eclipse
  • Import the projects into your workspace in Eclipse:
    • File --> Import
    • Existing projects into workspace
    • Select the yona-server folder
    • Check the box "Search for nested projects"
    • Do not check the box "Copy projects into workspace"
    • Click finish
  • Add the following entries to the hosts file ( /etc/hosts on Linux or C:\Windows\System32\drivers\etc\hosts on Windows):       log          # The logging server, only used when running from Docker 
  • Add the scripts directory to PATH
  • No labels