enaio® repository-manager

enaio® repository-manager wurde aktualisiert und muss neu installiert und neu konfiguriert werden.

Bisher bestand enaio® repository-manager aus dem Service 'repositorymanager', der KGS-Komponenten verwendete und zugleich die ArchiveLink- und ILM-Anbindung beinhaltete.

Mit der neuen Version werden keine KGS-Komponenten mehr verwendet und die ArchiveLink- und ILM-Anbindungen sind aufgeteilt auf zwei eigene Services.

• Service 'repositorymanager-ilm' für die ILM-Anbindung

• Service 'repositorymanager‑archivelink' für die ArchiveLink-Anbindung

Falls nur die ArchiveLink-Anbindung oder nur die ILM-Anbindung verwendet wird, dann muss nur der entsprechende Service installiert werden.

Die Services werden über enaio® service-manager installiert. Sie müssen über die Dateien rmilm-prod.yml und rmalink-prod.yml konfiguriert werden.

Wenn die Services installiert werden, dann müssen sie vor der Inbetriebnahme vollständig konfiguriert werden.

SAP® CMIS-Anbindung

Der neue Service 'repositorymanager-cmis' stellt die Schnittstelle 'CMIS' für die SAP®-Anbindung im Projekt zur Verfügung.

Der Service ermöglicht aktuell keine allgemeine CMIS-Anbindung, sondern eine spezifische SAP®-Anbindung entsprechend der SAP®-Spezifikationen.

Migration ArchiveLink und ILM

Für die Aktualisierung von Installationen mit dem Service 'repositorymanager' bietet enaio® service-manager weiterhin den Service 'repositorymanager' zusätzlich zu den neuen Services 'repositorymanager-ilm' und 'repositorymanager‑archivelink' zur Installation an.

Mit dieser Option wird der bestehende Service 'repositorymanager' nicht deinstalliert. Damit bleibt die Konfigurationsdatei repositorymanager-prod.yml erhalten und der Zugriff auf die KGS-Administrationsseite möglich. Daten dieser Konfigurationen werden für die Konfiguration der neuen Services benötigt.

Nach der Migration muss der Service 'repositorymanager' über die Datei servicewatcher-sw.yml aus dem Verzeichnis \config von enaio® service-manager deaktiviert werden: instances: 0

Die folgende Anleitung setzt voraus, dass die Objektdefinition asobjdef_GenericCRweb.xml in der bestehenden Installation verwendet wird.

Migration ArchiveLink-Anbindung

Für die ArchiveLink-Anbindung installieren Sie über enaio® service-manager den Service 'repositorymanager‑archivelink'. Die Konfiguationsdatei rmalink-prod.yml wird in das Verzeichnis \config installiert.

Folgende Parameter müssen angegeben werden:

• Repository

  repositorymanager-al:
    enaio:
      cabinet:
        repositories:
          '[Generic CR Web]': RS

Die Repository-Bezeichnung übernehmen Sie aus der bisherigen Konfigurationsdatei repositorymanager-prod.yml:

repository-manager:
  repositories:
    a-link: "Generic CR Web |RS|"

• Standard-Parameter

  Die folgenden Werte von Standard-Parametern müssen übernommen werden, falls sie in der repositorymanager-prod.yml angegeben sind und damit die Standard-Werte überschreiben. Sie werden den neuen Standard-Parametern zugeordnet.

  Parameter-Bezeichnung repositorymanager-prod.yml	Parameter-Bezeichnung rmalink-prod.yml
  repository-manager.set-archivable	repositorymanager-al.enaio.set-archivable
  repository-manager.components.text	repositorymanager-al.enaio.components.text
  repository-manager.components.scanned	repositorymanager-al.enaio.components.scanned
  repository-manager.propagate-retention	repositorymanager-al.retention.enabled
  repository-manager.barcode.cntType2docType	repositorymanager-al.barcode.cnt-type-doc-type
  repository-manager.barcode.default-docType	repositorymanager-al.barcode.default-doc-type
  repository-manager.barcode.default-protection	repositorymanager-al.barcode.default-protection
  repository-manager.barcode.default-protocol-version	repositorymanager-al.barcode.default-protocol-version
  repository-manager.barcode.processing-limit	repositorymanager-al.barcode.limit

• Barcode-Verarbeitung

  Wenn die Barcode-Verarbeitung aktiviert ist, dann werden die folgende Parameter in der rmalink-prod.yml benötigt.

  • repositorymanager-al.barcode.interval

    Der Wert entspricht dem Wert 'BarcodeTimer' der KGS-Konfiguration. Ein Wert größer 0 aktiviert die Barcode-Verarbeitung.

    In der KGS-Konfiguration ist der Wert in Sekunden angegeben. Für den Parameter 'repositorymanager-al.barcode.interval' geben Sie den Wert in Minuten an.

    Beispiel: KGS BarcodeTimer 1800 entspricht einem Wert von 30.

  • repositorymanager-al.enaio.barcode.sap.connections

    Die Daten für die SAP®-Verbindungen zum Repository entnehmen Sie der KGS SAP Connector Konfiguration: Main > KGS SAP Connector > Actions: Edit > Configuration Values.

    Beispiel:

    

  Entsprechende Konfiguation 'repositorymanager-al.enaio.barcode.sap.connections'

  repositorymanager-al:
    enaio:
      barcode:
        sap:
          connections:
            - name: OSH
              contRep: RS
              ashost: 10.10.4.7
              sysnr: 00
              client: 800
              user: RISTIC
              passwd: password
              lang: en

  • servicewatcher-sw.yml

    Die Datei servicewatcher-sw.yml aus dem Verzeichnis \config von enaio® service-manager passen Sie an:

    applications:
    - name: rmalink
      type: microservice
      profiles: prod,cloud,blue
      instances: 1
      memory: 512M
      port: 8092
      path: .
      arch: x64
      jdk: jdk17
      options:
      - -Dloader.path="C:/enaio/service-manager/data/rm-alink/lib"

  • Sie geben den Pfad zum Verzeichnis \data\rm-alink\lib entsprechend ihrer Installation als absoluten Pfad an.

• Komprimierung der Dateien

  Wenn die Komprimierung von Dateien aktiviert ist, dann aktivieren Sie die Komprimierung über die folgenden Parameter in der rmalink-prod.yml:

  • repositorymanager-al.compression.limit

    Größe in MB, ab der Dateien komprimiert werden. Der Standard-Wert 0.0 deaktiviert die Komprimierung.

  • repositorymanager-al.compression.content-types

    Mime Typ der Dateien, die komprimiert werden. Wenn alle Dateien komprimiert werden sollen, dann wird der Parameter nicht benötigt.

• SAP®-Verbindungskonfiguration

  Im SAP® GUI öffnen Sie über die Transaktion 'OAC0' die bestehende Verbindung und führen die folgenden Schritte aus.

  • Port Number: Geben Sie den Port vom Service 'repositorymanager‑archivelink' an. Standard: 8092.

  • HTTP Script: Geben Sie folgendes an: api/enaio/al

    Sie können die Verbindung über die Waage-Schaltfläche testen.

  • Senden Sie das Zertifikat über die Brief-Schaltfläche an den Service 'repositorymanager‑archivelink'.

  • Aktivieren Sie das Zertifikat in enaio® service-manager über den Endpunkt /api/enaio/certificate/activate vom Service 'repositorymanager‑archivelink' per 'PUT request'. Parameter: contRep und cn

Migration ILM-Anbindung

Für die ILM-Anbindung installieren Sie über enaio® service-manager den Service 'repositorymanager‑ilm'. Die Konfiguationsdatei rmilm-prod.yml wird in das Verzeichnis \config installiert.

Folgende Parameter müssen angegeben werden:

• repositorymanager-ilm.auth.username / repositorymanager-ilm.auth.password

  Benutzername und Passwort aus der KGS ILM Konfiguration.

• repositorymanager-ilm.enaio.cabinet.ilm-name

  Bezeichnung des enaio®-Ordnertyps, in dem ILM-Daten gespeichert werden. Standard: SAPILM Collection

• repositorymanager-ilm.retention.enabled

  Falls mit dem bisherigen Parameter repository-manager.propagate-retention: false Retentionszeiten deaktiviert waren, dann deaktivieren Sie die Retentionszeiten ebenfalls über den neuen Parameter. Standard: true.

• SAP®-Verbindungskonfiguration

  Im SAP® GUI öffnen Sie über die Transaktion 'SM59 > HTTP Connections to External Server' die bestehende Verbindung und führen die folgenden Schritte aus.

  • Port: Geben Sie im Bereich 'Technical Settings' den Port des Services 'repositorymanager‑ilm' an. Standard: 8094.

  • Password: Geben Sie im Bereich 'Logon & Security' das Passwort ein, das aus der KGS ILM Konfiguration in die rmilm-prod.yml übernommen wurde.