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 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
Network server 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 à niveau.

Journaux

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

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

Ceci 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 ne sont pas fournis pour MQTT :

Service	Fichier de configuration	Configuration
LRR	$ROOTACT/usr/etc/lrr/lrr.ini	level=0, debug=0, size=10000000 (10MB)
LRC	$ROOTACT/usr/etc/lrr/lrc.ini	level=0, debug=0, size=10000000 (10MB)
TAO	$ROOTACT/usr/etc/tao/configs/tao_server_config.yaml	level: WARN, maxSize=10 (10 MB)
Node-RED	$ROOTACT/usr/etc/node-red/settings.js	level : 'error', size=10000000 (10 MB)
MQTT	$ROOTACT/usr/etc/mqtt/mosquitto.conf	log_dest none, il faut le remplacer par log_dest file /var/log/mosquitto.log pour activer la journalisation

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 le faire dynamiquement via une session d'administration telnet (telnet 0 2009).
• Pour Node-RED :
  • level: "trace" (à deux 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 file /var/log/mosquitto.log et définissez log_type.

note

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