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 administrative web UI and network 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:

2019-07-10-raspbian-buster-lite.img

downloaded from

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

and with the NOOBS image installed on the sd card 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 to 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. After removing dhcpcd5 package you need to enable network interface(s) and ensure internet access. Follow the instructions here.

  4. Install the gdebi command line tool:

    sudo apt-get update
    sudo apt-get install gdebi-core
  5. 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
  6. 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. 4.1.0).

  7. Install Kura with: 

    sudo gdebi kura_<version>_raspberry-pi-2-3_installer.deb
  8. It could happen that ‘wlan’ interface is “soft blocked” by default and needs to be enabled. To see if it is blocked run:

    rfkill list

    and unblock it with:

    sudo rfkill unblock wlan
  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:

    https://<device-ip>

    The browser will prompt the user to accept the connection to an endpoint with an untrusted certificate: Untrusted certificate page

    Untrusted certificate details

    Proceed trusting the source

    Once trusted the source, the user will be redirected to a login page where the default username is:

    admin

    and the default password is:

    admin

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