 |
Online-Hilfe icom Data Suite |
Update-Pakete
Allgemeines
Update-Pakete werden benutzt, um mit der icom Data Suite Dateien auszutauschen, die in der icom Data Suite gespeichert oder ausgeführt werden sollen. In jedem Update-Paket ist ein Manifest in Form einer Datei enthalten, dessen Einträge die enthaltenen Dateien beschreiben. Das Manifest und die Dateien als unkomprimiertes tar-Archiv zusammen ergeben ein Update-Paket. Bei den Dateien kann es sich um Profil- oder Konfigurationsdateien handeln.
Bereits gepackte Pakete (diese enthalten bereits ein MANIFEST) sind bereits für ein Update verwendbar. Sollen verschiedene Update-Pakete in einem Paket zusammengefasst werden, zum Beispiel ein Profil und eine ASCII-Konfiguration (wie im Beispiel unten), müssen die einzelnen Pakete zuerst entpackt werden und dann die darin enthaltenen Dateien zusammen mit dem Manifest zu einem gemeinsamen Update-Paket geschnürt werden.
Manifest
Das Manifest ist eine Textdatei (ASCII oder UTF-8 ohne BOM) mit dem Dateinamen "MANIFEST" (ohne Dateinamenserweiterung, z.B. .txt). Es enthält Sektionen, die die Dateien im Archiv beschreiben. Leere Zeilen werden ignoriert. Groß- und Kleinschreibung wird unterschieden. Jede Zeile muss mit einem Schlüsselwort beginnen, anschließend folgt das "="-Zeichen und der Wert. Direkt vor und nach dem "=" sind keine Leerzeichen erlaubt. Eine neue Sektion wird mit dem Schlüsselwort "FILENAME" begonnen. Das Manifest sollte immer die erste Datei sein, die im Archiv enthalten ist. Ein Update-Paket muss somit nicht komplett übertragen werden um erkennen zu können, was dieses Archiv enthält. Im Manifest enthaltene Schlüsselwörter sind:
| Schlüsselwort | Bedeutung | zwingend erforderlich |
|---|---|---|
| FILENAME | Dateiname der zu benutzenden Datei | ja |
| FILETYPE | fest vorgegebener Text, der den Typ der Datei beschreibt | ja |
| MD5SUM | MD5-Prüfsumme, um die Unversehertheit der Datei zu prüfen | ja |
| FILESIZE | Angabe der Größe der Datei in Bytes | nein |
| DESCRIPTION | freier Text, der die zu benutzende Datei beschreibt | nein |
| VERSION | Eine Versionsbezeichnung | nein |
Mögliche Einträge für den FILETYPE sind:
| FILETYPE | Bedeutung |
|---|---|
| icom Data Suite - Binary Configuration | Die Datei ist ein Profil in Form einer Binärdatei |
| icom Data Suite - ASCII Configuration | Die Datei ist eine ASCII-Konfiguration, die nach dem Hochladen sofort ausgeführt und nicht gespeichert wird |
| icom Data Suite - Stored ASCII Configuration | Die Datei ist eine ASCII-Konfiguration, die nach dem Hochladen gespeichert und nicht ausgeführt wird |
Beispiel eines Manifests für ein Profil-Paket
FILENAME=Profile
FILESIZE=17312
FILETYPE=icom Data Suite - Binary Configuration
DESCRIPTION=Profile: 'Profile', created on 2016-05-20 12:42:40
MD5SUM=3750def5c933925710196ae756cda1eb
Beispiel eines Manifests für ein ASCII-Konfigurations-Paket
FILENAME=ascii.txt
DESCRIPTION=ASCII config
MD5SUM=11d11f5bd994e6ad1294e14fe921de5f
FILETYPE=icom Data Suite - ASCII Configuration
Beispiel eines Manifests für ein Paket mit einem Profil und einer ASCII-Konfiguration
FILENAME=Profile
FILESIZE=17312
FILETYPE=icom Data Suite - Binary Configuration
DESCRIPTION=Profile: 'Profile', created on 2016-05-20 12:42:40
MD5SUM=3750def5c933925710196ae756cda1eb
FILENAME=ascii.txt
DESCRIPTION=ASCII config
MD5SUM=11d11f5bd994e6ad1294e14fe921de5f
FILETYPE=icom Data Suite - ASCII Configuration