Installieren und Starten von piccaport.exe (Windows)
Die .exe Datei kann in ein beliebiges Verzeichnis der Festplatte kopiert werden. (Eine Java Laufzeitumgebung ab Version 8 wird empfohlen)
Installieren und Starten picapport.jar
Die .jar Datei kann in ein beliebiges Verzeichnis der Festplatte kopiert werden. (Eine Java Laufzeitumgebung ab Version 8 wird empfohlen)
Beispiel CMD-Datei für Oracle Jre auf Windows
java -jar picapport.jar
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
Seit Version 5.0 geht auch:
java -Duser.home=/opt/picapport -jar picapport-headless.jar
Server Konfiguration
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
Java-System properties
Name | Default | Verison | Imple | Beschreibung |
---|---|---|---|---|
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) |
Parameter in picapport.properties
Name | Default | Verison | Imple | Beschreibung |
---|---|---|---|---|
Allgemeine Serverparameter | ||||
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) |
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 |
server.max.concurrent.imageio | not set (3) | 1.3 | JA | Anzahl gleichzeitiger ImageIO Operationen (Bilder in voller größe im Speicher) |
server.cookie.timeout.seconds | not set (default = 60*60*24*100 = 100 days) | 5.0 | JA | Gültigkeit der in Cookies gespeicherten Anmeldedaten (Benutzer hat Anmeldung gespeichert) Wird der Wert 0 eingetragen so kann man keine Anmeldedaten speichern. |
gui.enabled | not set (true) | 1.0 | JA | Boolean Parameter um GUI zu aktivieren/deaktivieren. mögl. Werte (true/false) |
gui.hideintray | not set (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 |
robot.* Konfiguration des Robots (Fotoverzeichnisse) | ||||
robot.root.n.path | root.0=$sd | 1.0 |
| Voll qualifizierter Pfad(e) zu einem Rootverzeichnis. Folgende Variablen können hierbei verwendet werden (n=0-n):
|
n | 1.0 |
| Optionale ID für diesen Eintrag (Wenn nicht gesetzt ist wird die ID auf IDn gesetzt) | |
robot.root.n.isuploadroot | nicht gesetzt | 5.0 | JA | Kennzeichnet das Verzeichnis als Upload-Verzeichnis. Es kann immer nur ein Verzeichnis das Uploadverzeichnis sein. Ist kein Upload-Verzeichnis explizit gesetzt, ist immer das erste Verzeichnis das Upload-Verzeichnis. Beispiel: robot.root.1.isuploadroot=true |
robot.filter.path.n | nicht gesetzt | 1.3 | JA | Regulärer Ausdruck um Bilder in bestimmten Pfade zu heraus zu filtern: (n=0-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 | JA | Zeit bis zum nächsten Rescan in Minuten (Default ist 5 Minuten) |
robot.filter.keywords.n | nicht gesetzt | offen |
| Regulärer Ausdruck um Bilder mit bestimmten Keywords heraus zu filtern: (n=0-n) |
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) |
robot.filter.rating | nicht gesetzt | offen |
| Gültige Werte (1-5): Beispiel 3 bedeutet nur Bilder mit Rating 3 und höher |
mail.* Mail-Client Konfiguration | ||||
mail.rescan.minutes | not set (9) | 2.0 | JA | Zeit bis zum nächsten fetchmail in Minuten (Default ist 9 Minuten) |
mail.check.fingerprint | not set (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. |
foto.* Parameter zur Steuerung der JPG-Generierung | ||||
foto.jpg.quality | not set (0.75) | 5.0 | JA | Qualitätseinstellung der JPG Komprimierung |
foto.jpg.scalemethod | not set (AUTOMATIC) | 5.0 | JA | Qualitätseinstellung der Scalierung Mögliche Werte: AUTOMATIC,SPEED,BALANCED,QUALITY,ULTRA |
foto.jpg.usecache | not set (0) | 5.0 | JA | Soll ein Cache, für die generierten Photos verwendet werden
|
foto.jpg.cache.height | not set (1080) | 5.0 | JA | Höhe der vorgenerierten und gecachten Bilder |
foto.jpg.cache.width | not set (1920) | 5.0 | JA | Breite der vorgenerierten und gecachten Bilder |
foto.jpg.cache.freeSpacePercentage | not set (20) | 5.0 | JA | Mindestgröße des Freien Speicherplatzes auf dem Cache-Pfad |
foto.jpg.cache.path | not set (<PicApport-Home>/cache) | 5.0 | JA | Pfad zum Cache Beispiel: C:\MyPhotoCache |
foto.thumb.quality | not set (0.75) | 5.0 | JA | Qualitätseinstellung der Thumbnails |
user.* Parameter zur Steuerung der CcUser2 Optionen | ||||
user.encryption.iterations | not set (1701) | 5.0 | JA | Anzahl an Hashdurchläufen für die Passwortspeicherung |
user.password.min | not set (1) | 5.0 | JA | Minimale Passwortlänge |
user.password.max | not set (75) | 5.0 | JA | Maximale Passwortlänge |
user.log.access | not set (false) | 5.0 | JA | Wenn true dann werden alle Logon-Vorgänge protokolliert |
plugin.* Parameter zur Steuerung der Plugins | ||||
plugin.shadow.path | not set | 5.0 | Pfad zu den Schattendateien | |
client.* Web-Client Konfiguration | ||||
client.timeout.short.millis | not set (3000) | 3.0 | JA | Wird aktuell von der #home Seite für Statusabfrage benutzt sobald diese angezeigt wird, damit es im Offline-Fall nicht 15 Sekunden dauert bis man wieder was machen kann. |
client.timeout.long.millis | not set (15000) | 3.0 | JA | Timeout für allgemeine Serveranfragen |
client.default.viewtime.millis | not set (7000) | 3.0 | JA | Vorgabewert für Anzeigedauer im Slideshow-Modus |
client.css.thumb.height | not set (110) | 3.0 | JA | CSS-Höhe für Thumbnails (mit 110 passen bei den meisten Phones zwei Thumbs nebeneinander) |
client.folder.sort | nicht gesetzt | 4.0.1 | JA | Optionaler Parameter. Wenn gesetzt wird Verzeichnisliste im Browser sortiert.* Beispiel: |
upload.* Upload Konfiguration | ||||
upload.tag.prefix | nicht gesetzt (PicApport/) | 5.0 | JA | Viele Fotobetrachter verwenden eine Baumstruktur zur anzeige von Tags. Mit dem Prefix wird dafür gesorgt, |
upload.tag | not set ($upload) | 5.0 | JA | Jedes hochgeladene Foto wird mit diesem Tag versehen (gemeinsam mit dem Prefix) Um alle hochgeladenen Fotos abzufragen einfach $upload eingeben |
upload.tag.useridprefix | nicht gesetzt (@) | 5.0 | JA | Jedes hochgeladene Foto wird mit diesem Tag+UserId versehen (gemeinsam mit dem Prefix) Beispiel: UserId=Hans -> Tag=@Hans (PicApport/@Hans mit Prefix) |
upload.max.filesize.mb | nicht gesetzt (10) | 5.0 | JA | Maximale Dateigröße für Upload in MB (1000x1000). Gültige Werte: 1 bis Integer.MAX_VALUE |
upload.max.requestsize | nicht gesetzt (-1) keine Begrenzung | 5.0 | JA | Maximale Requestgröße (Server) für Upload Gültige Werte: (-1) bis Integer.MAX_VALUE |
upload.max.memorysize | nicht gesetzt (102.400) | 5.0 | JA | Maximaler Speicher (Server) für Upload Gültige Werte: 1024 bis Integer.MAX_VALUE |
upload.max.parallel.uploads | nicht gesetzt (3) | 5.0 | JA | Maximale Anzahl gleichzeitiger Dateiübertragungen (Client) |
upload.path | nicht gesetzt (uploads/$UID$/$YYYY$/$MM$-$TITLE$) | 5.0 | JA | Pfad zum für Uploads von Fotos. Dieser Pfad wird automatisch unterhalb des für Uploads konfigurierten Rootverzeichnisses (siehe: robot.root.n.isuploadroot) angelegt. Folgende Variable können verwendet werden(immer Großbuchstaben verwenden):
Wichtig: Keine Verzeichnistrenner (Slash oder Backslash) am Anfang oder Ende des Eintrags eingeben. |
Programmparameter (Argumente) für piccapport.exe bzw. picapport.jar
Die Konfiguration von PicApport über eine Konfigurationsdatei ist optional. Alle Parameter können auch direkt beim Starten an Piccaport.exe übergeben werden.
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 | Beschreibung |
---|---|---|---|
-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. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|