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.

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

Open

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.

Open

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.

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.

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.