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)

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

  • 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: apache-groovy-binary-3.0.5.zip (nach erfolgreicher Installation wird zusätzlich ein verstecktes Verzeichnis groovy-3.0.5 erzeugt)
    (Warnung) Nur wenn eine apache-groovy-binary-x.x.x.zip verfügbar ist wird das Add-on Subsystem in PicApport aktiviert.

  • 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.5.zip
                Groovy directory C:\Users\picapport\.picapport\groovy\groovy-3.0.5 exists
                Adding Groovy jar to new URLClassLoaderC:\Users\picapport\.picapport\groovy\groovy-3.0.5\lib\groovy-3.0.5.jar
           Groovy runtime loaded from C:\Users\picapport\.picapport\groovy: 3.0.5
           
           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.
  • (Warnung) Kurz zusammengefasst:
    Server beenden, ZIP-Datei(en) ins Groovy-Verzeichnis kopieren, Server starten, fertig (Zwinkern)

Namenskonventionen und Versionen

Groovy Laufzeitumgebung

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

  • PicApport Version 9.x benötigt eine Groovy - Laufzeitumgebung ab Version 3.0.x (Stand September 2020: apache-groovy-binary-3.0.5.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.

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