PicApport wurde in der Programmiersprache Java geschrieben.
Die gute Nachricht : Hierdurch läuft der PicApport-Server auf nahezu allen aktuellen Betriebssystem-Plattformen 
.
Die schlechte Nachricht: Aufgrund der Anzahl der Installationsmöglichkeiten sind wir nicht in der Lage, alle Details für alle möglichen Betriebssysteme zu dokumentieren 
.
Mittlerweile unterstützen uns hier schon einige PicApport Anwender mit kleinen Dokus nachdem sie PicApport auf einer Ihrer Plattformen installiert haben.
Wir freuen uns über jegliche Informationen bzgl. Erfahrungen bei der Installation, die uns helfen dieses Handbuch zu verbessern.
Unterstützte Java-Runtime Versionen
| PicApport Version | Java 8.x | Java | Java | Java | Java |
|---|---|---|---|---|---|
| 7.2.x und älter | Ja | - | - | - | |
| 7.3.0 | Ja | Ja | Ja | - | |
| 7.x, 8.x sowie 9.0 | Ja | Ja | Ja | Ja*1 | |
| ab 9.1 *2 | Ja | Ja | Ja | Ja*2 | Ja *2,*3 |
| ab 10.2 *2 | Ja | Ja | Ja | Ja*2 | Ja *2 |
*1: Hinweise für Java ab Java Version 11 Beispiel Startkommando für picapport.jar mit Java 11: java -cp d:\java\FX\javafx-sdk-11\lib\*;picapport.jar -Xms2048m -Xmx2048m de.contecon.picapport.PicApport | |||||
*2: Hinweise für die PicApport-Server-GUI ab PicApport Version 9.1 (picapport-headless.jar ist davon nicht betroffen) Die PicApport Server GUI-läuft ab Version 9.1 auch ohne Java FX welche ab Java 11 aus der Java-Runtime entfernt wurde. | |||||
*3: Hinweise für Java ab Version 16 Für Java ab Version 16 muss PicApport ab Version 10.2 benutzt werden. (Freigabe von 10.2 erfolgt voraussichtlich im November 2021) Für alle PicApport Versionen vor 10.2 muss eine Java Version kleiner 16 benutzt werden.
| |||||
WICHTIG für Add-ons: Um PicApport Add-ons auf Java Versionen >= 16 zu nutzen, muss Groovy ab Version 3.0.9 (apache-groovy-binary-3.0.9.zip) im .picapport/groovy Verzeichnis installiert werden (alte apache-groovy-*.zip löschen) Siehe hierzu auch
Hardwareanforderungen an den Server
Fotosammlungen sind wahre Datenmonster. Abhängig von der Anzahl der Fotos und den gleichzeitig angemeldeten Benutzern, empfehlen wir mindestens 1024MB freien Speicher für den Server.
Wir empfehlen dringend den Einsatz einer 64-Bit JVM.
Wichtig
Installiert man PicApport nicht mit dem Windows Installer, dann muss beim Starten von Java die Speicherkonfiguration gesetzt werden. (z.B. java -Xms512m -Xmx2048m)
Aktuelle Java Runtimes haben recht gute Standardwerte für die Speicherkonfiguration. Wir empfehlen jedoch dringend nach dem ersten Start von PicApport die Logdatei zu prüfen.
Nur hier kann man erkennen, wie viel Hauptspeicher der PicApport Server wirklich nutzen kann. Die Zeile sieht z.B. so aus:
MSG @ 13:04:19.646 java.runtime totalMemory=1073mb maxMemory=14520mb freeMemory=1057mb processors=16
Wir empfehlen für maxMemory mindestens 1024mb besser deutlich mehr (das hängt natürlich auch von der Anzahl gleichzeitiger Benutzer, Anzahl Fotos usw. ab)
Beispiele unter: PicApport-Server Guide oder Wie kann ich den von PicApport verwendeten Arbeitsspeicher beeinflussen ?
Oracle Doku unter: https://docs.oracle.com/javase/8/docs/technotes/tools/windows/java.html
| Erfahrungswerte (Von Anwendern gemeldet) | ||||||
|---|---|---|---|---|---|---|
| Speichereinstellungen | Java-JM | Betriebssystem / Hardware | PicApport Version | Anzahl Fotos | Anzahl gleichzeitiger Benutzer | Besonderheiten |
| Eingesendet für Version 8.0.x | ||||||
-Xms512m -Xmx1024m | openjdk version "1.8.0_222" OpenJDK Runtime Environment (build 1.8.0_222-8u222-b10-1ubuntu1~16.04.1-b10) OpenJDK 64-Bit Server VM (build 25.222-b10, mixed mode) | OS: Linux Mint Mate 18.3 64bit Sylvia 8GB / Intel J3355 Celeron® 2x2,0GHz passiv gekühlt / 24H Betrieb zugelassen Zulassung für Linux Inbetriebnahme 04.2018 | V8.0.00 PicApport-headless.jar Bereits viertes Update ohne Probleme! Einfach diePicApport-headless.jar ausgetauscht, neustart, fertig! Super einfach | 1000 bis 5000 nach ca. einem Jahr erfolgt Archivierung und neue Bilder rücken nach | 2-10 | Parallelläuft Sync-Software Seafile 55% Speicherauslastung ohne Zugriffe Temperatur ca. 40°C Leerlauf (unbeheizter Keller) 4TB Nas-Festplatte IronWolf im externen Gehäuse über USB 3.0 Betrieb über Dyn-DNS Dienst Spdyn.de derzeit ohne letsencrypt! (kommt aber jetzt) DSL-Geschwindigkeiten:
Bildaufbau bei ca. 5MB *.jpg super schnell! Stromkosten ca. 2€/Monat Service/Wartung: über SSH-Server (Terminal) und über No-Machine Remote Desktop (grafisch) |
| Eingesendet für Version 7.4.x | ||||||
| -Xms256m -Xmx1024m -XX:MaxDirectMemorySize=4g -Dstorage.diskCache.bufferSize=512 | java -version java version "11.0.2" 2019-01-15 LTS Java(TM) SE Runtime Environment 18.9 (build 11.0.2+9-LTS) Java HotSpot(TM) 64-Bit Server VM 18.9 (build 11.0.2+9-LTS, mixed mode) | ESXi (Intel Xeon E3 1260L) VM mit 2vCPUs und 4 GB RAM. OpenMediaVault VM mit 4 GB RAM | 7.4.x | 1,3 Millionen Bilder Datenbank auf SSD Fotos auf HD | 1-2 | Start command used for PicApport: StartPicApport.sh wird mit nice -n 10 gestartet: java -Xms256m -Xmx1024m -XX:MaxDirectMemorySize=4g -Dstorage.diskCache.bufferSize=512 -Duser.language=de -Duser.home=/opt/picapport -jar /opt/picapport/picapport-headless.jar |
| Eingesendet für Version 7.3.0 | ||||||
| -Xmx800m -Dstorage.diskCache.bufferSize=1024 | Java(TM) SE Runtime Environment (build 1.8.0_72-b15) | Debian GNU/Linux 8 (jessie) Intel(R) Pentium(R) CPU G620 @ 2.60GHz 4 GB Hauptspeicher | 7.3.0 | 95.521 | Send in by user toz.info@gmail.com Start command used for PicApport: $ ulimit -n 500000 && java -Xmx800m -Dstorage.diskCache.bufferSize=1024 -Duser.home=/opt/picapport -jar headless_v730.jar -pserver.port=8080 -probot.root.0.path=/mnt/pics/Bilder/ -pgui.enabled=true -pupload.path="\$YYYY\$-\$MM\$-\$DD\$/\$TITLE\$" -pclient.folder.sort=name | |
| Eingesendet vor Version 7.3.0 | ||||||
-Xms4048m -Xmx4048m -XX:MaxDirectMemorySize=2g Auch wenn diese Werte für 10 Benutzer | Oracle java version "1.8.0_111" Java(TM) SE Runtime Environment (build 1.8.0_111-b14) Java HotSpot(TM) 64-Bit Server VM (build 25.111-b14, mixed mode) | Windows 10 pro 64bit | 6.3.0 | 1.000.000 | 10 | Alle 1.000.000 Fotos waren auf einem über USB3 verbundenem magnetischen Laufwerk.
|
-Xms2048m -Xmx2048m -XX:MaxDirectMemorySize=2g Auch wenn diese beiden Werte für 10 Benutzer | Oracle java version "1.8.0_111" | Windows 10 pro 64bit Intel(R) Core(TM) i7-4900MQ CPU 2.80GHz RAM 16GB | 6.2.2 | 400.000 | 10 | Alle 400.000 Fotos waren auf einem über USB3 verbundenem magnetischen Laufwerk.
|
| -Xms512m -Xmx1024m | Oracle Java JRE 1.8.0_102, 64bit | Ubuntu 16.04 LTS, Desktop-Version | 6.2 | 25.000 | 4 | |
| -Xms2048m -Xmx2048m | Oracle jre1.8.0_91 64-Bit | Windows 10 Windows 10 | 6.2 6.2 | 50.000 7.000 | 4 10 | Zwei Server auf einem PC |
-Xms1024m -Xmx2048m -Xss4m -XX:MaxMetaspaceSize=128m | 32-Bit | QNAP NAS TS-653 Pro mit 8 GB Hauptspeicher | 6.1 | 100.000 | Aktuell bei 100.800 Fotos und ca. 11.500 erzeugten thumbnails: Exakt 2 Stunden von Start der Initialisierung bis NotifyStopCrawl. Weitere 3 Stunden für die thumbnail-Erzeugung bisher. Ein knappes GB hat die Datenbank: | |
Installation unter Windows
Für die Installation unter Windows gibt es für Einsteiger einen komfortablen Installer. Siehe Installation von PicApport auf einem Windows System
Fortgeschrittene Benutzer oder Administratoren können PicApport auch als Windows-Dienst installieren. Siehe Installation von PicApport als Windows Dienst
Selbstverständlich kann man PicApport unter Windows auch mit einer bereits vorhandenen Java Installation betreiben.
Installation unter Linux
- Installation von PicApport unter Linux
Enthält Dokumentation sowie ein paar Downloads
Installation auf NAS-Systemen
- Installation von PicApport auf einen QNAP NAS-Server
Enthält Dokumentation (pdf) sowie ein qpkg package.
Installation unter OS X
Installation in einen Docker-Container
Die Verzeichnisstruktur des PicApport Servers
Standardmäßig legt PicApport alle veränderlichen Daten unterhalb des Home-Verzeichnisses des aktuellen Benutzern im Verzeichnis .picapport ab. Der Name und Ort diese Verzeichnisses kann geändert werden. Siehe hierzu PicApport-Server Guide. Unter Windows ist dies normalerweise C:\Users\YOUR-USERID\.picapport Unter Linux ist dies normalerweise /home/YOUR-USERID/.picapport Wird PicApport zur ersten mal auf einem Server gestartet, so wird dieses Verzeichnis automatisch angelegt und mit Standard-Vorgabewerten gefüllt.
Wichtig
PicApport benötigt uneingeschränkte Schreibrechte für das .picapport Verzeichnis.
- Anlegen Ändern Löschen von Dateien
- Anlegen Ändern Löschen von beliebigen Unterverzeichnissen
Eine detaillierte Beschreibung der Verzeichnisstruktur findet sich hier: Die Verzeichnisstruktur des PicApport Servers