Businessserver

An dieser Stelle können Sie Einstellungen für den esBusinessserver-Dienst vornehmen, den Businesserver-Dienst starten / stoppen und den Status der Module einsehen.

Bereich 'Dienst'

Status

Zeigt den aktuellen Zustand des Dienstes an

Abhängige Dienste

Zeigt an welche Dienste von diesem Dienst abhängig sind

Abhängig von

Gibt an von welchen Diensten der Start des Businessserver-Dienstes abhängig ist.

Hier wird als abhängige Dienste der Dienst Druckerwarteschlange und der Dienst Netzwerkverbindungen empfohlen.

Ist die SQL-Datenbank auf dem gleichen Server installiert, kann auch der Datenbankdienst (MSSQL Server) angegeben werden.

Startart

Hier sollte immer Automatisch angegeben sein, der Dienst wird dann beim Start des Betriebssystems mit gestartet.

Bereich 'Client-Einstellungen'

Servername

Hier wird der Servername angegeben über den der esBusinessserver im Netz erreichbar sein soll.

Port

Hier wird der Port angegeben, über den der Businessserver kommuniziert.

Standardports:

Webservice: 12164

Ereignisse: 12165

SSL Konfiguration

Für die Kommunikation mit dem Webservice des esBusinessserver-Dienstes ist SSL-Zertifikat erforderlich. Über die Schaltfläche SSL Konfiguration kann ein bereits vorhandenes Zertifikat ausgewählt oder ein selbstsigniertes Zertifikat erstellt werden.

Selbstsigniertes Zertifikat erstellen

Sofern kein anderes Zertifikat zur Verfügung steht, kann über diese Schaltfläche ein Eigenzertifikat (self-signed) erstellt werden

Zertifikat an Port binden

Über die Schaltfläche Zertifikat an Port binden wird das ausgewählte Zertifikat für die Kommunikation mit dem Webservice an den Port gebunden. Damit wird eine gesicherte Kommunikation sichergestellt.

Übersicht über alle SSL Ports

Um die Portbindung aufzuheben, klicken Sie auf die Schaltfläche Übersicht über alle SSL Ports. Wählen Sie im Bereich Netzwerkadressen den Port aus und klicken anschließend auf die Schaltfläche Zertifikatsbindung entfernen.

Bereich 'Fehlerbenachrichtigungen'

Es besteht die Möglichkeit Fehlerbenachrichtigungen per E-Mail zu versenden. Tragen Sie dazu die entsprechende E-Mail-Adresse und eine eserp-Personalnummer (für den Absender) ein.

Bereich 'Module'

In diesem Bereich können Sie den Status der einzelnen Module erkennen, die für den esBusinessserver-Dienst konfiguriert wurden.

Über die Schaltfläche Konfigurieren können Sie jeweils für die Module E-Mail-Versand, SMS-Versand und Fax-Versand die jeweiligen Einstellungen aufrufen.

Anzeige des Modul-Status

Nach einer Änderung der Konfiguration und anschließendem Neustart des esBusinessserver-Dienstes kann es je nach Modul einige Zeit in Anspruch nehmen bis der Status auf Aktiv steht. Sie können mit der Schaltfläche Status aktualisieren den Status erneut abfragen.

Bereich 'Businessserver Logdatei'

Aktiviert

Die Option gibt an, ob das Ereignisprotokoll des Dienstes grundsätzlich aktiv ist (Aktiviert = Log-Datei wird erstellt).

Bei aktivierter Option werden fortlaufend die Ereignisse im Betrieb des Businessservers protokolliert und in einer Datei gespeichert. Im Fehlerfall kann diese Protokolldatei (Log-File) zur Fehleranalyse verwendet werden.

Die Log Datei hat den Dateinamen esbusinessserver.log.

Siehe auch Logdateien auswerten

Pfad

In dem hier angegebenen Ordner werden die Protokolldateien (Logfiles) erstellt. Über die Schaltfläche Auswählen können Sie den Dateiauswahl Dialog zum festlegen eines Speicherpfades festlegen.

Log erweitern

Wird diese Option aktiviert, werden weitere ausführliche Informationen protokolliert und in der Protokolldatei (Logdatei) gespeichert. Die Datei hat den Dateinamen ESBusinessserverDebug.xml.

Log-Level

Über den Log-Level wird festgelegt, wie detailliert Informationen zum Programmablauf / zu den Datenbankabfragen aufgezeichnet werden.

Jedes Log-Level schließt die darunterliegenden Level ein. D.h. das Level INFO gibt auch zusätzlich alles aus, was beim LOG-Level WARN ausgegeben wird.

DMS Funktionen

Dateihash Generierung

Bei einem Update auf die eserp Version 1.50 ist es einmalig erforderlich für alle Dokumente im Dokumentenmanagement (DMS) einen Dateihash zu erzeugen. Über diesen Dateihash erhält jede Datei im DMS eine eindeutige ID, die es dem Businesserver ermöglicht die Dateien zu unterscheiden.

Starten

Über die Schaltfläche Starten kann die Dateihashgenerierung begonnen werden. Da der Vorgang längere Zeit in Anspruch nehmen kann, ist eine gesonderte Bestätigung erforderlich.

Im nächsten Schritt können Sie angeben, ob Sie eine Datei (Textdatei im CSV-Format) vorliegen haben. Über die Schaltfläche Ja gelangen Sie zur Dateiauswahl der entsprechenden CSV-Datei.

Mit der Auswahl Nein wird die Dateihash Generierung ohne Datei gestartet.

Dateihash Generierung über ein Skript

Über ein Skript kann auf dem Server, auf dem die Dateien des DMS abgelegt sind, die Dateihash-Generierung durchgeführt werden. Das Ergebnis der Skriptausführung wird in einer CSV-Datei gespeichert, die im Businessserver eingelesen werden kann.

Das Skript steht wird Windows (Powershellskript) und Linux (Bash) zur Verfügung.

Windows-Skript (Powershell)

function GetHashes{
    param(
        $FilePath
    )

    $sha = Get-FileHash $FilePath -Algorithm SHA256 | Select-Object -First 1 -ExpandProperty Hash
    $md5 = Get-FileHash $FilePath -Algorithm MD5 | Select-Object -First 1 -ExpandProperty Hash
    
    $hash = New-Object -TypeName psobject
    $hash | Add-Member -MemberType NoteProperty -Name Path -Value $FilePath
    $hash | Add-Member -MemberType NoteProperty -Name SHA256 -Value $sha
    $hash | Add-Member -MemberType NoteProperty -Name MD5 -Value $md5 
    $hash | Export-Csv -Path 'D:\hashes.csv' -Append -Delimiter ';' -NoTypeInformation
}

$files = Get-ChildItem -Path 'D:\testfiles' -Recurse -File | Select-Object -ExpandProperty FullName

foreach($file in $files)
{
    Write-Output "hashing $file"
    GetHashes($file)
}

Erforderliche Anpassung

Passen Sie das Powershellskript an den markierten Stellen an Ihre DMS-Umgebung an.

Linux Skript (Bash)

#/bin/sh

searchPath=$1
resultFile="hashes.csv"

echo -n > $resultFile

find "${searchPath}" -type f -print0 | while read -d $'\0' file
do
    echo "hashing ${file}"
    absolutePath=`realpath "${file}"`
    sha=($(sha256sum "${file}"))
    md5=($(md5sum "${file}"))
    echo "${absolutePath};${sha};${md5}" >> $resultFile
done

Erforderliche Anpassung

searchPath = DMS-Pfad (Verzeichnis mit den DMS-Dateien)

resultFile = CSV-Datei (Name der Ausgabedatei)

Businessserver-Dienst - Steuerung / Installation

Installieren

Abhängig vom Status des Dienstes kann dieser gestartet, gestoppt, installiert oder deinstalliert werden. Beim Installieren eines Dienstes erscheint eine Abfrage, ob der Dienst unter einem anderen Konto als dem lokalen Systemkonto installiert werden soll.

Ist das nicht der Fall, so fahren Sie durch Klicken auf OK einfach fort.

Andernfalls füllen Sie die beiden Eingabefelder aus und klicken anschließend auf OK.

Das hier eingetragene Konto (Benutzer) benötigt Berechtigungen für den Zugriff auf das Dokumentenmanagement im eserp.

Siehe auch Voraussetzungen esBusinessserver (Dienst-Benutzer).

Den Pfad für das Dokumentenmanagement wird unter Dokumentenmanagement festgelegt. Die Berechtigungen für diesen Pfad werden über das Windows-Betriebssystem vergeben.

Dienst Benutzer

Windows-Benutzer mit Berechtigung Als Dienst ausführen und Netzwerkanmeldung.

Siehe auch Systemvoraussetzungen

Deinstallieren

Um den Businessserverdienst zu verändern (Anmeldedaten etc.) kann es notwendig sein, den Dienst zu deinstallieren und anschließend mit neuen Einstellungen wieder zu installieren.