Dokumentation für Knetmon

1. Intro
2. Vorraussetzungen
3. Installieren
4. Kompilieren
5. Konfiguration
6. Kommandozeilenparameter
7. Falls Knetmon abstürzt...

Die jeweils neueste Version ist erhältlich unter
http://www.rz.tu-ilmenau.de/~lekus/netmon.html

Bitte informieren Sie mich, wenn Sie es schaffen, knetmon auf einem anderen System als linux/pc zu kompilieren.
Bugreports, Kommentare, Patches, Vorschläge... an
alexander.neundorf@rz.tu-ilmenau.de


Alexander Neundorf

Für vollständige Funktionalität benötigen Sie:

-die KDE-libraries (http://www.kde.org), mindestens libkdecore.so und libkdeui.so, beide in Version 2.0 oder neuer
-die Qt-library 1.4 oder neuer (http://www.troll.no)
-eine funktionierende Samba-Installation, das bedeutet, das folgende sollte funktionieren:
-smbclient
-smbstatus
-smbmount
-smbumount
-ein funktionierendes NFS-System, das bedeutet:
-NFS-Unterstützung im Kernel ("mount ... -t nfs" muss funktionieren)
-"showmount -e" muss funktionieren
-nslookup
-ping
-talk oder ein anderes talk Programm
-telnet
-rlogin
-finger

libqt 1.42
libkdecore 2.0
libc 5.4.33
libg++ 27.2.8
libstdc++ 27.2.8
g++ 2.7.2.1

Packen Sie knetmon-0.99pre1.tgz (tar -zxvf knetm...) aus, wechseln Sie in das neue Verzeichnis, und rufen Sie configure, make und danach make install auf (in dieser Reihenfolge).
Das sollte Knetmon kompilieren und die erzeugte binary in Ihr KDE-binary-Verzeichnis kopieren, einen KDE applink erzeugen und die Dokumentation installieren.
Eventuell muss KPanel danach neu neu gestartet werden, falls Sie es verwenden.
Dann sollten Sie Knetmon im Startmenu under "Internet" finden.
Wenn Sie KNetmon manuell installieren Knetmon wollen:
-kopieren Sie die binary knetmon/knetmon und knetmon/knetmon/netmonwrapper in Ihr KDE-binary-Verzeichnis ($KDEDIR/bin)
-kopieren Sie knetmon/knetmon.kdelnk nach $(KDEDIR)/share/applnk/Internet und starten Sie KPanel neu
-legen Sie die Verzeichnisse $KDEDIR/share/doc/html/eng/knetmon und $KDEDIR/share/doc/html/de/knetmon an und kopieren Sie die Dateien po/en/index.html bzw. po/de/index.html dorthinein

Wenn Knetmon läuft, muss es über den Konfigurationsdialog konfiguriert werden unter ->Mehr ->Konfiguriere .

Stellen Sie sicher, daß Sie das Recht haben, smbmount auszuführen, das heißt, smbmount und smbumount müssen suid root installiert sein (der Administrator (root) Ihres Systems muss das "set user id on execution"-Flag von beiden Dateien setzen).

Wenn Knetmon läuft, muss es konfiguriert werden, den Konfigurationsdialog finden Sie unter ->Mehr ->Konfiguriere .
Knetmon liest seine Konfiguration normalerweise aus der Datei ($KDEDIR)/share/config/knetmonrc und wenn diese nicht existiert von ($HOME)/.kde/share/config/knetmonrc.
Da Netzwerke recht unterschiedlich aufgebaut sein können, ist die Konfiguration recht komplex, am besten Sie probieren an der Kommandozeile mit smbclient und smbmount aus, welche Parameter Sie in Ihrem Netzwerk benötigen und wählen diese dann im Konfiguartionsdialog aus.

Unter Netzwerk-Einstellungens:

Aktive Arbeitsgruppe:

Hier sehen Sie den Namen der momentan angezeigten Arbeitsgruppe und können zwischen den bereits konfigurierten Arbeitsgruppen umschalten.
Um eine Arbeitsgruppe hinzuzufügen, klicken Sie auf Neue Arbeitsgruppe und tragen im erscheinenden Dialog einen Namen für die neue Arbeitsgruppe ein. Der Name kann frei gewählt werden und ist nicht vom realen Namen Ihrer Arbeitsgruppe abhängig.
Um den Namen einer Arbeitsgruppe zu ändern klicken Sie auf Ändere Name. Zum Löschen einer Arbeitsgruppe existiert ein Button Lösche Arbeitsgruppe.
mögliche Werte: beliebiger_Name
Voreinstellung: default
knetmonrc: wg_name

Knetmon wird diesen Namen überall einsetzen, wo Nutzernamen erforderlich sind, Sie haben aber immer die Möglichkeit, einen anderen Namen einzutragen.

mögliche Werte: beliebiger_Name
Voreinstellung: tux
knetmonrc: std_user

Knetmon wird versuchen, die browse list mit "smbclient -L ..." von dem Rechner zu holen, den Sie hier angeben.
Eventuell können Sie diese Einstellung auf "localhost" lassen, aber normalerweise sollte es mit dem Nameserver oder etwas ähnlichem besser funktionieren.
Wenn Sie die Option "Hole browse list mittels Samba" nicht aktiviert haben, sollte diese Option egal sein.

mögliche Werte: name of a samba or windows machine
Voreinstellung: localhost
knetmonrc: browselist_server

Hier entscheiden Sie, ob Knetmon nslookup für einige Aktionen verwenden wird. Wenn Sie diese Option aktivieren, müssen Sie die IP-Adresse Ihres Nameservers in der Eingabezeile eintragen, wenn Ihr LAN ordentlich funktioniert, sollte es auch mit dem Namen des Nameservers klappen.
Wenn Sie diese Option aktivieren, sind Sie in der Lage, die IP-Adressen andererr Rechner zu abzufragen, und Sie können Knetmon dazu zwingen, die IP-Adressen für Samba (wie: "smbclient -I 123.456.789.012 ...") zu benutzen. Weiterhin ermöglicht es Ihnen, die Liste der im Netz aktiven Rechner ohne smbclient zu bekommen.
Wenn Sie sich nicht sicher sind, lassen Sie diese Option aus.

mögliche Werte: inaktiv (no) oder die IP-Adresse oder der Name Ihres Nameservers
Voreinstellung: no
knetmonrc: use_nslookup

Statt nslookup kann auch nmblookup verwendet werden, bei den meisten Konfigurationen funktioniert beides. nmblookup muss verwendet werden, wenn die Rechner in ihrem Netz von ihren DNS-Namen abweichende WINS-Namen haben.
mögliche Werte: yes, no
Voreinstellung: no
knetmonrc: use_nmblookup

Wenn Sie diese Option einstellen, wird Knetmon smbclient wie folgt aufrufen: smbclient -L hostname -I 123.456.789.012
sonst ohne: smbclient -L hostname
In den meisten Fällen ist diese Option nicht nötig.
Wenn Sie diese Option aktivieren, muß auch "Benutze NSLookup" aktiviert werden.
Wenn Sie nicht sicher sind, aktivieren Sie diese Option nicht.

mögliche Werte: yes, no
Voreinstellung: no
knetmonrc: use_ip_for_samba

Diese Option sollten Sie einschalten, wenn Sie die Option -W benutzen, wenn Sie smbclient manuell aufrufen, dies sollte nur nötig sein, wenn es in Ihrem Netzwerk mehr als eine Arbeitsgruppe gibt. Als Name der Arbeitsgruppe wird dann der Name in Aktive Arbeitsgruppe benutzt. Wenn Sie sich nicht sicher sind, aktivieren Sie diese Option nicht.

mögliche Werte: yes, no
Voreinstellung: no
knetmonrc: use_wgname_for_samba

Bei manchen Netzwerkkonfigurationen ist es notwendig, bei smbclient die Option -U guest zu benutzen, um auf einen Rechner zugreifen zu können.

mögliche Werte: yes, no
Voreinstellung: no
knetmonrc: use_guest_for_samba

Wenn Sie diese Option aktivieren, werden Sie jedesmal, wenn Sie auf Freigaben anderer Rechner zugreifen wollen, nach Nutzername und Passwort gefragt.
Dann wird smbclient so aufgerufen: smbclient //hostname/IPC$ yourpassword -L hostname -U mylogonname
Diese Option wird (glaube ich) hauptsächlich gebraucht, wenn Ihr Server ein NT PDC ist und die Freigaben alle über Benutzerebene laufen.

mögliche Werte: yes, no
Voreinstellung: no
knetmonrc: use_pw_allways

Da sich die Syntax der Optionen von Samba mit der Version 2.0 stark geändert hat, müß dies hier angegeben werden.

mögliche Werte: yes, no
Voreinstellung: no
knetmonrc: use_samba2

Wenn Sie das Standard Unix-Talk in einem xterm benutzen wollen, lassen Sie diese Option inaktiv, wenn Sie ein Xwindows-Talk Programm (welches nicht in einem xterm läuft) tragen Sie diese in die Eingabezeile ein.
Es ist wichtig, daß dieses Talk, wenn man es wie folgt startet: "ihrXtalk nutzername@rechnername" versucht eine Verbindung zu "nutzername" auf Rechner "rechnername" herzustellen.
Sicher wollen Sie dazu "ktalk" verwenden.

mögliche Werte: jedes funktionierende X Talk
Voreinstellung: inaktiv (standard)
knetmonrc: xtalk

Dieser xterm wird benutzt werden um ping, rlogin und so weiter auszuführen.
Kvt funktioniert eventuell nicht, Sie sollten es einfach bei "xterm" lassen.

mögliche Werte: jeder beliebige xterm mit Optionen entsprechend dem Standard-xterm
Voreinstellung: xterm
knetmonrc: xterm

Der xterm der bei "Benutze dieses xterm" angegeben wurde, wird mit diesen Optionen gestartet werden, tragen Sie hier ein, was Ihne gefällt, zum Beispiel "-fn 7x14" um die Schriftgröße 7x14 in einem Standard-xterm zu benutzen.

mögliche Werte: gültige Optionen für den gewählten xterm
Voreinstellung:
knetmonrc: xterm_options

Dies ist der Dateimanager, der gestartet wird, wenn Sie "Erkunde Rechner" auswählen. Wenn Sie Ihren Dateimanager namens "xyz_fm" starten wollen, der das Verzeichnis "irgendeins" anzeigt, und dazu an der Kommandozeile "xyz_fm -d irgendeins" eingeben würden, dann tragen Sie hier "xyz_fm -d %dir" ein, dann sollte es funktionieren.
Wenn Sie einen Textmodus-(Terminal-)Dateimanager angeben, z.B. "mc" in Farbe mit der Schriftgröße 7x14, müssen Sie eintragen:
"color_xterm -fn 7x14 -e mc -c %dir".

mögliche Werte: jeder funktionierende Dateimanager
Voreinstellung: kfmclient openURL %dir
knetmonrc: filemanager

Tragen Sie hier das Verzeichnis ein, unter dem die Freigaben anderer Rechner gemountet werden sollen. Um auf die Freigaben anderer Rechner zugreifen zu können, müssen . diese zuerst gemountet werden. Wenn Sie zum Beispiel hier "~/Netzwerkumgebung" eingeben, und eine Freigabe mit dem Namen "public" vom Rechner "der_rechner" aus der Arbeitsgruppe "meine_AG", mounten, wird diese Freigabe unter ~/Netzwerkumgebung/meine_AG/der_rechner/public gemountet.
In diesem Verzeichnis müssen Sie unbedingt Schreibberechtigung haben.
Meiner Meinung nach sollten Sie diese Einstellung so lassen, eine weitere Möglichkeit wäre irgendwo unterhalb von /tmp/, dort sollte auch jeder Schreibberechtigung haben.

mögliche Werte: ein beliebiges Verzeichnis, in dem Sie Schreibberechtigung haben
Voreinstellung: ~/network/
knetmonrc: mount_point

Hier geben Sie die Anzahl von Sekunden an, nach denen Knetmon periodisch seine Anzeige aktualisiert.

mögliche Werte: 5 bis 3600
Voreinstellung: 300
knetmonrc: refresh

Hier tragen Sie die Anzahl der Sekunden ein, die KNetmon auf Antworten von anderen Rechnern im Netz warten wird, z.B. die Zeit die KNetmon auf smbclient oder nslookup warten wird.
Abhängig von Ihrem Netzwerk, sollte eine Zeit von 5 Sekunden genug sein.

mögliche Werte: 1 bis 600
Voreinstellung: 15
knetmonrc: killing_time

Hier entscheiden Sie, ob die Freigaben, die von Knetmon gemountet wurden, beim Beenden des Programms automatisch geunmountet und die angelegten Verzeichnisse geloescht werden.
Diese Option sollte immer gewählt werden, sonst kann es Probleme geben.

mögliche Werte: yes, no
Voreinstellung: yes
knetmonrc: unmount_on_exit