Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

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

Installation mit dem Windows Installer

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

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

Manuelle Installation (alle Betriebssysteme)

Verzeichnisstruktur

  • 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 on Dateien durchsucht und neue Add-Ons ons werden automatisch installiert.
    Für jedes Add-On 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 Mal ein Add-On Installiert on installiert muss einmalig auch eine Groovy-Laufzeit-Umgebug Umgebung installiert werden. Die Anders als bei den Add-ons bleibt die entsprechende ZIP-Datei bleibt 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 on Subsystem in PicApport aktiviert.

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

    Code Block
    languagetext
    titleBeispiel einer Logdatei nach erfolgreicher Installation
    collapsetrue
    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-Dateien 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 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 September 2020: apache-groovy-binary-3.0.5.zip)

...

Add-on-Dateien

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

...

  • 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 (Wird für Verzeichnisnamen verwendet) von Version
  • Version
    immer in der Form x.x.x
  • .zip

Nach erfolgreicher Installation der Add-Ons werden die .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.   

Besonderheiten

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

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

Die Ausnahme sind Add-Ons 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)

...

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