Overview

Enable SSH Access

Eclipse Kura™ Installation

Development Environment Installation

Overview

This section provides Eclipse Kura™ quick installation procedures for the Raspberry Pi and the Kura development environment.

Note:

This quickstart will install the version of Kura with the administraive web UI and netwowrk configuration support but not CAN support. For more information on this please visit the Eclipse Kura download page

This quickstart has been tested using the following image:

2016-11-25-raspbian-jessie-lite.img

downloaded from

https://www.raspberrypi.org/downloads/raspbian/

and with the NOOBS image installed on the sdcard bundled with the Raspberry Pi 3.

Enable SSH Access

The ssh server is disabled by default on Raspbian images released after November 2016, in order to enable it follow the instructions available at the following URL:

https://www.raspberrypi.org/documentation/remote-access/ssh/

Eclipse Kura™ Installation

Note:

The last Raspbian Stretch adopts the new Consistent Network Device Naming. To correctly run Eclipse Kura on the Raspberry Pi, it should be disabled adding the net.ifnames=0 parameter at the end of the /boot/cmdline.txt file.

To install Kura with its dependencies on the Raspberry Pi, perform the following steps:

  1. Boot the Raspberry Pi with the latest Raspbian image (starting from release 2.1.0 Kura only supports Debian 8 or above).

  2. The dhcpcd5 package is not compatible with Kura and needs to be removed performing the following command:

    sudo apt-get purge dhcpcd5
  3. NetworkManager conflicts with Kura network management, make sure that it is not installed performing the following command:

    sudo apt-get remove network-manager

    In the latest Raspbian releases, type the following command to disable the network manager:

    sudo systemctl disable networking
  4. In the latest raspbian releases, the wireless interface is disabled by default. Type the following command to enabled it:

    sudo rfkill unblock all
  5. Install the gdebi command line tool:

    sudo apt-get update
    sudo apt-get install gdebi-core
  6. Make sure that Java 8 is installed with

    java -version

    if not install OpenJDK 8 performing the following command:

    sudo apt-get install openjdk-8-jre-headless
  7. Download the Kura package with:

    wget http://download.eclipse.org/kura/releases/<version>/kura_<version>_raspberry-pi-2-3_installer.deb

    Note: replace <version> in the URL above with the version number of the latest release (e.g. 2.1.0).

  8. Install Kura with: 

    sudo gdebi kura_<version>_raspberry-pi-2-3_installer.deb
  9. Reboot the Raspberry Pi with:

    sudo reboot

    Kura starts on the target platform after reboot.

  10. Kura setups a local web ui that is available using a browser via:

<pre>http://&lt;device-ip&gt;</pre>

Default **username** is:

<pre>admin</pre>

Default **password** is:

<pre>admin</pre>

Development Environment Installation

User Workspace

To set up the development environment for Eclipse Kura, perform the following steps:

  1. Download and install JDK SE 8 as appropriate for your OS (if it is not already installed). For Windows and Linux users, the JDK can be downloaded from Java SE 8 Downloads. Use the latest version of Java SE Development Kit.
  2. Download and install the Eclipse IDE for Java EE Developers from the Eclipse download site.
  3. Download the Kura user workspace archive from the Eclipse Kura download site.
  4. Import the Kura workspace zip file into the new Eclipse project development environment.
  5. Begin developing Kura-based applications for your target platform.

Oomph Installer

  1. Start the Eclipse Installer
  2. Switch to advanced mode (in simple mode you cannot add the custom installer)
  3. Select “Eclipse for Committers” and select a JRE 1.8+ -> Next
  4. Add a new installer by URL: https://raw.githubusercontent.com/eclipse/kura/develop/kura/setups/kura.setup -> Check and next
  5. Update Eclipse Kura Git repository’s username (HTTPS, link to your fork) and customize further settings if you like (e.g. Root install folder, Installation folder name) -> Next
  6. Leave all Bootstrap Tasks selected -> Finish
  7. Accept the licenses and unsigned content
  8. Wait for the installation to finish, a few additional plugins will be installed
  9. At first startup Eclipse IDE will checkout the code and perform a full build
  10. A few Working Sets will be prepared