Update-Pakete werden benutzt, um mit dem Router Dateien auszutauschen, die auf dem Router gespeichert oder ausgeführt werden sollen.

Dabei kann es sich handeln um:

  • Firmware-Updates

  • Binäre Konfigurationsdateien

  • ASCII-Konfigurationsdateien

  • Container

  • Container-Konfigurationen

Unterschiedliche Dateien können in einem kombinierten Update-Paket zusammengepackt werden. Eine Manifest-Datei definiert die im Paket enthaltene(n) Datei(en) und ist ebenso Teil des Pakets.

Situation

Sie haben einen Router im Feld und müssen die Konfiguration des Routers mit Hilfe einer ASCII-Konfigurationsdatei aktualisieren. Folgende Lösung beschreibt, wie ein Update-Paket, das eine Konfigurationsdatei enthält, zusammengepackt wird. Andere Update-Pakete können entsprechend zusammengepackt werden.

Lösung

Es wird vorausgesetzt, dass Sie eine ASCII-Konfigurationsdatei haben, wie sie zum Beispiel in diesem Configuration Guide erzeugt wurde. [1]

Sie müssen noch ein Update-Paket erstellen, das diese Konfigurationsdatei enthält.

Erstellen des Update-Pakets

  1. Die PowerShell auf einem Windows-Rechner über die Windows-Taste () und Eingabe von powershell öffnen oder ein Terminal-Fenster auf einem Linux-Rechner öffnen.

  2. Zum Verzeichnis wechseln, in dem die ASCII-Konfigurationsdatei abgelegt ist.

  3. Die MD5-Prüfsumme der Konfigurationsdatei berechnen:
    > md5sum ascii_config_file.txt [2]

  4. Die MD5-Prüfsumme in die Zwischenablage kopieren.

  5. Eine Textdatei mit dem Namen MANIFEST (ohne Dateiendung) und folgendem Inhalt erzeugen:
    FILENAME=ascii_config_file.txt
    DESCRIPTION=ASCII config for update packet example [3]
    MD5SUM=paste_above_checksum_here
    FILETYPE=ASCII Configuration [4]

  6. Die MANIFEST-Datei und die ASCII-Konfigurationsdatei in das Update-Paket packen:
    > tar -vcf config_packet.tar MANIFEST ascii_config_file.txt [5]

Sie haben jetzt ein Update-Paket erstellt, das auf den Router hochgeladen werden kann.

Es gibt unterschiedliche Dateitypen für unterschiedliche Dateien und Zwecke. Folgende Tabelle zeigt diese Optionen:
FILETYPE Zweck

Full Software Update

Major-Firmware-Update (1.0, 2.0, 3.0 usw.)

Incremental Software Update

Minor-Firmware-Update (2.1, 2.2, 2.3 usw.)

Binary Configuration

Profil in Form einer Binärdatei

ASCII Configuration

ASCII-Konfiguration, die nach dem Hochladen sofort ausgeführt und nicht gespeichert wird

Stored ASCII Configuration

ASCII-Konfiguration, die nach dem Hochladen gespeichert und nicht ausgeführt wird

Container

Linux-Container

Container Configuration

Der als tar-Archiv gepackte Inhalt von /data/etc eines Containers

Hochladen des Update-Pakets im Web-Interface

  1. Web-Interface des Routers mit einem Browser aufrufen: 192.168.1.1 [6]

  2. Im Menü Administration → Up-/Download zum Abschnitt Upload gehen, auf Durchsuchen…​ klicken und das oben erzeugte Update-Paket auswählen.

  3. Auf Hochladen klicken.

Das Update-Paket wird auf den Router hochgeladen und entsprechend verarbeitet.

Fehlersuche

  • Die MANIFEST-Datei darf keine Dateiendung haben, wie zum Beispiel .txt.

  • Bei Windows-Rechnern kann es vorkommen, dass die Routine md5sum zur Berechnung der MD5-Prüfsumme nicht verfügbar ist. In diesem Fall kann die Prüfsumme mit dem Befehl certutil -hashfile ascii_config_file.txt md5 berechnet werden.

Zurück zu den Configuration Guides für die icom OS Smart Devices

Zurück zur Übersicht

1. Diese ASCII-Konfigurationsdatei kann für Testzwecke verwendet werden.
2. Dies ist nur ein Beispiel für den Namen einer ASCII-Konfigurationsdatei.
3. Dies ist nur eine Beschreibung der enthaltenen Konfigurationsdatei.
4. Die Schreibweise des Dateitypen ist wichtig, da er die Verwendung des Update-Pakets festlegt.
5. Dieser Befehl packt die angegebenen Dateien (hier MANIFEST und ascii_config_file.txt) in das angegebene tar-Paket (hier config_packet.tar).
6. Anmeldung je nach Konfiguration; Voreinstellung bei älteren Firmware-Versionen: Benutzername: insys, Kennwort: icom