Kerlink passerelles

Les modèles de passerelles Kerlink supportés sont :

• iFemtoCell

• iFemtoCell Evolution

• iStation

• iBTS (modèles standard et compact)

• Wirnet SOP4 (fin de vie)

Tous les modèles de points d'accès Kerlink partagent la même version de firmware sauf pour le modèle SOP4. Cependant, la procédure d'installation de LRR diffère légèrement selon le modèle.

Prérequis logiciels et matrice de compatibilité

Modèle de Passerelle	Version LRR	Version du Firmware	Version FPGA
Kerlink iFemtoCell	2.8.73	5.11.0	31, 33
Kerlink iFemtoCell Evolution	2.8.73	5.11.0	31, 33
Kerlink iStation	2.8.73	5.11.0	31, 33
Kerlink iBTS	2.8.73	5.11.0	61
Kerlink SOP4	2.4.77	3.3	31, 33

astuce

Le design hardware du modèle compact iBTS supporte une seule carte radio. Ainsi, il n'est ni compatible avec des déploiements tri-secteurs ni avec les 72 canaux des RF regions.

Le design hardware du modèle standard d'iBTS peut être utilisé de différentes manières :

• Pour des déploiements mono-secteur avec une antenne omnidirectionnelle et jusqu'à 72 canaux, choisissez le modèle ThingPark 'Wirnet iBTS standard 72-channels'.

• Pour des déploiements tri-secteurs, avec trois antennes directionnelles et jusqu'à 16 canaux RF par secteur, choisissez le modèle ThingPark 'Wirnet iBTS multi-sector'.

Vérification de la version du firmware

Pour vérifier la version actuelle du firmware Kerlink de votre passerelle :

cat /tmp/sys_startup_status.json | grep sw_version

Important Pour les passerelles Kerlink, sauf les modèles SOP4, qui ont été initialement installées avec une version de firmware différente de 4.3.3 et 5.11.0, la passerelle doit être flashée avec un live burner du firmware 5.11.0 avant d'installer la nouvelle image de passerelle.

note

La dernière image LRR intègre un live burner personnalisé, permettant de mettre à jour à distance le LRR de KerOS 4.3.3 avec LRR 2.6.27 à KerOS 5.11.0 avec LRR 2.8.73.

Veuillez consulter la documentation et le support Kerlink pour plus de détails sur la manière de flasher la version 5.11.0 du firmware Kerlink.

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.

Pour tous les modèles Kerlink sauf le SOP4, l'installation du logiciel LRR peut utiliser une des méthodes suivantes :

1. Accès SSH direct à la passerelle et transfert du logiciel LRR respectif sur celle-ci. Pour utiliser cette méthode, suivez les étapes décrites dans Installer la passerelle Kerlink avec SSH direct.

2. Installer avec une clé d'installation USB. Pour utiliser cette méthode, suivez les étapes décrites dans Installer la passerelle Kerlink avec clé USB.

Réinitialisation d'usine

Si le logiciel LRR de ThingPark a déjà été installé sur la passerelle, suivez ces étapes pour la réinitialiser :

1. Connectez-vous à votre passerelle en tant qu'utilisateur root.

2. Utilisez les commandes suivantes pour déclencher une réinitialisation d'usine :

   kerosd -s
   reboot

À ce stade, votre passerelle redémarrera et restaurera les paramètres d'usine. Cela peut prendre quelques minutes.

Vous pouvez également effectuer une réinitialisation d'usine avec la clé d'installation USB préparée dans Installer la passerelle Kerlink avec clé USB, procédez comme suit :

1. Insérez la clé d'installation USB dans la passerelle.

2. Attendez environ 20 secondes jusqu'à ce que les 4 LEDs (2 sur le port debug + 2 sur le port local) clignotent très rapidement, 3 LEDs seulement dans le cas de iFemtoCell.

3. Une fois les LEDs en clignotement, retirez la clé d'installation USB. Cela déclenchera un redémarrage de la passerelle et restaurera les paramètres d'usine. Cela peut prendre quelques minutes.

Installation avec SSH direct

Cette méthode est valable pour tous les modèles Kerlink sauf le SOP4.

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 /home/root

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

   cd /home/root

4. Extraire tous les documents du package :

   tar -xf [KERLINK image file name]

   où [Nom du fichier image KERLINK] est le nom du fichier de l'image (.tar.gz fichier) que vous avez précédemment téléchargé et transféré dans /home/root

5. Créez le répertoire /user/.updates sur la passerelle s'il n'est pas déjà créé :

   mkdir /user/.updates

6. Copiez tous les paquets ipk extraits du package dans le répertoire /user/.updates :

   cp *.ipk /user/.updates/

7. Pour déclencher une nouvelle installation, retirez le dossier $ROOTACT existant si existant en utilisant la commande suivante :

   rm -rf $ROOTACT

8. Initiez l'installation du package LRR en exécutant les commandes suivantes, suivies d'un redémarrage de la passerelle :

   sync
   kerosd -u
   reboot

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

9. Une fois que la passerelle a redémarré et est opérationnelle, vérifiez que l'image ThingPark est correctement installée avec la commande suivante. Le statut doit afficher "OK" pour les packages ipk installés.

   cat /user/.update

Si l'installation a été effectuée avec succès, vérifiez que la version LRR installée sur la passerelle est celle attendue (voir le matrice 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

Installation avec clé USB

Les passerelles Kerlink offrent un moyen d'installation facile grâce à une clé USB. Pour procéder à l'installation du logiciel LRR, vous devez préparer la clé d'installation USB avec les fichiers obtenus à partir du package logiciel LRR téléchargé précédemment.

Cette méthode est valable pour tous les modèles Kerlink (y compris le SOP4).

Préparation de la clé d'installation USB

1. Formater en FAT32 la clé USB.

2. Décompressez le package logiciel LRR téléchargé précédemment à la racine du système de fichiers de la clé d'installation USB.

3. Ajoutez le fichier usbkey.txt dans la clé USB si un logiciel LRR a déjà été installé sur la passerelle.

Le package logiciel LRR contient :

• Image fichier .ipk : les packages à installer

• usb.autorun : le script qui installe les paquets ipk à l'intérieur de la passerelle Kerlink

• usbkey.txt : contient la phrase secrète qui permet à usb.autorun de s'exécuter.

La liste des fichiers est donnée à titre informatif - les noms de fichiers réels peuvent changer en fonction du firmware et de la version LRR :

• TP_Enterprise_BS_Image_kerlink.KERL_<GW_MODEL>_any<PLATFORM>_<LRR_version>_v<IMG_VERSION>.ipk

• usb.autorun

• usbkey.txt (optionnel, uniquement nécessaire si LRR est déjà installé sur la passerelle)

Installation d'iFemtoCell ou iFemtoCell Evolution

Si votre passerelle n'a pas de logiciel LRR installé et est déjà avec sa configuration d'usine, vous pouvez procéder à l'installation de du logiciel LRR.

1. Insérez la clé d'installation USB dans la passerelle IFEMTOCELL ou IFEMTOCELL EVO.

2. Attendez environ 25 secondes, jusqu'à ce que le port ethernet clignote.

3. Une fois le port Ethernet clignotant, retirez la clé USB. Cela déclenchera le redémarrage pour effectuer l'installation (tous les packages de la clé USB seront installés sur la passerelle). Cela peut prendre quelques minutes.

4. Une fois que la passerelle a redémarré et est opérationnelle, vérifiez que la version LRR installée sur la passerelle est celle attendue (référez-vous à la matrice 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

Installation d'iBTS, iBTS Compact ou iStation

Si l'état actuel de votre iBTS ou iStation est inconnu, observez le comportement de l'unité: une passerelle IBTS ou iStation avec les paramètres d'usine redémarre toutes les 5 minutes.

Si votre passerelle n'a pas de logiciel LRR installé et est déjà avec sa configuration d'usine, vous pouvez procéder à l'installation de du logiciel LRR.

1. Vérifiez que l'IBTS ou iStation ne redémarre pas : par défaut, IBTS ou iStation redémarre toutes les 5 minutes. Vous pouvez attendre 3 minutes après le dernier redémarrage.

2. Insérez la clé d'installation USB. Pour la Kerlink iStation, un adaptateur USB Type C vers USB-A serait nécessaire.

3. Attendez environ 25 secondes jusqu'à ce que la LED jaune sur le port debug clignote très rapidement.

4. Une fois la LED clignotante, retirez la clé USB. Cela déclenchera le redémarrage pour effectuer l'installation du logiciel LRR. Cela peut prendre quelques minutes.

5. Une fois que la passerelle a redémarré et est opérationnelle, vérifiez que la version LRR installée sur la passerelle est celle attendue (référez-vous à la matrice 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

Installation de Kerlink Wirnet SOP4

Si votre passerelle n'a pas de logiciel LRR installé et est déjà avec sa configuration d'usine, procédez aux étapes suivantes pour installer le logiciel LRR :

1. Assurez-vous que la passerelle est hors tension depuis au moins 10 minutes pour garantir que la batterie interne est complètement déchargée.

2. Branchez la clé USB dans la passerelle.

3. Allumez la passerelle. Cela déclenchera l'installation du logiciel LRR, puis la passerelle redémarrera. Cela peut prendre quelques minutes.

4. Une fois que la passerelle a redémarré et est opérationnelle, vérifiez que la version LRR installée sur la passerelle est celle attendue (référez-vous à la matrice 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 LRR

Mettre à jour avec SSH direct

Cette méthode est valable pour tous les modèles Kerlink sauf le SOP4.

Suivez les étapes ci-dessous pour mettre à jour votre passerelle de Keros 4.3.3 + LRR 2.6.x :

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 /home/root

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

   cd /home/root

4. Extraire tous les documents du package :

   tar -xf [KERLINK image file name]

   où [Nom du fichier image KERLINK] est le nom du fichier de l'image (.tar.gz fichier) que vous avez précédemment téléchargé et transféré dans /home/root

5. Créez le répertoire /user/.updates sur la passerelle si cela n'a pas été déjà créé :

   mkdir /user/.updates

6. Copiez tous les packages ipk extraits du package vers le répertoire /user/.updates :

   cp *.ipk /user/.updates/

7. Initiez la mise à jour des packages Keros et LRR en exécutant les commandes suivantes, suivies d'un redémarrage de la passerelle :

   sync
   kerosd -u
   reboot

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

8. Pendant le redémarrage de la passerelle, connectez-vous à votre compte sur le portail ThingPark. Accédez à la page détaillée de la passerelle, allez à l'onglet Avancé, et sous le widget Sécurité, cliquez sur Régénérer.

   Cette étape régénère le certificat de sécurité pour la passerelle, ce qui est nécessaire pour rétablir correctement un lien de backhaul sécurisé entre la passerelle et le Cœur de réseau ThingPark après la mise à jour du LRR.

9. Une fois que la passerelle a redémarré et est opérationnelle, vérifiez que l'image ThingPark est correctement installée avec la commande suivante. Le statut doit afficher "OK" pour les packages ipk installés.

   cat /user/.update
   cat /user/.upgrade.log

Si l'installation a été effectuée avec succès, vérifiez que la version LRR installée sur la passerelle est celle attendue (voir le matrice 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 à niveau du customlrrini*.ipk

Si vous devez mettre à niveau le package customlrrini*.ipk et avez encore l'ancien package setvpn installé, vous devez d'abord enlever setvpn:

opkg remove setvpn
kerosd -u && sync && reboot

cp customlrrini.ipk /user/.updates/
kerosd -u && sync && reboot