Installationspakete

Installationspakete werden von Sevitec in Form von 7-zip Archiven zur Verfügung gestellt. Folgende Pakete werden benötigt:

  • ocx-alertingservice.7z

Das benötigte Installationspaket auf den Server ins Verzeichnis <Laufwerk>:\OneConnexx\Install kopieren.

Den Inhalt des Installationspakets nach <Laufwerk>:\OneConnexx\AlertingService entpacken.

Bei der Erstinstallation die Datei OneConnexx.AlertingService.exe.config.sevitec in OneConnexx.AlertingService.exe.config umbenennen.

Dadurch wird folgende Verzeichnisstruktur erstellt:

\OneConnexx
 |-AlertingService

Service installieren

Der Alerting Windows-Dienst wird über die Eingabeaufforderung (Windows Konsole) installiert. Die Eingabeaufforderung muss als Administrator geöffnet werden.

Ins «AlertingService» Unterverzeichnis wechseln und den Service installieren:

cd \OneConnexx\AlertingService
OneConnexx.AlertingService.exe –install –servicename=OneConnexx.Alerting

Zum Deinstallieren:

OneConnexx.AlertingService.exe –uninstall –servicename=OneConnexx.Alerting

In einem Unternehmensnetzwerk wird empfohlen, für den Alerting-Service einen eigenen Benutzer anzulegen unter dem der Service installiert wird. Um den Service unter diesem Benutzer auszuführen muss folgendermassen vorgegangen werden:

sc config OneConnexx.Alerting obj= "<Benutzername>" password= "<Passwort>"
  • OneConnexx.Alerting durch den Namen ersetzen unter dem der Service installiert wurde
  • <Benutzername> muss bei einem Domänenbenutzer in der Form Domäne\Benutzername geschrieben werden, bei einem lokalen Benutzer in der Form .\Benutzername
  • Wichtig ist der Abstand nach obj= bzw. password=

Wichtig: Der Domänenbenutzer muss Modify- und Write-Rechte auf das logs Unterverzeichnis haben.

Konfiguration

OneConnexx.AlertingService.exe.config

In der Konfigurationsdatei <Laufwerk>:\OneConnexx\AlertingService\OneConnexx.AlertingService.exe.config sind folgende Parameter zu konfigurieren:

  • connectionStrings: Der Connection-String zur Datenbank. Wenn der AlertingService Windows-Dienst unter einem Domänenbenutzer läuft, sollte «Integrated Security» gewählt werden. Wenn der AlertingService mehrere Datenbanken überwachen soll, können mehrere Connection-Strings angegeben werden.
  • nlog: Konfiguration der Protokollierung des Alerting-Service. Standardmässig wird in eine Datei oneconnexx.alerting.log im Unterverzeichnis logs protokolliert.
  • MailSenderDefaultTimeout: Interval in Millisekunden in dem Mails versendet werden (Standard: 30000, alle 30 Sekunden).
  • RuleCheckerDefaultTimeout: Interval in Millisekunden in dem Regelverletzungen geprüft werden (Standard: 60000, jede Minute).
  • MailSenderDefaultFrom: Absenderadresse der versendeten E-Mails.
  • MailSenderClientServer: IP Adresse oder Hostname des Mailserver für ausgehende E-Mails.
  • MailSenderClientPort: Port des Mailservers (Standard: 25).
  • MailSenderClientTimeout: Timeout in Millisekunden für das Versenden von E-Mails.
  • MailSenderClientSsl: True = SSL verwenden, False = kein SSL (Standard: False).
  • MailSenderClientUserName: Optional der Benutzername für den Mailserver.
  • MailSenderClientUserPassword: Optional ein Passwort für den Mailserver.