yappa-ng Standard Dokumentation

Installationsanleitung

Wie installiere ich yappa-ng

(yappa-ng Installations-HowTo)

  1. Anforderungen
  2. INSTALLATION
    1. Kurz
    2. Ausführlich :-)
      1. Standard Installation
      2. Installation auf Servern die "PHP Safe Mode" aktiviert haben
  3. Passwörter
  4. Fehlersuche und Fehlerbehebung
    1. Standard Überprüfungen (check_setup.php)
    2. Checkliste für "broken images"
      1. Debug-Checkliste
      2. Das "check_image.php" Hilfsprogramm
      3. ImageMagick: Test ob das "convert Programm" funktioniert
      4. GD: "altes" GD ?
    3. Safe Mode
    4. Open Basedir
    5. "unable to fork"
    6. *.php4 Dateierweiterung wird benötigt
    7. NICHTS funktioniert - bitte hilf mir!!
  5. SICHERHEIT Einige dieser Sicherheits-Themen werden auch in der FAQ (FAQ.html) behandelt. Ich will, dass sie irgendwo gelesen werden! :-)
    1. .htaccess
    2. check_setup.php und check_setup.txt
    3. Album-Admin Passwort


1. Anforderungen

yappa-ng benötigt folgendes:

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:

->zum Seitenanfang


2. INSTALLATION

2.1 Kurz

Die Installation von yappa-ng ist WIRKLICH EINFACH !!!

Kurz gesagt:

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:

(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


--> DAS WAR'S! Gratulation, die yappa-ng Installation ist abgeschlossen!
Wie ich es versprochen habe: Es ist wirklich so einfach! :-))


Tipps:


->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:


--> 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:


->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)


->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! ;-)

  1. 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" )
  2. Hat der Pfad zum Bild Lese-Berechtigung für den WebSERVER?
  3. 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 :-) )
  4. 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!]
  5. 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!
  6. 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!!!)
  7. 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!
  8. 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!)
  9. 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 :-)

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

->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?

What things to watch when installing yappa-ng with "safe_mode" in effect?

->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?

What things to watch when installing yappa-ng with "open_basedir" in effect?

->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:

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 <<