Mise à jour de l'agent sur un Teltonika

Migration de l'agent v2 vers v3

Si vous migrez un équipement depuis l'agent v2 vers la v3, il est important de comprendre les changements structurels qui ont été apportés. La v3 introduit une nouvelle organisation des fichiers et dossiers pour améliorer la maintenabilité et la sécurité.

Changements de structure des fichiers

Configuration principale

Agent v2 :

Configuration centralisée dans /etc/alemca/config.yaml

Agent v3 :

Fichier de credentials : /etc/alemca/credentials.yaml - Contient uniquement les informations sensibles (clés, tokens, etc.)
Fichiers de configuration : /etc/alemca/configs/ - Contient tous les autres paramètres de configuration

Important

Lors de la migration, les credentials sont automatiquement extraits du fichier config.yaml vers le nouveau fichier credentials.yaml. Les autres paramètres sont déplacés dans le dossier configs/.

Scripts personnalisés

Agent v2 :

Scripts Lua stockés directement dans /etc/alemca/

Agent v3 :

Scripts personnalisés : /etc/alemca/scripts/ - Tous vos scripts Lua personnalisés

Fichiers système

Agent v2 :

Fichiers système mélangés avec la configuration utilisateur

Agent v3 :

Fichiers système : /etc/alemca/system/ - Contient tous les fichiers liés au système
Commandes par défaut : /etc/alemca/system/commands/ - Scripts de commandes pré-installés

Processus de migration automatique

La migration est généralement automatique lors de l'installation de la v3 :

Sauvegarde automatique : L'ancien fichier config.yaml est sauvegardé
Extraction des credentials : Les informations d'authentification sont extraites vers credentials.yaml
Réorganisation des configurations : Les autres paramètres sont déplacés vers configs/
Migration des scripts : Les scripts personnalisés sont déplacés vers scripts/
Installation des commandes système : Les nouvelles commandes par défaut sont installées dans system/commands/

Vérification post-migration

Après la mise à jour vers la v3, vérifiez la nouvelle structure :

# Vérifier la structure des dossiers
ls -la /etc/alemca/

# Vérifier le fichier de credentials
ls -la /etc/alemca/credentials.yaml

# Vérifier les configurations
ls -la /etc/alemca/configs/

# Vérifier les scripts personnalisés
ls -la /etc/alemca/scripts/

# Vérifier les fichiers système
ls -la /etc/alemca/system/

# Vérifier les commandes par défaut
ls -la /etc/alemca/system/commands/

Résolution des problèmes de migration

Si vous rencontrez des problèmes après la migration :

Scripts personnalisés manquants

Si vos scripts personnalisés ne sont pas visibles :

# Vérifier s'ils sont encore dans l'ancien emplacement
ls -la /etc/alemca/*.lua

# Si oui, les déplacer manuellement
mv /etc/alemca/*.lua /etc/alemca/scripts/

Il faudra par la suite changer le chemin dans le fichier de configuration.

Configuration incomplète

Si certaines configurations semblent manquantes :

# Vérifier le fichier de sauvegarde
ls -la /etc/alemca/config.yaml.backup

# Comparer avec la nouvelle structure
cat /etc/alemca/configs/*

Sauvegarde recommandée

Avant toute migration, il est fortement recommandé de sauvegarder le dossier /etc/alemca/ complet pour pouvoir restaurer en cas de problème.

Vérifications initiales

L'interface web

Si la version de l'agent n'apparaît pas dans la section Monitoring de l'interface web, cela indique que l'agent n'est pas à jour.

Pour vérifier :

Connexion à l'interface web : Accédez à l'interface web alemca.
Sélection du équipement : Recherchez et cliquez sur l'équipement concerné.
Accès à la section Monitoring : La section Monitoring se situe à droite.
Affichage des métriques : Cliquez sur le bouton Show more pour afficher toutes les métriques.
Vérification du champ version_agent : Assurez-vous que le champ version_agent est visible. S'il ne l'est pas, une mise à jour de l'agent est nécessaire.

Accès SSH

Étant donné que l'agent est déjà installé, vous pouvez vous connecter en SSH pour procéder à la mise à jour.

Procédure :

Créer un lien de connexion : Il est nécessaire de disposer d'un lien de connexion pour accéder à l'équipement en SSH. Pour cela, il faudra créer une session SSH via l'interface web.
Accès à l'interface web : Connectez-vous à l'interface web alemca et cliquez sur l'equipement concerné.
Aller dans l'onglet remote : Cliquez sur l'onglet Remote.
Créer une session SSH : Dans la partie Direct Access nous allons créer une session SSH.
- Selectionner le protocole : Choisir le protocole tcp.
- Selectionner le port : Le port SSH est le 22 il faudra donc le rentrer dans le champ port.
- Selectionner la durée de la session : Choisir la durée de la session. généralement 1h suffit.
- Créer la session : Cliquer sur le bouton Create Session pour créer la session.
Obtention du lien de connexion : Cliquez sur l'icône de copie pour copier le lien de connexion du dispositif.
Connexion SSH : Dans un terminal, exécutez la commande suivante :

ssh root@<lien_de_connexion>

Example

La commande apparaîtra ainsi :

ssh root@fr04.remote.alemca.tech -p 12345

Vérification de l'espace libre

Commande pour vérifier l'espace libre :

df -h

Assurez-vous que l'équipement dispose d'au moins 3 Mo d'espace libre pour effectuer la mise à jour, en vérifiant la colonne Available pour la ligne où la colonne Mounted on contient uniquement '/'.

Procédure de mise à jour de l'agent

Identifier l'architecture de l'équipement :

Exécutez la commande suivante sur l'équipement :

cat /etc/os-release

Ou, si votre appareil est un Teltonika, vous pouvez également exécuter la commande suivante :

cat /etc/openwrt_release

Notez la valeur du champ OPENWRT_ARCH, qui indique l'architecture du dispositif.

Télécharger la dernière version de l'agent :
Accédez au dépôt officiel : repo.alemca.io.
Rendez-vous dans le dossier opkg (spécifique aux appareils Teltonika).
Copier le lien de téléchargement .ipk correspondant à l'architecture de votre équipement.

Example

Pour une architecture arm_cortex-a7_neon-vfpv4, le fichier sera :

agent-alemca-arm_cortex-a7_neon-vfpv4-latest.ipk

Installer l'agent sur l'équipement :

Sur l'équipement, exécutez la commande suivante en remplaçant <lien_du_fichier> par le lien direct vers le fichier .ipk :

opkg install <lien_du_fichier.ipk>

Example

Votre commande doit apparaître comme suit:

opkg install http://repo.alemca.io/*/*/*/*/agent-alemca-*****-latest.ipk

Redémarrer l'équipement :

Pour appliquer les modifications, redémarrez l'équipement avec la commande :

reboot

Une fois redémarré, vérifiez que le champ version_agent est désormais visible dans la section Monitoring de l'interface web.

Info

Il se peut que l'affichage de la version sur la plateforme web prenne un peu de temps. Nous vous recommandons de patienter quelques instants. Vous pouvez également essayer de vider votre cache pour accélérer l'affichage.

Si après quelques minutes le champ n'est toujours pas visible ?

c'est que la configuration n'est pas correcte. Dans ce cas, nous allons apporter des modifications au document de configuration, veuillez répéter les éléments suivants dans l'ordre.