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

Hier finden sie alle nötigen Informationen zur Installation der Add-ons auf einem PicApport-Server.

Eine Übersicht aller verfügbaren Add-ons mit dem jeweiligen Download-Link findet sich hier: PicApport Add-on Guide

Installation mit dem Windows Installer

Einfach die gewünschten Add-ons im Installer auswählen, Server starten, fertig.

Ob ein Add-on über den Windows-Installer verfügbar ist, ist jeweils bei den Add-ons dokumentiert.

Manuelle Installation (alle Betriebssysteme)

  • Wird zum ersten Mal ein Add-on installiert muss einmalig auch eine Groovy-Laufzeit-Umgebung installiert werden. Anders als bei den Add-ons bleibt die entsprechende ZIP-Datei für die Groovy-Laufzeit-Umgebung immer im .picapport/groovy Verzeichnis stehen.
    Beispiel: .picapport/groovy/apache-groovy-binary-3.0.9.zip (nach erfolgreicher Installation wird zusätzlich ein verstecktes Verzeichnis groovy-3.0.9 erzeugt)
    Download binary Version Groovy 3.0.x: https://groovy.apache.org/download.html
    (Warnung) Nur wenn eine apache-groovy-binary-x.x.x.zip verfügbar ist wird das Add-on Subsystem in PicApport aktiviert.
    (Warnung) Bei Update der java Runtime auf eine Version größer Java 16 muss mindestens apache-groovy-binary ab Version 3.0.9 installiert werden (vorhandene apache-groovy-binary-x.x.x.zip durch neue ersetzen und Server starten)
     
  • Alle Add-ons können direkt auf der PicApport Webseite herunter geladen werden: https://www.picapport.de/de/add-ons.php
     
  • Alle für die Installation notwendigen Dateien sind jeweils als ZIP-Datei verfügbar und werden in das .picapport/groovy Verzeichnis kopiert.

  • Bei jedem Start des PicApport Servers wird dieses Verzeichnis nach neuen Add-on Dateien durchsucht und neue Add-ons werden automatisch installiert.
    Für jedes Add-on wird ein eigenes Verzeichnis angelegt und die Installationsdatei wird von PicApport dort ausgepackt und gesichert.

  • Nach erfolgreicher Installation der Add-ons werden die .zip ZIP-Dateien in das erstellte Add-on Verzeichnis kopiert, so dass im Groovy-Verzeichnis immer nur das aktuelle apache-groovy-binary-v.v.v.zip erhalten bleibt. 

  • In der Datei .picapport/groovy/logfiles/currentConfiguration.log kann nach dem Serverstart die erfolgreiche Installation der Add-ons überprüft werden.
    Die Logdatei ist auch über die PicApport Web-Gui Serververwaltung->Logdateien->groovyaddons/currentConfiguration.log einsehbar.

    Beispiel einer Logdatei nach erfolgreicher Installation 
    Groovy configuration log created: Wed Aug 12 13:40:38 CEST 2020

       GroovyManager.loadGroovyFromClasspath: Groovy not found on classpath. Now try to load from C:\Users\picapport\.picapport\groovy
       Search for Groovy runtime (apache-groovy-binary-*.zip) in C:\Users\picapport\.picapport\groovy
       Load Groovy runtime C:\Users\picapport\.picapport\groovy\apache-groovy-binary-3.0.9.zip
            Groovy directory C:\Users\picapport\.picapport\groovy\groovy-3.0.9 exists
            Adding Groovy jar to new URLClassLoaderC:\Users\picapport\.picapport\groovy\groovy-3.0.9\lib\groovy-3.0.9.jar
       Groovy runtime loaded from C:\Users\picapport\.picapport\groovy: 3.0.9
       
       Search for new Add-ons (pag?AddonName-v.v.v.zip) in C:\Users\picapport\.picapport\groovy
       0 Add-ons installed/updated

       Start (re)loading Groovy Addons: Wed Aug 12 13:40:39 CEST 2020
       Load Groovy Addon C:\Users\picapport\.picapport\groovy\pagcPrivateFileFilter\PrivateFileFilter.groovy Version:0.0.1 addontype:PathFilter of class:PrivateFileFilter
       Load Groovy Addon C:\Users\picapport\.picapport\groovy\pagfNonJpgTitleField\NonJpgTitleField.groovy Version:0.0.1 addontype:PhotoFieldProvider of class:NonJpgTitleField
       Load Groovy Addon C:\Users\picapport\.picapport\groovy\pagpExifToolSimpleInfo\ExifToolSimpleInfo.groovy Version:0.0.1 addontype:PhotoFileProcessor of class:ExifToolSimpleInfo
       Load Groovy Addon C:\Users\picapport\.picapport\groovy\pagpGroovyProceduresTestTool\GroovyProceduresTestTool.groovy Version:0.0.1 addontype:PhotoFileProcessor of class:GroovyProceduresTestTool
       Load Groovy Addon C:\Users\picapport\.picapport\groovy\pagpMetadataAnalyser\MetadataAnalyser.groovy Version:0.0.1 addontype:PhotoFileProcessor of class:MetadataAnalyser
       Load Groovy Addon C:\Users\picapport\.picapport\groovy\pagpOpenrouteGeoJSONRoute\OpenrouteGeoJSONRoute.groovy Version:0.0.1 addontype:PhotoFileProcessor of class:OpenroutGeoJSONRoute
       Load Groovy Addon C:\Users\picapport\.picapport\groovy\pagpOSMGeoReverseEncoder\OSMFields.groovy Version:0.0.1 addontype:PhotoFieldProvider of class:OSMFields
                         Field:osm of type DATA_TYPE_STRING index=INDEX_TYPE_FULLTEXT addToGlobalFulltext=true addToGlobalKeywords=false addToReport=true
                         Field:osmCountry of type DATA_TYPE_STRING index=INDEX_TYPE_FULLTEXT addToGlobalFulltext=false addToGlobalKeywords=false addToReport=true
                         Field:osmState of type DATA_TYPE_STRING index=INDEX_TYPE_FULLTEXT addToGlobalFulltext=false addToGlobalKeywords=false addToReport=true
                         Field:osmPostcode of type DATA_TYPE_STRING index=INDEX_TYPE_ID addToGlobalFulltext=false addToGlobalKeywords=false addToReport=true
                         Field:osmCity of type DATA_TYPE_STRING index=INDEX_TYPE_FULLTEXT addToGlobalFulltext=false addToGlobalKeywords=false addToReport=true
                         Field:osmRoad of type DATA_TYPE_STRING index=INDEX_TYPE_FULLTEXT addToGlobalFulltext=false addToGlobalKeywords=false addToReport=true
       Load Groovy Addon C:\Users\picapport\.picapport\groovy\pagpOSMGeoReverseEncoder\OSMGeoReverseEncoder.groovy Version:0.0.1 addontype:PhotoFileProcessor of class:OSMGeoReverseEncoder
       Load Groovy Addon C:\Users\picapport\.picapport\groovy\pagpTagYourPhotos\TagYourPhotos.groovy Version:0.0.1 addontype:PhotoFileProcessor of class:TagYourPhotos
       Load Groovy Addon C:\Users\picapport\.picapport\groovy\pagpTagYourPhotos\TagYourPhotosFields.groovy Version:0.0.1 addontype:PhotoFieldProvider of class:TagYourPhotosFields
                         Field:TagYourPhotos of type DATA_TYPE_STRING index=INDEX_TYPE_FULLTEXT addToGlobalFulltext=true addToGlobalKeywords=false addToReport=true
                         Field:typTags of type DATA_TYPE_STRING index=INDEX_TYPE_HIERARCHICAL addToGlobalFulltext=false addToGlobalKeywords=true addToReport=true
                         Field:typLandmarks of type DATA_TYPE_STRING index=INDEX_TYPE_FULLTEXT addToGlobalFulltext=false addToGlobalKeywords=false addToReport=true
                         Field:typCountry of type DATA_TYPE_STRING index=INDEX_TYPE_FULLTEXT addToGlobalFulltext=false addToGlobalKeywords=false addToReport=true
                         Field:typState of type DATA_TYPE_STRING index=INDEX_TYPE_FULLTEXT addToGlobalFulltext=false addToGlobalKeywords=false addToReport=true
                         Field:typCity of type DATA_TYPE_STRING index=INDEX_TYPE_FULLTEXT addToGlobalFulltext=false addToGlobalKeywords=false addToReport=true
                         Field:typDistrict of type DATA_TYPE_STRING index=INDEX_TYPE_FULLTEXT addToGlobalFulltext=false addToGlobalKeywords=false addToReport=true

       Check for new photofields.
       Field osm already exists.
       Field osmCountry already exists.
       Field osmState already exists.
       Field osmPostcode already exists.
       Field osmCity already exists.
       Field osmRoad already exists.
       Field TagYourPhotos already exists.
       Field typTags already exists.
       Field typLandmarks already exists.
       Field typCountry already exists.
       Field typState already exists.
       Field typCity already exists.
       Field typDistrict already exists.
  • (warning) Kurz zusammengefasst:
    Server beenden, ZIP-Datei(en) ins Groovy-Verzeichnis kopieren, Server starten, fertig (wink)

Namenskonventionen und Versionen

Groovy Laufzeitumgebung

  • apache-groovy-binary-v.v.v.zip
    Die jeweils aktuelle Laufzeitumgebung (binary) gibt es auf der PicApport Add-on Downloadseite oder auf https://groovy.apache.org/download.html

  • PicApport Version 10.x benötigt eine Groovy - Laufzeitumgebung ab Version 3.0.x (Stand September 2021: apache-groovy-binary-3.0.9.zip)

Add-on-Dateien

Die Namen der Add-on-Installationsdateien sind wie folgt aufgebaut:

typName-Version.zip

  • typ
    • pagc (Crawlerfilter)
    • pagf (Felderweiterung)
    • pagp (Prozedur)
  • Name
    Name des Addons (wird auch für den Verzeichnisnamen verwendet, welches bei der Installation des Add-ons generiert wird).
  • Bindestrich
    Dieser trennt Name von Version
  • Version
    immer in der Form x.x.x
  • .zip

Besonderheiten

Wurde beim Serverstart bereits eine Groovy Runtime installiert, können bestimmte Add-ons auch im laufenden Betrieb des Servers installiert bzw. aktualisiert werden.

Hierzu ist folgender Konsolenbefehl auf dem PicApport-Server einzugeben: reloadaddons

Die Ausnahme sind Add-ons, die neue Datenbankfelder hinzufügen. Diese müssen bei beendetem Server installiert werden. (Eine Aktualisierung, wenn keine neuen Datenbank-Felder dazukommen ist auch im laufenden Betrieb möglich)

Siehe hierzu auch die Entwicklerdoku.

(warning)Wenn man sich nicht sicher ist: Vor dem Installieren von Add-ons den Server beenden.(warning)