Administration à distance

Un répéteur en point haut n'est pas accessible tous les jours. L'administration distante est ce qui rend son exploitation soutenable.

Le principe

Un répéteur MeshCore accepte des commandes envoyées par radio, à condition que l'émetteur soit authentifié comme administrateur. Cette possibilité est propre au micrologiciel répéteur : un room server n'offre pas le jeu complet de commandes d'administration.

Préparer l'accès distant, avant l'installation

C'est l'étape à ne pas repousser : une fois le nœud sur un pylône, il est trop tard.

1. Changer le mot de passe administrateur.

password un-mot-de-passe-long-et-unique

Le mot de passe d'usine est password. Un répéteur laissé ainsi peut être reconfiguré par n'importe qui à portée radio.

2. Autoriser les clés qui devront administrer le nœud.

setperm <cle_publique_admin> 3

Niveaux disponibles :

Donnez le niveau 3 à au moins deux personnes. Un administrateur unique indisponible, et le nœud devient inadministrable.

3. Vérifier la liste.

get acl

Cette commande n'est disponible qu'en liaison série : contrôlez-la avant de partir sur site.

4. Noter la clé publique du nœud.

get public.key

Conservez-la : c'est l'identifiant qui permet de retrouver le nœud dans les traces et les outils d'analyse. C'est aussi ce que vous renseignez en déclarant le nœud sur la carte.

Commandes utiles à distance

Prendre des nouvelles

ver
neighbors
get repeat

Ajuster le comportement

set tx 18
set flood.advert.interval 24
set advert.interval 240

Se signaler après une intervention

advert

Redémarrer

reboot

Le piège des paramètres radio

Modifier les paramètres radio d'un nœud distant est l'opération la plus risquée : si les nouvelles valeurs ne conviennent pas, le nœud disparaît du réseau et il faut se déplacer.

La commande tempradio existe exactement pour cela : elle applique des paramètres pour une durée limitée, puis revient d'elle-même aux réglages précédents.

tempradio 869.618,62.5,8,8,15

Ici, essai pendant 15 minutes. Si le nœud reste joignable et que le résultat convient, rendez le changement définitif avec set radio. Sinon, patientez : le nœud revient tout seul.

Adoptez le même réflexe pour tout réglage susceptible de vous couper l'accès.

Mise à jour par radio

start ota

Une mise à jour par radio d'un nœud éloigné est lente et sensible à la coupure. Sur un nœud difficile d'accès et qui fonctionne correctement, l'abstention est souvent le meilleur choix : ne mettez à jour que pour un correctif dont vous avez réellement besoin.

Journalisation pour diagnostic

log start

Laissez tourner le temps d'observer le problème, puis relisez le journal en liaison série lors de votre prochaine visite :

log
log stop
log erase

Le journal occupe le stockage du nœud : pensez à l'arrêter.

Bonnes pratiques

• Deux administrateurs minimum par nœud.
• Consigner la configuration appliquée — le wiki est fait pour cela.
• Éviter les changements groupés : un réglage à la fois, avec vérification entre chacun.
• Ne jamais toucher aux paramètres radio d'un nœud distant sans tempradio.
• Prévoir un accès physique : tout finit par nécessiter une visite.