PicApport-Server Guide (Deutsch) Autor: Contecon Software GmbH E-Mail: support@contecon.de Datum: 27.03.2015
Inhaltsverzeichnis 1 Installieren und Starten von piccaport.exe (Windows) 3 2 Installieren und Starten picapport.jar 4 2.1 Beispiel CMD-Datei für Oracle Jre auf Windows 4 2.2 Beispiel Linux Script Debian Headless 4 3 Server Konfiguratuion 5 3.1 Java-System properties 5 3.2 Parameter in picapport.properties 6 3.3 Programmparameter (Argumente) für piccapport.exe 8 Contecon Software GmbH 2
1 Installieren und Starten von piccaport.exe (Windows) Die.exe Datei kann in ein beliebiges Verzeichnis der Festplatte kopiert werden. (Eine Java Laufzeitumgebung ab Version 7 ist notwendig) Contecon Software GmbH 3
2 Installieren und Starten picapport.jar Die.jar Datei kann in ein beliebiges Verzeichnis der Festplatte kopiert werden. (Eine Java Laufzeitumgebung ab Version 7 ist notwendig) 2.1 Beispiel CMD-Datei für Oracle Jre auf Windows java -jar picapport.jar 2.2 Beispiel Linux Script Debian Headless -DTRACE=INFO ist optional (Werte: ERROR, INFO, WARNING, DEBUG) -Duser.home ist optional und kann verwendet werden um das Datenbankverzeichnis umzusetzen. java -DTRACE=INFO -Duser.home=/opt/picapport -cp picapport.jar de.contecon.picapport.picapport -configfile=/opt/picapport/.picapport/picapport.properties -pgui.enabled=false Contecon Software GmbH 4
3 Server Konfiguratuion Die Konfiguration erfolgt optional über eine Java.properties Datei die wie folgt versucht wird zu öffnen: wenn Programmparameter -configfile gesetzt ist dann wird versucht diese Datei zu laden. (Diese Datei muss dann aber existieren.) im Verzeichnis user.home/.picapport/picapport.properties danach im im Verzeichnis user.dir/ /picapport.properties (aktuelles Verzeichnis) danach wird ohne.properties Datei mit den unten beschriebenen Defaults gestartet. Alle in picapport.properties gesetzten Parameter können mittels der Kommandozeile überschrieben werden. Die Groß / Kleinschreibung der Namen ist zu beachten 3.1 Java-System properties Name Default Verison supported Imple mented picapport.directory.picapport 3.2 JA Name picapport directory user.home java system dependent 1.0 JA Pfad zum Userverzeichnis abhängig vom Betriebssystem picapport.home not set 3.2.2 JA Überschreibt user.home aber nur wenn dort nicht bereits ein.picapport Verzeichnis existiert. (Wird vom Windows Installer verwendet) Contecon Software GmbH 5
3.2 Parameter in picapport.properties Name Default Verison supported Imple mented server.port 80 1.0 JA IP-Port für Zugriff auf Server: Werte 0-65535 server.bind.n not set (all available) 1.0 IP-Stack auf dem der Server erreichbar ist (wird normalerweise nur bei mehreren Netzwerkkarten benötigt) Beispiel: server.bind.0=192.168.0.1 server.theme not set (a) 1.0 JA default JQuery Theme wenn nichts in Url gesetzt ist server.photobuffer not set (3) 1.0 JA Number of photos loaded into the browser during the slideshow The total number of photos in the browser is server.(photobuffer*2)+1 server.max.concurrent.imageio not set (3) 1.3 JA Anzahl gleichzeitiger ImageIO Operationen (Bilder in voller größe im Speicher) gui.enabled true 1.0 JA Boolean Parameter um GUI zu aktivieren/deaktivieren. mögl. Werte (true/false) gui.hideintray true 1.0 JA Boolean Parameter um GUI direkt nach Start im System Tray zu verstecken thumbs.height not set (120) 1.0 JA Integer Höhe der Thumbnails. mögl. Werte 32-1024 thumbs.num.thumbs.before.pause not set (250) 1.0 JA Integer Anzahl Thumbnails befor der "morebutton" erscheint. mögl. Werte 10-10000 db.max.photos.per.query not set (2000) 1.0 JA Integer Anzahl der Photos die der Server maximal pro Anfrage verwaltet mögl. Werte 100-1000000 Nicht mehr notwendig(unterstützt) ab Version 1.2 Contecon Software GmbH 6
Name Default Verison supported Imple mented robot.root.n.path root.0=$sd wenn $sd nicht verfügbar root.0=$cd 1.0 Voll qualifizierter Pfad(e) zu einem Rootverzeichnis. Folgende Variablen können hierbei verwendet werden (n=0-n): $cd - Aktuelles Verzeichnis $sd - Systemverzeichnis welchs für Bilder Vorgesehen ist. (Bei Windows CSIDL_MYPICTURES der GetSpecialFolderLocation API) Beispiel: robot.root.0.path=$cd robot.root.1.path=e:/animalpictures robot.root.n.id n 1.0 Optionale ID für diesen Eintrag (Wenn nicht gesetzt ist wird die ID auf IDn gesetzt) robot.filter.path.n nicht gesetzt 1.3 Regulärer Ausdruck um Bilder in bestimmten Pfade zu heraus zu filtern: (n=0-n) robot.filter.name.n nicht gesetzt offen Regulärer Ausdruck um Bilder mit bestimmten Dateinamen (ohne Pfad) heraus zu filtern: (n=0-n) robot.rescan.minutes 5 1.0 Zeit bis zum nächsten Rescan in Minuten (Default ist 5 Minuten) Ein Rescan kann manuell mit dem Konsolenbefehl werden. startcrawler erzwungen robot.filter.keywords.n nicht gesetzt offen Regulärer Ausdruck um Bilder mit bestimmten Keywords heraus zu filtern: (n=0-n) Beispiel: robot. filter.keywords.0=.*private.* robot. filter.keywords.1=.*privat.* robot.filter.person.n nicht gesetzt offen Regulärer Ausdruck um Bilder mit bestimmten Personen heraus zu filtern: (n=0-n) robot.filter.title.n nicht gesetzt offen Regulärer Ausdruck um Bilder mit bestimmten Titeln heraus zu filtern: (n=0-n) Contecon Software GmbH 7
Name Default Verison supported Imple mented robot.filter.rating nicht gesetzt offen Gültige Werte (1-5): Beispiel 3 bedeutet nur Bilder mit Rating 3 und höher mail.rescan.minutes 9 2.0 JA Zeit bis zum nächsten fetchmail in Minuten (Default ist 9 Minuten) Ein Fetchmail kann manuell mit dem Konsolenbefehl werden. startfetchmail erzwungen mail.check.fingerprint true 2.0 JA Wenn true dann wird nach dem laden von Fotos über Email geprüft ob das Foto schon in der Datenbank ist. Wenn ja wird das Foto nicht in das Verzeichnis kopiert. client.timeout.short.millis 3000 3.0 JA Wird aktuell von der #home Seite für Statusabfrage benutzt sobald diese angezeigt wird, damit client.timeout.long.millis 15000 3.0 JA Timeout für allgemeine Serveranfragen es im Offline-Fall nicht 15 Sekunden dauert bis man wieder was machen kann. client.default.viewtime.millis 7000 3.0 JA Vorgabewert für Anzeigedauer im Slideshow-Modus client.css.thumb.height 110 3.0 JA CSS-Höhe für Thumbnails (mit 110 passen bei den meisten Phones zwei Thumbs nebeneinander) 3.3 Programmparameter (Argumente) für piccapport.exe Die Konfiguration von Piccapport über eine Konfigurationsdatei ist optional. Alle Parameter können auch direkt beim Starten an Piccaport.exe übergeben werden. Contecon Software GmbH 8
Parameter die in picapport.properties definiert wurden, werden durch die Angabe beim Starten von piccaport.exe überschrieben. Die Groß / Kleinschreibung der Namen ist zu beachten Name Anzahl Default Parameter -configfile 1 nicht gesetzt Absoluter Dateiname (mit Pfad) für picapport.properties -p[name] 1 nicht gesetzt Hiermit können beliebige Parameter der Datei picapport.properties gesetzt werden. Beispiel: picapport.exe -configfile=c:\myconig.properties -pserver.port=8080 -probot.root.0=c:\myphotos Contecon Software GmbH 9