Services et journaux

Remarque

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

Services

Les services sont accessibles via des commandes CLI :

• pour le serveur TAO
• pour les passerelles distantes

Services sur le serveur TAO

5 services sont démarrés sur le serveur TAO :

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

Services sur la passerelle distante TAO

2 services sont démarrés sur la passerelle distante TAO :

Rôle	Service
Passerelle LRR	lrr
Serveur d'administration ThingPark Enterprise All-in-one	tao

précaution

Il n'est pas permis de modifier les fichiers de configuration situés 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 de stockage des journaux	espace tmpfs
ufispace	/var/volatile/log	100 Mo
tektelic	/var/volatile/log	64 Mo
gemtek	/dev/shm/log	500 Mo
kerlink	/var/run	114 Mo

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

Service	Chemin
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 log sont maintenus très bas et ne sont pas fournis pour MQTT :

Service	Fichier de configuration	Configuration
LRR	$ROOTACT/usr/etc/lrr/lrr.ini	niveau=0, débogage=0, taille=10000000 (10MB)
LRC	$ROOTACT/usr/etc/lrr/lrc.ini	niveau=0, débogage=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 aucun, il faut le changer en log_dest fichier /var/log/mosquitto.log pour activer la journalisation

Modification du niveau de journalisation

• Pour LRR, TAO, Node-RED et MQTT, vous devez vous connecter sur la passerelle et modifier les fichiers de configuration puis redémarrer le service correspondant.
• Pour LRC, vous pouvez faire de même ou dynamiquement via une session admin telnet (telnet 0 2009).
• Pour Node-RED :
  • niveau : "trace" (à 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 en log_dest fichier /var/log/mosquitto.log et définissez log_type.

note

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