***************************************** *** GSDB : Greywolf's Server Database *** ***************************************** EINLEITUNG Dies ist eine kleine Webseite, die entstanden ist, um auf LAN-Parties FTP-, HTTP- und SMB-Server leichter zu finden und durchsuchen zu koennen. Jeder Besucher kann Server mit allen benoetigten Daten (Login, Passwort, IP, Port, Kommentare) in die Liste eintragen und (Passwortgeschuetzt) die Eintraege spaeter auch aendern oder loeschen. SMB Server werden automatisch im Netz gesucht und in die Liste aufgenommen. (Benoetigt ein installiertes Samba-Paket) Als "Bonus" gibt es noch einen Zugriffszaehler und ein Gaestebuch dazu. :-) Um die Server zu durchsuchen, werden ueber einen eigenen kleinen Daemon in regelmaessigen Abstaenden Skripte gestartet, die die Verzeichnislisten erstellen und den Status der Server (online/offline) pruefen. Das Durchsuchen nach Windows-Freigaben ist optional, da das Durchsuchen der Freigaben und besonders die Suche in den erstellten Verzeichnislisten den Server ziemlich stark belasten kann. Um Windows 2000-Freigaben zu sehen, wird uebrigens Samba ab Version 2.0.7 benoetig. INSTALLATION Einfach die Datei "install.sh" aufrufen. Eine Installation als "root" sollte nicht noetig sein, sofern man an den Installationsverzeichnissen Schreibrechte hat. Den WWW Server muss jeder selber entsprechend konfigurieren ... Es werden ausserdem folgende Programme benoetigt : - "grep" -> zur schnelleren Suche in den Verzeichnislisten - "FTP.pm" -> Perl-Modul zum Zugriff auf FTP Server URL: http://www.perl.com/CPAN-local/modules/by-module/Net/libnet-.tar.gz - "CGI.pm" und "Cookie.pm" -> fuer Diverses ... URL: http://www.perl.com/CPAN-local/modules/by-module/CGI/CGI.pm-.tar.gz Die Suche in Windows-/Samba-Freigaben benoetigt ausserdem : - "nmblookup" und "smbclient" (aus dem Samba Paket) -> zum Finden der Server und Erstellen der Verzeichnislisten Wer den Counter installieren moechte, braucht dafuer : - "GD.pm" -> Perl-Modul zur Grafikmanipulation URL: http://www.perl.com/CPAN-local/modules/by-module/GD/GD-.tar.gz GIF wird bis hoechstens Version 1.19 unterstuetzt, spaetere Versionen unterstuetzen stattdessen PNG (der Counter kann beides verwenden, bei der Installation muss gewaehlt werden, welche Unterstuetzung aktiviert werden soll) (... ich hoffe, ich hab nix wichtiges vergessen ... ;-) ) Nach der Installation (und nach jedem Rechnerneustart) muss /usr/local/httpd/cgi-data/gsdb/gsdbupdated per Hand gestartet werden. Dieses Programm laeuft im Hintergrund und startet im (in der Konfigurationsdatei) angegebenen Intervall die Skripte, die Status und Dateilisten aktualisieren. "gsdbupdated --term" beendet einen bereits laufenden Daemon. Fuer weitere Funktionen siehe "gsdbupdated --help". KONFIGURATION Erledigt das Installationsprogramm ... Aenderungen an der Konfiguration koennen nachtraeglich an der Konfigurations- datei /usr/local/httpd/cgi-data/gsdb/config.pl vorgenommen werden. Wer spaeter einmal eingetragene Server loeschen moechte (ohne das Passwort zu haben), findet die jeweiligen Dateien in den *Unterverzeichnissen* von /usr/local/httpd/cgi-data/gsdb (Standardpfad). Die Dateinamen sind selbst- erklaerend ... einfach die Dateien der jeweiligen Server loeschen und gut ... (aber nicht die Verzeichnisse oder Skripte mit loeschen!) Der Counter und das Gaestebuch lassen sich wie schon gesagt fuer mehrere Seiten verwenden. Um einen neuen Benutzer fuer das Gaestebuch anzulegen, muss einfach nur ein weiteres Verzeichnis in /usr/local/httpd/cgi-data/guestbook angelegt werden. Verzeichnisname = Benutzername. (Gross-/Kleinschreibung beachten!) Aufruf mit "http://.../cgi-bin/guestbook.cgi?user=" Fuer den Counter wird aehnlich leicht ein neuer Benutzer angelegt. "echo 0 > /usr/local/httpd/cgi-data/counter/users/" Aufruf mit "http://.../cgi-bin/counter.cgi?user=&options=x,y,z" x = Zahlenset, y = Rahmenset (0=kein Rahmen), z = Anzahl der Stellen (1-9) Zu Zahlenset und Rahmenset siehe /usr/local/httpd/cgi-data/counter (einfach mal die Bilder anschauen ...) Wenn trotzdem mal etwas nicht klappt, sollte man nachschauen, ob der WWW Server (und moeglichst auch NUR der) fuer die angegebenen Verzeichnissen bzw. Dateien auch *Schreibrechte* hat! (Bei den Skripten reichen Lese- und natuerlich Ausfuehrrechte) Notfalls einfach einen Blick in das Installationsskript werfen oder die Dateien noch einmal drueberinstallieren ... SONSTIGES Ich hasse es, ne Doku zu erstellen ... (fast so schlimm, wie im Programm zu versuchen, alle moeglichen Eingabefehler abzufangen ;-) ...) Wer nen Fehler findet: Mail am mich. Wenn was nicht laeuft und ein Blick in diese Beschreibung und vielleicht auch ein Blick in den Sourcecode nicht weiterhelfen: auch Mail an mich ... Download : http://www.wiesner-net.de/gsdb.tar.gz Homepage : http://www.wiesner-net.de Copyright (C) 1999,2000 Markus Wiesner (m_wiesner@gmx.net) This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.