yappa-ng Standard Dokumentation
Installationsanleitung
Wie installiere ich yappa-ng
(yappa-ng Installations-HowTo)
- Anforderungen
- INSTALLATION
- Kurz
- Ausführlich :-)
- Standard Installation
- Installation auf Servern die "PHP Safe Mode" aktiviert haben
- Passwörter
- Fehlersuche und Fehlerbehebung
- Standard Überprüfungen (check_setup.php)
- Checkliste für "broken images"
- Debug-Checkliste
- Das "check_image.php" Hilfsprogramm
- ImageMagick: Test ob das "convert Programm" funktioniert
- GD: "altes" GD ?
- Safe Mode
- Open Basedir
- "unable to fork"
- *.php4 Dateierweiterung wird benötigt
- NICHTS funktioniert - bitte hilf mir!!
- SICHERHEIT Einige dieser Sicherheits-Themen werden auch in der FAQ (FAQ.html) behandelt. Ich will, dass sie irgendwo gelesen werden! :-)
- .htaccess
- check_setup.php und check_setup.txt
- Album-Admin Passwort
1. Anforderungen
yappa-ng benötigt folgendes:
- PHP 4.1 oder höher (darf auch PHP 5 sein!)
- eine der beiden folgenden Grafik Bibliotheken (Programme)
- GD library (ist in manchen PHP Versionen sogar standardmässig mitcompiliert)
- ImageMagick's "convert" Programm.
Sie finden:
yappa-ng benötigt oder verwendet KEINE Datenbank (KEIN MySQL oder ähnliches)!!
yappa-ng wurde auf Linux und Windows, Apache und IIS getestet.
yappa-ng läuft auch bei folgenden PHP-Einstellungen:
- safe_mode
- open_basedir
- PHP 5
->zum Seitenanfang
2. INSTALLATION
2.1 Kurz
Die Installation von yappa-ng ist WIRKLICH EINFACH !!!
Kurz gesagt:
- Entpacken Sie das yappa-ng_xxx.tar.gz oder yappa-ng_xxx.zip in ein Dateiverzeichnis das Ihr Webserver lesen und schreiben kann,
- stellen Sie sicher, dass Ihr Webserver alle Dateien und Directories lesen kann , und
- dass der Webserver Schreibberechtigung im yappa-ng Hauptverzeichnis hat.
- Starten Sie "setup.php" (mit dem Webbrowser setup.php aufrufen)
- danach mit dem Webbrowser das index.php aufrufen
- ...und Viel Spass!!! ;-)
Es ist tatsächlich so einfach!
Jetzt wäre ein guter Zeitpunkt um einen Check zu machen ob irgendwelche
BUGS gemeldet und/oder Patches verfügbar sind (Externer Link)
den Sie einspielen sollten! :-)
Um einen Überblick über die vorhandene Dokumentation zu bekommen würde ich dringend einen Blick in folgendes Dokument empfehlen: _README.FIRST.html !!! (Englisch)
->zum Seitenanfang
2.2 Ausführlich :-)
Es besteht ein grosser Unterschied zwischen der Installation von yappa-ng auf einem Server der die "PHP Safe Mode Einschränkungen" aktiviert hat
und einem Server ohne diese Einschränkungen.
Wenn Sie sich nicht sicher sind, ob der Server auf dem Sie yappa-ng installieren werden die "PHP Safe Mode Einschränkungen" aktiviert hat
oder nicht dann laden Sie das kleine Script: "check_safe_mode.php" auf den Server hoch und starten Sie es (mit dem Webbrowser aufrufen).
Die Ausgabe dieses Scripts wird Ihnen folgendes anzeigen:
- Ob der Server die "PHP Safe Mode Einschränkungen" aktiviert hat
- Ob der Server die "PHP Open Basedir Einschränkungen" aktiviert hat
- Ob der Server die "GD Grafikbibliothek" installiert hat.
(Dieses Script kann Ihnen leider nicht sagen, ob (und wenn ja: wo) der Server das "ImageMagick convert Programm" installiert hat. Das müssen Sie Ihren Provider fragen, falls Sie es nicht wissen!)
Wenn die "PHP Safe Mode Einschränkungen" aktiviert sind UND die "GD Grafikbibliothek" installiert ist lesen Sie bitte in folgendem Abschnitt weiter: 2.2.2 Installation auf Servern die "PHP Safe Mode" aktiviert haben
Wenn die "PHP Safe Mode Einschränkungen" aktiviert sind und die "GD Grafikbibliothek" nicht installiert ist tut es mir sehr leid,
aber Sie können yappa-ng auf diesem Server leider nicht installieren!
Im "PHP Safe Mode" können Sie leider nicht das "ImageMagick convert Programm" verwenden - Sie sind auf die "GD Grafikbibliothek" angewiesen!
Wenn die "PHP Safe Mode Einschränkungen" nicht aktiviert sind lesen Sie bitte gleich beim nächsten Absatz weiter!
->zum Seitenanfang
2.2.1 Standard Installation
- Entpacken Sie das yappa-ng_xxx.tar.gz oder yappa-ng_xxx.zip in ein Dateiverzeichnis das Ihr Webserver lesen und schreiben kann,
$ cp ./yappa-ng_xxx.tar.gz /usr/local/htttpd/htdocs
$ cd /usr/local/httpd/htdocs
$ tar zxvf yappa-ng_xxx.tar.gz
und benennen es um auf wasimmer Sie wollen (optional!!):
$ mv yappa-ng meinefotos
- Behalten Sie unbedingt die Dateiordner-Struktur genauso, wie sie im offiziellen Archiv ist!
- Stellen Sie sicher dass Ihr Web Server (!!) alle Dateien und Dateiordner der yappa-ng Installation lesen kann.
- Stellen Sie sicher dass Ihr Web Server (!!) im Hauptverzeichnis der yappa-ng Installation (das ist das Verzeichnis in dem alle anderen
Unterverzeichnisse und das index.php liegen) auch schreiben kann.
- WICHTIG: Mehr als 95% aller Installationsprobleme sind auf falsch gesetzte Datei- und Verzeichnisberechtigungen zurückzuführen!!!!!! :-).
- Starten Sie mit dem Webbrowser das script "setup.php"! (Leider derzeit nur in Englischer Sprache)
- Initialisieren Sie die Globale Konfiguration (Sagen Sie "yes" zu [Initialize])
- Geben Sie ein yappa-ng Systemadministrations-Passwort an (wird für das setup.php, die toolbox.php
und das erste Album-Passwort verwendet)
- Gehen Sie durch alle Felder des "Part 1 Main" um yappa-ng zum Laufen zu bringen.
- Hakerln Sie die Felder "Create Directory" an, um nicht vorhandene Verzeichnisse automatisch erstellen zu lassen!
- Falls Sie eine Fehlermeldung bekommen lesen Sie bitte genau was in der Fehlermeldung steht und welche Vorschläge von
yappa-ng angeboten werden, um den Fehler zu beheben. Weiters lesen Sie bitte alle Online gebotenen Hilfetexte und ausführlichen Beschreibungen die im "setup.php" angeboten werden! (Leider derzeit alles noch in Englisch!)
- Das Setup-Programm prüft alle Ihre Eingaben und versucht Ihnen Hilfestellung und Vorschläge zu bieten wo immer das möglich ist! (Leider derzeit nur in Englischer Sprache)
- Konfigurieren Sie "Part 4 Languages" bevor Sie den nächsten Setup-Schritt durchführen.
Da Sie die Deutsche Version der Installationsanleitung lesen werden Sie "Deutsch" als die Standardsprache (="Default Language") wählen.
- Erst dann sagen Sie ja zu "New Installation" (Checkbox anhakerln und auf Submit klicken)!
- Dann klicken Sie auf den Link "<<< Run yappa-ng >>>" und sind damit fertig mit der Installation!
- Haben Sie Spass mit yappa-ng!!! :-)
- Das Album Admin-Login Passwort nach der Erstinstallation von yappa-ng ist das Passwort, das Sie im Setup-Programm angegeben haben (setup.php)
- Wenn Sie immer noch Fehlermeldungen bekommen oder das DEMO-Bild nicht angezeigt wird dann lesen Sie bitte im Kapitel "4. Fehlersuche und Fehlerbehebung" hier in der Installationsanleitung nach!
- Jetzt da alles läuft ist der richtige Zeipunkt um Ihr eigenes news_xxx.html (wobei xxx das Sprachkürzel ist) zu entwerfen um Ihre Besucher zu begrüssen und ihnen die Neuigkeiten zu präsentieren!
(Die Datei liegt im yappa-ng Hauptverzeichnis).
Die Datei "news_xxx.html" ist die Begrüssungsseite (Willkommen in der yappa-ng Foto Galerie ...).
Lesen Sie im MANUAL mehr darüber, wie Sie Ihre eigene Willkommensseite(n) für yappa-ng erstellen.
--> DAS WAR'S! Gratulation, die yappa-ng Installation ist abgeschlossen!
Wie ich es versprochen habe: Es ist wirklich so einfach! :-))
Tipps:
- Sollten nun nach de Installation eventuell Fehler auftreten, so lesen Sie das Kapitel Fehlersuche und Fehlerbehebung weiter unten in dieser Installationsanleitung!!!
- Lesen Sie das Kapitel SICHERHEIT in dieser Installationsanleitung!!!
- Wertvolle weiterführende Informationen finden Sie in der FAQ und im MANUAL!
- Bevor Sie beginnen jede Menge neue Alben zu erstellen sollten Sie das Home-Album (also das "unter" dem Beispielalbum!) so konfigurieren, wie Sie
später Ihre Alben haben wollen. Alle Einstellungen (mit Ausnahme des Administrationspasswortes) werden vom Unteralbum automatisch übernommen
und müssen daher nicht für jedes neue Album neu konfiguriert werden! Das funktioniert aber nur bei der Albumerstellung!!
- Bevor Sie beginnen jede Menge neue Alben zu erstellen sollten Sie sich auch einen ungefähren Plan machen, wie Sie Ihre
Galerie aufbauen wollen. Sie können natürlich allen Alben in "einer Ebene" in der Linken Navigationsleiste haben, die dann mit der Zeit immer Lang und Länger wird.
Empfehlungen zum Aufbau lesen Sie bitte hier im "MANUAL: Galerie strukturieren" nach!
- Werfen Sie unbedingt einen Blick in die Datei _README.FIRST.html
um einen Überblick über die vorhandene Dokumentation zu bekommen!
->zum Seitenanfang
2.2.2 Installation auf Servern die "PHP Safe Mode" aktiviert haben
Wenn Sie eine Erklärung dafür haben wollen, warum die Installation von yappa-ng auf Servern die die "PHP Safe Mode" Einschränkungen aktiviert haben
viel umständlicher ist als auf Servern ohne die aktivierte "PHP Safe Mode" Einschränkung
oder wenn es Sie ganz einfach nur interessiert was dieses "PHP Safe Mode" überhaupt ist,
dann lesen Sie den Abschnitt "Safe Mode" im Kapitel Fehlersuche und Fehlerbehebung
in dieser Installationsanleitung.
Und hier ist die Installationsanleitung für Systeme die die Safe Mode Einschränkungen aktiviert haben:
- Entpacken Sie das yappa-ng_xxx.tar.gz oder yappa-ng_xxx.zip in ein Dateiverzeichnis Ihrer Wahl, aber NICHT in das
Dateiverzeichnis in das Sie yappa-ng installieren wollen!!!
$ cp ./yappa-ng_xxx.tar.gz /usr/local/htttpd/htdocs
$ cd /usr/local/httpd/htdocs
$ tar zxvf yappa-ng_xxx.tar.gz
- Entpacken Sie die Dateien des Archivs: "safe_mode_installation.tar.gz" (oder "safe_mode_installation.zip")
- Laden Sie das Script "safe_mode_start.php" auf den Webserver (FTP,...) und starten Sie es (mit dem Webbrowser starten!).
An der Stelle, an die Sie das Script hochgeladen und gestartet haben, wird das yappa-ng Hauptverzeichnis erstellt!
- Geben Sie den Namen des Dateiverzeichnisses ein, in das das komplette yappa-ng installiert werden soll.
Dieser Directoryname wird auch im Pfad sein, wenn Sie yappa-ng aufrufen.
Die Voreinstellung ist "yappa-ng". (http://www.ihredomain.com/yappa-ng/). Bitte geben Sie nur ein Dateiverzeichnis an! Das Script wird nicht mehrere Verzeichnisse hintereinadner erstellen!!!
Es funktioinert nicht dass Sie gar keinen Verzeichnisnamen eingeben. Das würde in der Standardinstallation funktionieren, aber es wird nicht funktionieren wenn "Safe Mode" aktiviert ist!
- Suchen Sie die Datei "safe_mode_install.php" zum hochladen in der Upload Box.
- Nachdem Sie auf "Submit" geklickt haben wird Ihnen ein Link zur weiteren Installation angezeigt.
Dieser Link (Url) ruft das eben von Ihnen hochgeladene Script "safe_mode_install.php" auf.
(Bitte rufen Sie das Script "safe_mode_install.php" ausschliesslich mit diesem Link auf, denn es werden Parameter mit dem Link an das Nachfolgescript übergeben!)
- Starten Sie das gerade hochgeladene Script safe_mode_install.php mit dem Link wie oben beschrieben:
- Suchen Sie nach den erforderlichen Dateien in den Upload feldern.
Diese befinden sich fast alle im dem yappa-ng Hauptverzeichnis, das nach dem entpacken des Archives entsatnden ist.
Nur das Demo-Bild und das Error Bild befindet sich im Verzeichnis: ./yappa-ng/install, und die Sprachdateien in ./yappa-ng/languages.
- Nachdem Sie den Button "Submit" angeklickt haben werden sämtliche benötigte Verzeichnisse erstellt
und die vorher gesuchten Dateien hochgeladen.
Einge Dateien werden neu erstellt, wie zB hitcounters, Konfigurationsdateien und Sicherheitsdateien
- Wenn Sie mehr als 3 Sprachen installieren wollen so können Sie das ohne weiteres tun indem Sie in die 3 Sprachfelder die nächsten
Sprachen anklicken und wieder "Submit" anklicken (solange Sie wollen oder bis Sie alle Sprachen installiert haben).
Sie müssen dazu nicht jedesmal neu die anderen Dateien heraussuchen (wie zB idex.php,...)
- Kopieren (FTP, move, copy&paste,...) Sie ALLE anderen Dateien der Installation in die entsprechenden Verzeichnisse (wirklich ALLE!!),
ohne die zuvor hochgeladenen zu überschreiben!!!! Vergewissern Sie sich dass Sie keine Dateien ausgelassen haben! (Tip: es gibt auch noch 2 Dateien im yappa-ng/languages Verzeichnis
die unbedingt benötigt werden!! (language_selection.inc.php und languages_translated.inc.php!!) Ohne diesen beiden wird yappa-ng nicht laufen!) ;-)
- Löschen Sie die beiden Scripts (safe_mode_start.php und safe_mode_install.php) von dem Server (jemand könnte sonst bösartige Software hochladen!!)!!!
- Starten Sie mit dem Webbrowser das Setup Tool "setup.php"!
- Geben Sie ein yappa-ng Systemadministrator Passwort ein (wird für das setup.php, die toolbox.php
und das erste Album-Passwort verwendet)
- Ändern Sie KEINE der Verzeichnisse aus "Part 1 Main"!! Die haben Sie bereits im vorigen Schritt angelegt!
- Falls Sie eine Fehlermeldung bekommen lesen Sie bitte genau was in der Fehlermeldung steht und welche Vorschläge von
yappa-ng angeboten werden, um den Fehler zu beheben. Weiters lesen Sie bitte alle Online gebotenen Hilfetexte und ausführlichen Beschreibungen die im "setup.php" angeboten werden! (Leider derzeit alles noch in Englisch!)
- Das Setup-Programm prüft alle Ihre Eingaben und versucht Ihnen Hilfestellung und Vorschläge zu bieten wo immer das möglich ist! (Leider derzeit nur in Englischer Sprache)
- Konfigurieren Sie "Part 4 Languages" bevor Sie den nächsten Setup-Schritt durchführen.
Da Sie die Deutsche Version der Installationsanleitung lesen werden Sie "Deutsch" als die Standardsprache (="Default Language") wählen.
- Erst dann sagen Sie ja zu "New Installation" (Checkbox anhakerln und auf Submit klicken)!
- Dann klicken Sie auf den Link "<<< Run yappa-ng >>>" und sind damit fertig mit der Installation!
- Haben Sie Spass mit yappa-ng!!! :-)
- Das Album Admin-Login Passwort nach der Erstinstallation von yappa-ng ist das Passwort, das Sie im Setup-Programm angegeben haben (setup.php)
- Wenn Sie immer noch Fehlermeldungen bekommen oder das DEMO-Bild nicht angezeigt wird dann lesen Sie bitte im Kapitel "4. Fehlersuche und Fehlerbehebung" hier in der Installationsanleitung nach!
- Jetzt da alles läuft ist der richtige Zeipunkt um Ihr eigenes news_xxx.html (wobei xxx das Sprachkürzel ist) zu entwerfen um Ihre Besucher zu begrüssen und ihnen die Neuigkeiten zu präsentieren!
(Die Datei liegt im yappa-ng Hauptverzeichnis).
Die Datei "news_xxx.html" ist die Begrüssungsseite (Willkommen in der yappa-ng Foto Galerie ...).
Lesen Sie im MANUAL mehr darüber, wie Sie Ihre eigene Willkommensseite(n) für yappa-ng erstellen.
- SECURITY:
- Vergessen ie nicht die beiden Scripts (safe_mode_start.php und safe_mode_install.php) von dem Server zu löschen! (jemand könnte sonst bösartige Software hochladen!!)!!!
--> DAS WAR'S! Gratulation, die yappa-ng Installation ist abgeschlossen!
Wie ich es versprochen habe: Das "Safe Mode Setup" dauert etwas länger, aber dafür lät yappa-ng nun auch auf dem Server im Safe Mode!!! :-))
Tipps:
- Sollten nun nach de Installation eventuell Fehler auftreten, so lesen Sie das Kapitel Fehlersuche und Fehlerbehebung weiter unten in dieser Installationsanleitung!!!
- Lesen Sie das Kapitel SICHERHEIT in dieser Installationsanleitung!!!
- Wertvolle weiterführende Informationen finden Sie in der FAQ und im MANUAL!
- Bevor Sie beginnen jede Menge neue Alben zu erstellen sollten Sie das Home-Album (also das "unter" dem Beispielalbum!) so konfigurieren, wie Sie
später Ihre Alben haben wollen. Alle Einstellungen (mit Ausnahme des Administrationspasswortes) werden vom Unteralbum automatisch übernommen
und müssen daher nicht für jedes neue Album neu konfiguriert werden! Das funktioniert aber nur bei der Albumerstellung!!
- Bevor Sie beginnen jede Menge neue Alben zu erstellen sollten Sie sich auch einen ungefähren Plan machen, wie Sie Ihre
Galerie aufbauen wollen. Sie können natürlich allen Alben in "einer Ebene" in der Linken Navigationsleiste haben, die dann mit der Zeit immer Lang und Länger wird.
Empfehlungen zum Aufbau lesen Sie bitte hier im "MANUAL: Galerie strukturieren" nach!
- Werfen Sie unbedingt einen Blick in die Datei _README.FIRST.html
um einen Überblick über die vorhandene Dokumentation zu bekommen!
->zum Seitenanfang
3. Passwörter
Bei der Erstinstallation wird das Album Administrationspasswort auf das Passwort gesetzt, das Sie im Setup Tool (setup.php)
für die System Admininstration angeben.
Vergessen Sie bitte nicht, dass Sie die Album Admin Passwörter für jedes Album getrennt ändern müssen.
Gehen Sie dazu in jedem Album extra in das Administrationsmenü des Albums (Login in rechter oberen Ecke) und ändern dort für jedes Album das Passwort!
Wenn Sie ganze Alben mit der ToolBox Option "Importieren" in yappa-ng importieren
(Directories die Sie mit FTP oder durch kopieren in den Album-Baum gebracht haben), dann können Sie sich eine "Ursprungs-Konfiguration" aussuchen.
Für alle diese auf einmal importierten Alben ist das Album-Admin-Passwort dann das gleiche! Details zum Import bitte im Manual nachlesen!
Das yappa-ng Systemadministrations Passwort (das Passwort das Sie für das Setup Tool und die ToolBox benötigen) wird in der ToolBox geändert!
Diese Änderung betrifft dann jedoch ausschliesslich das System Administrations Passwort!
->zum Seitenanfang
4. Fehlersuche und Fehlerbehebung
4.1 Standard Überprüfungen (check_setup.php)
- Wenn Sie eine Fehlermeldung vom Format "yappa-ng_ERROR_xxx" bekommen (xxx ist eine Zahl), so sehen Sie bitte in der ERRORCODES Datei nach!
Dort ist eine detaillierte Erklärung und Hilfestellung zu diesem Fehler und wird Ihnen helfen, dieses Problem zu beheben!
Diese ERRORCODES sind eine zusätzliche Hilfe um die Installation von yappa-ng noch einfacher zu gestalten! ;-)
- Möglicherweise ist der Fehler ein bereits gemeldeter BUG und vielleicht existiert sogar schon ein Patch dafür! Sehen Sie sich daher folgenden Link an:
BUGS.html (Externer Link!)
- Starten Sie mit Ihrem Browser das Script check_setup.php
in Ihrem yappa-ng Hauptverzeichnis (z.B.: http://www.mysite.com/yappa-ng/check_setup.php )
- Nachdem das Script gelaufen ist erhalten Sie die Analyse an der gleichen Stelle als check_setup.txt
(z.B.: http://www.mysite.com/yappa-ng/check_setup.txt )
->zum Seitenanfang
4.2 Checkliste für "broken images"
4.2.1 Debug-Checkliste
In den allermeisten Fällen handelt es sich dabei ganz einfach um falsche Zugriffsberechtigungen für Dateien und/oder Verzeichnisse!
Hier finden Sie eine kurze "Checkliste" zur Fehlerbehebung - Bitte überprüfen Sie JEDEN Punkt! ;-)
- Ist das Bild selbst lesbar für den WebSERVER?
(Zur Überprüfung: Rufen Sie das Bild mit Ihrem Webbrowser auf: "http://www.mysite.com/yappa-ng/photos/sample/yappa-ng_DEMO.jpg" )
- Hat der Pfad zum Bild Lese-Berechtigung für den WebSERVER?
- Haben Sie vor der Installation überprüft, ob Ihre PHP-Installation den "PHP Safe Mode" aktiviert hat?
Wenn "PHP Safe Mode" aktiv ist - haben Sie dann auch die "Safe Mode Installation" durchgeführt?
(Details hierzu lesen Sie bitte hier nach: Ausführlich :-) )
- Wird das Bild korrekt angezeigt, wenn Sie die Option "Original" als Grösse in der yappa-ng Einzelbildansicht anwählen?
(Bei der Option "Original" in der Einzelbildansicht wird keine Grössenverändeung des Bildes vorgenommen.
Wird das Bild hier richtig angezeigt so liegt der Fehler beim Aufruf von GD oder ImageMagick (je nachdem, welches der beiden Sie verwenden).
[Wenn Sie auch bei dieser Option kein Bild sehen, so überprüfen Sie bitte nochmals die Punkte vorher!]
- Versuchen Sie irgendein kleines (!!) Bild mit der Album-Admin Option "Bilder hochladen" in das Album zu laden und schauen Sie nach, ob Sie es ansehen können!
- Versuchen Sie das Bild mit der Album-Admin Option "Initialisieren" zu initialisieren. Möglicherweise sehen Sie dabei eine Fehlermeldung, die Ihnen auf der Fehlersuche weiterhelfen kann!
(Hier wird die Konvertierung direkt aufgerufen und daher sehen Sie hier Fehlermeldungen die Sie sonst nirgends zu Gesicht bekommen!!!)
- Der Fehler könnte auf ein Berechtigungsproblem sein, falls Sie das Bild mit ftp hochgeladen haben und nicht mit dem Album Admin "Upload" hochgeladen haben!
- Der folgende Test funktioniert nur, wenn Sie das vom Setup installierte Verzeichnis (Album) "sample" mit dem DEMO Bild "yappa-ng_DEMO.jpg"
noch nicht gelöscht haben! (Verändern Sie die Parameter um andere Bilder in anderen Alben zu überprüfen!)
- http://www.mysite.com/yappa-ng/show.php?size=original&album_name=/sample&obj_name=yappa-ng_DEMO.jpg
(Die Gross/Kleinschreibung ist wichtig!!)
Der Webbrowser sollte das Bild "yappa-ng_DEMO.jpg" unverändert in Originalgrösse darstellen.
- http://www.mysite.com/yappa-ng/show.php?size=640x640&album_name=/sample&obj_name=yappa-ng_DEMO.jpg
(640x640 stimmt schon so!)
Der Webbrowser sollte das Bild "yappa-ng_DEMO.jpg" in der Grösse 640 x 480 darstellen.
- Stellen Sie sicher dass Sie in der ToolBox im Bereich "Logfile" alle Log-Optionen aktiviert haben und sehen
Sie dann nach einem neuerlichen Veruch dort im yappa-ng Logfile mit Hilfe des yappa-ng Logfile Betrachters nach.
Wenn nichts von davon zielführend war, dann sehen Sie im WEBSERVER-LOGFILE nach. (Dies ist natürlich nur mögliche,
wenn Sie vollen Zugang zu den Webserver-Logfiles haben. Überspringen Sie die folgenden Punkte, wenn Sie keinen Zugang zu diesen Dateien haben!)
(Es ist mir kein ISP bekannt, der Ihnen als normaler Homepage-User freien Zugang zu seinen Serverlogs geben wird :-)
- Finden Sie 4xx Server Fehler (403 - Zugriff verboten oder 404 - Datei nicht gefunden)?
Wenn Sie derartige Fehler im SERVER-Logfile finden sollten diese Sie ziemlich zielgerichtet auf den Fehler hinweisen und Sie können so den Fehler beheben (Wieder mal eine falsche Zugriffsberechtigung??)
- Tauchen dort andere Fehler auf?
- Sie sollten Einträge im Logfile finden, die folgende Syntax haben:
http://www.mysite.com/yappa-ng/show.php?size=thumbnail&album_name=/sample&obj_name=yappa-ng_DEMO.jpg
- Sehen Sie in Ihrem php-error.log auch nach (falls Sie ein solches haben. Viele Standardinstallationen von PHP werden ohne Fehlerlog installiert!). Vielleicht sehen Sie dort einen Hinweis??
Tipp:
==> Sollte dies alles nichts helfen, dann lesen Sie bitte in folgendem Kapitel weiter:
NICHTS funktioniert - bitte hilf mir!!
->zum Seitenanfang
4.2.2 The "check_image.php" utility
->zum Seitenanfang
4.2.3 ImageMagick: Test if the "convert utility" is working
- Did you provide the full UNIX-path (including the name "convert" itself) to the convert utility (e.g.: '/usr/bin/convert')?
- If you use a WINDOWS based system make sure you make the windows-like call to convert (with .exe!) (e.g. 'C:\full\windows\path\convert.exe') !
- Has the web server execute permission for the convert utility? (path & utility)?
- Does the convert utility work from the commandline? (Test only possible if you have commandline-access to the webserver!)
- change into your album where some images are
- change the permissions that you too can read/write in this directory/image - not only the web server
- type the following command:
/UNIXpathToConvert/convert -size 50x50 -geometry 50x50 -quality 60 xy.jpg yz.jpg
where xy.jpg is your source-image and yz.jpg is the output. This is exactly the command I create with php!!
- look at the image yz.jpg if it is correct and you can view it. It should be a very small 50x50 jpg image.
->zum Seitenanfang
4.2.4 GD: "old" GD
yappa-ng uses an autodetect-method to guess what version of GD you use.
But - alas! This does not work on every system! :-(
If you are using GD and have broken images set the
config-parameter "gd_truecolor" to "no" (ONLY THAN!)
(Background: If possible I use the 'ImageCreateTruecolor' function of GD.
I try to check for this function - but on some systems this method does
not work - so if you say "no" in the config I override the test.)
If you use ImageMagick this parameter has absolute no meaning!
->zum Seitenanfang
4.3 Safe Mode
yappa-ng is fully "safe_mode" compatible - but you have to know some facts:
What is the "safe_mode" PHP directive?
- "safe_mode" compares the owner UID (=UserID) of all files / directories it
reads from/writes to with the owner UID from the starting script.
For yappa-ng the scripts which are started directly (and not included or read by these) are the following:
- index.php - the yappa-ng main script which starts the application
- show.php - shows the images and gets called from other scripts (index.php, slideshow.php,...)
- setup.php - the yappa-ng Setup Tool
- slideshow.php - Showing the Slideshow, gets called with all parameters from the index.php
- check_setup.php - checks the environment, parameters and some basics.
- check_noimage.php - runs some checks to show images with your current settings
- If one of the above starting scripts has another owner (maybe your FTP-User!!!) than the
file / directory that yappa-ng wants to access you will get the following error (example!!):
Warning: SAFE MODE Restriction in effect. The script whose uid is 500 is not
allowed to access /yappa-ng/photos/sample/yappa-ng_DEMO.jpg owned by uid 0 in /yappa-ng/index.php on line 67
- IF DEFINED only executables within the "safe_mode_exec_dir" get executed!
For yappa-ng this is the convert utility.
- These parameters are set and/or changed in the php.ini (/etc/php.ini in most linux installations,
??? on windows and others). You can view the current setting in the check_setup.txt file!
- If you have changed something in the php.ini you have to restart your web server to make the changes active!
What things to watch when installing yappa-ng with "safe_mode" in effect?
- All files and directories should have the owner UID (=UserID) of the web server.
(specially the index.php the show.php and the setup.php).
- New directories / uploaded images will get automatically the owner UID of the web server.
- If the setup.php / index.php / show.php do not have the UID of the web server
yappa-ng will not be able to read/write within the newly created directories and will not be able to write to the newly created files
(hits.log, config.inc.php, config_album.inc.php,...)
- Thats why you will have to follow the "Safe Mode Installation Routine":
- Upload a script (safe_mode_start.php) which will do the following steps:
- Create the main yappa-ng directory (you may name it as you like!) (getting the right permissions)
- Upload the main safe mode installation file (safe_mode_install.php) (which gets the right permissions itself)
- Run the previously uploaded safe_mode_install.php script, which will do the following steps:
- Create all directories
- Create some files (hitcounters, config files, security files,...)
- Let you upload some specific files (the scripts that get started directly)
- Copy (FTP, move, copy&paste,...) all other files of the installation into the appropriate directories (all of them),
without overwriting one of the previously created/uploaded!!!!
- Delete the 2 scripts (safe_mode_start.php and safe_mode_install.php) from the server (someone could upload malicious scripts)!!!
- Continue with the Standard Installation! :-)
- You will have to use GD!
->zum Seitenanfang
4.4 Open Basedir
yappa-ng is fully "open_basedir" compatible - but you have to know some facts:
What is the "open_basedir" PHP directive?
- IF DEFINED (default is empty) it limits the files that can be opened by PHP
to the specified directory-tree, including the file itself.
- This parameter is set and/or changed in the php.ini (/etc/php.ini in most linux installations, ??? on windows and others).
You can view the current setting in the check_setup.txt file!
- If you have changed something in the php.ini you have to restart your Web server to make the changes active!
What things to watch when installing yappa-ng with "open_basedir" in effect?
- Make sure the complete yappa-ng installation is within the "open_basedir".
- The "photo_root" has to be within the "open_basedir".
- The "cache_root" has to be within the "open_basedir".
- The file upload temp path has to be within the "open_basedir".
- If you use ImageMagick:
- The convert utility has to be within the "open_basedir".
->zum Seitenanfang
4.6 "unable to fork"
If you get an error like:
Warning: exec(): Unable to fork [C:\ImageMagick\convert.exe -size 50x50.....
This is a windows-related issue and has nothing to do with yappa-ng but with the
permission settings on your webserver!
There may be an easy way out for you (thanks to Jesper Rudbeck, who sent me this hint):
"We had lotso fun with "unable to fork" errors. It turned out to be a permissions problem. Y
ou must give RX permission on "\winnt\system32\cmd.exe" to the user account that
your web server runs as (e.g. IUSR_xxx on IIS, LocalSystem on Apache).
Turning on a Win2000 user right called "Bypass traverse checking" also solved a related
problem but I forget what or why."
Another solution has been submitted by swbadn (Thanks):
"I copied cmd.exe into the c:\php folder and that seems to work as well. I
set the permissions to read and execute only. This keeps from having to give
anonymous access to C:\winnt\system32\cmd.exe where all of those nasty IIS
scripts always seem to attack and I think is a little more secure than
having to give access to the cmd.exe in the C:\winnt\system32 directory."
->zum Seitenanfang
4.7 *.php4 extension needed
Some servers still need the "*.php4 extension" instead of the standard "*.php extension".
If you are running yappa-ng on such a server there are a view things you have to do:
- rename the file "index.php" to "index.php4"
- rename the file "show.php" to "show.php4"
- rename the file "setup.php" to "setup.php4"
- Edit the file config_private.inc.php and set the
"resize_script" => "show.php",
to
"resize_script" => "show.php4",
- if you need the check_setup.php script for installation help
rename the file "check_setup.php" to "check_setup.php4"
Do no other changes!!!
->zum Seitenanfang
4.8 NICHTS funktioniert - bitte hilf mir!!
Wenn Sie ein Problem haben, das nicht in dieser Installationsanleitung behandelt wird (also auch nicht hier in der Fehlersuche und Fehlerbehebung)
So sehen Sie bitte in der FAQ und dem MANUAL nach!
Leider sind beide Dokumente noch in Englischer Sprache!
Wenn Sie Hilfe benoetigen, weil weder diese Installationsanleitung noch die FAQ weiterhilt,
dann ist es nun an der Zeit, folgendes zu lesen:
SUPPORT_REQUESTS_deutsch im yappa-ng /docs Dateiverzeichnis!
Darin ist eine detaillierte Anleitung, wie und wo Sie Support bekommen!
->zum Seitenanfang
5. SECURITY
5.1 .htaccess
If your web server supports .htaccess directory-protection (Apache Webserver) you should protect
your complete yappa-ng "photo_root" (Photos Main Directory)!
You need no direct web-access to this directory - everything is done with
PHP-scripts from your yappa-ng main directory!
It is important for you if you have userprotected albums.
If the directoryname AND the image name is known someone can access these
images without the yappa-ng password-query if no .htaccess-protection is in place!
->zum Seitenanfang
5.2 check_setup.php and check_setup.txt
DELETE (!!) or rename the check_setup.php script after you have the installation complete.
If created DELETE the check_setup.txt file too!
Anybody can point his browser to the check_setup.php script and create the
check_setup.txt file. There is no danger that this in itself is dangerous,
but within the created check_setup.txt file there is some information about
the setup of your webserver. This information is kept only to the yappa-ng related
topics (some server configuration options, some PHP configuration options and of course
your yappa-ng configuration options) and is necessary to get some yappa-ng
installations up and running! ;-)
It's a good strategy that nobody should know very much about your setup.
Some people don't even let their web server display his signature.
On the other hand: if this is a standard installation of a linux distribution
or windows installation there will be no information which is not already known.
Deleting /renaming these files will just keep you on the safe side! :-)
->zum Seitenanfang
5.3 Album-Admin password
Log into your home-photo album (this is where the "Welcome to yappa-ng..." text
shows after installation) as Album-Admin as soon as possible after installation
and change the default password to your own (Even if there are no images in it and
even if you never will have images directly in this central folder).
There is no real security issue if you do forget / ommit it, but it could happen
that someone changes the password to one you do not know, upload/delete images,...
And I do not believe you will think this is funny! ;-)
Hint:
Before you start creating many albums after installation configure your
home album as you want to have it.
Everything but the admin-password will be inherited to the next "child album"!
->zum Seitenanfang
Bestandteil der yappa-ng Dokumentation von Fritz 'wizard' Berger: >> yappa-ng Homepage <<