APT-TRANSPORT-MIRR(1) APT APT-TRANSPORT-MIRR(1) NAME apt-transport-mirror - APT-Transportmethode fur starker automatisierte Spiegelserverauswahl BESCHREIBUNG Diese APT-Transportmethode implementiert kein Protokoll, um auf lokale oder ferne Depots selbst zuzugreifen, beschafft jedoch eine Spiegelserverliste und leitet alle Anfragen an den/die Spiegel, der/die aus der Liste herausgegriffen wurde(n). Der Zugriff erfolgt uber andere Transportprotokolle wie apt-transport-http(1). Die Grundfunktionalitat ist seit APT 0.7.24 verfugbar, war jedoch bis APT 1.6 nicht dokumentiert. APT 1.6 enthalt eine komplette Neuentwicklung der Transportmethode und der unterstutzten Funktionalitaten. Beachten Sie, dass eine Transportmethode niemals durch einen Benutzer direkt aufgerufen wird, jedoch von APT-Werkzeugen basierend auf der Konfiguration des Benutzers. Falls das Beschaffen einer Datei mittels eines Spiegelservers fehlschlagt, stellt die Methode sicher, dass automatisch ein anderer moglicher Spiegelserver der Liste ausprobiert wird, entweder bis die Datei geholt wurde oder bis kein Spiegelserver auf der Liste mehr ubrig ist. Damit werden transparent Serverausfallzeiten und ahnliche Probleme gehandhabt. Die Konsequenzen fur die Sicherheit aufgrund der Transportmethode basieren auf Sicherheitserwagungen, die mit der Transportmethode verbunden sind, die zum Holen der Spiegelserverliste verwendet wird, und welche Transportmethoden beim Zugriff auf den/die ausgewahlten Spiegelserver durch die Transportmethode beteiligt sind. OPTIONEN Diese Transportmethode hat derzeit keine Konfigurationsoptionen. Die Auswahl des Spiegelservers basiert ganz auf den angebotenene Spiegelservern auf der Spiegelserverliste und den Dateien, die APT holen mochte. Spiegelserverlistenformat Eine Spiegelserverliste enthalt mindestens eine Zeile. Jede Zeile gibt einen URI fur einen Spiegelserver an. Leere Zeilen und die, die mit einem Rautezeichen (#) beginnen, werden ignoriert. Ein URI beginnt immer mit einem URI-Schema, das angibt, welche Transportmethode fur diesen Spiegelserver benutzt wird. Falls der URI beispielsweise mit http: anfangt, ist die zustandige Transportmethode apt-transport- http(1), was spezielle Anforderungen an das Format des verbleibenden Teils des URI stellen kann. Metadaten uber einen Spiegelserver konnen in derselben Zeile angegeben werden, vom URI durch einen Tabulator getrennt. Mehrere Elemente der Metadaten konnen ihrerseits durch Leerzeichen oder Tabulatoren getrennt werden. (Dies ist eine fortschrittliche Funktionalitat, die erst seit APT 1.6 verfugbar ist. Altere APT-Versionen scheitern bei der Auswertung von Spiegelserverlisten, die diese Funktionalitat verwenden.) Seit APT 1.6 wird auch die Verwendung komprimierter Spiegelserverlisten unterstutzt. Beachten Sie, dass der Dateiname der Spiegelserverliste den verwendeten Komprimierungsalgorithmus angeben muss; es wird keine automatische Bestimmung anhand des Dateiinhalts durchgefuhrt. Spiegelserverauswahl anhand von Metadaten Wie im Format angegeben, konnen an einen Spiegelserver zusatzliche Metadaten angehangt werden, um zu verhindern, dass ein Spiegelserver ausgewahlt wird, um eine Datei zu beschaffen, die diesen Metadaten nicht entspricht. Auf diese Weise kann die Spiegelserverliste z.B. Teilspiegelserver enthalten, die nur bestimmte Architekturen bereitstellen, und APT wird fur Dateien, die eine nicht aufgefuhrte Architektur benotigen, automatisch einen anderen Spiegelserver auswahlen. Unterstutzt werden Beschrankungen fur die Architektur (arch), den Codenamen der Veroffentlichung (codename), Bestandteil des Depots, in dem sich die Datei befindet (component), die zur Datei passende Sprache (lang), Suite-Name der Veroffentlichung (suite) und Typ der Datei (type). Reihenfolge der Ersatzspiegel Falls fur einen Spiegel keine Prioritat uber den Metadatenschlussel priority angegeben wurde, ist die Reihenfolge, in der die Spiegelserver ausgewahlt werden, zufallig. Falls eine bestimmte Zusammenstellung von Spiegelservern zuerst vor anderen Zusammenstellungen ausprobiert werden soll, kann die Prioritat explizit gesetzt werden. Die Spiegelserver mit der niedrigsten Nummer werden zuerst ausprobiert. Spiegelserver, die keine explizit gesetzte Prioritat haben, werden standardmassig auf die hochstmogliche Nummer gesetzt und daher zuletzt ausprobiert. Die Auswahl zwischen Spiegelservern mit derselben Prioritat erfolgt wiederum zufallig. Erlaubte Transportmethoden in einer Spiegelserverliste Die Verfugbarkeit und Auswahl von Transportmethoden in einer Spiegelserverliste wird durch die Zugriffsart von APT auf die Spiegelserverliste beschrankt. Falls eine lokale Transportmethode wie file oder copy benutzt wird, kann die Spiegelserverliste auch lokale Ressourcen enthalten, wahrend eine Spiegelserverliste, auf die per http zugegriffen wird, dies nicht kann. Eine Spiegelserverliste kann nicht zusatzlich eine weitere Spiegelserverliste oder andere verpackte Transportmethoden (wie apt-transport-tor) enthalten. Sie finden in der Dokumentation dieser Transportmethoden, wie sie mit der Spiegelservermethode benutzt werden. Beachten Sie, dass APT-Versionen vor 1.6 keine andere Transportmethode als http unterstutzten. BEISPIELE Einfaches Beispiel Eine einfache Beispielspiegelserverliste, die von allen APT-Versionen mit einer Spiegelservermethode (>= 0.7.24) unterstutzt wird, in der der Client einen von drei Spiegelservern aussuchen kann: http://ftp.de.debian.org/debian/ http://ftp.us.debian.org/debian/ http://deb.debian.org/debian/ Angenommen, eine Datei mit diesem Inhalt ware als /etc/apt/mirrorlist.txt auf Ihrem Rechner gespeichert. Sie kann (seit APT 1.6) wie folgt in sources.list(5) benutzt werden: deb mirror+file:/etc/apt/mirrorlist.txt bookworm main Alle Versionen der Spiegelservermethode unterstutzen eine Spiegelserverliste, auf die mittels HTTP zugegriffen werden kann. Wird davon ausgegangen, dass sie unter http://apt.example.org/mirror.lst verfugbar ist, kann obiger Sources.list-Eintrag kann stattdessen auch wie folgt geschrieben werden: deb mirror://apt.example.org/mirror.lst bookworm main Beachten Sie, das seit APT 1.6 die Verwendung von mirror+http der Einheitlichkeit wegen mirror vorgezogen werden sollte. Die Funktionalitat ist dieselbe. Beispiel mit verbesserter Spiegelserverauswahl anhand von Metadaten Wie in der Formatdefinition erklart, unterstutzen dies APT-Versionen vor 1.6 nicht und das Auswerten der Spiegelserverliste wird scheitern. Die Beispielspiegelserverliste ist absichtlich komplex, um einige Aspekte der Auswahl zu zeigen. Die folgende Einstellung wird angenommen: Der erste Spiegelserver ist ein lokaler Spiegelserver, auf den mit der File-Methode zugegriffen wird, aber moglicherweise unvollstandig. Der zweite Spiegelserver hat eine gute Verbindung, ist aber ein Teilspiegelserver in sofern, dass er nur Dateien der Architekturen amd64 und all enthalt. Die verbleibenden Spiegelserver sind Durchschnittsserver, die nur kontaktiert werden sollen, wenn die vorherigen nicht funktionieren. file:/srv/local/debian/mirror/ priority:1 type:index http://partial.example.org/mirror/ priority:2 arch:amd64 arch:all type:deb http://ftp.us.debian.org/debian/ type:deb http://ftp.de.debian.org/debian/ type:deb https://deb.debian.org/debian/ In dieser Einstellung mit dieser Spiegelserverliste wird der erste Spiegelserver benutzt, um alle Indexdateien herunterzuladen, unter der Annahme, dass auf die Spiegelserverliste selbst uber eine lokale Transportmethode wie file zugegriffen wird. Falls dies nicht so ist, auf den Spiegelserver aus einem anderen Grund nicht zugegriffen werden kann oder er die angeforderte Datei nicht enthalt, wird ein anderer Spiegelserver benutzt, um die Datei zu beschaffen, was vom Typ der Datei abhangt: Eine Indexdatei wird durch den letzten Spiegelserver auf der Liste bereitgestellt, wahrend ein Paket der Architektur amd64 durch den zweiten und z.B. der Architektur i386 durch einen der letzten drei. FEHLER APT-Fehlerseite[1]. Wenn Sie einen Fehler in APT berichten mochten, lesen Sie bitte /usr/share/doc/debian/bug-reporting.txt oder den reportbug(1)-Befehl. Verfassen Sie Fehlerberichte bitte auf Englisch. UBERSETZUNG Die deutsche Ubersetzung wurde 2009 von Chris Leick in Zusammenarbeit mit dem deutschen l10n-Team von Debian angefertigt. Beachten Sie, dass diese Ubersetzung Teile enthalten kann, die nicht ubersetzt wurden. Dies ist so, damit kein Inhalt verloren geht, wenn die Ubersetzung hinter dem Originalinhalt hinterherhangt. AUTOR APT-Team FUssNOTEN 1. APT-Fehlerseite https://bugs.debian.org/src:apt APT 2.9.8 09 Dezember 2017 APT-TRANSPORT-MIRR(1)