Debian Gallery2

Allgemein

Voraussetzung:

• Webserver Apache und PHP
• MySQL Server

Gallery2 ist eine PHP-Applikation, die vom Webserver ausgeführt wird. Zur Installation wird das "Typical-Paket" verwendet. Daneben gibt es noch die Pakete "Minimal", "Full", "Developer" und ein sog. Preinstaller. Leider war eine Installation via Preinstaller nicht erfolgreich, sodass hier das "Typical-Paket" verwendet wird.

Installation der Pakete

Version/Pfad des aktellen "Typical-Paketes" (.tar.gz anstatt .zip) ermitteln: http://codex.gallery2.org/Gallery2:Download#Packages. Z.B. aktuell V2.3=> Download-Path: http://downloads.sourceforge.net/gallery/gallery-2.3-typical.tar.gz. Evtl. den Pfad bei der wget und tar Anweisung anpassen.

cd /usr/local/src (falls Verzeichnis nicht existiert, mit mkdir /usr/local/src anlegen)
wget http://downloads.sourceforge.net/gallery/gallery-2.3-typical.tar.gz

Entpacken (Dateinamen evtl. anpassen, falls neuere Version verwendet wird)

tar vxf gallery-2.3-typical.tar.gz

Anlegen des Config-Files:

touch gallery2/config.php
chmod 666 gallery2/config.php

Anpassen der Dateirechte und Verschieben ins Webserver-Verzeichnis:

chown -R www-data:www-data gallery2
chmod 777 gallery2/modules
chmod 777 gallery2/themes
mv gallery2 /var/www/

Anlegen des Photo-Verzeichnisses:

mkdir /usr/local/share/gallery2
chmod 777 /usr/local/share/gallery2

Optional: Anlegen eines FTP-Users und Verzeichnisses, um Bilder per FTP hochladen zu können: Voraussetzung: FTP-Server ist installiert

adduser --home /home/gallery2 --shell /bin/false --ingroup ftpusers --disabled-login gallery2

Die Fragen je nach Bedarf beantworten.

passwd gallery2

zeimal ein Passwort für den Gallery-User eingeben.

mkdir /home/gallery2/upload
chown gallery2:ftpusers /home/gallery2/upload

Anlegen der SQL-Datenbank:

Hinweis:
die beiden SQL-Befehle erfordern die Eingabe des SQL-Root-Passwortes (siehe auch hier) Im 2.MySQL-Befehl GALLERY2_PWD durch das zu verwendende Passwort für die Gallery2 Datenbank ersetzen

mysqladmin -uroot -p create gallery2
mysql gallery2 -uroot -p -e"GRANT ALL ON gallery2.* TO gallery2@localhost IDENTIFIED BY 'GALLERY2_PWD'"

Nötige Module installieren und Webserver neustarten:

apt-get install php-gettext
apt-get install imagemagick
apt-get install netpbm
apt-get install unzip
/etc/init.d/apache2 restart

Einrichtung via Webbrowser

Die komplette (beinahe komplette) weitere Konfiguration erfolgt online via Webbrowser. Adresse http://IP_DES_Servers/gallery2/install eingeben

• Installation starten anklicken
• Eine Seite mit einem Authentication-Code erscheint. Nun gibt es 2 Möglichkeiten:

• Das File "login.txt" herunterladen (Den Link "korrekte Version von login.txt" anklicken) und im Verzeichnis /var/www/gallery2/ abspeichern (am einfachsten geht dies mit WINSCP --> siehe OpenSSH ).

oder

• Auf dem Server das File "login.txt" erstellen und darin den angezeigten Authentication-Code einfügen und das File abspeichern. Anschließend Rechte anpassen

vi /var/www/gallery2/login.txt

Den Authentication Code einfügen und abspeichern.

chmod 777 /var/www/gallery2/login.txt

• Auf der Gallery2-Webseite Authentifiziere mich anklicken
• Weiter zum Schritt 2 anklicken
• Es wird geprüft, ob alle Systemvoraussetzungen erfüllt sind. Es sollten alle Punkte mit Erfolgreich deklariert sein.
• Weiter zum Schritt 3 anklicken
• Standard-Installation wählen und Weiter zum Schritt 4 anklicken
• Directory Path setzen (oben erstelltes Verzeichnis): /usr/local/share/gallery2/
• Speichern anklicken
• Weiter zum Schritt 5 anklicken
• Folgende Datenbank-Settings vornehmen (GALLERY2_PWD wie oben beim Anlegen der Datenbank angegeben):

Datenbank Type: MySQL (v3.23.34a und neuer)
DB-Rechnername:  localhost
DB-Benutzername: gallery2
DB-Password:     GALLERY2_PWD
DB-Name:         gallery2
Tabellen-Präfix: g2_
Spalten-Präfix:  g_

• Speichern anklicken
• Weiter zum Schritt 6 anklicken
• Administratorkonto anlegen:

Administrator Benutzername:   z.B. Admin oder root
Passwort:                     ADMIN_PWD
(erneut eingeben):            ADMIN_PWD
Administrator-email-addresse: admin@dyndns.domain
Admin full name (optional):   Gallery Administrator

• Erstellen anklicken
• Weiter zum Schritt 7 anklicken
• Konfigurationsdatei erfolgreich erstellt. sollte ausgegeben werden.
• Weiter zum Schritt 8 anklicken
• Nach der Installation der Kern Pakete auf 'Weiter zum Schritt 9 klicken
• Die gewünschten Plugins aktivieren. Im Zweifel einfach alle aktivieren. Die Plugins können auch später mittels Admin-Zugang aktiviert bzw. deaktiviert werden.
  • Um die Plugins zu aktivieren:Ausgewählte Module aktivieren anklicken. Anschließend Weiter zum Schritt 10 anklicken.
  • Um die Plugins später mittels Admin Zugang zu aktivieren: Weiter zum Schritt 10 ohne Aktivierung anklicken
• Es wird eine Warnung ausgegeben, dass die zugriffsrechte für config.ini nicht sicher sind.
• Auf dem Server folgenden Befehl eingeben, um das Config-File abzusichern:

chmod 644 /var/www/gallery2/config.php

• Erneut prüfen' anklicken
• Nun sollte die Sicherheitsprüfung eine sichere config.ini bescheinigen.Weiter zum Schritt 11 anklicken
• Gehe zu meiner Gallery! anklicken

Anpassen der Installation

Während der Installation wird die URL (http://IP_DES_Server/gallery2) im Konfigfile hinterlegt. Dadurch ist es später nicht möglich, die Gallery aus dem Internet erreichbar zu machen. Diese Einstellung ist aber eigentlich gar nicht nötig und sollte deshalb auskommentiert werden:

vi /var/www/gallery2/config.php

Am Ende des Files den Eintrag $gallery->setConfig('baseUri', 'http://IP_DES_Server/gallery2/main.php'); durch PHP-Kommentarzeichen (//) deaktivieren:

//$gallery->setConfig('baseUri', 'http://IP_DES_Server/gallery2/main.php');

Konfiguration

Falls die Webseite der Gallery2 noch nicht angezeigt wird, im Webbrowser die Adresse http://IP_DES_Server/gallery2 eingeben.

• Rechts oben auf Anmelden klicken
• Userdaten des angelegten Users Admin eingeben und auf Anmelden klicken
• Site-Administration anklicken
• im Bereich Allgemein folgende Einstellungen vornehmen:
  • Email: Standardmäßig wird PHP verwendet um emails zu senden. Wenn der Emailserver gemäß →Anleitung eingerichtet wurde, sollte eine Mail versendet werden können, ohne Email-Eingaben vorzunehmen

Testmail schicken: Empfängermail in die Textbox vor E-Mail senden eingeben und E-Mail senden anklicken.

Falls die Testmail nicht ankommt, folgende Einstellungen vornehmen

server:           localhost oder SMTP-Server des Providers
Username:         username für Mailversand
Passwort:         Passwort für Mailversand
Smtp From Adress: gallery@domain

Testmail schicken: Empfängermail in die Textbox vor E-Mail senden eingeben und E-Mail senden anklicken. Die Testmail sollte nun ankommen.

• Bereich Erweiterungen auswählen, um Plugin einstellungen zu ändern

Vorinstallierte plugins werden mittels installieren installiert. Die Zeile wird komplett grün dargestellt. Nach erfolgreicher Installation wird die Zeile wieder normal dargestellt. Manche Plugins erfordern eine Konfiguration.

• Plugin Gd installieren (falls noch nicht geschehen)
• Plugin Archiv hochladen installieren, damit ganze Zip-Files mit Bildern hochladen zu können, anstatt jedes Bild einzeln. Plugin-Konfiguration: Pfad zu unzip=/opt/bin/unzip

Download weiterer nützlicher Plugins: Weitere Gallery Erweiterungen anwählen

• Erweiterungs-Liste herunterladen anwählen
• Nach Download der Liste auf Fortsetzen klicken bzw. einige Sekunden warten, um zur Liste aller Plugins zu gelangen
• Liste mit weiteren Plugins erscheint
• downloaden anwählen um gewünschtes Plugin zu downloaden.
  • Besonders empfehlenswert ist das Plugin Add Items aus dem Bereich Import, mit dessen Hilfe es möglich ist, Bilder z.B. per FTP auf den Server hochzulanden und anschließend direkt von dort in ein Album zu transferieren
  • Nach dem Download erscheint in der linken Liste der Punkt Web/Server. Diesen Punkt anklicken.
  • Als Local Server Upload Paths Pfad: /home/gallery/upload eingeben und auf add klicken
  • Save anklicken
  • Um Gallery aus dem Internet zu erreichen, muss das Plugin HTTP AUTH installiert werden.

• Userverwaltung: Bereich Benutzer anklicken
  • Benutzer erstellen anklicken um einen neuen User anzulegen
  • geforderte Daten des neuen Users eingeben
  • Benutzer erstellen anklicken, um den neuen User zu übernehmen
• Nach Bedarf in den anderen Bereichen die gewünschten Einstellungen vornehmen
• Wenn alle Einstellungen erfolgreich angewendet wurden, Abmelden (rechts oben) anwählen

Anlegen eines Albums

Zusammenhängende Bilder (z.B. eines Urlaubs) werden in einem Album verwaltet. Jedes Album erhält einen Unterordner auf der Festplatte des Servers unter /usr/local/share/gallery2.

Falls die Webseite der Gallery2 noch nicht angezeigt wird, im Webbrowser die Adresse http://IP_Des_Servers/gallery2 eingeben.

• Rechts oben auf Login klicken
• Admindaten eingeben und auf Login klicken
• Im linken Bereich Album hinzufügen anklicken
• Folgende Daten eingeben:

Name:            Verzeichnis unter dem das neue Album auf der Festplatte abgelegt werden soll. z.B. Weltreise_2008
Titel:           Später in Gallery angezeigter Titel des Albums. z.B. Weltreise 2008
Zusammenfassung: Inhaltsangabe. z.B. Bilder der Weltreise
Schlüsselwörter: Schlüsselwörter, nach denen später gesucht werden kann. z.B. Weltreise 2008 Rucksacktourist
Beschreibung:    Ausführliche Beschreibung

• Wenn alle erforderlichen Angaben gemacht sind, Erstellen anklicken

Eine neue Maske im Reiter Album erscheint.

• Größe der Vorschaubilder einstellen. Standard: 150
• Skalierte Bilder. In der Album Ansicht werden die Vorschaubilder gezeigt. Beim Anklicken eines solchen Vorschaubildes kann das Bild skaliert oder in voller Größe ausgegeben werden. Standardmäßig ist eine Skalierung von 640x640 vorgegben. Diese kann angepaßt bzw. neue Skalierungen hinzugefügt werden z.B. 800x800.
• Button Speichern anklicken

Im Reiter Motiv kann das Layout des Albums angepasst werden.

• Zeilen und Spalten anpassen. Z.B. 5 Zeilen und 5 Spalten
• Die weiteren Einstellungen nach Bedarf anpassen
• Speichere Motiv-Einstellungen anklicken

Bilder hochladen

Mit FTP-Programm als User gallery2 auf den Server ins Verzeichnis upload hochladen.

Falls die Webseite der Gallery2 noch nicht angezeigt wird, im Webbrowser die Adresse http://IP_Des_Servers/gallery2 eingeben.

• Rechts oben auf Login klicken
• Admindaten eingeben und auf Login klicken

• Album anklicken, bzw. Kein Vorschaubild, falls das Album leer ist
• Elemente hinzufügen
• Reiter From Local Server anwählen
• Den Link /home/gallery2/upload anklicken und Find Files anwählen
• Liste aller hochgeladenen Bilder erscheint
• Die Bilder, die übernommen werden sollen auswählen und Auswahl mit Add Files abschließen.
• Die Bilder werden übernommen und die Vorschaubilder und skalierten Bilder werden generiert.
• Nachdem alle Bilder übernommen wurden, Button Fortsetzen anklicken

Zugriffsrechte für Alben bearbeiten

Standardmäßig sind alle Alben für alle User und Gäste sichtbar. Die Berechtigungen für jedes einzelne Album könne separat angepasst werden.

Falls die Webseite der Gallery2 noch nicht angezeigt wird, im Webbrowser die Adresse http://IP_Des_Servers/gallery2 eingeben.

• Rechts oben auf Login klicken
• Admindaten eingeben und auf Login klicken

Als Beispiel soll hier beschrieben werden, wie nur bestimmte User Alben ansehen können. Die anderen Berechtigungen je nach Bedarf anpassen.

• Album anklicken
• In der linken Leiste Berechtigungen anpassen auswählen
• Die Zeile jeder [core] alle Versionen sehen durch anklicken von Entfernen löschen.
• Im Bereich Benutzerberechtigungen folgende Eingaben vornehmen:

Benutzer (linkes Feld): Namen des Nutzers, der das Album sehen soll, eintragen

[core] alle Versionen sehen aus der Pulldown Liste auswählen

Button Berechtigung hinzufügen anklicken