Diese Anleitung zeigt, wie man die Cisco Online-Dokumentation auf einen lokalen Rechner spiegeln kann.
Los geht es:
- Das Tool wget besorgen
Unter Linux hat man das vermutlich per default installiert, unter Windows kann man dieses (und viele weitere nützliche Linux-Tools) von http://unxutils.sourceforge.net/ herunterladen und installieren (man kopiert die Dateien einfach an einen Ort, der im Suchpfad von Windows steht). - Dann legt man sich ein Verzeichnis auf der Festplatte für die gespiegelte Cisco-Dokumentation an und wechselt auf der Kommandozeile in dieses Verzeichnis. Bei einem NTFS-Dateisystem kann man übrigens durch das Setzen des “Komprimierung”-Schalters viel Plattenplatz sparen.
- In dem Verzeichnis erstellt man eine Datei (bei mir heißt sie mirror-DocCD.cmd) und in diese Datei kommt der wget-Aufruf mit den passenden Parametern:
wget -k -K -p -m -R pdf,pl,txt,do,cgi -I /univercd/home/ www.cisco.com/univercd/home/home.htm
Vorsicht:
Diese Zeile kopiert die komplette Online-Dokumentation. Das kann zum einen lange dauern und erzeugt natürlich auch viel Traffic.
Die Bedeutung der Parameter (sie sind natürlich auch in der Doku zu wget beschrieben):
-k
konvertiert absolute in relative Links, damit die Links nicht zu www.cisco.com führen. Diese Konvertierung wir nach allen Downloads durchgeführt, daher sollte der Befehl nicht vorzeitig abgebrochen werden.
-K
sichert die Dateien vor der Konvertierung. Das wird gemacht um bei einem weiteren Aufruf von wget besser erkennen zu können ob sich die Datei geändert hat.
-p
holt alle Grafiken, die für die Darstellung der Seiten benötigt werden
-m
durchsucht alle Links auf der Startseite rekursiv (ohne Begrenzung), lädt aber nur Dateien, die neuer als lokal vorhandene Dateien sind.
-R
Die Dateiendungen, die nicht heruntergeladen werden sollen (hier halt pdf, pl, txt, do, cgi)
-I
Das Verzeichnis, in dem wget beim Herunterladen bleiben soll. Wenn dieser Parameter fehlt holt wget nahezu die gesamte Cisco-Webseite. Diesen Parameter wollen wir wirklich nicht vergessen!
Da auch dieses Spiegeln der Doku ziemlich lange dauern kann, ist es evtl. sinnvoll nur bestimmte benötigte Kapitel herunterzuladen. Der folgende Aufruf holt z.B. nur die Dateien, die zum IOS 12.4 gehören:
wget -k -K -p -m -R pdf,pl,txt,do,cgi
-I /univercd/cc/td/doc/product/software/ios124/ www.cisco.com/univercd/cc/td/doc/product/
software/ios124/124cg/index.htm
Dieser Befehl kann jetzt natürlich auch wiederholt ausgeführt werden um geänderte oder neue Seiten in der Doku herunterzuladen (was schon auf der Festplatte ist wird natürlich nicht nochmal geladen). Um Ciscos (und auch unsere) Ressourcen zu schonen sollte man das natürlich nicht zu häufig machen. So, nun viel Spaß mit der gespiegelten Cisco Dokumentation.