PicApport Installationshandbuch

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 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
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.

Hardwareanforderungen an den Server

Fotosammlungen sind wahre Datenmonster. Abhängig von der Anzahl der Fotos und den gleichzeitig angemeldeten Benutzern, empfehlen wir mindestens 512 MB 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 -Xmx1024m)

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® 2×2,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	07.03.00	95521		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	06.03.00	1000000	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	06.02.02	400000	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	25000	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	100000		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

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

toz.info@gmail.com