Kerlink passerelles

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

• iFemtoCell
• iFemtoCell Evolution
• iStation
• iBTS (modèles standard et compact)
• Wirnet SOP4 (fin de vie)

Les modèles de passerelle Kerlink peuvent avoir différentes versions de firmware. La procédure d’installation du LRR diffère légèrement selon le modèle et la version du firmware.

Prérequis logiciels et matrice de compatibilité

Modèle de passerelle	Version LRR	Version firmware	Version FPGA
Kerlink iFemtoCell	2.8.96	6.4.0	31, 33
	2.8.73_8	5.11.0	31, 33
Kerlink iFemtoCell Evolution	2.8.96	6.4.0	31, 33
	2.8.73_8	5.11.0	31, 33
Kerlink iStation	2.8.96	6.4.0	31, 33
	2.8.73_8	5.11.0	31, 33
Kerlink iBTS	2.8.73_8	5.11.0	61
Kerlink SOP4	2.4.77	3.3	31, 33

note

Le live-burner de KerOS 5.11.0 vers KerOS 6.4.0 est désormais disponible. Cela ne peut être fait que si un redémarrage électrique n’est pas nécessaire, ce qui est le cas pour la plupart des passerelles Kerlink où le Secure Store n’a jamais été activé. Pour vérifier si votre passerelle a besoin d’un redémarrage électrique, vous pouvez exécuter la commande suivante :

ELECTRICAL_REBOOT_NEEDED=$(cat /proc/cmdline | grep -c "sb_lock=1")

Le live-burner de KerOS 5.11.0 vers KerOS 6.4.0 échouera si un redémarrage électrique est nécessaire.

Si LRR existe déjà, la mise à jour conservera la configuration. Si vous ne souhaitez pas conserver la configuration existante, vous devez supprimer $ROOTACT.

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 :

# On KerOS 4.3.3 and KerOS 5.11.0
cat /tmp/sys_startup_status.json | grep sw_version
# On KerOS 6
cat /etc/os-release

prudence

Pour les passerelles (à l’exception de la SOP4) qui ont été initialement installées avec une version de firmware différente de 4.3.3, 5.11.0 ou 6.4.0, la passerelle doit être flashée avec le live burner correspondant du firmware avant d’installer la nouvelle image de passerelle.

Installation du LRR sur KerOS 6.4.0

Consultez la documentation et le support Kerlink pour plus de détails sur la façon de flasher la version 6.4.0 du firmware.

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.

Prérequis

Important : définissez un mot de passe administrateur avant d’installer le LRR.

Sur un nouveau KerOS 6.4.0, un mot de passe administrateur est nécessaire après la mise à jour. Un mot de passe root sera également nécessaire mais il sera réinitialisé par l’installation du LRR. Enfin, un accès ssh sera également nécessaire.

# prompt asking for login
admin
# You are required to change your password immediately (administrator enforced).
# New password
<enter your admin password>
# Retype new password
<enter your admin password>
# try to enter root
sudo su
<enter your root password>

# Update the system
apt update
apt dist-upgrade -y
apt upgrade -y

# Allow password authentication for SSH
sed -i 's/PasswordAuthentication no/PasswordAuthentication yes/g' /etc/ssh/sshd_config
# Going back to admin user
exit

Réinitialisation d’usine

Effectuer une réinitialisation d’usine sur KerOS 6 supprimera toutes les data utilisateur et configurations. Vous devrez saisir un nouveau mot de passe pour l’utilisateur admin.

# Factory reset for KerOS6
reboot factory-reset

Installation du LRR

# On your local machine
scp TP_Enterprise_BS_Image_kerlink.KERL_<GW_MODEL>_any<PLATFORM>_<LRR_version>_v<IMG_VERSION> admin@<base_station_IP>:/

ssh admin@<base_station_IP>

# On the base station
sudo su
<enter your root password>
chmod 755 /TP_Enterprise_BS_Image_kerlink.KERL_<GW_MODEL>_any<PLATFORM>_<LRR_version>_v<IMG_VERSION>
/TP_Enterprise_BS_Image_kerlink.KERL_<GW_MODEL>_any<PLATFORM>_<LRR_version>_v<IMG_VERSION>
reboot

Mise à jour de KerOS 5.11.0 vers KerOS 6.4.0

Consultez la documentation et le support Kerlink pour plus de détails sur la façon de flasher la version 5.11.0 du firmware.

Le liveburner est déjà inclus dans l’image LRR pour KerOS 6.4.0. L’exécuter sur un KerOS 5.11.0 mettra à jour le firmware vers KerOS 6.4.0 et installera le LRR en une seule étape.

L’installation du LRR est simple en utilisant Direct SSH.

Téléchargez l’image LRR (par exemple TP_Enterprise_BS_Image_kerlink.KERL_ISTA.1_any_TPCP_SAAS_2.8.96_v1.0) comme décrit dans Récupération de l’image de la passerelle. Transférez‑la ensuite vers la passerelle (pas dans /tmp, qui est trop petit) et exécutez‑la simplement.

Important : définissez un mot de passe administrateur avant de mettre à jour KerOS.

# On your local machine
scp TP_Enterprise_BS_Image_kerlink.KERL_<GW_MODEL>_any<PLATFORM>_<LRR_version>_v<IMG_VERSION> admin@<base_station_IP>:/

ssh root@<base_station_IP>

# On the base station
chmod 755 /TP_Enterprise_BS_Image_kerlink.KERL_<GW_MODEL>_any<PLATFORM>_<LRR_version>_v<IMG_VERSION>
/TP_Enterprise_BS_Image_kerlink.KERL_<GW_MODEL>_any<PLATFORM>_<LRR_version>_v<IMG_VERSION>
reboot

Installation du LRR sur KerOS 4.3.3 ou 5.11.0

Important : si la passerelle ne peut pas être mise à jour vers KerOS 6.4.0, le LRR peut tout de même être installé sur KerOS 5.11.0.

note

La dernière image LRR compatible avec KerOS 4.3.3 embarque un live burner personnalisé, ce qui permet de mettre à jour à distance le LRR depuis KerOS 4.3.3 avec LRR 2.6.27 vers KerOS 5.11.0 avec LRR 2.8.73.

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écupération de l’image LRR

Utilisez l’un des liens suivants pour télécharger l’image LRR en fonction de votre modèle :

• Pour iStation : Dernière image wirista pour KerOS 5.11.0.
• Pour iFemtoCell : Dernière image wirmana pour KerOS 5.11.0.
• Pour iFemtoCell Evolution : Dernière image wirfevo pour KerOS 5.11.0.
• Pour iBTS : Dernière image wirmaar pour KerOS 5.11.0.

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 du LRR de KerOS 4.3.3 vers KerOS 5.11.0

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 effectuer la mise à jour de votre passerelle depuis 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