Migration yuuvis® RAD repository-manager 5
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: |
repositorymanager-al.rad.barcode.sap.connections |
Liste von SAP®-Verbindungen zum Repository. Beispiel:
Die Werte übernehmen Sie aus der KGS-Konfiguration: |
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.