Voraussetzung ist, dass eine Java Runtime installiert ist.

Über den Finder Verzeichnis anlegen, in dem sich picapport befinden soll (die folgenden Installationsbeschreibung geht von dem Verzeichnis /Users/Benutzername/Documents/picapport aus; demzufolge sind dann bei allen weiteren Schritten und Dateien die Pfade anzupassen).

Terminal öffnen und in des Verzeichnis gehen

> cd ~/Documents/picapport

Die JAR-Datei für Picapport von dem Download Bereich von picapport.de herunteladen und in das Verzeichnis kopieren

Erstellen einer Batch-Datei mit dem Namen picapport_run.sh und dem folgenden Inhalt (Benutzername sowie Name der JAR-Datei ist zu ersetzen):

PicApport ohne Server GUI (headless):

#!/bin/bash
java -Xms512m -Xmx1024m -Duser.home=/Users/Benutzername/Documents/picapport -jar picapport-headless.jar -configfile=/Users/Benutzername/Documents/picapport/picapport.properties

PicApport mit Server GUI:

#!/bin/bash
java -Xms512m -Xmx1024m -Duser.home=/Users/Benutzername/Documents/picapport -jar picapport.jar -configfile=/Users/Benutzername/Documents/picapport/picapport.properties

Erläuterungen:

- mit -Xms512m -Xmx1024m wird die Speicherkonfiguration gesetzt. Siehe hierzu: PicApport Installationshandbuch
- mit -Duser.home legen wir fest, dass das Konfigurations- und Datenverzeichnis .picapport nicht im Home-Verzeichnis des angemeldeten Benutzers angelegt wird.
- mit -configfile geben wir an, dass die Konfigurationsdatei sich im picapport-Verzeichnis befindet und nicht im .picapport-Verzeichnis, damit ist es einfacher Änderungen in der Konfiguration vorzunehmen, da Verzeichnisse, die mit einem . beginnen im Finder nicht sichtbar sind

Shell-Script ausführbar machen mit

> chmod a+x picapport_run.sh

Erstellen der picapport.properties Konfigurationsdatei im Verzeichnis picapport (siehe user.home oben) mit folgendem Inhalt (hier gegebenenfalls die Parameter anpassen):

server.port=8080
server.ssl=false
gui.enabled=false
gui.hideintray=true
server.demomode=false

Zur Erläuterungen der Parameter und weiterer Parameter siehe auf der Seite PicApport-Server Guide den Abschnitt "Parameter in picapport.properties".

Jetzt kann der Picapport-Server mit dem Shell-Script gestartet werden:

> ./picapport_run.sh

Wenn alles funktioniert sollte der Server über den Browser erreichbar sein.

Beenden erfolgt über die Eingabe von Exit im Terminal auf der Konsole des Picapport.

Automatisches Starten des Servers nach Anmeldung des Benutzers

Möchte man nun den Picapport-Server so installieren, dass er automatisch nach der Anmeldung des Benutzers startet, so reichen die folgenden Installationsschritte:

Erstellen einer Datei mit dem Namen de.contecon.picapport.plist und dem folgenden Inhalt (auch hier wieder den Benutzernamen setzen):

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
	<dict>
		<key>KeepAlive</key>
		<true/>
		<key>Label</key>
		<string>de.contecon.picapport</string>
		<key>ProgramArguments</key>
		<array>
			<string>/Users/Benutzername/Documents/picapport/picapport_run.sh</string>
		</array>
		<key>RunAtLoad</key>
		<true/>
		<key>WorkingDirectory</key>
		<string>/Users/Benutzername/Documents/picapport</string>
		<key>StandardErrorPath</key>
		<string>/Users/Benutzername/Documents/picapport/server.log</string>
		<key>StandardOutPath</key>
		<string>/dev/null</string>
	</dict>
</plist>

Erstellen einer Verknüpfung zu der gerade angelegten Datei in die Liste der zustartenden Programme pro Benutzeranmeldung:

> ln -sfv /Users/Benutzername/Documents/picapport/de.contecon.picapport.plist ~/Library/LaunchAgents/

Zum Prüfen, ob der Dienst sich starten lässt, den folgenden Befehl eingeben

> launchctl load ~/Library/LaunchAgents/de.contecon.picapport.plist

Picapport sollte jetzt über den Browser erreichbar sein.

Beenden lässt sich der Dienst über den Befehl:

> launchctl unload ~/Library/LaunchAgents/de.contecon.picapport.plist

Nach einem Neustart des Rechners und einer erfolgreichen Anmeldung sollte der Picapport-Server über den Browser erreichbar sein.

Beispieldateien