Cisco Interface Module voor LoRaWAN IXM upgraden met de Console

Inleiding

Dit document beschrijft de procedure voor het upgraden van de software van een Cisco Iot Extension Module (IXM) met alleen de consolepoort en een USB-station.

Voorwaarden

Vereisten

Er zijn geen specifieke vereisten van toepassing op dit document.

Gebruikte componenten

De informatie in dit document is gebaseerd op de volgende software- en hardware-versies:

• RJ45 naar seriële kabel 
• USB-station (1 GB is meer dan genoeg) of lokale netwerktoegang
• PoE of voeding voor de IXM
• Firmware-images

Opmerking: de firmware-images kunnen worden gedownload van CCO: https://software.cisco.com/download/release.html?mdfid=286311296&softwareid=286311234&release=2.0&relind=AVAILABLE&rellifecycle=&reltype=latest 

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u de potentiële impact van elke opdracht begrijpen.

Achtergrondinformatie

De Cisco IXM of Interface Module voor LoRaWAN kan in twee modi worden uitgevoerd: standalone of virtueel. Wanneer IXM als virtueel wordt uitgevoerd, kan een upgrade worden uitgevoerd vanaf de IR8x9 die is aangesloten op de IXM. In de stand-alone modus kan de upgrade worden uitgevoerd via de CLI. In sommige gevallen is het niet mogelijk om de firmware te upgraden (bijvoorbeeld wanneer de IXM is geconfigureerd voor de virtuele modus en er geen IR8x9 beschikbaar is) of wanneer het verschil in firmware te groot is met betrekking tot versiecompatibiliteit.

Configureren

Stap 1. Bereid de firmware-images (en het USB-station) voor.

Het eerste deel is om de firmware-images voor te bereiden die nodig zijn om de upgrade uit te voeren.

Het doel is om deze bestanden op de IXM te krijgen, dit kan worden gedaan met behulp van een USB-station of lokale netwerkverbinding.

Wanneer de firmware-afbeelding wordt gedownload van CCO, wordt deze geleverd als een gzipped tar-bestand: ixm_mdm_i_k9-2.0.tar.gz.

Extraheer de .tar.gz en kopieer de recovery.itb- en release.itb-bestanden naar een USB-station of HTTP-server, bereikbaar met de IXM.

Stap 2. Verbind IXM via consoletoegang.

Zodra de bestanden om de upgrade uit te voeren zijn voorbereid, moet u verbinding maken met de IXM met behulp van de consolepoort. De consolepoort bevindt zich aan de rechterkant van de IXM en is bedekt met een waterdichte schroef:

Sluit de consolekabel aan op de RJ45 op de IXM en op de seriële poort van uw pc en open een terminal met de volgende instellingen: 8/N/1/115200

Als alles goed gaat, moet u een prompt zien met:

[root@lorawan ~]#

Optioneel vraagt de IXM u om in te loggen met het root-account.

Stap 3. Kopieer de firmwarebestanden naar de IXM.

Optie 1: Een USB-station gebruiken

Wanneer u het USB-station gebruikt, sluit u het station aan op de USB-poort op de IXM (onder de consolepoort). Toegang tot de USB-poort kan moeilijk zijn omdat de ingang vrij smal is, een USB-verlengkabel kan u hier helpen.

Nadat u het USB-station hebt aangesloten, verschijnt dit op het scherm:

root@lorawan ~]# usb 4-1.2: new high-speed USB device number 4 using xhci-hcd
usb 4-1.2: New USB device found, idVendor=058f, idProduct=6387
usb 4-1.2: New USB device strings: Mfr=1, Product=2, SerialNumber=3
usb 4-1.2: Product: USB Flash Drive
usb 4-1.2: SerialNumber: BE087588
usb-storage 4-1.2:1.0: USB Mass Storage device detected
scsi3 : usb-storage 4-1.2:1.0
scsi 3:0:0:0: Direct-Access              USB Flash Drive  8.07 PQ: 0 ANSI: 2
sd 3:0:0:0: [sdb] 15564800 512-byte logical blocks: (7.96 GB/7.42 GiB)
sd 3:0:0:0: [sdb] Write Protect is off
sd 3:0:0:0: [sdb] No Caching mode page found
sd 3:0:0:0: [sdb] Assuming drive cache: write through
sd 3:0:0:0: [sdb] No Caching mode page found
sd 3:0:0:0: [sdb] Assuming drive cache: write through
 sdb: sdb1
sd 3:0:0:0: [sdb] No Caching mode page found
sd 3:0:0:0: [sdb] Assuming drive cache: write through
sd 3:0:0:0: [sdb] Attached SCSI removable disk

Nu, koppel de USB-drive en kopieer de recovery.itb en release.itb bestanden naar /tmp op de IXM:

[root@lorawan ~]# mount /dev/sdb1 /mnt/
[root@lorawan ~]# cp /mnt/*.itb /tmp

Optie 2: De bestanden kopiëren via het netwerk

Wanneer u de bestanden via het netwerk kopieert, sluit u de netwerkpoort van de IXM rechtstreeks of via een switch aan op uw computer en configureert u een bereikbaar netwerkadres. 

Als u een netwerkadres op de IXM wilt configureren om de bestanden te kopiëren, kunt u een gewone ifconfig-opdracht gebruiken: 

[root@lorawan ~]# ifconfig eth0 10.48.43.200

Nadat het apparaat bereikbaar is, kunt u de bestanden downloaden van de in stap 1 voorbereide HTTP-server:

[root@lorawan ~]# cd /tmp
[root@lorawan tmp]# wget http://10.48.43.201:1000/recovery.itb
Connecting to 10.48.43.201:1000 (10.48.43.201:1000)
recovery.itb         100% |*******************************| 23684k  0:00:00 ETA
[root@lorawan tmp]# wget http://10.48.43.201:1000/release.itb
Connecting to 10.48.43.201:1000 (10.48.43.201:1000)
release.itb          100% |*******************************| 44794k  0:00:00 ETA
[root@lorawan tmp]#

Stap 4. Voer de upgrade uit.

broot@lorawan ~]# /opt/script/reimage.sh -n /tmp/release.itb -f /tmp/recovery.it
Calling latest reimage.sh...
Could not find out the version. May be using dev builds. Mode update skipped
Writing factory mode image...
47368+1 records in
47368+1 records out
24252422 bytes (23.1MB) copied, 1.318204 seconds, 17.5MB/s
Writing normal mode image1...
89589+1 records in
89589+1 records out
45869754 bytes (43.7MB) copied, 2.453597 seconds, 17.8MB/s
Writing normal mode image2...
89589+1 records in
89589+1 records out
45869754 bytes (43.7MB) copied, 2.458087 seconds, 17.8MB/s
Updating u-boot boot parameters...
Stop lxc container...
Stopping default lxc container...
umount: /mnt/container/rootfs/run: mountpoint not found
umount: /mnt/container/rootfs/var/run: mountpoint not found
lxcbr0: port 1(vethPFLXN1) entered disabled state
umount: /mnt/container/rootfs: mountpoint not found
device vethPFLXN1 left promiscuous mode
lxcbr0: port 1(vethPFLXN1) entered disabled state
Stop logging service...
Stopping syslog-ng daemon: OK
Stop logging signal received
umount: /var/log/: target is busy
		(In some cases useful info about processes that
		 use the device is found by lsof(8) or fuser(1).)
Try to umount log directory again...
2244
Stop mdev...
umount: /data/uflash: mountpoint not found
Repartion internal SD...

Welcome to fdisk (util-linux 2.26.2).
Changes will remain in memory only, until you decide to write them.
Be careful before using the write command.


Command (m for help): Created a new DOS disklabel with disk identifier 0x676d0d95.

Command (m for help): Partition type
   p   primary (0 primary, 0 extended, 4 free)
   e   extended (container for logical partitions)
Select (default p): Partition number (1-4, default 1): First sector (2048-7618559, default 2048): Last sector, +sectors or +size{K,M,G,T,P} (786432-7618559, default 7618559):
Created a new partition 1 of type 'Linux' and of size 640 MiB.

Command (m for help): Partition type
   p   primary (1 primary, 0 extended, 3 free)
   e   extended (container for logical partitions)
Select (default p): Partition number (2-4, default 2): First sector (2048-7618559, default 2048): Last sector, +sectors or +size{K,M,G,T,P} (2097152-7618559, default 7618559):
Created a new partition 2 of type 'Linux' and of size 2.6 GiB.

Command (m for help): The partition table has been altered.
Calling ioctl() to re-read partition table.
Re-reading the partition table failed.: Device or resource busy

The kernel still uses the old table. The new table will be used at the next reboot or after you run partprobe(8) or kpartx(8).

Recreate filesystem...
Creating filesystem for system data...
/tmp/_reimage.sh: line 322: cryptkey: command not found
/tmp/_reimage.sh: line 323: cryptsetup: command not found
/tmp/_reimage.sh: line 324: cryptsetup: command not found
/tmp/_reimage.sh: line 325: cryptsetup: command not found
mke2fs 1.42.12 (29-Aug-2014)
The file /dev/mapper/cryptroot does not exist and no size was specified.
Creating filesystem for user data...
mke2fs 1.42.12 (29-Aug-2014)
/dev/sda2 contains a ext3 file system labelled 'APP'
	last mounted on Thu Jan  1 00:00:06 1970
/dev/sda2 is mounted; will not make a filesystem here!
Restart mdev...
Starting mdev...
Restart logging service...
Mounting log directory...
Starting syslog-ng daemon: OK
[root@lorawan ~]#

Stap 5. Start de IXM opnieuw op na de upgrade.

Start de IXM opnieuw op om de upgrade te voltooien:

[root@lorawan ~]# reboot
[root@lorawan ~]# watchdog watchdog0: watchdog did not stop!
Stopping cron jobs...
Stopping default lxc container...
lab is not running
umount: /tmp/lxc: not mounted
Stopping sshd: OK
Stopping ntpd: OK
Stop lora HAL...
Stopping Network Interface Plugging Daemon: eth0.
Stopping network...ifdown: interface eth0 not configured
Saving random seed... done.
Clear kernel parameters...
Stopping system config...
Stop checking PID...
Save clock...
killall: watchdog: no process killed
Stopping syslog-ng daemon: OK
Stop logging signal received
No handlers could be found for logger "mdm"
The system is going down NOW!

Verifiëren

Hiermee kunt u controleren of de upgrade succesvol is geweest:

Voorbeeld van een oudere versie:

[root@lorawan ~]# cat /etc/cisco_version 
VERSION=1.0.06
BRANCH=warbler_1_0_throttle
VIEW=nburra-warbler_1_0_throttle.warbler_1_0_throttle_nightly_12052016
FREEZE TIME=05-Dec-2016.21:40:46UTC-08:00

Voorbeeld na de upgrade:

[root@lorawan ~]# cat /etc/cisco_version
VERSION=2.0
BRANCH=corsica_2_0_throttle
VIEW=nburra-corsica_2_0_throttle.corsica_2_0_throttle_NIGHTLY_2.0_05272017_203603
FREEZE TIME=26-May-2017.15:50:34UTC-07:00

Problemen oplossen

Er is momenteel geen specifieke troubleshooting-informatie beschikbaar voor deze configuratie.