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
9.x | Java
10.x | Java
11, 12,13,14,15 | Java
16, 17 und höher |
|---|
| 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
JavaFX ist ab Java11 nicht mehr in der Java Runtime enthalten. Benutzt man picapport.jar mit der ServerGUI unter Java 11 ist JavaFX separat einzubinden.
(picapport-headless.jar ist davon nicht betroffen)
Siehe auch OpenJDK JavaFX Wiki: https://wiki.openjdk.java.net/display/OpenJFX/Main 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.
Die PicApportServer-GUI lässt sich somit auf allen aktuellen Java Runtime-Versionen auch ohne JavaFX starten.
Lediglich der Programmteil für Verwaltung von E-Mailkonten (sehr alter Programmteil) benötigt noch JavaFX und ist nur dann verfügbar wenn ein JavaFX im classpath (siehe oben unter *1) verfügbar ist. |
*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 PicApport Add-on Installation Guide
|
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.
| Note |
|---|
|
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
32/64 Bit | 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 Shuttle DX30 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: - 50MB Download
- 10MB Upload am Server
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
und 1.000.000 Fotos gut funktionieren,
empfehlen wir natürlich höhere Werte | 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
Intel(R) Core(TM) i7-4900MQ CPU 2.80GHz
RAM 16GB | 6.3.0 | 1.000.000 | 10 | Alle 1.000.000 Fotos waren auf einem über USB3 verbundenem magnetischen Laufwerk.
Das .picapport Verzeichnis auf einer eingebauten SSD - Speicherverbrauch der Fotos auf USB-Laufwerk: ~2,5TB
- Größe des .picapport Verzeichnisses mit Datenbank:
| -Xms2048m -Xmx2048m -XX:MaxDirectMemorySize=2g Auch wenn diese beiden Werte für 10 Benutzer
und 400.000 Fotos gut funktionieren,
empfehlen wir natürlich höhere Werte | 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
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.
Das .picapport Verzeichnis auf einer eingebauten SSD - Speicherverbrauch der Fotos auf USB-Laufwerk: ~920GB
- Größe des .picapport Verzeichnisses mit Datenbank: 5,3GB
| | -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
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
und Intel Celeron J1900 (4 Kerne, 2 GHz) | 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 auf NAS-Systemen
Installation unter OS X
Installation in einen Docker-Container
Die Verzeichnisstruktur des PicApport Servers
| Excerpt Include |
|---|
| Die Verzeichnisstruktur des PicApport Servers |
|---|
| Die Verzeichnisstruktur des PicApport Servers |
|---|
| nopanel | true |
|---|
|
| Note |
|---|
|
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
toz.info@gmail.com