Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Blueriq Model Analyzer consists out of three components: Blueriq Sonar Plugin, Blueriq Sonar Scanner, Blueriq Sonar Quality Gate. This page will explain how to install and setup all of these component.

Installation requirements

All of the components require the Java to be available on the machine from where the components are ran. You can either install Java with a Java Installer, which makes Java globally available on your system, or you can extract Java to a specific folder. This installation manual will provide information for both options. Make

Install requirements

Install Java

Java needs to be installed on the machine on which analysis will be carried out. To make sure Java is installed on your machine, you can open a command prompt and type

java –version 

If Java is installed you will be prompted with the installed Java version, like this:

Image Removed

If Java is not installed on your machine, you can download it from https://java.com/nl/download/  and follow instructions  from there.

Make sure you download the correct Java version (32/64bit)

Install Sonarqube

. See the Blueriq Model Analyzer Platform Support page which version of Java is support for your Blueriq Model Analyzer version.

Blueriq Sonar Plugin

The Blueriq Sonar Plugin is a plugin for SonarQube, which makes it possible to perform an analysis on you Blueriq Models created in the Blueriq Studio. The Blueriq Sonar Plugin needs to be placed inside a SonarQube instance. This manual will provide information on how to install SonarQube and how to place the Blueriq Sonar Plugin in the correct directory of Sonarqube so it becomes available.

Installing Sonarqube

Download SonarQube from httpsSonarQube can be downloaded from http://www.sonarqube.org/downloads/.

Select the supported version mentioned in Blueriq Model Analyzer Platform Support, and store it on your machine. Unzip the downloaded zip-file to the destination folder of your choice. The contents of the unzipped folder should look like this:

Info

Install Maven

Apache Maven can be downloaded from https://maven.apache.org/download.cgi

Select the download of your choice, and store it on your machine. Then, unzip the downloaded zip-file to the destination folder of your choice. The contents of the unzipped folder should look like this:

Image Removed

Add maven to path

to be able to run sonarqube analysis you need to add maven to your path. This is done by opening a command prompt window in administrator mode and typing the following command:

Code Block
languagevb
themeMidnight
titleAdministrator: Command Prompt
setx path "%path%;<maven installation location>\bin"

Install Blueriq Model Analyzer for Sonarqube

titleConfiguring Java

If you do not Java globally available on your system, you will need to set the path to the installation directory of Java. This can be done by editting the wrapper.conf file which is located in the conf directory of your SonarQube installation folder. 

Below is an example of how the wrapper.conf should look when you Java installation folder is located here: C:\Program Files\Java\jdk-11.0.2

Code Block
languagetext
titlewrapper.conf
# Path to JVM executable. By default it must be available in PATH.
# Can be an absolute path, for example:
#wrapper.java.command=/path/to/my/jdk/bin/java
wrapper.java.command=C:/Program Files/Java/jdk-11.0.2/bin/java

...

Installing Blueriq Sonar Plugin in Sonarqube

The Blueriq Sonar Plugin The Blueriq Model Analyzer plugin called bma-sonar-plugin.jar needs to be placed inside the SonarQube directory in installation directory of SonarQube. Navigate to the subdirectory called extensions/plugin , for instance /sonarqube-5.6.6/extensions/pluginsinside the installation directory of SonarQube, and copy the bma-sonar-plugin.jar into the directory.

Note

Only copy the bma-sonar-plugin

Note

Do not copy bma-qualitygate-installer-#.jar to extensions/plugin. This will prevent SonarQube from starting up.

After installation

If any non SonarQube plugin jars are placed into the extensions/plugin directory, Sonarqube will to start.

Running SonarQube

When the Blueriq Sonar Plugin When the Blueriq Model Analyzer plugin is in place, start the SonarQube service by running the StartSonar.bat in the subdirectory of the bin folder corresponding to your operating system. For instance /sonarqube-5.6.6/bin/windows-x86-x64

...