Einfügen eines eigenen Downloadservers

Anwendungsbereich

Seit Gemini 3.0.0, besteht die Möglichkeit, einen eigenen Downloadserver in das Image zu integrieren. Hierzu müssen allerdings einige "Regeln" eingehalten werden. Auf der Dreambox 7020, im Verzeichnis /etc liegt eine Datei Namens: useraddon.xml. Bei den "kleinen" Boxen (DM5xxx) liegt diese Datei unter /var/tuxbox/config/ Diese wird zwingend benötigt um euren eigenen Server zu identifizieren. Desweiteren muss auf euren Servern eine XML liegen, wie sie in der useraddon.xml angegeben wurde.

Das Addon

Das Addon/Plugin muss als gepacktes *.tar.bz2 File vorliegen, andernfalls findet keine Installation statt! Achtet auch darauf, dass vor dem packen die entsprechenden Dateien die entsprechenden Rechte haben. Hierbei ist zu beachten, das wenn man ein Paket mit z.B. WinRar schnürt, diese Rechte wieder verloren gehen! Ein verpacken mittels Cygwin unter Windows funktioniert tadellos, unter Linux ist dies selbstverständlich Standard.

Info zum "verpacken": Vorgehensweise unter Linux, oder Cygwin identisch. Ihr legt eine Ordnerstruktur entsprechend der späteren Struktur auf der Box an, in den meisten Fällen beginnend mit: /var. Per Konsole nun in den übergeordneten Ordner wechseln, sodass Ihr /var seht. Gebt nun folgendes ein:

tar -cvf addon.tar var

Dies schnürt erstmal alles zusammen, anschliessend:

bzip2 addon.tar

Damit wird dann das *tar File komprimiert -> Fertig.

Die useraddon.xml

Ist der erste Schritt zum einfügen eines eigenen/anderen Downloadservers und sieht wie folgt aus: _________________________________________________________________________________________________

<?xml version="1.0" encoding="iso-8859-1" ?>

<item>

<item name="example (useraddon.xml)" url="http://example/example.xml" />

</item>

________________________________________________________________________________________

In der Sektion "item", wird mit dem Punkt "name" der Name/Kennung des zuzufügenden Servers angegeben. Der Punkt "url" definiert die Zieladresse und die Detail XML (In unserem Fall hier die: example.xml), welche durchsucht werden soll.

Wie in dem Beispiel unschwer zu erkennen ist, können beliebig viele Server eingetragen werden. Hierzu ist einfach eine weitere Zeile " <item name=.... /> " einzufügen.

Die example.xml

Ist die Datei, welche auf eurem Server Lokal vorhanden sein muss. Hier werde Detailinformationen zu dem entsprechendem Dateidownload eingetragen:

_____________________________________________________________________________________________________

<image>

      <image target="0815" name="Plugin1" url="http://beispielserver/plugins/Plugin1" version="001" creator="ME" md5="11111111111111111111111111111111" description="Plugin1 ==> Erstes Plugin" />
           
           

</image>"

________________________________________________________________________________________________________

Auch hier können beliebig viele Sektionen "image" hinzugefügt werden, um eure downloads zu erweitern.

Einzel Erklärung:

  target      = Hier wird die Dateigröße in Bytes angegeben
  name        = Das ist der anzuzeigende Name des Plugins
  url         = Die Zieladresse des downzuloadenden Plugins
  version     = Versionsinformation des Plugins
  creator     = Erstellerinformationen
  md5         = Die md5 Checksumme. Wird beim download verglichen. Wenn diese nicht stimmt, erfolgt kein download!
  description = Beschreibung des Plugins

Angaben die hierbei UNBEDINGT richtig sein müssen sind:

 name, url, md5