Migration yuuvis® RAD repository-manager 5

yuuvis® RAD repository-manager 10.x »

Ab yuuvis® RAD 10.12 steht yuuvis® RAD repository-manager in der Version 5 zur Verfügung. Mit der neuen Version werden keine KGS-Komponenten mehr verwendet und die ArchiveLink- und ILM-Anbindungen sind aufgeteilt auf zwei eigene Services: 'rmalink' und 'rmilm'.

yuuvis® RAD repository-manager in der Version 4 kann weiter verwendet werden. Eine Aktualisierung auf die Version 5 wird erst mit einer folgenden Version von yuuvis® RAD notwendig.

Die Services 'rmalink' und 'rmilm' werden zusätzlich mit installiert, aber nicht aktiviert. Der Service 'repository-manger' bleibt aktiviert, damit ein Zugriff auf die KGS-Administration möglich ist und Daten aus der bestehenden Konfiguration eingesehen und übernommen werden können: http://<service-manager-IP>:<Port>/cs/

Nach der Konfiguration der neuen Services müssen diese über die Datei servicewatcher-sw.yml aus dem Verzeichnis \config von yuuvis® RAD service-manager über den Parameter instances aktiviert werden und der vorherige Service 'repository-manger' muss deaktiviert werden.

Wenn nur die ArchiveLink-Anbindung oder nur die ILM-Anbindung verwendet wird, dann muss nur der entsprechende Service konfiguriert und aktiviert werden.

Migration ArchiveLink-Anbindung

Der Service 'rmalink'- benötigt die Konfigurationsdatei rmalink-prod.yml. Diese Datei muss im Verzeichnis \config von yuuvis® RAD service-manager angelegt werden.

Eine Vorlage für die Konfiguration stellen wir zum Download zur Verfügung.

Parameter der Konfigurationsdatei rmalink-prod.yml:

Parameter Wert
repositorymanager-al.rad.repositories

Kommaseparierte Liste von SAP-Repositories.

Die Repository-Bezeichnungen übernehmen Sie aus der KGS-Konfiguration:

Main > tia® Content Server

repositorymanager-al.rad.use-sidecar

Verbindung über den Service 'dmssidecar'.

Übernehmen Sie den Wert aus der Datei repositorymanager-prod.yml.

Für den Wert false benötigen Sie Werte für die folgenden Parameter.

repositorymanager-al.rad.api-uri

IP-Adresse und Port, über die yuuvis® RAD repository-manager den yuuvis® RAD core-service erreicht.

Default-Port für yuuvis® RAD core-service: 8080

repositorymanager-al.rad.username Benutzername für den Zugriff auf den yuuvis® RAD core-service
repositorymanager-al.rad.password Passwort für den Zugriff auf den yuuvis® RAD core-service

Folgende Parameter müssen angegeben werden, falls sie in der Datei repositorymanager-prod.yml angegeben sind und damit Default-Werte überschreiben.

Parameter rmalink-prod.yml Parameter repositorymanager-prod.yml Default
repository-manager.propagate-retention

repositorymanager-al.retention.enabled

true
repository-manager.barcode.cntType2docType

repositorymanager-al.barcode.cnt-type-doc-type

Image/TIFF=FAX|application/pdf=PDF
repository-manager.barcode.default-docType

repositorymanager-al.barcode.default-doc-type

TIF
repository-manager.barcode.default-protection repositorymanager-al.barcode.default-protection "rcud"
repository-manager.barcode.default-protocol-version repositorymanager-al.barcode.default-protocol-version "0047"
repository-manager.barcode.processing-limit repositorymanager-al.barcode.limit 1000

Wenn das Barcodeszenario aktiviert ist, werden folgende Parameter benötigt. Die Werte übernehmen Sie aus der KGS-Konfiguration.

Parameter Wert
repositorymanager-al.barcode.interval

Barcode-Verarbeitungsintervall in Minuten.

Der Default-Wert 0 deaktiviert die Barcode-Verarbeitung.

Der Wert ist in der KGS-Barcode-Konfiguration in Sekunden angegeben:
Main > KGS SAP Connector > Edit Configuration > Barcode
Hier muss der Wert dagegen in Minuten angegeben werden.

repositorymanager-al.rad.barcode.sap.connections

Liste von SAP®-Verbindungen zum Repository.

Beispiel:

repositorymanager-al:
  rad:
    barcode:
      sap:
        connections:
          - name: OSH
            contRep: IR
            ashost: 10.12.4.7
            sysnr: 00
            client: 800
            user: user
            passwd: secret
            lang: en

Die Werte übernehmen Sie aus der KGS-Konfiguration:
Main > KGS SAP Connector > Actions: Edit > Configuration Values

Wenn die Kompression aktiviert ist, dann werden folgende Parameter benötigt. Die Werte übernehmen Sie aus der KGS-Konfiguration: Main > KGS SAP Connector > Edit Configuration > Components

Parameter Wert
repositorymanager-al.compression.limit

Kompression für Objekte, die die angegebenen Größe in MB überschreiten.

Der Wert 0.0 deaktiviert die Kompression.

repositorymanager-al.compression.content-types

Wenn die Kompression aktiviert ist, dann kann sie auf Content-Typen eingeschränkt werden.

Beispiel: [application/pdf, image/png]

servicewatcher-sw.yml

Ebenfalls angepasst werden muss die Datei servicewatcher-sw.yml aus dem Verzeichnis \config von yuuvis® RAD service-manager.

applications:
- name: rmalink
  type: microservice
  profiles: prod,cloud,red
  instances: 1
  memory: 512M
  port: 8092
  path: ${appBase}/rmalink/rmalink-app.jar
  options:
  - -Dloader.path=${enaio.data.path}/rm-alink/lib

SAP®-Verbindungskonfiguration ArchiveLink

Vor der SAP®-Verbindungskonfiguration muss der Service 'rmalink' aktiviert und gestartet werden.

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 'rmalink' an. Standard: 8092.

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

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

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

  • Aktivieren Sie das Zertifikat in yuuvis® RAD service-manager über den Endpunkt /api/rad/certificate/activate vom Service 'rmalink' per 'PUT request'. Parameter: contRep und cn

Migration ILM-Anbindung

Der Service 'rmilm' benötigt die Konfigurationsdatei rmilm-prod.yml. Diese Datei muss im Verzeichnis \config von yuuvis® RAD service-manager angelegt werden.

Eine Vorlage für die Konfiguration stellen wir zum Download zur Verfügung.

Parameter der Konfigurationsdatei rmilm-prod.yml. Die Werte übernehmen Sie aus der KGS-Konfiguration:

Main > KGS SAP Connector > Edit Configuration > ILM

Parameter Wert
repositorymanager-ilm.auth.username

Benutzername des ILM-Clients

repositorymanager-ilm.auth.password

Passwort des Benutzernamens

repositorymanager-ilm.retention.enabled

Retentionszeiten werden in yuuvis® RAD für ILM-Dokumente mit Löschsperre gesetzt.

Default: true

Der Parameter wird nur benötigt, wenn Retentionszeiten in der Datei repositorymanager-prod.yml über den Parameter repository-manager.propagate-retention deaktiviert sind.

repositorymanager-ilm.rad.dms.use-sidecar

Verbindung über den Service 'dmssidecar'.

Für den Wert false benötigen Sie Werte für die folgenden Parameter.

repositorymanager-ilm.rad.dms.api-url

IP-Adresse und Port, über die yuuvis® RAD repository-manager den yuuvis® RAD core-service erreicht.

Default-Port für yuuvis® RAD core-service: 8080

repositorymanager-ilm.rad.dms.username Benutzername für den Zugriff auf den yuuvis® RAD core-service
repositorymanager-ilm.rad.dms.password Passwort für den Zugriff auf den yuuvis® RAD core-service

Beispielkonfiguration:

repositorymanager-ilm:
  auth:
    username: user
    password: secret
  rad:
    dms:
      use-sidecar: false
      api-uri: http://10.10.104.38:8080
      username: user
      password: secret
  retention:
    enabled: false

SAP®-Verbindungskonfiguration ILM

Vor der SAP®-Verbindungskonfiguration muss der Service 'rmilm' aktiviert und gestartet werden.

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 'rmilm' 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.

  • Testen Sie die Verbindung.