Page tree
Skip to end of metadata
Go to start of metadata

on

Hier werden die zur Konfiguration des Servers benötigten Parameter beschrieben.

Eine detaillierte Beschreibung der Installation unter verschiedenen Betriebssystemen und der Verzeichnisstruktur auf dem PicApport Server befindet sich im PicApport Installationshandbuch.


Schnelleinstieg Installation von PicApport

Starten von picapport.exe (Windows)

Die .exe Datei kann in ein beliebiges Verzeichnis der Festplatte kopiert werden. (Eine Java Laufzeitumgebung ab Version 11 wird empfohlen)

Installieren und Starten picapport.jar

Die .jar Datei kann in ein beliebiges Verzeichnis der Festplatte kopiert werden. (Eine Java Laufzeitumgebung ab Version 11 wird empfohlen)

Beispiel CMD-Datei für Oracle Jre auf Windows mit Speicherkonfiguration

java -Xms512m -Xmx2048m -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 -Xms512m -Xmx2048m -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 -Xms512m -Xmx2048m -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.
  • weitere Informationen zum Java .properties-Dateiformat (Escaping von Backslash etc.) gibt es hier: https://de.wikipedia.org/wiki/Java-Properties-Datei

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
supported

Imple
mented

Beschreibung

picapport
.directory

.picapport

3.2

JA

Name picapport directory

user.home

java system
dependent

1.0JAPfad zum Userverzeichnis
abhängig vom Betriebssystem
picapport
.home
not set3.2.2JAÜberschreibt user.home aber
nur wenn dort nicht bereits
ein .picapport Verzeichnis existiert.
(Wird vom Windows
Installer verwendet)

Allgemeine Regeln zum Java .properties Dateiformat

Parameter in picapport.properties


Name

Default

Verison
supported

Imple-
mented

Beschreibung

Allgemeine Serverparameter

server.port

80
Seit Version 6.2 wird unter Mac OS
Port 8080 als Default gesetzt.

1.0

JA

IP-Port für Zugriff auf Server:
Werte 0-65535

server.contextpathnot set
(empty)
7.0JA

Ermöglicht das optionale Setzen eines Context-Pfades für die URL's des PicApport Servers.
Die ist z.B. dann sinnvoll wenn der PicApport Server hinter einem Proxy läuft.

Normalerweise ist das URL-Schema von PicApport wie folgt:

  • http://meinserver.de/picapport
  • http://meinserver.de/js/* für interne javascript Dateien
  • http://meinserver.de/css/* für interne css Dateien
  • usw.....

Wird nun der server.contextpath gesetzt ändert sich dies wie folgt:

server.contextpath=/meinefotos

  • http://meinserver.de/meinefotos/picapport
  • http://meinserver.de/meinefotos/js/* für interne javascript Dateien
  • http://meinserver.de/meinefotos/css/* für interne css Dateien
  • usw.....

Der server.contextpath muss mit einem Schrägstrich anfangen und darf nicht mit einem Schrägstrich beendet werden.

Wird dieses Feature genutzt, ist darauf zu achten die aktuellen Designs (PicApport - Designs) für Version 7 oder später zu verwenden.

server.bind.n

not set
(all available)

1.0

JA

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

Anzahl Fotos, welche im Browser während der Slideshow
vorgehalten bzw. nachgehalten werden.

Die gesamt Anzahl der Fotos im Speicher des Browsers ist:
(server.photobuffer*2)+1

server.autoupdate.photobuffernot set (100)5.2JA

Ist als Sortierung "Neuste automatisch aktualisieren" gewählt,
gibt dieser Wert an, wie viele Fotos in der Slideshow verfügbar
sind. (Vorgabe sind die 100 neusten der Fotos der Abfrage).
Dieser Vorgabewert kann jederzeit mit  dem limitresult:nnnnn
Operator in der Abfrage überschrieben werden.

server.external.address.for.shared.links

not set (default: aktuelle
Serveradresse der Browsersession
welche den Link erzeugt)

6.2JA

Ist der PicApport-Server über verschiedene Adressen (z.B lokales WLAN und externe DynDNS-Adresse) erreichbar,
wird mit diesem Parameter eingestellt, welche Serveradresse beim generieren von Links verwendet werden
soll.
Dieser Parameter kann auch über die Weboberfläche in der Benutzerverwaltung bei der Gruppe "Geteilte Fotos" mit
dem Button "Aktuelle URL für Links setzten" gesetzt werden.

Beispiel: server.external.address.for.shared.links=http://onlinedemo.picapport.de:80

server.max
.concurrent.imageio
not set (3)1.3JAAnzahl gleichzeitiger ImageIO
Operationen (Bilder in voller
größe im Speicher)

server.max.concurrent.shares.per.session

not set (3)6.2JAAnzahl geteilter Links (Shares) die gleichzeitig (Tabs)
in einer Browser Session angezeigt werden können.
server.cookie
.timeout.seconds
not set (default =
60*60*24*100
= 100 days)
5.0JAGültigkeit der in Cookies
gespeicherten Anmeldedaten
(Benutzer hat Anmeldung
gespeichert)
Wird der Wert 0 eingetragen
so kann man keine
Anmeldedaten speichern.
server.session.timeout.secondsnot set (default = 30 * 60 = 30 minutes)7.2JAZeit in Sekunden bis eine Session auf dem Server automatisch beendet wird wenn keine Aktivität festgestellt wird.
server.admin.remote.command.nnot set7.6JA

Erlaubt es die auf der Weboberfäche verfügbaren Konsolenkommandos zu konfigurieren.
Ist dieser Parameter nicht gesetzt wird folgende Konfiguration verwendet:

  • startcrawler

  • status

  • trace error

  • trace info

  • trace debug

  • restartpicapportserver (Nur wenn Java Runtime ab Version 9 benutzt wird)
  • restartpicapportserver dbinit (Nur wenn Java Runtime ab Version 9 benutzt wird)

Beispiel: (Es kann nur der crawler gestartet werden oder Neustart des Servers)

  • server.admin.remote.command.0=startcrawler

  • server.admin.remote.command.1=restartpicapportserver

server.admin.restart.prefix.nnot set7.6JA

Optionale Erweiterung für den restartpicapportserver Konsolenbefehl.  Wird PicApport z.B. unter Windows ohne Server GUI über eine CMD-Konsole gestart ist diese nach dem Neustart nicht mehr verfügbar (obwohl der neue PicApport-Prozess läuft). Mit folgender Konfiguration wird auch für dern neuen Prozess wieder eine Konsole geöffnet:

  • server.admin.restart.prefix.0=cmd
  • server.admin.restart.prefix.1=/c
  • server.admin.restart.prefix.2=start
  • server.admin.restart.prefix.3=PicApport Server

gui.enabled

not set (true)
in
picapport-
headless.jar

default=false

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

1.0

JA

Integer Höhe der Thumbnails.
mögl. Werte 32 - 1024

thumbs.modenot set (0)5.1JA

0= Thumbs immer aus jpg-thumb generieren wenn möglich(default)
1= jpg-thumb benutzen wenn dessen höhe > thumbs.height
2= Thumbs immer aus jpg generieren (beste Qualität aber am langsamsten)

thumbs.num.thumbs.before.pause

not set (250)

1.0

JA

Integer Anzahl  Thumbnails bevor
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

robot.* Konfiguration des Robots (Fotoverzeichnisse)

robot.root.n.path

root.0=$sd
wenn $sd nicht
verfügbar
root.0=$cd

1.0

JA

Voll qualifizierter Pfad(e) zu einem Rootverzeichnis.
Folgende Variablen können hierbei verwendet werden (n=0-n):

  • $cd - Aktuelles Verzeichnis
  • $sd - Systemverzeichnis welches für Bilder vorgesehen ist.
    (Bei Windows CSIDL_MYPICTURES der GetSpecialFolderLocation API)
    Beispiel: (Doppelpunkt und Backslash jeweils mit führendem Backslash geschrieben wie in .properties-Dateien erforderlich)
    robot.root.0.path=$cd
    robot.root.1.path=E\:\\AnimalPictures

robot.root.n.id

IDn

1.0

JA

Optionale ID für diesen Eintrag
(Wenn nicht gesetzt ist wird die ID auf IDn gesetzt)

robot.root.n
.isuploadroot
nicht gesetzt5.0JA

Kennzeichnet das Verzeichnis als Upload-Verzeichnis.
Es kann immer nur ein Verzeichnis dasUploadverzeichnis sein.
Ist kein Upload-Verzeichnis explizit gesetzt, ist immer das erste Verzeichnis das Upload-Verzeichnis.
Beispiel:
robot.root.1.isuploadroot=true

robot.root.n.aliasnicht gesetzt9.1JA

Optionaler Parameter. Ein gültiger alias besteht nur aus Buchstaben und Ziffern.
Wenn gesetzt, wird dieser anstatt robot.root.n.path im Verzeichnisbrowser und der Timeline angezeigt.
Zusätzlich wird der Alias bei den Operatoren dir: und dirall: unterstützt indem man ein @ als Prefix voranstellt.  
Im Gegensatz zur intern verwendeten robot.root.n.id die eher beschreibende Funktion hat, ist der Alias optional und kann bei den Operatoren dir: und dirall: verwendet werden.

Beispiel: (Zur besseren Lesbarkeit sind Doppelpunkt und Backslash nicht mit \: und \\ codiert wie erforderlich)
Konfigurationsparameter robot.root.0.id=fotos
Konfigurationsparameter robot.root.0.path=C:\Users\public\picapport\photos
Konfigurationsparameter robot.root.0.alias=Fotos

Operator Beispiel ohne alias: dir:"C:\Users\public\picapport\photos\2021\Urlaub"
Operator Beispiel mit alias: dir:"@Fotos\2021\Urlaub"

robot.root.n.webdavmountnicht gesetzt10.4JA

Optionaler Parameter: Pfad-ID der WebDAV URL für dieses Verzeichnis. Eine gültige Pfad-ID besteht nur aus Buchstaben und Ziffern.

Wenn gesetzt, dann ist dieses Verzeichnis (und alle Unterverzeichnisse) für WebDAV Zugriffe verfügbar.
Für alle konfigurierten WebDAV Verzeichnisse legt der PicApport Server beim Starten eine Benutzergruppe WebDAV.[webdavmount] an.
Um auf das WebDAV-Verzeichnis zugreifen zu können, muss ein Benutzer Mitglied der Gruppe WebDAV.[webdavmount] sein.

Beispiel: (Zur besseren Lesbarkeit sind Doppelpunkt und Backslash nicht mit \: und \\ codiert wie erforderlich)
Konfigurationsparameter robot.root.0.id=fotos
Konfigurationsparameter robot.root.0.path=C:\Users\public\picapport\photos
Konfigurationsparameter robot.root.0.webdavmount=myphotos

Name der implizit angelegten PicApport-Benutzergruppe: WebDAV.myphotos (Nur Mitglieder dieser Gruppe haben Zugriff auf das WebDAV Verzeichnis)

Auf das WebDAV-Verzeichnis kann nun über folgende URL zugegriffen werden:

  • protokoll://serveradresse/dav/myphotos
    (Beispiel: https://meinserver/dav/myphotos)
    Die für einen Benutzer verfügbaren WebDAV URL's werden im About Dialog der WebOberfläche angezeigt.

Sollen statt einem gesamten Rootverzeichnis nur bestimmte Unterverzeichnisse der konfigurierten Rootverzeichnisse freigegeben werden,
können diese stattdessen mit den Parametern webdav.n.webdavmount und webdav.n.path (siehe weiter unten) eingestellt werden.

Weitere Infos zum Thema WebDAV Konfiguration in PicApport siehe Konfiguration und Verwendung des in PicApport integrierten WebDAV Servers

robot.filter.path.n

nicht gesetzt

1.3

JA

Regulärer Ausdruck um Bilder in
bestimmten Pfade zu heraus zu
filtern: (n=0-n)

Beispiel siehe: Gibt es in PicApport die Möglichkeit, ein bestimmtes Verzeichnis Indizierung/der Ansicht in PicApport auszuschließen?

robot.filter.name.n

nicht gesetzt

offen

nein

Regulärer Ausdruck um Bilder mit
bestimmten Dateinamen (ohne Pfad)
heraus zu filtern: (n=0-n)

robot.rescan.minutes

nicht gesetzt

  • default = 5 Minuten
    wenn robot.use.filesystem.monitor = false
  • default 1 x täglich um Mitteracht
    wenn robot.use.filesystem.monitor = true
    (oder nicht gesetzt)

1.0

JA

Zeit bis zum nächsten Rescan  in
Minuten (Default ist 5 Minuten oder 1 x täglich)
Ein Rescan kann manuell mit dem
Konsolenbefehl startcrawler
erzwungen werden.

Wertebereich 1 - 2.147.483.647

robot.use.filesystem.monitornicht gesetzt (true)9.0JAWenn nicht gesetzt oder true dann überwacht PicApport die konfigurierten
Verzeichnisse (robot.root.n.path) bezüglich Änderungen und übernimmt
diese sofort in die PicApport Datenbank. Dies beinhaltet anlegen, ändern oder löschen
von Dateien im Dateisystem.

robot.filter.keywords.n

nicht gesetzt

offen

nein

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

nein

Regulärer Ausdruck um Bilder
mit bestimmten Personen heraus
zu filtern: (n=0-n)

robot.filter.title.n

nicht gesetzt

offen

nein

Regulärer Ausdruck um Bilder mit
bestimmten Titeln heraus zu filtern:
(n=0-n)

robot.filter.rating

nicht gesetzt

offen

nein

Gültige Werte (1-5): Beispiel 3
bedeutet nur Bilder mit Rating 3
und höher

robot.always.create.idnicht gesetzt (false)7.0JAZur Verwaltung von MyTags und Likes wird bei der ersten Vergabe eines Tags eine eindeutige PicApport ID in
den Metadaten der .jpg Datei erzeugt. Ist dieser Parameter gesetzt wird die ID direkt beim ersten Laden in die Datenbank
generiert. Dies erleichtert z.B. die Datensicherung weil sich die Fotodateien nicht mehr ändern wenn man Likes oder MyTags vergibt.
robot.days.keep.deleted.photosnicht gesetzt (30)7.6JA

Werte 0-9999999

Gib an wie viele Tage Photos nach den Löschen erhalten bleiben.
Wenn > 0 werden die Dateien umbenannt durch Anhängen der Erweiterung .$@$YYYYMMDD$pa$removed  (YYYYMMDD wird durch aktuelles Datum ersetzt)
Die Dateien sind somit nicht mehr in PicApport sichtbar und werden vom Crawler final nach der angegebenen Zeitspanne gelöscht.

Wird als Wert 0 gesetzt, so werden die Dateien sofort gelöscht.

robot.check.root.before.db.removenicht gesetzt (false)9.2JA

Dieser Parameter ist nützlich, wenn der PicApport Server auf Fotos zugreift, die auf Netzwerklaufwerken oder
Wechseldatenträger gespeichert sind. Sind diese während eines Crawlerdurchlaufs nicht verbunden entfernt
PicApport alle Fotos auf diesem Laufwerk aus der Datenbank.

Wird dieser Parameter auf true gesetzt, wird geprüft ob das dazu passende Rootverzeichnis existiert. Existiert 
es nicht, wird von einen nicht (mehr) verbundenen Netzwerklaufwerk ausgegengen und die Fotos bleiben
in der Datenbank. (In der Slideshow wird ein Platzhalterbild angezeigt)

Wird das Netzwerklaufwerk dann wieder verbunden, müssen nicht alle Fotos wieder in die Datenbank geleden werden.


webdav.* WebDAV Konfiguration (Erweitere WebDAV Konfiguration)

webdav.n.webdavmount
webdav.n.path

nicht gesetzt10.4JA

Erweiterte WebDAV Konfiguration. Es müssen immer beide Parameter gesetzt werden. (n=0-n)

Ermöglicht es, gezielt Freigaben unterhalb von Rootverzeichnissen anzulegen.
Wichtig ist hierbei, dass Verzeichnisse, die in webdav.n.path konfiguriert werden, unterhalb eines konfigurierten Root-Verzeichnisses liegen.
(warning) WebDAV Freigaben außerhalb der konfigurierten Root-Verzeichnisse sind nicht möglich. (warning)

Ansonsten funktionieren diese beiden Parameter wie robot.root.n.path und robot.root.n.webdavmount.

Beispiel: (Zur besseren Lesbarkeit sind Doppelpunkt und Backslash nicht mit \: und \\ codiert wie erforderlich)
Konfigurationsparameter webdav.0.path=C:\Users\public\picapport\photos\mobileuploads
Konfigurationsparameter webdav.0.webdavmount=mobile

Name der implizit angelegten PicApport-Benutzergruppe: WebDAV.mobile (Nur Mitglieder dieser Gruppe haben Zugriff auf das WebDAV Verzeichnis)

Auf das WebDAV-Verzeichnis kann nun über folgende URL zugegriffen werden:

  • protokoll://serveradresse/dav/mobile
    (Beispiel: https://meinserver/dav/mobile)
    Die für einen Benutzer verfügbaren WebDAV URL's werden im About Dialog der WebOberfläche angezeigt.

Weitere Infos zum Thema WebDAV Konfiguration in PicApport siehe Konfiguration und Verwendung des in PicApport integrierten WebDAV Servers

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)
Ein Fetchmail kann manuell mit
dem Konsolenbefehl startfetchmail
erzwungen werden.

mail.check.fingerprintnot set (true)2.0JAWenn 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.0JA

Qualitätseinstellung der
JPG Komprimierung


Wertebereich 0.0 - 1.0 (1.0 ist beste Qualität)

foto.jpg.scalemethodnot set
(AUTOMATIC)
5.0JA

Qualitätseinstellung der
Scalierung

Mögliche Werte: AUTOMATIC,
SPEED,BALANCED,
QUALITY,ULTRA

foto.jpg.usecache
not set (0)5.0JA

Soll ein Cache, für die generierten
Photos verwendet werden

  • 0=Kein Read-Cache, Fotos
    werden skaliert wenn für
    Slideshow benötigt
  • 1=On demand, Fotos werden
    skaliert wenn zum ersten
    mal für Slideshow benötigt;
  • 2=crawler&ondemand,
    Alle Fotos werden
    automatisch zur schnellen
    Verfügbarkeit vom Crawler in
    den Cache eingetragen
    Die Option benötigt  meisten
    Festplattenplatz (ist aber bei
    Abrufen am schnellsten)
foto.jpg.cache.heightnot set (1080)5.0JAHöhe der vorgenerierten
und gecachten Bilder

foto.jpg.cache.width

not set (1920)5.0JABreite der vorgenerierten
und gecachten Bilder
foto.jpg.cache
.freeSpacePercentage
not set (20)5.0JAMindestgröße des Freien
Speicherplatzes auf dem
Cache-Pfad
foto.jpg.cache.path
not set
(<PicApport-Home>
/cache)
5.0JAPfad zum Cache Beispiel:
/MyPhotoCache
foto.thumb.qualitynot set (0.75)5.0JA

Qualitätseinstellung
der Thumbnails

Wertebereich 0.0 - 1.0 (1.0 ist beste Qualität)

user.* Parameter zur Steuerung der CcUser2 Optionen

user.encryption
.iterations
not set (1701)5.0JAAnzahl an Hashdurchläufen
für die Passwortspeicherung
user.password.minnot set (1)5.0JAMinimale Passwortlänge
user.password.maxnot set (75)5.0JAMaximale Passwortlänge
user.log.accessnot set (false)5.0JAWenn true dann werden alle
Logon-Vorgänge protokolliert
user.log.webdavnot set (false)10.4JA

Wenn true dann werden alle
WebDAV Zugriffe protokolliert

plugin.* Parameter zur Steuerung der Plugins

plugin.shadow.pathnot set6.2JA

Pfad zu den Schattendateien(Shadow-Files) (*.$.jpg Dateien)

Optionaler Parameter. Wenn nicht gesetzt werden die Schatten-Dateien im gleichen Ordner wie die Originaldatei abgelegt.
Beispiel: 

  • plugin.shadow.path=/PicApportShadowFiles
  • plugin.shadow.path=C\:\\PicApportShadowFiles


Wir empfehlen dringend die Schattendateien in ein Verzeichnis abzulegen das nicht für PicApport Fotos konfiguriert ist (robot.root.*).

Die Schattendateien sind so von den Fotos "galvanisch" getrennt und lassen sich so jederzeit einfach löschen und dann neu Aufbauen.
(Achtung! Wenn man Metadaten gesetzt hat werden dies in den Schattendateien abgelegt)

client.* Web-Client Konfiguration

client.timeout
.short.millis
nicht gesetzt (3000)3.0JAWird 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
nicht gesetzt  (15000)3.0JATimeout für allgemeine
Serveranfragen
client.default
.viewtime.millis
nicht gesetzt  (7000)3.0JAVorgabewert für Anzeigedauer im
Slideshow-Modus
client.css
.thumb.height
nicht gesetzt  (110)3.0JACSS-Höhe für Thumbnails
(mit 110 passen bei den
meisten
Phones zwei Thumbs
nebeneinander)
client.folder.sortnicht gesetzt4.0.1JA

Optionaler Parameter.
Wenn gesetzt wird Verzeichnisliste
im Browser sortiert.*
Ist nötig da mache Linux System
überhaupt nicht sortieren.
Mögliche Werte: name,
name_insensitive, name_reverse,
name_reverse_insensitive

Beispiel:
client.folder.sort
=name_reverse_insensitive

client.hideemptyfoldersnicht gesetzt (false)10.4JAOptionaler Parameter. (true oder false)
Wenn true dann werden leere Verzeichnisse im Verzeichnisbrowser nicht mehr angezeigt.
Diese Parameter kann mit der User-Option dirbrowser.emptyfolders für einzelne Benutzer übersteuert werden.
client.viewer.maxzoomnicht gesetzt (1000)6.2JA

Optionaler Parameter.
Steuert den Zoombereich von Originalfotos in der Slideshow.
Wertebereich 100-2000

client.viewer.snapviewnicht gesetzt  (true)6.2JAOptionaler Parameter. (true oder false)
Steuert Sichtbarkeit der Snapview (kleines Fenster oben links) beim Zoomen.
client.loadoriginal.with.gesturenicht gesetzt  (true)6.2JAOptionaler Parameter. (true oder false)
Wenn false, dann kann das Originalfoto nicht mit "pinch zoom" Gesten oder Mousewheel geladen werden.
client.quick.btn.max.autonicht gesetzt  (10)7.0JAOptionaler Parameter.
Steuert die maximale Anzahl der letzten Tags die als Quickbutton automatisch gespeichert werden
Wertebereich 1-50
client.video.types.jsonnicht gesetzt7.0JA

Optionaler Parameter.
Gibt an welche Videoformate direkt in der Slideshow abgespielt werden können.
Voraussetzung ist das der Browser diese Formate auch unterstützt.

Wenn der Parameter nicht gesetzt ist gilt folgender Vorgabewert (abVersion 9.2):

[{'ext':'.mp4','mime':'video/mp4'},{'ext':'.m4v','mime':'video/mp4'},{'ext':'.ogv','mime':'video/ogg'},
{'ext':'.webm','mime':'video/webm'},{'ext':'.mov','mime':'video/quicktime'},{'ext':'.qt','mime':'video/quicktime'}]

Der Parameter ist in JSON-Notation zu definieren. (Bitte hierbei beachten, das der : in der .properties Datein mit Backslash (\:)codiert werden muss)

Bei äteren Versionen:

[{'ext':'.mp4','mime':'video/mp4'},{'ext':'.ogv','mime':'video/ogg'},{'ext':'.webm','mime':'video/webm'}]

client.is.PWAnicht gesetzt (true)7.3

JA

Die Offlinefähigkeit (WebApp) von PicApport basiert vor Version 7.3 ausschließlich auf der AppCache-Technologie.
Diese wird von nahezu allen Browsern unterstützt. Es wird allerdings von allen Browserherstellern empfohlen,
mittelfristig auf die neuere ServiceWorker Architektur zu wechseln.
Ab Version 7.3 wird die Offlinefähigkeit optional über Serviceworker (Progressive Web App) hergestellt.
(SSL mit gültigem Zertifikat erforderlich).

Wichtig: Mit Freigabe der Version 9.1 vom 12.02.2021 wurde der default auf true umgestellt und der Status Experimentell entfernt (vorher war der default false)

client.thumb.titlenicht gesetzt  (hidden)9.0JA

Steuert die Anzeige eines Titels auf den Thumbnails. Folgende Werte sind möglich:

  • hidden (nicht sichtbar)
  • filename (Dateiname)

  • filenamenoext (Dateiname ohne Erweiterung)

  • fullpath (Serverpfad zur Datei)

  • phototitle (Titel aus den Metadaten)

  • photoid (interne ID)

  • date (Aufnahemdatum)

  • year (Aufnahemejahr)

  • timestamp (Zeitstempel)

  • fromaddon (Über Add-on gesteuert. Inhalt abhängig vom jeweiligen Add-on. siehe Doku Add-ons)

client.sort.random.smart.grpsizenicht gesetzt  (3)9.1JA

Optionaler Parameter.
Wertebereich 2-100
Default = 3

Anzahl Fotos für Gruppierung bei Random-Smart-Sortierung.
Bei Random Smart Sortierung werden abhängig von diesem Parameter N-Fotos die nacheinander folgend möglichst am gleichen Tag aufgenommen wurden gruppiert.

client.theme.color

nicht gesetzt
default = #039be5

10.1JA

Unabhängig von der globalen Farbschema Einstellung kann der Administrator bequem über die Benutzerverwaltung der PicApport Weboberfläche einzeln für jeden Benutzer das Farbschema einstellen (Menüpunkt Passwort setzen).

Ist ein Benutzer berechtigt, sein eigenes Kennwort zu ändern, dann kann er auch das Farbschema jederzeit selbst ändern (Menüpunkt Eigene Benutzerdaten ändern in den Benutzereinstellungen).

Eine Übersicht mit ein paar Screenshots von möglichen Themes findet sich hier: https://www.picapport.de/theme-gallery/

client.theme.darkthemenicht gesetzt  (false)10.1JA

Optionaler Parameter. (true oder false)

Theme-Modus (hell oder Dunkel) der Weboberfläche wenn nicht explizit bei Benutzer gesetzt.

Kann auch individuell für jeden Benutzer eingestellt werden. Siehe oben client.theme.color

upload.* Upload Konfiguration

upload.tag.prefix

nicht gesetzt
default =$PicApport/

Bitte beachten: Vor Version 9.2 war der Default PicApport/ (ohne $)

5.0JA

Viele Fotobetrachter verwenden eine Baumstruktur zur anzeige von Tags.
Mit dem Prefix wird dafür gesorgt, dass alle von Picapport erzeugten Tags unterhalb von $PicApport stehen.

upload.tag

nicht gesetzt
default = $upload
5.0JAJedes hochgeladene Foto wird mit diesem Tag versehen (gemeinsam mit dem Prefix).
Um alle hochgeladenen Fotos abzufragen einfach $upload eingeben
upload.tag.useridprefix

nicht gesetzt
default = @

5.0JAJedes 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  (100)
Vor Version 9.2 war der Default auf 10MB
5.0JAMaximale 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.0JAMaximale Requestgröße (Server) für Upload
Gültige Werte: (-1) bis Integer.MAX_VALUE
upload.max.memorysizenicht gesetzt
(102.400)
5.0JAMaximaler Speicher (Server) für Upload
Gültige Werte: 1024 bis Integer.MAX_VALUE
upload.max.parallel.uploadsnicht gesetzt (3)5.0JA

Maximale Anzahl gleichzeitiger Dateiübertragungen (Client)
Gültige Werte: 1 bis 100

upload.path

nicht gesetzt
default = uploads/@$UID$/$YYYY$/$MM$-$TITLE$

Vor Version 9.1 war der defaultwert wie folgt ohne @:

uploads/$UID$/$YYYY$/$MM$-$TITLE$

5.0JAPfad für Uploads von Fotos.
Dieser Pfad wird automatisch unterhalb des für Uploads konfigurierten Rootverzeichnisses (siehe: robot.root.n.isuploadroot) angelegt.
Folgende VariableN können verwendet werden (immer Großbuchstaben verwenden):
  • $UID$ - Wird durch die UserID (welche den Upload durchführt)  ersetzt
  • $YYYY$ - Wird durch das aktuelle Jahr (Aufnahmedatum des Fotos) ersetzt
  • $MM$ - Wird durch den aktuellen Monat (Aufnahmedatum des Fotos) ersetzt
  • $DD$ - Wird durch den aktuellen Tag (Aufnahmedatum des Fotos) ersetzt
  • $TITLE$ - Maximal 127 Zeichen vom Bildtitel (Ungültige Zeichen werden durch _ (underscore) ersetzt)
  • $UYYY$ - Wird durch das aktuelle Jahr (des Uploads) ersetzt (Ab Version 10)
  • $UM$ - Wird durch den aktuellen Monat (des Uploads) ersetzt (Ab Version 10)
  • $UD$ - Wird durch den aktuellen Tag (des Uploads) ersetzt (Ab Version 10)

Wichtig: Keine Verzeichnistrenner (Slash oder Backslash) am Anfang oder Ende des Eintrags eingeben.

upload.user.tagnicht gesetzt
default =check
7.0JA

Der Wert dieses Parameters wird automatisch als Usertag für Fotos gesetzt die über die Upload-Funktion kommen.
Somit kann jeder Benutzer seine neuen Uploads bequem mit GPS Tags und anderen Infos ausstatten wenn
man #check in das Suchfeld eingibt.    

Ist man mit der Nachbearbeitung der Metadaten fertig, kann man den Tag löschen.
Gibt man false für upload.user.tag ein werden keine Usertags beim Upload erzeugt.

upload.allow.video

nicht gesetzt
default=true (zusätzlich wird das PicApportVideoThumbnailPlugin benötigt)

9.2JADient zum Abschalten von Video Uploads bei installierten PicApportVideoThumbnailPlugin

server.ssl.* SSL Konfiguration

server.sslnot set (false)2.0JAWenn true dann wird SSL Protokoll aktiviert (Schlüssel werden generiert)
server.ssl.keystorenot set2.0JADateiname Keystore (Default = .picapport/picapport.ks)
server.ssl.passwordnot set2.0JAKennwort für Keystore
server.ssl.keypasswordnot set2.0JAPasswort für Zertifikat
server.ssl.truststorenot set2.0JADateiname der Truststore Datei (Default = .picapport/picapport.ks)
server.ssl.trustpasswordnot set2.0JAKennwort für Truststore
server.ssl.pem.privatekeyfilenot set10.0
JA

Alternativ zu einem Zertifikat in einem Keystore kann man auch die beiden Parameter server.ssl.pem.privatekeyfile und server.ssl.pem.certificatefile setzten.

Die folgende URL erläutert die Erzeugung von Zertifikaten unter Ubuntu: https://www.digitalocean.com/community/tutorials/how-to-create-a-self-signed-ssl-certificate-for-apache-in-ubuntu-16-04

Beispiel:
server.ssl.pem.privatekeyfile=/etc/apache2/ssl/apache.key

server.ssl.pem.certificatefilenot set10.0JA

Alternativ zu einem Zertifikat in einem Keystore kann man auch die beiden Parameter server.ssl.pem.privatekeyfile und server.ssl.pem.certificatefile setzten.

Die folgende URL erläutert die Erzeugung von Zertifikaten unter Ubuntu: https://www.digitalocean.com/community/tutorials/how-to-create-a-self-signed-ssl-certificate-for-apache-in-ubuntu-16-04

Beispiel:
server.ssl.pem.certificatefile=/etc/apache2/ssl/apache.crt

geo.* Kartenmodul Konfiguration





geo.max.markers

not set (20000)

6.0JAMaximale Anzahl von Markern auf der Karte
Wird die Anzahl überschritten bekommt der Anwender einen Hinweis.
Größere Werte sind bei ausreichendem Speicher kein Problem

geo.cluster.size

not set (120)6.0JAGöße der Cluster siehe: http://sintef-9012.github.io/PruneCluster/examples/random.10000-size.html

geo.marker.margin

not set (20)6.0JAMarker Margin siehe: http://sintef-9012.github.io/PruneCluster/examples/random.10000-size.html

geo.max.zoom

not set (18)6.0JAMaximales Zoomlevel des Kartenmoduls
geo.distance.km.defaultnot set (50)6.0JAVorgabewert KM für near: Operator
geo.map.defaultnot set (0)6.3.05JADefault Karte
  • 0 = Open Street Map (Vorgabe wenn nichts gesetzt ist)
  • 1 = Esri Satellite
  • 2 = Open Street Map B&W
  • 3 = Thunderforest landscape
  • 4 = Thunderforest outdoors
geo.map.key.thunderforestnot set6.3.05JA

Seit Februar 2017 wird für Thunderforest maps ein apikey benötigt.

Den Key kann man sich hier beschaffen: https://www.thunderforest.com/docs/apikeys/

Beispiel: geo.map.key.thunderforest=abcd1234abcd1234abcd1234abcd1234

pan360.* Panoramaviewer Konfiguration





pan360.rotation.speed

not set (-4)

7.3JARotationsgeschwindigkeit der 360° Panoramen in Grad pro Sekunde.
  • negative Werte = Drehung im Uhrzeigersinn
  • positive Werte = Drehung gegen den Uhrzeigersinn
  • Wertebereich -180 bis +180

pan360.slideshow.viewtime.seconds

not set (90)7.3JA

Anzeigezeit in Sekunden der sich drehenden Panoramen in der Slideshow (play-Modus)

  • Der Defaultwert von 90 Sekunden bedeutet, dass bei der Vorgaberotation von -4 (pan360.rotation.speed)
    das Panorama etwa so lange angezeigt wird bis eine Umdrehung ausgeführt wurde.
  • Wird der Parameter auf 0 gesetzt, so wird der Panoramaviewer in der Slideshow (play-Modus)
    nicht automatisch gestartet.
  • Wertebereich 0-99999

pan360.tags

not set (360)7.3JA

Tags die automatisch generiert werden um 360° Panoramen suchen zu können.

Standardmäßig verwendet PicApport den Tag pan360.

Wird dieser Parameter verändert oder gesetzt sollte danach die Datenbank neu aufgebaut werden.

fuzzysearch.* Konfiguration Thesaurus (Synonymwörterbuch) und phonetische Suche

fuzzysearch.modenot set (THESAURUS_ONLY)7.5JA

Gib den Standard Suchmodus bei der Volltextsuche an.

Hierbei wird gesteuert wie sich die Volltextsuche bei der Eingabe der Tilde(~)-Zeichen (Fuzzy-Suche) verhält:

WertVerhalten

THESAURUS_ONLY
(Standard)

Wenn mindestens ein Thesaurus (Synonymwörterbuch) in .picapport/thesaurus installiert ist läuft die Volltextsuche über alle gefundenen Synonyme des eingegebenen Suchwortes.
Ist das Wort nicht im Thesaurus eingetragen wird "normal" (ohne Thesaurus) gesucht.
Weiterhin gilt:

  • ~suchwort
    sucht den Suchbegriff ohne vorher Synonyme zu suchen (Einschränkung der Ergebnismenge)

Beispiel:

Der Thesaurus enthält folgenden Eintrag: Fasching Karnaval Carneval Fastnacht

Sucht man nach Fasching werden automatisch auch alle Fotos gefunden folgende Wörter enthalten: Fasching, Karnaval, Carneval, Fastnacht

Sucht man nach ~Fasching werden nur Fotos gefunden die in der Volltextsuche Fasching enthalten

NOT_FUZZY

Standardmäßig wird nur nach dem eingegebenen Suchwort gesucht. (Ohne Thesaurus und Phonetik)
Weiterhin gilt:

  • ~suchwort
    sucht den Suchbegriff im Thesaurus und wenn gefunden, alle passenden Synonyme. Wird kein Thesaurus Eintrag gefunden wird automatisch phonetisch gesucht.
FUZZY

Standardmäßig wird der Suchbegriff im Thesaurus gesucht und wenn gefunden nach alle passenden Synonymen gesucht. Wird kein Thesaurus Eintrag gefunden wird automatisch phonetisch gesucht.
Weiterhin gilt:

  • ~suchwort Standardsuche. Es wird nur nach dem eingegebenen Suchwort gesucht. (Ohne Thesaurus und Phonetik)

Unabhängig von Suchmodus gilt:

  • ~~suchwort
    Nur phonetische Suche: sucht nach phonetisch gleichklingenden Worten (z.B. Eingabe ~~Maier findet Maier, Mayer, Meier) siehe auch: weiter unten fuzzysearch.phonetic.encoder
  • ~~~suchwort
    Nur Suche über Synonyme: Sucht nur wenn ein Thesauruseintrag gefunden wurde nach allen Synonymen. Ist das Wort nicht im Thesaurus eingetragen wird "normal" (ohne Thesaurus) gesucht.
fuzzysearch.phonetic.encoder

not set (Vorgabe ist Sprachabhängig)
Vorgaben:

de: ColognePhonetic

en: DoubleMetaphone

es: none

fr: none

7.5JA

Folgende Verfahren werden unterstützt: (Wichtig: unbedingt auf Gross- Kleinschreibung achten)

WebApi Konfiguration (Wichtig für PhotoSyncApp)

siehe PicApport Web-API


siehe Configuration parameter to control Web-API functions in picapport.properties

auf PicApport Web-API

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
Parameter

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.
Beispiel:
picapport.exe -configfile=c:\myconig.properties -pserver.port=8080 -probot.root.0=C:\myphotos

Logging Konfiguration

ParameterBeschreibung
-DTRACE=loglevel

Folgende Werte für loglevel sind möglich:

  • ERROR (default)
  • WARNING
  • INFO
  • DEBUG
  • OFF
-DccNumLogFiles=nMaximale Anzahl Logfiles (n>2)
-DccLogFileSize

Maximale Logfilegröße in Bytes

default = 1000000 (1MB) Minimum=10000

-DccLogDirectory

default = .picapport/logfiles (wird automatisch angelegt)

-DccLogFileBaseNameÜberschreibt die default Dateinamen
Default=picapport (picapport.nnn)
-DccLogRefresh

Zeitabstand für Prüfung ob Logfile voll ist in Millisekunden

default=600000 =10 Minuten =600.000 millis; minimum = 60.000 millis = 1 Minute