Anbindung einer externen MS SQL Server Datenbank für die Nutzung des Organigramm- und MS-Teams-Datenexplorers

 

Verfügbar ab…

Die hier beschriebene Anbindung an einen MS SQL Datenbankserver für die Nutzung des Organigramm-Datenexplorers ist ab der UC-Analytics Version 13.0.1 freigegeben.

Die Nutzung des MS-Teams-Datenexplorers ist ab der UC-Analytics Version 13.5.x freigegeben.

Voraussetzungen für die Anbindung einer externen MS SQL Datenbank

  • Installierte UC-Analytics / AlwinPro Version 13.0.1 oder neuer

  • Superuser Zugang zur aurenz Software

  • MS SQL Server ab Version 2019

  • Ein ausreichendes Zeitfenster. Während der Aktivierung und der Datenmigration ist der UC-Analytics Dienst evtl. für längere Zeit nicht verfügbar.

Für die Aktivierung des Organigramm-Datenexplorers muss entweder kundenseitig ein Microsoft SQL Server bereitgestellt werden oder es muss ein Microsoft SQL Express Server installiert werden.
Ab der Version 13.5.x kann im Rahmen der Installation der aurenz UC-Analytics optional ein MS SQL Server Express inkl. der Datenbankinstanz ”UCANALYTICS” automatisch mit-installiert werden

Automatische Installation MS SQL Server Express im Rahmen einer Neuinstallation (Ab Version 13.5.x)

Im Rahmen der Standard-Setup-Routine der aurenz UC-Analytics kann optional ein MS SQL Server Express inkl. der Datenbankinstanz ”UCANALYTICS” automatisch mitinstalliert werden.

Wichtig ist ein Online-Zugriff des Systems wie auch das Starten des Setups als Administrator.

Die folgende Abfrage erhalten Sie am Ende der aurenz-Installation:

Bei Installation läd das setup eine aktuelle Version des MS SQL-Server Express direkt von Microsoft herunter und installiert diese mit allen relevanten Einstellungen.

Alternativ kann der SQL Server nachinstalliert werden. Starten Sie dazu die Admin-Oberfläche “als Administrator”, melden sich als administrativer Benutzer (z. B. superuser) an:

Datei → Programm einrichten → Grundeinstellungen

und aktivieren Sie die “Erweiterten Einstellungen anzeigen”, aktivieren Sie “Externe SQL Datenbank verwenden” und starten Sie die Installation mit einem klick auf den Button.

Daten die bereits von einer PBX in die aurenz Standard-Datenbank eingelesen wurden, können nachträglich in die SQL DB kopiert werden.

Soll der MS SQL Server manuell installiert werden, folgen Sie dieser Anleitung:

Vorbereitung MS SQL Server

Installation des Microsoft SQL Express Server ausschließlich für die UC-Analytics

Dieser Schritt ist nur notwendig, wenn von Seite des Kunden kein SQL Server bereitgestellt wird. Ist bereits ein SQL Server vorhanden, dann weiterlesen im Kapitel UC-Analytics Datenbank anlegen auf kundeneigenem Microsoft SQL Server.

  1. Download des Microsoft SQL Express Servers z.B. hier:
    Download Microsoft® SQL Server® 2019 Express from Official Microsoft Download Center (https://www.microsoft.com/de-DE/download/details.aspx?id=101064)

  2. Entpacken des heruntergeladenen Archivs und Start des Setups
    ACHTUNG: die Installation des SQL Server sollte auf demselben Rechner erfolgen, auf dem auch die UC-Analytics installiert ist. Grundsätzlich ist auch eine Installation auf einem anderen Rechner möglich, allerdings muss dann der Zugang über TCP aktiviert werden, was im Standard nicht der Fall ist.

Im SQL Server-Installationscenter sind folgende Einstellungen zu wählen:

  1. Neue Eigenständige SQL Server-Installation oder Hinzufügen von Funktionen zu einer vorhandenen Installation

  2. Installationsregeln
    Hier sind keine Einstellungen notwendig, so lange keine Fehler oder Warnungen angezeigt werden.

  3. Funktionsauswahl
    Hier kann das Verzeichnis gewählt werden, in welchem der SQL Server installiert werden soll. Dies darf nicht das UC-Analytics Verzeichnis sein, da es sonst im Falle einer Deinstallation zu Problemen kommt.

  4. Instanzkonfiguration
    Hier muss Benannte Instanz gewählt werden und es muss eine Instanz-ID festgelegt werden

  5. Serverkonfiguration
    Die Einstellungen können hier übernommen werden. 
    SQL Server-Datenbankmodul, automatischer Start
    SQL Server-Browser, deaktiviert

  6. Datenbank-Engine-Konfiguration
    Hier ist unbedingt Gemischter Modus auszuwählen. Ebenso muss ein Kennwort festgelegt werden

UC-Analytics Datenbank anlegen auf bestehendem/kundeneigenem Microsoft SQL Server

Dieser Schritt ist nur notwendig, wenn ein kundenseitiger SQL Server verwendet wird. Bei Installation eines neuen SQL Express Servers kann dieses Kapitel übersprungen werden.

Voraussetzungen

Voraussetzung, dass eine Nutzung eines Kunden SQL Servers möglich ist, dass bei dem Kundenserver die Gemischte Authentifizierung mit Benutzername und Passwort aktiviert ist. Ein Anmeldung mittels Windows Nutzer ist durch UC-Analytics nicht möglich.

Bei Verwendung eines Kundeneigenen SQL Servers kann ein Backup mit AlwinBackup zwar erstellt aber nicht zurückgespielt werden. Das zurückspielen eines Backups muss in diesem Fall manuell durch einen Datenbank Administrator des Kunden gemacht werden.

Datenbank anlegen

Für das Anlegen einer neuen Datenbank ist eine Anmeldung mit dem Microsoft SQL Server Management Studio notwendig. Dort wird dann unter Datenbanken über das Kontext Menü eine neue Datenbank angelegt.

Im nächsten Schritt wird ein Datenbankname festgelegt. In diesem Beispiel nennen wir die Datenbank AlwinPro, es ist aber auch jeder andere Name möglich.

SQL Benutzer anlegen

Über den Menüpunkt Sicherheit > Anmeldungen > Neue Anmeldung wird ein neuer Benutzer angelegt.

Im nachfolgenden Dialog werden dann Benutzername und Passwort festgelegt.

Die Punkte Ablauf des Kennworts erzwingen und Benutzer muss das Kennwort bei den nächsten Anmeldung ändern sollten nicht verwendet werden, da die UC-Analytics nicht in der Lage ist das SQL Kennwort während des Betriebs zu ändern.

Im jetzt folgenden Schritt müssen der neu erzeugten Anmeldung noch Rechte für die Datenbank zugeordnet werden. Dies erfolgt indem man unter Datenbanken > (AlwinPro-Datenbank) > Sicherheit > Benutzer einen neuen Benutzer anlegt und dort die Daten der Anmeldung auswählt.

Die Anmeldung hat mehrere Seiten.

Seite Allgemein

Hier ist der Anmeldename einzutragen, der weiter oben gewählt ist und unter Standardschema ist der dbo einzutragen.

Jetzt muss noch auf die Seite Mitgliedschaft gewechselt werden und dort die Mitgliedschaft bei db_owner ausgewählt werden.

Die Einrichtung des Benutzers wird jetzt mit OK beendet.

Anbindung des MS SQL Servers und Übertragen der bestehenden Daten

UC-Analytics Dienste beenden

An diesem Zeitpunkt beginnt jetzt das Wartungsfenster. Es müssen zwingend alle UC-Analytics Dienste beendet werden. Dies gilt auch für alle Nebenplatzinstallationen und das Datenaufnahme-Icon.

SQL Datenbank mit UC-Analytics verknüpfen

Aktuell ist nach einer Installation die Anbindung an eine externe SQL Datenbank erstmal nicht möglich. Um das Leistungsmerkmal freizuschalten ist ein Eintrag in der APPSETTINGS.ini im "System" Ordner des UC-Analytics Programmverzeichnisses notwendig. Ergänzen Sie folgende Zeile:

DatabaseExternalSQL=

Starten Sie dann anschließend das Administrationsprogramm UCA.exe und loggen Sie sich als Superuser ein. Öffnen Sie nun die Grundeinstellungen und aktivieren Sie die Option "Erweiterte Einstellungen anzeigen". Navigieren Sie dann zur Punkt "Datenbanken → Externe SQL Datenbank":

Konfigurieren Sie nun auf dieser Seite die Parameter für die Anbindung an die externe UC-Analytics Datenbankinstanz.

Hier die Bedeutung der einzelnen Parameter:

Datenbank-Instanz
Name der SQL Server Instanz, wie bei der Installation der Datenbank festgelegt. Vor den Instanz-Namen wird der Rechnername des Datenbankservers gesetzt.

Username
Name des SQL Anwenders, der Zugriff auf die UC-Analytics Datenbank hat.
Wurde der SQL Express Server neu installiert, so ist hier der Name sa zu verwenden. Ansonsten der Name des Anwenders, der beim Anlegen der Datenbank gewählt wurde.

Passwort
Kennwort des SQL Anwenders, der Zugriff auf die AlwinPro Datenbank hat.

Datenbank-Name
Name der UC-Analytics Datenbank (hier heißt diese AlwinPro). Wurde der SQL Express Server neu installiert, so kann hier ein beliebiger Name gewählt werden da die UC-Analytics die Datenbank selbst anlegt falls diese noch nicht existiert. Bei Verwendung eines kundeneigenen SQL Servers muss der Name verwendet werden, der beim Anlegen der Datenbank verwendet wurde.

Freier Connection-String
Im Normalfall bleibt dieser Eintrag leer. Sind für den Zugriff auf eine (kundeneigene) Datenbank jedoch spezielle Anforderungen vorhanden, so kann hier ein kompletter ODBC Verbindungsstring eingegeben werden. Wird hier etwas eingegeben, dann werden die anderen Einstellungen nicht benötigt.
Ein Beispiel eines möglichen Connection String wäre:
Driver={SQL Server};Server=WS-SANDER\SQLEXPRESS;Database=AlwinPro;Uid=sa;Pwd=Aurenz@Password

Es ist sinnvoll bei Verwendung von SEConnection trotzdem noch den Parameter Datenbank-Name zu setzen. Dieser wird benötigt, wenn eine Sicherung der Datenbank durch AlwinBackup erfolgen soll.

Schlißen Sie nach eingabe der Parameter die Maske und beenden die UC-Analytics Administration. Die Datenbank wird erst dann angelegt und erst dann kann auch die Verbindung geprüft werden.
Hierzu klicken Sie auf "Verbindungstest". Sollte die Authentifizierung fehlschlagen oder der Datenbankserver nicht erreichbar sein, dann wird eine entsprechende Fehlermeldung angezeigt.

Start der Datenmigration in die SQL Datenbank

Möchten Sie die bereits vorhandenen Gesprächsdaten in die SQL Datenbank übernehmen, so drücken Sie auf Vorhandene Gesprächsdaten in SQL Datenbank kopieren.

Während des Update Vorgangs ist eine Fortschrittsanzeige vorhanden.

Wie lange das Update dauert hängt von sehr vielen Faktoren und lässt sich nicht voraussagen. Als Anhaltspunkt: Auf einem standardmäßig ausgestattetem Server dauert die Migration von 4,5 Mio Gesprächen und 8000 Teilnehmern etwa 30 Minuten.

Nach Beendigung der Migration wird angezeigt, wie viele Datensätze übertragen wurden.

Die Datenmigration kann auch zu einem späteren Zeitpunkt durchgeführt werden und kann bei Bedarf auch wiederholt werden. Bei der Wiederholung werden jedoch alle Gespräche der SQL Datenbank gelöscht und durch die Daten der Migration ersetzt.

Aktivierung des Organigramm-Datenexplorers

Damit die neuartigen Auswertungen und der Datenexplorer in der WebSuite zur Verfügung stehen, muss in den Grundeinstellungen unter "Durchführbare Analysen" jetzt noch der Eintrag "Organigramm-Datenexplorer" aktiviert werden.

Start der UC-Analytics Dienste

Jetzt können die UC-Analytics Dienste wieder gestartet werden. Der Organigramm Datenexplorer steht jetzt in der WebSuite bereit. Bitte beachten, dass nur der Superuser automatisch das Recht für die Ausführung des Organigramm Datenexplorers erhält. Für alle anderen Anwender muss dieses Recht manuell hinzugefügt werden.







© aurenz GmbH 2022