Services et journaux

Remarque

L'accès aux services ou aux journaux est une tâche avancée qui nécessite un accès root sur la passerelle.

Services

Les services sont accessibles par :

• /etc/init.d/<service>, pour la plupart des passerelles
• /etc/rcU.d/S90<service>, sur Kerlink Wirnet iFemtoCell-evolution

5 services sont démarrés sur ThingPark Enterprise All-in-one :

rôle	service
Passerelle LRR	lrr
Serveur réseau LoRaWAN	lrc
Serveur d'administration ThingPark Enterprise All-in-one	tao
node-RED	node-red
Broker MQTT	mqtt

Remarque

Il est interdit de modifier tout fichier de configuration situé sous /home/actility/usr/etc... (sauf pour des tests temporaires). Toutes ces modifications seront perdues après une mise à jour

Journaux

Tous les journaux sont stockés dans un espace en mémoire tmpfs :

modèle	chemin racine du stockage des journaux	espace tmpfs
ufispace	/var/volatile/log	100 MB
gemtek	/dev/shm/log	500 MB

Pour chaque service, un dossier dédié est créé :

service	commande
LRR	<log storage root path>/_LRRLOG
LRC	<log storage root path>/_LRCLOG
tao	<log storage root path>/_TAOLOG
node-red	<log storage root path>/_NODEREDLOG
mqtt	<log storage root path>/_MQTTLOG

Cela est réalisé via des liens (exemple Ufispace) :

am335x-evm:/# ls -l /home/actility/var/log/
lrwxrwxrwx    1 root     root            25 Jan  5 11:36 lrc -> /var/volatile/log/_LRCLOG
lrwxrwxrwx    1 root     root            25 Jan  5 11:36 lrr -> /var/volatile/log/_LRRLOG
lrwxrwxrwx    1 root     root            29 Jan  5 11:36 node-red -> /var/volatile/log/_NODEREDLOG
lrwxrwxrwx    1 root     root            25 Jan  5 11:36 tao -> /var/volatile/log/_TAOLOG

Les niveaux de journalisation sont maintenus très bas, et non fournis pour MQTT :

service	fichier de configuration	configuration
LRR	$ROOTACT/usr/etc/lrr/lrr.ini	niveau=0, déboguer=0, taille=10000000 (10MB)
LRC	$ROOTACT/usr/etc/lrr/lrc.ini	niveau=0, déboguer=0, taille=10000000 (10MB)
TAO	$ROOTACT/usr/etc/tao/configs/tao_server_config.yaml	niveau : WARN, tailleMax=10 (10 MB)
Node-RED	$ROOTACT/usr/etc/node-red/settings.js	niveau : "erreur", taille=10000000 (10 MB)
MQTT	$ROOTACT/usr/etc/mqtt/mosquitto.conf	log_dest aucune, il faut le changer en log_dest fichier /var/log/mosquitto.log pour l'activation du journal

Modification du niveau de journalisation

• Pour LRR, TAO, Node-RED et MQTT, vous devez vous connecter à la passerelle, modifier les fichiers de configuration puis redémarrer le service correspondant.
• Pour LRC, vous pouvez faire de même ou dynamiquement via une session telnet admin (telnet 0 2009).
• Pour Node-RED :
  • niveau: "trace" (dans 2 endroits)
  • Ajouter section : uplinkDownlink: { log: (s)=>{(module.exports.logging.customLogger.handler())({timestamp: s.slice(0,s.indexOf(" ")), msg:s.slice(s.indexOf(" ")+1)}) } },
• Pour MQTT, configurez log_dest à log_dest fichier /var/log/mosquitto.log, et définissez log_type.

Remarque

Tous les journaux (pas pour le Broker MQTT) sont stockés en mémoire, ils sont copiés sur disque chaque jour dans $ROOTACT/traces.