CLARC MIGRATION SERVER Konfiguration

Grundeinstellungen

Mit einem Doppelklick auf den C4 Konfigurationsknoten /clarc/Software/clarc migration server/Basics wird der Dialog zur Konfiguration der Grundeinstellungen geöffnet.

Der Dialog kann ebenfalls über den entsprechenden Schnellzugriffs-Button (Konfiguration), Enter oder das Kontext-Menü geöffnet werden.

/clarc/Software/clarc migration server/Basics
ParameterBeschreibung

Basics

Log levelDer vom Server zu verwendende Log-Level.
Create log fileLogdatei erzeugen - ja/nein.

Security

Allow external requestsErlaubt HTTP Anfragen welche nicht vom lokalen System kommen. Wichtig z.B. für das API Szenario.
Use trusted ip listEs werden nur HTTP Anfragen von Systemen akzeptiert, welche in der Liste der vertrauenswürdigen IP-Adressen aufgeführt sind.
Trusted ip listListe der vertrauenswürdigen IP-Adressen. Siehe "Use trusted IP list". Die Adressen werden mit "," getrennt aufgeführt.


Agenten

Mit den Agenten werden verschiedene Migrations-Typen konfiguriert, die ab einem spezifizierten Zeitpunkt periodisch in einem Intervall ausgeführt werden. Jeder Agent kann dabei unterschiedliche Jobs durchführen. Aktuell ist es nur möglich, SAP ArchiveLink Migrationen durchzuführen.

ParameterBeschreibung

Agent

Agent nameFrei zu vergebender Name des Agenten
Agent descriptionBeschreibung des Agenten
Agent type

Aktuell unterstützte Agenten sind

  • SAP ArchiveLink migration
Agent is activeAgent ist aktiv (ja/nein)
Start date/timeDatum und Uhrzeit an der der Agent zum aktiv werden soll
IntervalIntervall in welchem der Agent periodisch ausgeführt werden soll. Es kann eine beliebige Angabe in Minuten erfolgen (Eingabe: "XX mins" - z.b. "13 mins") oder eine vorgegebene Auswahl getroffen werden.

MongoDB

Einstellungen für die Verbindung zur MongoDB (Agent "SAP ArchiveLink migration")
Hostname/IPHostname oder IP zur MongoDB
PortPort zur MongoDB
Replica set nameName des replica sets (wenn aufgesetzt)
Database set nameDatenbankname
Collection nameName der Collection in der MongoDB
UsernameUsername für MongoDB
PasswordPasswort des Users für MongoDB
Authentication DBDatenbankname für die Authentifizierung zur MongoDB
Transport layer security (TLS)TLS benutzen ja/nein
Collation localeStandard Spracheinstellungen bei text suche (Standard: en)

SAP Migration

SAP spezifische Einstellungen (Agent "SAP ArchiveLink migration")
SAP systemAuswahl der im C4 konfigurierten SAP Systeme
SAP repositoryName des SAP repositories
SAP TOA table namesKommaseparierte Liste der verwendeten TOA Tabellen aus SAP. Soll ein Datenarchiv von SAP migriert werden, kann hier auch statt den TOA-Tabellen die zugehörige Tabelle "ADMI_FILES" angegeben werden.
SAP TOA start dateAb welchem Datum sollen Informationen zu Dokumenten aus der TOA Tabelle geholt werden
SAP TOA end dateBis zu welchem Datum sollen Informationen zu Dokumenten aus der TOA Tabelle geholt werden (optional). Wir der Haken bei bei der Checkbox "Set end date" nicht gesetzt, wird periodisch beim Start des Agenten nach neuen TOA/ADMI_FILES Einträgen gesucht und neue Einträge werden migriert.
Retrieving rangeIntervall (in Tagen) um TOA/ADMI_FILES Einträge zu lesen. Es ist wichtig vorher zu ermitteln, wie viele Einträge in einer solchen Range zu erwarten sind. Die Anzahl der Einträge sollte 100.000 nicht übersteigen. 


Jobs

Jobs können zu jedem Agenten angelegt werden. Dabei können Jobs unterschiedliche Konfigurationen für einen Typ von Agenten haben.

ParameterBeschreibung

SAP ArchiveLink migration job

Job nameFrei zu vergebender Name des Jobs
Job descriptionBeschreibung des Jobs
Job is activeJob ist aktiv (ja/nein)
Source repo nameRepository Name des Fremdarchivs
Target repositoryRepository im SAP Knoten des CLARC CONTENT SERVER
CertificateAuswahl eines erzeugten Zertifikats für den Zugriff auf das ArchiveLink Archiv. Ein Zertifikat (PKCS#7)  kann mit dem Knopf auf der rechten Seite erzeugt werden. Dort muss ein Passwort und ein Hash Algorithmus gewählt werden. Ebenfalls müssen Angaben des Ausstellers erfasst werden, damit eine Aussteller ID (Authentication ID) erzeugt werden kann. Für eine Beschreibung der Felder siehe https://de.wikipedia.org/wiki/X.509
Certificate passwordDas beim Erzeugen des Zertifikats gewählte Passwort
Certificate Auth IDDie beim Erzeugen des Zertifikats generierte Authentication ID. Eventuell vorhandene Leerzeichen dürfen dabei nicht manuell gelöscht werden.
Base URL to AL repoDie URL zum ArchiveLink Archiv
ArchiveLink versionVersion der ArchiveLink Schnittstelle (in der Regel 0045, 0046 oder 0047)
SAP business objectGeschäftsobjekt aus SAP
SAP document typeName des Dokumenttyps in SAP (* für alle Typen)
Migration report folderVerzeichnis in welchem ein Report der Migration abgelegt wird.
Test connectionPrüft die Verbindung zum ArchiveLink System
Get server infoHolt Informationen des ArchiveLink Servers
Send public certificateSendet das erzeugte Zertifikat zum ArchiveLink Server. Dort muss das Zertifikat dann aktiviert werden, damit Daten gelesen werden können

Maintanance

Reset status and migrateWir die Checkbox aktiviert, kann man zwischen "All entries" und "Failed entries". Während bei "Failed entries" versucht wird nur die fehlgeschlagenen Einträge neu zu migrieren, würden bei "All entries" alle Einträge neu migriert. Bereits migrierte Einträge werden dabei nicht überschrieben, sondern übersprungen. Möchte man das Archiv also nochmals komplett neu migrieren, ist darauf zu achten, dass im Ziel-Repository sowohl alle MongoDB Einträge (falls benutzt), als auch alle Dateien auf dem Storage manuell entfernt werden.