Installieren

enaio® repository-manager • 11.0 »

Vorausetzungen

Vorausgesetzt ist die vollständige Installation von enaio®.

enaio® repository-manager stellt die Schnittstellen 'ArchiveLink' entsprechend dem Integrationsszenario S/4-BC-AL 7.40 zur Verfügung.

Diese Schnittstelle wird seitens SAP® ab der Version ERP 6.x sowie mit S/4HANA ab Version 1503 unterstützt. ArchiveLink steht nicht für S/4HANA - public cloud zur Verfügung.

enaio® repository-manager stellt die Schnittstellen 'ILM' entsprechend dem Integrationsszenario BC-ILM 3.1 zur Verfügung.

Diese Schnittstelle wird seitens SAP® ab der Version ERP 6.0 EhP 8 sowie mit S/4HANA ab Version 1503 unterstützt.

Installation

Mit der Installation über os_service-manager_setup.exe aus dem Verzeichnis \Backend\Service-Manager\ werden die Services installiert und aktualisiert.

Aktivieren Sie bei die Installation den Service 'repository-manager'. Die Services 'dms' und 'license' werden ebenfalls benötigt.

Für Aktualisierungen kann ebenfalls das Service-Manager-Update aus dem Verzeichnis \Backend\ verwendet werden.

Beim Starten des Services 'repository-manager' werden Zuordnungen zwischen Content-Repositories und enaio®-Dokumenttypen sowie deren Felder geprüft: Endpunkt 'manage/health/dmsObjectModel'. Falls Fehler vorliegen, dann läuft der Service, wird aber im enaio® services-admin als 'down' angezeigt.

Für die Kommunikation mit SAP® ist in der Regel das Einspielen eines Zertifikats für Datenkonsistenz und Sicherheit, die entsprechende Anpassung der Konfigurationsdatei repositorymanager-prod.yml, das Einbinden des Zertifikats in enaio® service-manager und entsprechende Anpassungen der SAP® SSL Konfiguration notwendig.

Standard-Einstellungen

enaio® repository-manager wird mit den folgenden Standard-Einstellungen installiert. Anpassungen sollten, falls notwendig, vor dem Start des Services erfolgen. Beachten Sie die spezifische Syntax von YML-Dateien.

Port Der Standard-Port für den Services 'repository-manager' ist 8010. Falls der Port geändert werden muss, dann ändern Sie ihn ausschließlich in der Datei servicewatcher-sw.yml. Ein Neustart von enaio® service-manager ist danach notwendig.
Arbeitsverzeichnis

Das Arbeitsverzeichnis wird als Standard im Unterverzeichns \rm\working-dir des Datenverzeichnis von enaio® service-manager angelegt.

Es kann über den Parameter working-dir der Konfigurationsdatei repositorymanager-prod.yml angepasst werden.

Konfigurationsdatei repositorymanager-prod.yml

Die Konfigurationsdatei repositorymanager-prod.yml wird bei der Installation in das Verzeichnis \config von enaio® service-manager installiert. Die zwingend notwendigen Parameter werden in der Regel über die Oberflächen von enaio® repository-manager angegeben. Optionale Parameter können mit einem Texteditor in die Konfigurationsdatei eingetragen werden.

Eine Konfigurationsdatei mit allen Parametern steht zum Download zur Verfügung.

Parameter der Konfigurationsdatei:

Parameter Typ Beschreibung Beispiel-Wert
repository-manager.working-dir String Arbeitsverzeichnis ${enaio.data.path}\rm\working-dir
repository-manager.repositories.a-link String

Der Wert wird über die Konfigurationsoberfläche angegeben.

Kommaseparierte Liste der a-link Repositories.

Ein einzelner Eintrag besteht aus dem enaio®-Schranknamen, Pipe-Zeichen, SAP®-Repository-Name, Pipe-Zeichen.

 SAP_OSI_RT|RT|,SAP_OSD_D1|D1|,TestTT|TT|
repository-manager.repositories.ilm-link String

Der Wert wird über die Konfigurationsoberfläche angegeben.

Kommaseparierte Liste der ILM Collections.

Ein einzelner Eintrag besteht aus dem enaio®-Schranknamen, Pipe-Zeichen, ILM Collection-Name, Pipe-Zeichen.

 ILM Collection|ILM|
repository-manager.propagate-retention Boolean

true: Retentionszeiten werden den Dokumenten zugeordnet.

Default: false

 true
repository-manager.logger.path String

Pfad zum Verzeichnis für die Protokolle

 ${repository-manager.working-dir}\logs
repository-manager.logger.max-history Integer

Maximale Anzahl von Tagen für die Aufbewahrung von Protokollen.

 7
repository-manager.components.text String

Liste von Formaten für den Dokumenttyp für Text-Dokumente

 text/plain
repository-manager.components.scanned String

Liste von Formaten für den Dokumenttyp für den Dokumenttyp für gescannte Dokumente

 image/tiff
repository-manager.barcode.cntType2docType String

Liste von Einträgen für das Mapping des Barcode-Dokumenttyps, durch das Pipe-Zeichen separiert.

Einträge bestehen aus enaio®-Content-Typ, Gleichheitszeichen, SAP®-Dokumenttyp.

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

Standard SAP®-Dokumenttyp, falls für den enaio®-Content-Typ kein Barcode-Mapping vorliegt.

 TIF
repository-manager.admin.password String

Der Wert wird über die Konfigurationsoberfläche geändert.

Passwort für den administrativen Benutzer. Default: optimal

 $2a$10$a74KZCLNMiqlt5vq5dKPXORm70
enaio.dms.username String

Für den Zugriff auf den DMS service wird als Standard der technischen Benutzer aus der Datei application-blue.yml von enaio® service-manager verwendet.

Falls ein anderer technischer Benutzer verwendet werden soll, dann geben Sie diesen hier an.

sap

Standard: root

Der technische Benutzer benötigt die vollständigen Zugriffsrechte auf die Objekte.
enaio.dms.password String Passwort des Benutzers für die Anmeldung am DMS service, falls ein anderer technischer Benutzer als der Standard-Benutzer angeben wird. secret
repository‑manager.http‑calls.short‑calls.
connect-timeout		 Integer

Timeout in Sekunden für die Verbindung mit enaio® server

Default: 30

  
repository‑manager.http‑calls.short‑calls.
write-timeout		 Integer

Timeout in Sekunden für das Schreiben von Daten

Default: 120

  
repository‑manager.http‑calls.short‑calls.
read-timeout		 Integer

Timeout in Sekunden für das Lesen von Daten

Default: 60

  
repository‑manager.http‑calls.long‑calls.
connect-timeout		 Integer

Timeout in Sekunden für das Aufrufen der Objektdefiniton

Default: 180

  
repository‑manager.http‑calls.long‑calls.
read-timeout		 Integer

Timeout in Sekunden für das Lesen der Objektdefiniton

Default: 3600

  
repository-manager.set-archivable Boolean Dokumente in enaio® erhalten die Eigenschaft 'zur Archivierung freigegeben'. Default: false true/false
management.trusted.ipPattern String

Der Zugriff auf Services und auf Management-Endpunkte kann über IP-Filter gesichert werden.

Eine Konfiguration für den enaio® repository-manager hat Vorrang vor der entsprechenden Konfiguration für die Services.

Die Standardeinstellung erlaubt Zugriff von allen IP-Adressen:

management.trusted.ipPattern: .*

(127\.0\.0\.1)|(10\.10\.7\.139)|(10\.10\.4\.*)

Falls für den Service 'dms' SSL aktiviert ist, dann muss die Konfigurationsdatei repositorymanager-prod.yml um folgenden Eintrag erweitert werden:

enaio.host: <hostname/IP-address>

hostname/IP-address: Abhängig vom Zertifikat wird der Hostname (FQDN) oder die IP-Adresse angegeben.

Verschlüsselung von Konfigurationswerten

Die Konfigurationswerte der Datei repositorymanager-prod.yml aus dem Verzeichnis \config\ von enaio® service-manager können verschlüsselt werden:

  • Öffnen Sie die Eingabeaufforderung als Administrator und wechseln Sie in das Verzeichnis \service-manager\tools\encryption\.

  • Führen Sie folgenden Befehl aus: encode.bat "value" -W

    Der verschlüsselte Wert wird mit führendem 'ENC' und in runden Klammern angezeigt: ENC(encryptedvalue)

  • Kopieren Sie den verschlüsselten Wert mit führendem 'ENC' und mit den runden Klammern und tragen Sie diesen in die Konfigurationsdatei ein.

  • Speichern Sie die Konfigurationsdatei und starten Sie den Service gegebenenfalls neu.

Verbindungen über enaio® gateway

Die Kommunikation zwischen enaio® und enaio® repository-manager kann abgesichert über enaio® gateway erfolgen:

Verbindung direkte Verbindung enaio® gateway-Verbindung
ArchiveLink <repository-manager-IP>:8100/cs/contentserver <gateway-IP>:80/repositorymanager/cs/contentserver
ILM <repository-manager-IP>:8100/cs/ilm <gateway-IP>:80/repositorymanager/cs/ilm
GUI <repository-manager-IP>:8100 <gateway-IP>:80/repositorymanager
KGS-GUI <repository-manager-IP>:8100/cs/  

KGS-GUI - Verbindung über enaio® gateway

Folgende Anpassungen an der Konfigurationsdatei …\os_gateway\config\application-prod.yml von enaio® gateway sind für diese Verbindung notwendig:

  • proxy.services.endpoints.endpoint

    proxy:
      services:
        endpoints:
          - endpoint:
              name: cs
              url: http://localhost:8010/cs

    Passen Sie gegebenenfalls die URL an: Adresse und Port von enaio® repository-manager.

  • ossecurity.exposedEndpoints

    ossecurity:
      exposedEndpoints: '/osweb/**,/cs/**'

  • ossecurity.unauthenticated.routes

    ossecurity:
      unauthenticated:
        routes: '/cs,/repositorymanager'