efileman FAQ

Erhalte Internal Server Error The server encountered an internal error or misconfiguration and was unable to complete your request. Please contact the server administrator... nach Installation des Scripts.

Da gibt es viele Gründe, z.B.:

Erhalte Internal Server Error The server encountered an internal error or misconfiguration and was unable to complete your request. Please contact the server administrator... nach Änderung der Sprachdatei.

Die Sprachdatei ist Perl Code !
Die Syntax von $TEXT{'date'} = "MM YYYY"; definiert den Schlüssel "date" für den Hash TEXT mit dem entsprechenden Wert "MM YYYY" und dem notwendigen Semikolon als Anweisungsende-Kennung. Der Wert ist in Anführungstrichen eingeschlossen.
Diese Syntax muss bei Änderung der Sprachdatei beachtet werden. Anderenfalls wird das Skript nicht funktionieren
Füge keinen Wert wie $TEXT{'mykey'} hinzu, der bereits existiert, denn dieser neue Wert wird den Inhalt des ersten überschreiben.
Soll HTML Code, der selbst Anführungsstriche enthält wie z.B. <p style="color:#efefef;">..., aus einem HTML Editor in die Sprachdatei eingefügt werden, dann kann qq{your text} zum Umschließen des Hash-Wertes anstelle der Anführungsstriche verwendet werden, also $TEXT{'mykey'} = qq{<p style="color:#efefef;">...</p>};

Erhalte CGI Error The specified CGI application misbehaved by not returning a complete set of HTTP headers. beim Starten des Skripts.

Einige Webserver z.B. Microsoft Information Server (das mag von dessen Konfiguration abhängen), arbeiten bevorzugt mit non-parsed-header (nph) Skripts, erwarten von dem Skript also vollständige HTTP Header Informationen. Beim Einsatz von efileman 7.1 and höher nenne die cgi Datei zu nph_scriptname.cgi um, im Normalfall also nph_efileman.cgi. Ältere Versionen (7.04) werden nicht funktionieren.

Erhalte Software error: Undefined subroutine &Apache::ROOT::cgi_2dbin::efileman::efileman_xx_2ecgi::sifre_kontrol called at /path/efileman_xx.cgi line xx. oder Internal Server Error The server encountered an internal error or misconfiguration and was unable to complete your request. Please contact the server administrator... beim Arbeiten mit dem Skript.

Überprüfe die Laufzeitumgebung des Servers, wenn dort Apache:mod_perl zum Einsatz kommt und efileman7.04x ist installiert, dann installiere eine höhere Version von efileman.

Wie kann ich die vollständigen Pfadinformationen im Gehe zu-Element im Manager verstecken ?

Definiere den Benutzerpfad in der Benutzer Konfiguration mit einem Aliasnamen wie z.B. "/user/webdoc/data/=html root".

Das efileman Logo erscheint nicht. Für alle Dateien im Manager wird nur das "no.gif" oder gar nichts angezeigt.

3 Möglichkeiten :

Warum unterscheidet efileman zwischen Anwender Pfad und Anwender URL, und wie werden diese konfiguriert ?

Pfad Variable : Für den Zugriff auf die Dokumente braucht der efileman immer eine Pfadangabe.
URL Variable : Einerseits kann ein Dokument nur mit einer URL-Angabe direkt mit dem Anklicken des Links im Browser angezeigt werden (wenn der Browser den Dokumententyp kennt, zumindest html, txt, jpg, gif). Durch die Verwendung von URL's kann die Performance des efileman gesteigert werden, denn sämtliche Dokument-Anfragen werden dabei nur durch den Webserver bearbeitet. Wird für die Anwender URL eine Pfadangabe eingetragen, werden Dokument-Anforderungen immer durch den efileman bearbeitet.
Andererseits könnte für den einen oder anderen die Verwendung von Pfadangaben den Vorteil haben, dass beim Klick auf ein Dokument generell ein Download gestartet wird. Der Zugriff auf Dokumente ausserhalb des Dokumentenstammverzeichnisses (auch document-root, WWW-root oder HTML-root) oder innerhalb des cgi-bin Verzeichnisses (welches normalerweise über den Browser nicht zugreifbar sein sollte !), kann im übrigen nur über eine Pfadangabe in der URL Variablen realisiert werden.
Bei der Verwaltung einer Domäne, bei der das cgi-bin innerhalb der HTML-Root liegt, bietet sich eine Pfadangabe in der URL Variablen auch deshalb an, weil damit keine zwei Roots für den Zugriff auf die Dokumente definiert werden müssen:

Anwender Pfad : /home/www/web4/html=HTML,/home/www/web4/html/cgi-bin=CGI
Anwender URL : http://www.efileman.de,/home/www/web4/html/cgi-bin

Prinzipiel hat man damit also die Wahl zwischen:

Anwender Pfad : /home/www/web4/html/demo=Demo
Anwender URL : http://www.efileman.de/demo

und

Anwender Pfad : /home/www/web4/html/demo=Demo
Anwender URL : /home/www/web4/html/demo

Mit efileman 7.1 kann auf komplette Partitionen/Laufwerke zugegriffen werden :

Anwender Pfad : /=Root
Anwender URL : /

oder für ein Windows Server System mit Laufwerksbuchstabe und Doppelpunkt :

Anwender Pfad : D:=Laufwerk D
Anwender URL : D:

Wenn keine Aliasname vergeben wird, dann wird in der Dateimanageransicht des efileman (statt des nicht vorhandenen Aliasnames) der Pfad angezeigt.

Das Skript darf nicht zum Hacken anderer Accounts missbraucht werden. Wenn durch Eingabe von nicht vorgegebenen Pfaden Zugang zu anderen Dokumenten oder gar Systemdateien erlangt werden kann, sollte umgehend der Systemadministrator/Webmaster des jeweiligen Servers informiert werden, denn dann ist auch der eigenen Account durch Dritte angreifbar. Wenn es danach, anstelle einer Beseitigung der Sicherheitslücke, Ärger wegen des Einsatzes des efileman gibt, sollte man sich nach einem anderen Webhoster, der mehr Sicherheit bieten kann, umsehen.

CHMOD, Permissions, Zugriffsrechte ?

efileman stellt die Zugriffsrechte ( für UNIX-Systeme, für Windows nicht relevant ) nummerisch in oktaler Schreibweise dar.
Leserechte (r) sind durch den Wert 4, Schreibrechte (w) durch die 2 und Ausführungsrechte (x) durch eine 1 gegeben.

Welche Zugriffsrechte (chmod) sollten für welche efileman-Verzeichnisse und Dateien vergeben werden ?

Für Version 7.04x und die jeweiligen Verzeichnisse entsprechend den Bedingungen auf efileman.de :

Für efileman 7.1 und die jeweiligen Verzeichnisse entsprechend den Bedingungen auf efileman.de :

Die aufgeführten Werte hängen davon ab, wer der Eigentümer der Dateien ist (du oder der Webserver), und welche anderen Prozesse Zugriff auf die Dateien benötigen, z.B. Datensicherungen. Auf einem MS Windows Serversystem sollten die entsprechenden Dateien zumindest als schreibgeschützt abgelegt werden. Das sollte mit jeder FTP Software durch Entfernen der Schreibrechte machbar sein. Rechte zum Ausführen der Dateien können auf einem MS Windows Serversystem nicht vergeben werden.

Wie sind die Namenskonventionen beim mehrmaligen Upload von Dateien gleichen Namens oder beim Upload in ein konfiguriertes generelles Upload-Verzeichnis ?

efileman 7.04 erzeugt die Dateien durch Hinzufügen von "_upload" zum Dateinamen im Falle eines zweiten Uploads einer Datei gleichen Names. Bei mehrfachem Upload einer Datei gleichen Namens wird diese zweite Datei jeweils überschrieben.

Dateiname
Dateiname_upload

efileman 7.1 erzeugt die Dateien durch Hinzufügen von "_upload_lfdNr" zum Dateinamen im Falle eines mehrfachen Uploads einer Datei gleichen Names, z.B. :

Dateiname
Dateiname_upload_1
Dateiname_upload_2
Dateiname_upload_...

Im Falle des Uploads in ein konfiguriertes generelles Upload-Verzeichnis erzeugt efileman die Dateien durch Hinzufügen von "Benutzername_" zum Dateinamen, z.B. :

Benutzername_Dateiname

oder kombiniert:

Benutzername_Dateiname
Benutzername_Dateiname_upload_1
Benutzername_Dateiname_upload_2
Benutzername_Dateiname_upload_...

"Benutzername_" wird nicht hinzugefügt, wenn ##username## in der Variablen Genereller Upload Pfad verwendet wird, da der Benutzer dadurch bereits identifiziert wurde, wie z.B.

/home/mydomain/uploads/##username##
oder
/home/mydomain/##username##/uploads

Mehr über das Upload-Thema, z.B. unvollständig übertragene Dateien und CGItempxxx Dateien.

efileman nutzt das Perl Standard-Modul cgi.pm, welches während des Uploads temporäre Dateien in der Form CGItmpxxx erzeugt.
Die folgende Beschreibung stammt aus der cgi.pm Dokumentation.

CGI.pm verarbeitet den Dateiupload. Normalerweise wird die übertragenen Datei dabei zuerst als temporäre Datei angelegt, welche nach Abschluss der Übertragung automatisch gelöscht wird. Die temporäre Datei wird mit Besitzerrechten angelegt (Mode 600). Das Verzeichnis für diese temporäre Datei wird wie folgt bestimmt:

wenn der aktuelle User (z.B. "nobody") ein Verzeichnis namens "tmp" in in seinem Home-Verzeichnis hat, wird das benutzt ( nur Unix Systeme ).
wenn die Umgebungsvariable TMPDIR existiert, wird das in dieser Variablen angegebene Verzeichnis verwendet
Ansonsten werden bei Vorhandensein verwendet : /usr/tmp, /var/tmp, C:\temp, /tmp, /temp, ::Temporary Items, und \WWW_ROOT.

Jede dieser Angaben wird darauf überprüft, das es sich um ein Verzeichnis handelt, und dass dafür Schreibrechte bestehen. Wenn nicht, wird die nächste Angabe ausprobiert.

Die verschiedenen Browser übertragen leicht verschiedenen Angaben zum Namen der übertragenen Datei. Einige Browser übertragen nur den Dateinamen, andere auch den Pfad unter Verwendung der Notationsregeln des jeweiligen Betriebssystems des Anwenders. Unabhängig davon ist der vom Browser übertragene Dateiname immer der Name der Datei des Anwenders, und steht in keiner Beziehung zur temporären Datei, die CGI.pm während des Uploads erzeugt.
Gelegentlich treten Probleme bei der Verarbeitung des Uploads auf, zumeist dann, wenn der Anwender den "Stop"-Button des Browsers betätigt, bevor der Upload beendet ist.

Unter bestimmten Umständen ist die Laufzeit eines Skriptes zeitlich beschräkt (Serverkonfiguration), was zum Abbruch des Skriptes durch den Server aus verschiedenen Gründen führt. Der Datei-Upload und die dafür benötigte Zeit hängen von der Dateigröße, der Internetverbindung des Anwenders, und der Internetverbindung sowie der aktuellen Auslastung des Servers ab. Folgende Angaben sollten bei bestehenden Schwierigkeiten in der Serverkonfiguration auf Existenz und Einstellung überprüft werden:

Die temporäre Datei verbraucht natürlich auch Platz auf der Festplatte des Servers, welcher je nach verwendetem Verzeichnis begrenzt sein kann. Unter Umständen wird die temporäre Datei im Dokumentenstammverzeichnis angelegt, dann muss der Account also für die Dauer des Uploads sowohl die hochzuladene Datei als auch die temporäre Datei aufnehmen können.

Das Verzeichnis für diese temporären Dateien kann auch einmalig im CGI.pm definiert werden:
Dafür dienen die Zeilen ab 23 ff. im CGI Modul.

Code:
# HARD-CODED LOCATION FOR FILE UPLOAD TEMPORARY FILES.
# UNCOMMENT THIS ONLY IF YOU KNOW WHAT YOU'RE DOING.
# $TempFile::TMPDIRECTORY = '/usr/tmp';

ef_check.cgi zeigt einige dieser CGI Parameter an.

efileman change only CGI parameter $CGI::DISABLE_UPLOADS in case of a disabled upload permission for a user. I'm going to limit the upload by CGI parameter, but it's comment out at the moment. See ef_main.pm and look for

Code:
# $CGI::POST_MAX= ...

The # comment out the line. I'll use it in a later version. Nicht mehr in finalen Version des efileman 7.1.

Die temporären Dateien werden nicht manuell angelegt, sondern werden vom Skript, unter Verwendung des originalen Dateinamens, nur an den Bestimmungsort kopiert.
Das CGI-Modul löscht die temporären Dateien nach Ende des Uploads normalerweise automatisch, es sei denn, der Skripttask wurde durch den Server oder andere Umstände beendet.

Sollten die temporäre Dateien (CGItempxxx) im Account, zumeist im Dokumentenstammverzeichnis, angelegt und nicht automatisch gelöscht werden können, sollte der Serveradministrator um eine Änderung des Pfades gebeten werden.

Siehe die CGI Dokumentation für weitere Informationen und insbesondere die CGI Revision History im Falle von Schwierigkeiten beim Upload bei Nutzung älterer Versionen von CGI.pm. Es kann nie schaden, zuerst die aktuelle Version des Moduls zu installieren.

Andere Gründe für einen nicht funktionierenden Upload können auch Firewall- und Proxyeinstellungen sein. Einige lokal installierte Virusscanner arbeiten wie ein Proxy. Die entsprechenden Filterregel sollten ebenfalls überprüft oder die Anwendungen zu Testzwecken zeitweilig deaktiert werden.

Erhalte "...Page not found or cannot display..." nach dem Login oder nach dem Ändern der Anwender-Pfadangaben im Admin Bereich.

Jeder Browser hat ein Zeitlimit. Das bedeutet, der Browser wartet eine gewisse Zeit (beim MS Internet Explorer i.d.R. 5 Minuten) auf eine Serverantwort, also die angeforderte Seite, und bricht danach mit einer Fehlermeldung ab. Dafür gibt es eine Menge Ursachen. Im Normalfall reicht es, mittels Aktualisieren-Funktion/Button die Seite erneut anzufordern. Siehe auch das nächste Thema.

Warum dauert es so lange, bis meine Dateien angezeigt werden ?

Zusätzlich zu Bandbreite und Qualität der Internetverbindung, dem verwendeten Modem und der Performance des Servers, können einer oder mehrere der folgende Gründe eine Rolle spielen :

Warum funktioniert der Download-Zähler des efileman 7.1 nicht ?

Zwei Dinge sind notwendig, damit der Download-Zähler funktionieren kann :

Wie können zip-Dateien mit dem Modul Archive::Zip erzeugt werden, wenn das Modul auf dem Server nicht installiert ist ? Oder was kann im Fall einer installierten, aber zu alten Version von Archive::Zip getan werden ?

Frage zuerst den Server Administrator nach einer Installation bzw. einem Update des Moduls. Folge der nachfolgenden Beschreibung nur im Fall von Schwierigkeiten.

Überprüfe ob Compress::Zlib auf dem Server installiert ist. Wenn Ja, lade das neueste Archive::Zip Module von http://www.bike-nomad.com/perl/ oder suche in CPAN.
Im heruntergeladenen Archive findet sich ein Verzeichnis lib und in lib ein Verzeichnis Archive. Kopiere das Verzeichnis Archive mitsamt Inhalt in das efileman Verzeichnis auf dem Account. Das ist alles !
Das wurde zwar bereits erfolgreich mit einigen Anwendern getestet und sollte i.d.R. funktionieren, muss aber nicht.