Eclipse Kapua - Revision history

Sedjro.zodehougan: /* Le Broker */

2018-04-09T17:14:23Z

Le Broker

← Older revision		Revision as of 17:14, 9 April 2018
Line 106:		Line 106:
	*Password: kapua-password		*Password: kapua-password

	> ~~Note~~:		> Notes:
	*Ne pas utiliser l'identifiant kapua-sys pour établir des connexions Mqtt.		*Ne pas utiliser l'identifiant kapua-sys pour établir des connexions Mqtt.
	*Si vous utilisez Docker sous Windows, le nom d'hôte ne sera probablement pas localhost mais l'adresse IP de votre instance docker.		*Si vous utilisez Docker sous Windows, le nom d'hôte ne sera probablement pas localhost mais l'adresse IP de votre instance docker.



	== Liens utiles ==		== Liens utiles ==

Sedjro.zodehougan at 17:13, 9 April 2018

2018-04-09T17:13:13Z

← Older revision		Revision as of 17:13, 9 April 2018
Line 71:		Line 71:
	[[File:Kapua-run.png\|alt=Kapua run]]		[[File:Kapua-run.png\|alt=Kapua run]]

			> La console d'administration est accessible à l'ardesse: http://localhost:8080/.
			> Pour se connecter:
			*Username: kapua-sys
			*Password: kapua-password


Line 86:		Line 90:


	== Services proposés ==

			=== ''' APIs RestFul ''' ===
	Eclipse Kura vise à fournir un conteneur basé sur OSGi pour les applications M2M s’exécutant dans les passerelles de service, il définit un Framework qui offre un ensemble de services communs pour les développeurs participant à des projets IOT.

			La documentation de l'API RESTFul est disponible à l'adresse http://localhost:8081/doc/. Le point de montage est quant à lui accessible à l'adresse: http://localhost:8081/v1/
	Il fournit un système gérable à distance, intégrant tous les services de base dont les applications ( iot ) ont besoin ainsi qu’une couche d’abstraction simplifiant l’accès au matériel de la passerelle
			Pour plus d'information: https://github.com/eclipse/kapua

	* Kura offre également un moyen de connexion à la plateforme d’intégration Cloud, la gestion à distance des systèmes, il met à disposition de l’utilisateur un ensemble d’API lui permettant d’écrire et de déployer son application de manière fiable et simplifiée ce qui permet un gain de temps énorme.
	* Il permet notamment la Gestion des différents ports de communication disponibles dans l'IoT (série, USB, Bluetooth, GPS, ...)
	* Il offre un Data Services qui permet la gestion des données pour avoir un reporting comme des statistiques sur les flux et publication à distance.
	* Configuration Service : via OSGi, permet d'importer / d'exporter la configuration de tous les services enregistrés dans le conteneur.
	* Network service : permet de configurez les interfaces réseau disponibles dans la passerelle, comme les modems Ethernet, Wifi et cellulaire.
	* Watchdog Service : Permet la surveillance des composants critiques et ainsi pouvoir lancer une réinitialisation du matériel en cas de défaillance
	'
	Kura propose une interface d'administration Web exécutée dans le conteneur Kura pour gérer la passerelle.

	== Architecture ==

			=== ''' Le Broker ''' ===
	Kura est une brique parmi tant d'autres dans le monde de l'IoT.

			Le conteneur de Broker expose un endpoint Mqtt accessible à l'adresse à tcp://localhost:1883/. Le Broker peut être accessible via Eclipse Kura ou un client Mqtt simple comme, par exemple, Eclipse Paho.
	C'est avant tout un module d'assistance pour la gestion et d'administration des passerelles en IoT.

			Pour qu'un client établisse une connexion Mqtt avec le Broker, il doit fournir des identifiants valides. Les informations d'identification de l'utilisateur kapua-broker sont les suivantes:
	Ainsi, on voit que Kura est présent sur plusieurs couches de l'IoT, de l'application aux passerelles IoT.
			*Username: kapua-sys
			*Password: kapua-password

			> Note:
	[[File:architectureKura.png\|alt=Schéma d'architecture logicielle, présentant la place de Kura\|Architecture logicielle, là où se situe Kura]]
			*Ne pas utiliser l'identifiant kapua-sys pour établir des connexions Mqtt.
			*Si vous utilisez Docker sous Windows, le nom d'hôte ne sera probablement pas localhost mais l'adresse IP de votre instance docker.

	== Versions ==
	Du 21 octobre 2015 au 29 mars 2018 , Il y a eu 10 versions , la plus récente et la trés attendu version 2.0 qui est sortie le 29 mars 2018 .

	== Kura Wires ==

			== Liens utiles ==
	Kura Wires un nouveau outil visuel de gestion de flots de données qui permet de définir des cycles de récupération et de traitement de données en sélectionnant simplement des composants sur une palette graphique et en les connectant les uns aux autres. Par exemple, un capteur de température peut être connecté à une passerelle de service Kura pour publier ses données de température sur une plate-forme cloud assez rapidement
			*https://github.com/eclipse/kapua/blob/develop/assembly/README.md

			*https://github.com/eclipse/kapua/blob/develop/dev-tools/src/main/vagrant/README.md#demo-machine-quick-start
	== Projets utilisant Kura ==
			*https://github.com/eclipse/kapua/blob/develop/docs/developer-guide/en/running.md#openshift

			*http://download.eclipse.org/kapua/docs/develop/user-manual/en/
	* [Industrial Equipment Monitoring] https://tobiddev.wordpress.com/
			*http://download.eclipse.org/kapua/docs/develop/developer-guide/en/
	* [Vehicle Monitoring] http://diyapps.blogspot.fr/
	* [Eclipse IoT Challenge Tumbl] http://openiotchallenge.tumblr.com/

	== Liens ==

	=== Comment bien commencer avec Kura ===
	http://wiki.eclipse.org/Kura/Getting_Started

	=== Dépendances ===

	Eclipse Kura
	http://www.eclipse.org/kura/

	OSGi
	https://www.osgi.org/

	NMEA
	http://www.gpsinformation.org/dale/nmea.htm

	MQTT
	http://air.imag.fr/index.php/MQTT

	Apache Camel
	http://camel.apache.org/

	==Getting started==

	Launch the gateway in a [[Docker]] container
	<pre>
	docker run --name=kura -d -p 8080:8080 ctron/kura-emulator:3.0.0-RC1
	</pre>

	Browse the console http://admin:admin@localhost:8080/kura

	Copy the following routes into the "Camel XML router" section.
	<pre>
	<routes
	xmlns="http://camel.apache.org/schema/spring"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://camel.apache.org/schema/spring https://camel.apache.org/schema/spring/camel-spring-2.17.3.xsd">

	<route id="camle-kura">
	<from uri="timer:trigger" />
	<setBody>
	<simple>${random(100)}</simple>
	</setBody>
	<to uri="stream:out" />
	</route>
	</routes>
	</pre>

	Follow the log
	<pre>
	docker logs -f kura
	</pre>


	TODO avec [[CC2541 SensorTag Development Kit]] https://eclipse.github.io/kura/wires/kura-wires-sensortag.html

Sedjro.zodehougan at 16:57, 9 April 2018

2018-04-09T16:57:26Z

← Older revision		Revision as of 16:57, 9 April 2018
Line 76:		Line 76:


	[[File:kura-device.png\|alt=~~Kapua~~ ~~run~~]]		[[File:kura-device.png\|alt=Kura device]]


Line 83:		Line 83:


	[[File:manage-device.png\|alt=~~Kapua~~ ~~run~~]]		[[File:manage-device.png\|alt=manage device]]

Sedjro.zodehougan at 16:56, 9 April 2018

2018-04-09T16:56:03Z

← Older revision		Revision as of 16:56, 9 April 2018
Line 52:		Line 52:

	=== ''' Cloner et lancer Kapua''' ===		=== ''' Cloner et lancer Kapua''' ===

	> Cloner le dépôt git de Kapua		> Cloner le dépôt git de Kapua
	<pre>		<pre>
	$ git clone https://github.com/eclipse/kapua		$ git clone https://github.com/eclipse/kapua
	</pre>		</pre>


	> Créez et exécutez Demo Box de Kapua en utilisant le script de démarrage rapide.		> Créez et exécutez Demo Box de Kapua en utilisant le script de démarrage rapide.
Line 63:		Line 65:
	</pre>		</pre>


⚫	> Les services suivants sont alors disponbles:

		⚫	> Les services suivants sont alors disponbles et s'exécutent:

	[[File:Kapua-run.png\|alt=Kapua run]]		[[File:Kapua-run.png\|alt=Kapua run]]



			=== ''' Connecter un périphérique Eclipse Kura ''' ===


			[[File:kura-device.png\|alt=Kapua run]]



			=== ''' Gérer le périphérique ''' ===


			[[File:manage-device.png\|alt=Kapua run]]

Sedjro.zodehougan at 16:43, 9 April 2018

2018-04-09T16:43:28Z

@@ Line 50: / Line 50: @@
 * Docker version 1.2+
 * Accès internet
 == Services proposés ==

Sedjro.zodehougan at 16:35, 9 April 2018

2018-04-09T16:35:04Z

← Older revision		Revision as of 16:35, 9 April 2018
Line 43:		Line 43:
	== Getting Started ==		== Getting Started ==


	- Pré-requis		=== ''' Pré-requis''' ===

	* Architecture 64 bits		* Architecture 64 bits
	* JVM version 8		* JVM version 8

Sedjro.zodehougan at 16:34, 9 April 2018

2018-04-09T16:34:01Z

← Older revision		Revision as of 16:34, 9 April 2018
Line 44:		Line 44:

	- Pré-requis		- Pré-requis
			* Architecture 64 bits
	*
			* JVM version 8

			* Docker version 1.2+
			* Accès internet

	== Services proposés ==		== Services proposés ==

Sedjro.zodehougan at 16:32, 9 April 2018

2018-04-09T16:32:11Z

← Older revision		Revision as of 16:32, 9 April 2018
Line 37:		Line 37:
	== Architecture ==		== Architecture ==
	Le diagramme suivant fournit une architecture fonctionnelle du projet Eclipse Kapua:		Le diagramme suivant fournit une architecture fonctionnelle du projet Eclipse Kapua:


	[[File:Kapua-archi.png\|alt=Archi Kapua\|Architecture fonctionnelle de Kapua]]		[[File:Kapua-archi.png\|alt=Archi Kapua\|Architecture fonctionnelle de Kapua]]

			== Getting Started ==

			- Pré-requis

			*

Sedjro.zodehougan at 16:19, 9 April 2018

2018-04-09T16:19:41Z

← Older revision		Revision as of 16:19, 9 April 2018
Line 37:		Line 37:
	== Architecture ==		== Architecture ==
	Le diagramme suivant fournit une architecture fonctionnelle du projet Eclipse Kapua:		Le diagramme suivant fournit une architecture fonctionnelle du projet Eclipse Kapua:

			[[File:Kapua-archi.png\|alt=Archi Kapua\|Architecture fonctionnelle de Kapua]]

Sedjro.zodehougan at 16:17, 9 April 2018

2018-04-09T16:17:09Z

← Older revision		Revision as of 16:17, 9 April 2018
Line 38:		Line 38:
	Le diagramme suivant fournit une architecture fonctionnelle du projet Eclipse Kapua:		Le diagramme suivant fournit une architecture fonctionnelle du projet Eclipse Kapua:


	[[File:Kapua-archi.png\|alt=Archi Kapua\|Architecture fonctionnelle de Kapua]]