3. Installation und Konfiguration STP Documents OnPremiseAgent

In diesem Kapitel erfahren Sie, wie Sie den STP.Documents.OnPremiseAgent installieren und konfigurieren. Gehen Sie dazu wie folgt vor. Wenn Sie den STP.Documents.OnPremiseAgent bereits installiert haben und beispielsweise den Mobile DESK nutzen, prüfen Sie bitte die für die Verfahrensanlage Plus (Deutsche Bank Integration) notwendigen Konfigurationen.

Anlegen der STP Documents Datenbank

1. Für den STP.Documents.OnPremiseAgent benötigen Sie eine Datenbank, die Sie zunächst anlegen müssen.

   

2. Zudem benötigen Sie einen Datenbankbenutzer mit “db_owner”-Berechtigung für die neu angelegte Datenbank.

   

   

Erstellen des technischen Agent Benutzers für den STP Documents OnPremiseAgent

1. Legen Sie in der Zentralen Benutzeradministration einen neuen Benutzer an. Dieser benötigt mindestens folgende Eigenschaften:

   • Loginnamen
   • Passwort
   • E-Mail-Adresse
   • Kürzel

   Zudem muss der Benutzer die folgenden Gruppen zugewiesen bekommen:

   • ClientProxies
   • Alle WZ(main)
   • Alle DMS(main)
   • CloudAccess-TenantName

   

2. Konfiguration des technischen Agent Benutzers im User Management der STP-Cloud:

   Navigieren Sie in der STP-Cloud über User-Management zu Benutzer und klicken Sie bei dem nun ebenfalls in der Cloud vorhandenen, neu angelegten Benutzer auf Bearbeiten.

   Vergeben Sie ein Passwort für den Benutzer. Es wird empfohlen, das selbe Passwort zu verwenden wie zuvor bei der Anlage in der Zentralen Benutzeradministration.

   Fügen Sie die Gruppe Documents.Agents hinzu und klicken Sie auf Speichern.

   

DMS System ID

Zur Installation des STP.Documents.OnPremise Agent benötigen Sie die “DMS System ID”. Diese können Sie über den LEXolution.DMS Client App Service oder über die LEXolution Datenbank ermitteln.

1. LEXolution.DMS Client App Service

   Klicken Sie mit der rechten Maustaste auf das Tray Icon des LEXolution.DMS Client App Service und klicken Sie danach auf LCAS Status …. In dem sich öffnenden Fenster wird Ihnen die System.Id angezeigt.

   

2. Sie können die “DMS System ID” auch über folgende Datenbankabfrage auf die LEXolution Datenbank ermitteln.

       SELECT ID FROM tblDatabaseId 

Ausführen des STP Documents OnPremiseAgent Installers

1. Starten Sie die Installation des STP.Documents.OnPremiseAgent und bestätigen Sie den Dialog mit weiter.

   

2. Konfigurieren Sie die Umgebung.

   

   Konfigurationswert	Beschreibung
   Umgebung	Wählen Sie prod-de.
   Tenant name	Tragen Sie hier die Subdomain Ihres Tenants ein.
   DMS system id	Tragen Sie hier die zuvor ermittelte “DMS System ID” ein.
   Agentenname	Tragen Sie hier den Benutzernamen des zuvor angelegten technischen Agent Benutzers ein.

3. Konfigurieren Sie den LEXolution Service Bus / Zentrale Benutzerverwaltung

   

   Konfigurationswert	Beschreibung
   Hostname (LSB)	Der Servername auf dem der LSB betrieben wird,zumeist der Applikations Server.
   Port (LSB)	Port für den LSB, Default: 5672
   Benutzername (LSB)	Benutzername für den LSB, Default: stpuser
   Passwort (LSB)	Passwort für den LSB, Default: stp.
   Benutzername (Zentale Benutzerverwaltung)	Tragen Sie hier den Benutzernamen des zuvor angelegten technischen Agent Benutzers ein.
   Passwort (Zentrale Benutzerverwaltung)	Tragen Sie hier das Passwort des zuvor angelegten technischen Agent Benutzers ein.

4. Konfigurieren Sie den STP-Cloud Authentifizierung

   

   Konfigurationswert	Beschreibung
   Authentifizierungsanbieter	Wählen Sie HTTP.
   Benutzername (in E-Mail-Form)	Tragen Sie hier die E-Mail-Adresse des zuvor angelegten technischen Agent Benutzers ein.
   Passwort	Tragen Sie hier das Passwort des zuvor angelegten technischen Agent Benutzers ein.

5. Konfigurieren der Datenbankverbindung

   

   Konfigurationswert	Beschreibung
   Name des Datenbankservers	Datenbankserver und ggf. Instanz auf dem die Datenbank für den STP.Documents.OnPremiseAgent angelegt wurde.
   Name der Datenbank	Name der Datenbank für den STP.Documents.OnPremiseAgent.
   Datenbank-Benutzername	Benutzername des für die Datenbank eingerichteten Benutzers.
   Datenbankbenutzerpasswort	Passwort des Datenbankbenutzers.

6. Bestätigen Sie den folgenden Dialoge mit “Installieren” und “Fertigstellen”.

   

   

Kontrolle der Installation des Dienstes über das Web-Interface

Nach erflogreicher Installation lässt sich der Status des STP.Documents.OnPremiseAgent leicht über das Web-Interface prüfen. Rufen Sie hierzu folgenden Link auf http://localhost:8090/. Sie können nun den Status zur Verbindung mit LEXolution.DMS und der STP Cloud sehen.

Erweiterte Anpassung der STP.Documents.OnPremiseAgent appsettings.json

Für die Verwendung von Verfahrensanlage Plus (Deutsche Bank Integration) müssen erweiterte Anpassungen am STP.Documents.OnPremiseAgent vorgenommen werden. Öffnen Sie hierzu die appsettings.json im Installationsverzeichnis.

Folgende Werte müssen angepasst oder im Falle eines zuvor bereits in einer niedrigeren Version installierten STP.Documents.OnPremiseAgent hinzugefügt werden:

Eine Beispiel für die appsettings.json könnte somit wie folgt aussehen:

{
  "Urls": "http://localhost:8090",
  "Serilog": {
    "Using": [
      "Serilog.Sinks.Console",
      "Serilog.Sinks.File"
    ],
    "MinimumLevel": {
      "Default": "Information",
      "Override": {
        "System": "Warning",
        "Microsoft": "Warning"
      }
    },
    "WriteTo": [
      {
        "Name": "Console",
        "Args": {
          "theme": "Serilog.Sinks.SystemConsole.Themes.AnsiConsoleTheme::Code, Serilog.Sinks.Console",
          "outputTemplate": "[{Timestamp:HH:mm:ss} {Level:u3}] {ThreadId} {EnvironmentUserName} {Message:lj} <s:{SourceContext}>{NewLine}{Exception}"
        }
      },
      {
        "Name": "File",
        "Args": {
          "path": "%PROGRAMDATA%\\STP AG\\STP Documents OnPremise Agent\\Logs\\log.txt",
          "rollingInterval": "Day",
          "fileSizeLimitBytes": 26214400,
          "rollOnFileSizeLimit": true
        }
      }
    ],
    "Enrich": [
      "FromLogContext",
      "WithMachineName",
      "WithThreadId",
      "WithEnvironmentUserName"
    ]
  },
  "Auth": {
    "Authority": "https://<TenantName>.stp-cloud.de/identity/",
    "Issuers": [
      "https://stp.stp-cloud.de/identity/",
      "https://<TenantName>.stp-cloud.de/identity/"
    ],
    "TenantNamePattern": "(?<tenant>.*?)\\.stp-cloud\\.de",
    "ClientId": "documents.agent.ui"
  },
  "ConnectionStrings": {
    "AgentDb": "Server=<DB-Server>;Database=<Database>;User=<User>;Password=<Passwort>;TrustServerCertificate=True"
  },
  "SignalRSettings": {
    "DocumentsRelayUrl": "https://<TenantName>.stp-cloud.de/documents/"
  },
  "AccessCredentials": {
    "TenantName": "<TenantName>",
    "ClientId": "documents.agent",
    "Provider": "HTTP",
    "Username": "<E-Mail des technischen Agent Benutzers>",
    "Password": "<Passwort>"
  },
  "DmsConfiguration": {
    "RabbitMqHostname": "<Server>",
    "RabbitMqPort": "5672",
    "RabbitMqUsername": "stpuser",
    "RabbitMqPassword": "stp.",
    "UmServerUser": "<technischer Agent Benutzer>",
    "UmPasword": "<Passwort>",
    "SystemId": "<DMS System ID>"
  },
  "DmsDurableEvents": true,
  "AgentName": "<technischer Agent Benutzer>",
  "MaxDevicesPerUser": "5",
  "NewDevicesEnabledByDefault": "true",
  "OnlyLocalDeviceManagement": "false",
  "AuditTrail": "false",
  "Cloudless": "false",
  "PermittedExtensions": "jpg, jpeg, png, bmp, gif, txt, pdf, doc, docx, dot, dotx, ppt, pptx, xls, xlsx, zip, msg, beamsg, xml",
  "ConnectWz": true,
  "HandleCloudRequestsAsynchronously": false,
  "AllowUserlessRequests": true,
  "EventsRelay": {
    "NewDocumentEvent": false,
    "NewDocumentVersionEvent": false,
    "DocumentMetadataChangedEvent": false,
    "DocumentDeletedEvent": false,
    "ContainerIdsOnly": false
  }
}

Speichern Sie die Datei ab und starten Sie den Dienst neu. Nach wenigen Minuten können Sie nun im Web-Interface zusätzlich den Status zum “STP Server 8005” (Winsolvenz Server) sehen.

Eine ausführliche Dokumentation zur Installation finden Sie hier und Informationen zur erweiterten Konfiguration hier.

Fahren Sie bitte mit dem folgenden Artikel fort: Installation und Konfiguration STP Winsolvenz OnPremise Connector