Passer au contenu principal

Passerelles Tektelic

Les modèles de Passerelle Tektelic supportés sont :

  • Kona Macro16

  • Kona Mega64

  • Kona Micro8 (Gen1 et Gen2)

  • Kona Enterprise (Gen1 et Gen2)

  • Kona Photon

Chaque modèle de passerelle Tektelic a sa propre version de firmware. Néanmoins, la procédure d'installation de LRR est générique pour tous les modèles Tektelic.

Prérequis logiciels et matrice de compatibilité

Modèle de PasserelleVersion LRRVersion du FirmwareVersion FPGA
Tektelic Micro82.8.67_77.1.2, 7.1.9, 7.1.12.1Partie du firmware
Tektelic Macro162.8.67_77.1.12.1Partie du firmware
Tektelic Mega642.8.67_77.1.2, 7.1.9, 7.1.12.1Partie du firmware
Tektelic Enterprise2.8.67_77.1.9, 7.1.12.1Partie du firmware
Tektelic Photon2.8.67_47.1.9, 7.1.12.1Partie du firmware

Si la version du firmware (BSP) de votre passerelle n'est pas celle mentionnée ci-dessus, consultez le portail de support Tektelic pour télécharger le firmware et obtenir des détails sur la façon de flasher le firmware Tektelic.

Vérification de la version du firmware

Pour vérifier la version actuelle du firmware Tektelic de votre passerelle, exécutez la commande suivante :

system_version | grep Release

Installation LRR

Après avoir téléchargé l'image de la passerelle comme décrit dans Récupération de l'image de la passerelle, suivez les étapes ci-dessous pour flasher votre passerelle avec la nouvelle image.

  1. Connectez-vous à la passerelle via SSH.Voir Connexion à la passerelle via SSH pour plus de détails.

  2. Transférez sur la passerelle le fichier image ThingPark que vous avez téléchargé précédemment en utilisant une commande wget, ou avec un outil comme WinSCP. Le répertoire de destination doit être /tmp.

  3. Déplacez-vous vers ce répertoire sous votre connexion SSH :

    cd /tmp
  4. Extraire tous les documents du package :

    tar -xf [TEKTELIC image file name]

    où [nom du fichier image TEKTELIC] est le nom du fichier de l'image (.tar.gz fichier) que vous avez préalablement téléchargé et transféré dans /tmp.

  5. Installez le package LRR en utilisant la commande suivante :

    ./postinstall.sh

    Après avoir exécuté la commande, la passerelle sera flashée avec l'image ThingPark. Ce processus prendra quelques minutes.

  6. Redémarrez la passerelle.

    safe_reset
    Note importante

    Évitez de redémarrer la passerelle avec la commande "reboot" car vous pourriez ne pas pouvoir vous reconnecter à la passerelle pour la prochaine heure en raison d'un problème connu au niveau du firmware.

  7. Une fois la passerelle redémarrée et opérationnelle, vérifiez que la version LRR installée sur celle-ci est celle attendue (reportez-vous au tableau de compatibilité ci-dessus). La version LRR peut être vérifiée via le menu SUPLOG (voir Connexion à SUPLOG).Vous pouvez également vérifier sur la passerelle avec la commande suivante :

    cat $ROOTACT/usr/etc/lrr/versions.ini

Mise à jour BSP et LRR

La mise à jour BSP et LRR s’applique uniquement aux chemins de mise à jour suivants :

Chemins de mise à jour supportés

Le tableau suivant résume les chemins de mise à jour supportés pour les passerelles Tektelic et les versions de BSP et LRR associées.

Modèle de PasserelleVersion du firmware / LRR existantVersion du firmware / LRR cible
Tektelic Micro8BSP 4.0.2 / LRR 2.6.81BSP 7.1.12.1 / LRR 2.8.67_7
Tektelic Macro16BSP 5.1.x / LRR 2.6.xBSP 7.1.12.1 / LRR 2.8.67_7
Tektelic Mega64BSP 5.0.2 à 5.0.6 / LRR 2.6.79BSP 7.1.12.1 / LRR 2.8.67_7
Tektelic EnterpriseBSP 2.1.4 / LRR 2.6.79BSP 7.1.12.1 / LRR 2.8.67_7

Paquets logiciels requis

Les paquets logiciels et scripts suivants sont requis pour effectuer la mise à jour BSP et LRR :

  • Script de mise à jour Tektelic BSP et LRR : tektelic-bsp-upgrade-lrr-2.8.67_7-1.7.tar.gz

    • Ce paquet contient le script de mise à jour et le paquet logiciel LRR requis pour la mise à jour BSP et LRR sur la passerelle. Cliquez ici pour télécharger le script.
  • Paquet de firmware BSP : BSP_7.1.12.1.zip

    • Cette archive contient le firmware BSP requis pour la mise à jour de la passerelle. Consultez le portail de support Tektelic pour télécharger le firmware Tektelic.

Procédures de mise à jour

Cette procédure de mise à jour BSP et LRR nécessite un SSH direct ou un SSH inversé vers la passerelle. Accès à la passerelle selon les besoins. Ensuite, suivez les étapes ci‑dessous pour effectuer la mise à jour.

  1. Vérifications préalables à la mise à jour :
    Avant de lancer la mise à jour, effectuez les vérifications suivantes pour vous assurer que la passerelle est prête pour le processus de mise à jour.

    • Vérifier la connectivité de backhaul de la passerelle : Assurez‑vous que la passerelle dispose d’une connexion de backhaul stable vers le network server afin d’éviter les interruptions pendant la mise à jour.
    • Effectuer une sauvegarde de la passerelle : Pour tous les modèles de passerelle Tektelic sauf Tektelic Micro8, vous pouvez créer une sauvegarde de la passerelle via l’option « BACKUP » sur l’interface graphique.
    • Vérifier les exigences d’espace disque : Pour garantir une mise à jour BSP et LRR fluide, vous devez vous assurer qu’il y a suffisamment d’espace libre sur la passerelle. Voici les vérifications à effectuer :
      • Assurez‑vous que le système de fichiers racine (rootfs) dispose d’au moins 30 % d’espace libre (environ 75 Mo).
        Si l’espace disque libre est inférieur à l’exigence, vous pouvez supprimer les fichiers restants des installations BSP précédentes du répertoire /lib/firmware à l’aide de la commande suivante :

        rm -rf /lib/firmware/[b-z]*
      • Assurez‑vous que /var/volatile dispose d’au moins 40 Mo d’espace libre. Si l’espace disque libre est inférieur à l’exigence, redémarrez l’équipement pour nettoyer les fichiers temporaires.

  2. Téléverser et extraire le script de mise à jour :
    Téléversez le fichier BSP_LRR_Upgrade_script (.tar.gz) vers la passerelle et placez‑le dans le répertoire /tmp/. Puis extrayez l’archive à l’aide des commandes suivantes :

     ```
    cd /tmp
    tar -zxvf <BSP_LRR_Upgrade_script>
    ```
  3. Téléverser l’image BSP :
    Téléversez le fichier Target_BSP_Firmware vers la passerelle. Placez‑le dans le répertoire /lib/firmware/ si un espace disque suffisant est disponible. Sinon, vous pouvez téléverser le fichier dans le répertoire /backup.

  4. Exécuter la mise à jour BSP + LRR :
    La mise à jour BSP et LRR est lancée à l’aide du script de mise à jour fourni. Le script supporte deux options d’exécution : effectuer la mise à jour avec une sauvegarde système ou sans sauvegarde système.

    Avec l’option de sauvegarde système, le script crée une sauvegarde du système actuel avant de procéder à la mise à jour. Cela nécessite un espace disque supplémentaire sur la passerelle.

    Pour les passerelles ayant une capacité de stockage limitée, en particulier la Tektelic Micro8, il est recommandé d’exécuter la mise à jour sans la sauvegarde système afin d’éviter des problèmes potentiels d’espace disque pendant le processus de mise à jour. Pour démarrer la mise à jour BSP et LRR, exécutez les commandes ci‑dessous pour vous rendre dans le répertoire du script de mise à jour et lancer la commande d’installation :

    cd /tmp/upgrade
    ./install.sh <backup_option> <full path to Target_BSP_Firmware>
    note

    <backup_option> est facultatif. Par défaut (sans spécifier l’option de sauvegarde), une sauvegarde système est toujours effectuée avant le démarrage de la mise à jour.

    Pour forcer la mise à jour sans sauvegarde système, spécifiez -f comme option de sauvegarde.

    La mise à jour BSP et LRR prendra environ 70 à 90 minutes. Vous serez déconnecté de la passerelle pendant le processus de mise à jour, mais la passerelle se reconnectera au network server en utilisant le certificat IPSEC existant lorsque la mise à jour sera terminée avec succès. Vous pouvez confirmer que la mise à jour est terminée en vérifiant dans l’interface graphique que les versions de la passerelle correspondent aux versions BSP et LRR souhaitées.

  5. Régénérer un nouveau certificat de sécurité :
    Il est recommandé de générer un nouveau certificat de sécurité depuis l’interface graphique, ce qui révoque automatiquement le certificat existant. Cela permet de s’assurer que le nouveau certificat installé sur la passerelle est compatible entre IPSEC et TLS. Ainsi, cela permet de changer la méthode de sécurité utilisée par la passerelle d’IPSEC vers TLS et inversement.

    Note importante

    Avant de générer un nouveau certificat de sécurité, vérifiez que la clé publique configurée dans la GUI correspond à la clé publique actuelle sur la passerelle. Cela permet de s’assurer que le nouveau certificat généré pourra être téléchargé sans problème par la passerelle.
    Après la génération du nouveau certificat via la GUI, la passerelle téléchargera automatiquement le nouveau certificat lorsqu’elle détectera que le certificat actuel a été révoqué.

  6. Effectuer une sauvegarde LRR après la mise à jour :
    Une fois que la passerelle a été vérifiée en bon état de fonctionnement, effectuez à nouveau une sauvegarde LRR via l’option « BACKUP » dans la GUI pour sauvegarder la passerelle avec la dernière version logicielle LRR. Cela permet de s’assurer que la sauvegarde effectuée à l’étape 1 sera remplacée par la nouvelle sauvegarde, qui est compatible avec la nouvelle version de BSP installée sur la passerelle.

Demander à l’IA