Observer avec PyMC¶

Ajoutez les points de terminaison principal et de secours de MeshCore Canada à un service de répéteur PyMC que vous exploitez déjà.

Cette méthode vous convient-elle?¶

Utilisez PyMC siUn service de répéteur PyMC fonctionnel gère déjà la radio.

Choisissez autre chose siVous installeriez Python et PyMC uniquement pour observer le trafic.

Gardez en fonctionL’hôte PyMC, le service, la connexion radio et l’accès Internet.

Vérifier votre installation¶

Cette procédure vise un service systemd Linux nommé pymc-repeater dont la configuration se trouve dans /etc/pymc_repeater/config.yaml. Confirmez la version, le nom du service, le chemin et le format de configuration avant toute modification. Si les chemins diffèrent, ou si vous utilisez macOS ou Windows, suivez la documentation de la version de PyMC installée.

Avant de commencer¶

[ ] PyMC fonctionne correctement avant le changement.
[ ] Vous connaissez les véritables chemins du service et de sa configuration.
[ ] La radio utilise les paramètres du réseau maillé local.
[ ] Vous avez choisi un véritable code d’emplacement.
[ ] Vous pouvez restaurer une copie de sauvegarde appartenant à root.

Notez l’état actuel du service :

sudo systemctl status pymc-repeater --no-pager
sudo cp -- /etc/pymc_repeater/config.yaml /etc/pymc_repeater/config.yaml.pre-meshcore-ca

Ce qui sera modifié¶

Vous modifierez la configuration YAML de PyMC et redémarrerez le service. Le changement ajoute un code d’emplacement et deux entrées de courtier chiffrées et authentifiées par jeton; il ne modifie pas le micrologiciel de la radio.

Configuration¶

Dans /etc/pymc_repeater/config.yaml, définissez le code d’emplacement dans mqtt :

mqtt:
  iata_code: YOW

Remplacez YOW par le véritable code le plus près de l’observateur.

Sous mqtt.brokers, ajoutez :

- name: MeshCore-CA
  enabled: true
  host: mqtt1.meshcore.ca
  port: 443
  transport: websockets
  format: letsmesh
  disallowed_packet_types: []
  retain_status: false
  tls:
    enabled: true
    insecure: false
  use_jwt_auth: true
  audience: mqtt1.meshcore.ca
- name: MeshCore-CA Backup
  enabled: true
  host: mqtt2.meshcore.ca
  port: 443
  transport: websockets
  format: letsmesh
  disallowed_packet_types: []
  retain_status: false
  tls:
    enabled: true
    insecure: false
  use_jwt_auth: true
  audience: mqtt2.meshcore.ca

N’ajoutez pas de mot de passe MQTT. Laissez le courriel facultatif du responsable vide, sauf s’il est nécessaire à l’exploitation.

Relisez la section modifiée, puis redémarrez le service :

sudo systemctl restart pymc-repeater
sudo systemctl status pymc-repeater --no-pager

Si le service échoue, consultez un court extrait du journal local :

sudo journalctl -u pymc-repeater -n 80 --no-pager

Examinez les résultats avant de les partager. Suivez la liste de caviardage.

Ce que vous devriez voir¶

Le service demeure actif sans erreur YAML, TLS ou de jeton, et son nombre de paquets change lorsque la radio capte du trafic à proximité.

Vérifier dans CoreScope¶

Trouvez l’observateur dans CoreScope Observers.
Attendez de l’activité normale à proximité.
Confirmez la présence d’un paquet récent dans CoreScope Packets.

Terminez avec Vérifier votre observateur. Un service systemd en bon état ne confirme pas que les paquets se sont rendus à CoreScope.

Récupération¶

Restaurez exactement la sauvegarde créée avant la modification :

sudo cp -- /etc/pymc_repeater/config.yaml.pre-meshcore-ca /etc/pymc_repeater/config.yaml
sudo systemctl restart pymc-repeater
sudo systemctl status pymc-repeater --no-pager

Conservez le fichier défectueux en privé s’il peut servir au diagnostic. Ne le publiez pas sans d’abord retirer les renseignements secrets et personnels.

Si la vérification échoue¶

Consultez le dépannage. Indiquez la version de PyMC, le nom du service, la première étape qui a échoué et un court extrait caviardé du journal.