Difference between revisions of "CI"

Revision as of 13:27, 30 October 2017

Info about our CI and Test Automation server to be posted here.

All subpages need to be subpages of www.openmbd.com/wiki/CI (e.g. www.openmbd.com/wiki/CI/Jenkins or www.openmbd.com/wiki/CI/SonarQube, etc.)

How to set-up Jenkins to build and test HANtune?

In order to install Jenkins, first the executable will need to be downloaded from the site of Jenkins

Press the download button. A pop-up menu will appear. From the menu select LTS Release (2.73.1) and click on the arrow, select Windows.

Then unzip the file that where downloaded and then click the executable. The installation process is going to start. Then follow the installation wizard. Choose the path where you want to install Jenkins. After the installation is over, open the webbrowser and type localhost:8080. It will direct to page as shown on the picture below.

Here will be asked to enter the password located in the C:\Program Files (x86)\Jenkins\secrets\initialAdminPassword (this is an example).

Once finded the password, copy and paste it under Administrator password. Then press continue. After this press install suggested plugins.

After the suggested plugins are installed a window will appear where the username, the password, full name, and email address must be set. After all this information was filled in click Save and finish. In the next window that will appear press Start using Jenkins. After this the Jenkins Dashboard will appear and will be similar with the picture below.

After this, Manage Jenkins needs to be clicked. A menu will show up and is going to look like the picture below.

From the list the button Manage Plugins needs to be selected. The following plugins will need to be installed:

• Locale Plugin;
• Multijob Plugin;
• Shared Workspace;
• TestComplete support plug-in;
• SonarQube Scanner support for Jenkins.

In order to install the plugins from the menu (see picture below) the button Available needs to be selected.

After Available was selected, in the search box it needs to be typed the name of the plugin that it is desired by the user to be install. In this case for example the MultijobPlugin. After the name of the plugin is typed the menu will look like the picture below.

The box needs to be clicked and then ‘Install without restart’ needs to be pressed. Then there will appear another menu for example like the picture below.

The option restart “Jenkins when…” will need to be selected. Then the same procedure will need to be repeated for all the plugins listed in the list above. In case it doesn’t restart automatically a refresh of the page is necessary.

After the plugins are installed the following programs will need to be installed on the PC:

• Apache Ant 1.9.7
• TestExecute 12
• SonarQube 5.6.6
• SonarQube Scanner 3.0.3.778

How to install Apache Ant 1.9.7?

In order to install Apache-ant-1.9.7 the program needs to be downloaded from the following site.

On the page, click on the External Mirror (source) and the download will start.

The following link will explain how Apache Ant can be installed.

How to install SonarQube LTS (5.6.6) and SonarQube Scanner (3.0.3.778)?

SonarQube can be downloaded here.

SonarQube Scanner can be downloaded from the following link.

By clicking on Windows 64 bit as shown on the picture below, the download wil start.

The following steps must be followed to install SonarQube and SonarQube Scanner: For SonarQube:

In Command Prompt go to the map where SonarQube is installed and start the service, for example:

C:\Program Files\SonarQube\sonarqube-5.6.6\bin\windows-x86-64>StartSonar.bat

If the service is up, SonarQube is installed properly.

This can be checked by the following link: SonarQube.

On the picture below, on the left side of the screen it shows that the SonarQube server is successfully started.

To change the default port, under the header WEB SERVER in the file sonar.properties in the map from SonarQube, the # must be removed and now the sonar.web.port can be changed, for example to 5900.

For SonarQube Scanner:

The following link can be used to install SonarQube Scanner: SonarQube Scanner.

These settings must be filled in Jenkins (IN DE BUILD EN CONFIGURE)

After Apache Ant, SonarQube and SonarQube Scanner are installed, the next step is to further configure Jenkins.

Now ANT, JDK and Sonarqube need to be installed in Jenkins. In order to do this:

First the button Manage Jenkins in the Jenkins homepage must be pressed, then Global Tool Configuration must be clicked. Once the button Global Tool Configuration was clicked it will appear a menu that will look like the picture below.

The button JDK installations needs to be clicked. Then there will appear a menu that will look like the picture below.

In the "Name" cassette, the name of the JDK must be specified , an example can be seen in the picture above. Then in the cassette of "JAVA_HOME" must be specified the destination of the JDK.

In order to install SonarQube Scanner the button SonarQube Scanner installations must be pressed. After the button is pressed there is going to appear a screen something similar with the picture below.

The same procedure like in the case of the installation of the JDK must be applied for SonarQube Scanner. In the "Name" box must be typed the name of the SonarQube Scanner. In the "SONAR_RUNNER_HOME" must be typed the specified path of the SonarQube Scanner. An example can be seen in the above picture.

In order to install ANT the same procedure like in the case of JDK and SonarQube Scanner must be applied.

An example of how ANT needs to be installed in Jenkins can be seen in the picture above.

After the programs are installed the next step is to Configure Jenkins. The "Configure System" menu can be accessed using the following steps: Click "Manage Jenkins", then click "Configure system". The menu that will appear will look like the picture below.

Then the next step SonarQube server needs to be configured. In order to do this, where "SonarQube servers" is written, the button add SonarQube needs to be clicked. In the "Name" cassette the name of the SonarQube token needs to be filled. After the name was filled in, the "Server URL" of the SonarQube server must be specified. An example can be seen in the picture below.

To fill in the "Server authentication token", the token must be made in the SonarQube server. To log in the first time in the SonarQube server, for "Login" type admin and for "password" type also admin, as show in the picture below.

Now the password can be changed and the token can be made, by clicking on the log in name in the upper right corner (see picture below) and click on "My account".

Then go to "Security" and now the password can be changed (see picture above). After that, the token can be made by typing a name in block "Enter Token Name" and then click on Generate. Then there will be a code that must be copied and pasted in "Server authentication token" in Jenkins, in the configuration of SonarQube server. An example of the SonarQube token (with the code) can be seen in the picture below.

Then te location of jenkins must be specified, an example is shown below.

The next step is to set up the Workspace Sharing. The "Name" can be anyone the user desires. For "Repository URL" the repository must be filled in. An example can be seen in the picture below.

The last thing that it needs to be set is the E-mail Notification.

Example in case the user has google mail:

SMTP server: smtp.gmail.com

Default user e-mail suffix: @gmail.com

openmbd.com/wiki/CI/Jenkins

openmbd.com/wiki/CI/SonarQube