Um aurenz UC-Analytics / Swyx Analytics / AlwinPro UC-Edition auf einen neuen Server zu migrieren folgen Sie dieser Anleitung:

Vorraussetzungen

• Die Version der Software muss auf dem Alten und dem neuen Server die Gleiche sein.
  Wir empfehlen ein eventuell gewünschtes oder erforderliches Update auf dem Altsystem zu erledigen um dann eine aktuelle Version zu migrieren
  → Beachten Sie, dass für ein Update unter Umständen eine gültige Software Assurance oder im Falle von Swyx Analytics ein Update Voucher nötig ist. Wenden Sie sich hierzu an Ihren Distributor oder Systempartner

• Beachten Sie die zur Version freigegebenen Betriebssysteme
  Diese finden Sie im Handbuch im Installationsverzeichnis (z. B. "C:\Program Files (x86)\Aurenz\UC-Analytics\Handbuch")

Vorgehen

1. Aktualisieren Sie gegebenfalls die Software auf dem Altsystem

2. Beenden Sie alle aurenz-Progamm-Module

3. Stellen Sie sicher, dass keine weiteren Benutzer am Server angemeldet sind, die ebenfalls noch Programm-Module geöffnet haben könnten

4. Starten Sie "als Administrator" das Programm "AlwinBackup.exe" im Programmverzeichnis und erstellen Sie eine Komplettsicherung
   
   

   Open

   

   
   Während der Sicherung wird die Datenbank exklusiv geöffnet. Deshalb kann die Software während der Sicherung nicht verwendet werden

   1. Die Sicherung muss erfolgreich abgeschlossen werden. Entsprechende Meldungen zeigt das Programm an.

5. Installieren Sie genau die gleiche Version auf dem neuen Server
   Beenden Sie den Konfigurations-Assistenten nach der Installation - diese Einstellungen werden bei der Datenrückspielung übernommen

6. Kopieren/Verschieben Sie die von AlwinBackup.exe erstellte Sicherungsdaten-Datei auf den neuen Server

7. Starten Sie "als Administrator" das Programm "AlwinBackup.exe" im Programmverzeichnis des neuen Servers

8. Wählen Sie die Karteikarte "Zurückspielen gesicherter Daten" und geben Sie den Speicherort des kopierten Backups ein

9. Stellen Sie sicher, dass alle Programm-Module beendet sind

10. Beenden Sie die aurenz Systemdienste:

    1. UC-Analytics Abrechnungsmodul

    2. UC-Analytics Datenaufnahme

    3. UC-Analytics Web Suite

    4. UC-Analytics Webserver

    5. UC- Analytics Datenbank* (*Nur bei speziellen Client-Server Installationen vorhanden)

11. Starten Sie die Datenrücksicherung

Funktionsprüfung

Überprüfen Sie grundsätzlich die Funktion der Software und im speziellen folgende Punkte
→ Je nach genutzem Funktionsumfang können entsprechende Punkte übersprungen werden

1. Datenquelle

   1. je nach TK System muss am TK-System oder auf Seite der aurenz Software eine Anpassung wegen eines geänderten Hostname bzw. IP-Adresse erledigt werden

   2. Eventuell vorhandene Firewall-Regeln müssen wegen eines geänderten Hostname bzw. IP-Adresse angepasst werden

   3. Eventuell muss die gewünschte IP-Kommunikation an der Windows Firewall zugelassen werden

2. Ausgabe von Auswertungen und Statistiken

   1. Druckeranbindung (für Direkt-Druck des Servers)

      1. lokale Drucker installiert mit korrektem Treiber und entsprechender Konfiguration?

      2. korrekter Standard-Drucker konfiguriert?

   2. Adobe Reader installiert (u. A. für Direkt-Druck nötig)?

   3. SMTP-Anbindung (Anbindung an E-Mail-System)

3. alle geplante und automatische Jobs sollten auf Funktion geprüft werden

4. automatische Datensicherung inkl. konfiguriertem Speicherort auf Gültigkeit prüfen

Problemlösungen

Dienst WebSuite startet nicht / WebSuite nicht erreichbar

Wurde eine Installation ggf. einen anderen Server migriert, kann es beim Start der WebSuite Probleme geben, falls sich Pfade geändert haben.

Im Installationspfad im Verzeichnis “WebSuite” befindet sich die Datei „wrapper.conf“. Dort ist unter “set.AURENZ_UCA_PROGRAM_DATA“ der Pfad (zum aurenz Daten-Verzeichnis hinterlegt.
Wenn dieser nach der Migration anders lautet, so muss dieser angepasst werden.
Hinweis: Ist der Installations-Pfad gleich dem Daten-Pfad, kann der Wert wie folgt lauten „set.AURENZ_UCA_PROGRAM_DATA=.“

 Hier ein Auszug der Datei:

Alter Servername in Datenaufnahme sichtbar

Falls in der Datenaufnahme der alte Servername noch dargestellt wird:

1. Stoppen Sie den Dienst UC-Analytics Datenaufnahme

2. löschen Sie im Installationsverzeichnis folgende Dateien:

   • ...\System\ACTIVERECEIVER.dat

   • ...\System\ACTIVERECEIVER.idx

Es sind noch UC-Analytics- oder AlwinPro-Programme angemeldet

Die Sicherung oder Datenrückspielung meldet, dass weitere Programme oder Arbeitsstationen  geöffnet sind. Somit kann kein exklusiver Datenbankzugriff statt finden.

Open

1. Sind weitere Benutzer am AlwinPro/UC-Analytics-Server angemeldet und haben eine aurenz Applikation oder das Datenaufnahme-Icon aktiv?
   → der oder die Benutzer müssen alles aurenz-Applikationen beenden oder sich ganz abmelden.

2. Aufgrund von Systemproblemen oder Abstürzen in der Vergangenheit können noch Lock-Files angelegt sein, die die Datenbank vor Inkonsistenz schützen sollen.
   → Prüfen Sie im Verzeichnis ...\System\ im Installationsverzeichnis auf vorhandene *.lck-Dateien. Jeder Prozess der aurenz Software erstellt eine eingene *.lck-Datei.
   → Die Datei enthält den Names des Rechners und die PID. Wird ein Prozess sauber beendet, wird auch die *.lck-Datei gelöscht. Gibt es den Prozess mit der PID auf dem Rechner im Namen der Datei nicht (mehr), kann die *.lck-Datei gelöscht werden.
   → Ansonsten muss die Applikation oder der entsprechende Dienst beendet werden - dann sollte auch die *.lck_Datei gelöscht werden

Prüfen Sie erneut, ob die Sicherung bzw. Datenrückspielung nun funktioniert. Falls nicht warten Sie 2 Minuten nachdem Sie die 2 obigen Punkte erledigt haben.

Alternative Migrationmöglichkeit (Copy und Regedit)

Bei allen AlwinPro Care und Hotel Produkten sind weitere, kundenindividuelle Schritte nötig!
Wenden Sie sich für eine Unterstützung unseres technischen Supports hierzu gerne an unseren Vertrieb (info@aurenz.de oder +49 7021 73888 0).

Diese Migrations-Variante kann bei falscher oder unvollständigen Durchführung zur Zerstörung der Datenbank-Struktur führen und sollte nur von erfahrenen Technikern durchgeführt werden.

Es sind Erfahrungen mit der Windows-Registry nötig.
Erstellen Sie vor einer Migration oder eines Updates IMMER ein Backup des Systems.

Grundsätzlich funktioniert diese Variante wie folgt:

1. Sicherung relevanter Registry-Keys

2. Beenden und deaktivieren aller aurenz Dienste und Applikationen

3. Kopieren der gesamten Installations- und Daten-Dateien (inkl. Verzeichnis-Struktur) auf den neuen Server

4. Setzen der gesicherten relevanten Registry-Keys

5. Ausführen des aurenz-Setup auf dem neuen Server

Anhand der relevanten Registry-Keys kann das Setup die alte Installation inkl. genauer Versionsnummer und Ordner-Pfade erkennen und so beim Setup die entsprechenden Maßnahmen für ein Versions-Update treffen.

Auf dem ALTEN SYSTEM:

• Öffnen Sie Regedit und sichern Sie den Schlüssel (Der Pfad kann sich je nach installiertem Produkt unterscheiden.)

  • z. Bsp.: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Aurenz\UC-Analytics\Version

  • oder z. Bsp.: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Aurenz\AlwinPro\Version

• Sichern Sie ebenfalls den gesamten Schlüssel HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Aurenz\ mit dem gesamten Inhalt
  So können z. B. die Werte für die Pfade später kontrolliert werden

• Die genaue Versionsnummer im DWORD-Wert “Version” ist immens wichtig. Wird dieser nicht zu 100% von der Altinstallation übernommen, kann die Datenbanksstruktur zerstört werden

• Erstellen Sie eine Verzeichniskopie

  • aller Dateien der aurenz-Installation (Falls getrennt: Daten & Installations-Verzeichnis)

  • weiterer Daten oder Verzeichnis-Strukturen die die aurenz-Software verwendet (export-Verzeichnisse, ausgelagerte Verzeichnis-Strukturen, …)

• Kopieren Sie die Daten und die Sicherungen der Registry auf den neuen Server

Auf dem NEUEN SYSTEM:

• Stellen Sie sicher, dass Sie Administratorrechte haben und keine Policyeinstellungen Sie beim Ausführen der Dateien einschränkt!

• Stellen Sie die aurenz Dateien auf dem neuen Server zur Verfügung und übernehmen Sie die Pfade 1 zu 1

• Regedit:

  • Importieren Sie per Regedit den auf dem alten Server gesicherten Schlüssel inkl. dem DWORD-Wert.

  • Unter dem Schlüssel “UC-Analytics” (bzw. Ihrem abweichenden Produkt-Namen) erstellen Sie eine Zeichenfolge

    • mit dem Namen "LocalDir" und als Wert den Pfadnamen, unter dem Sie das Installations-Verzeichnis eingefügt haben
      (Standard: C:\Program Files (x86)\Aurenz\UC-Analytics)

    • mit dem Namen "WorkingDir" und als Wert den Pfadnamen, unter dem Sie das Verzeichnis eingefügt haben

      • Wenn auf dem alten Server das Installations-Verzeichnis gleich dem Daten-Verzeichnis ist

        • Den selben Pfad wie bei “LocalDir”: Standard: C:\Program Files (x86)\Aurenz\UC-Analytics

      • Wenn auf dem alten Server das Installations-Verzeichnis nicht gleich dem Daten-Verzeichnis ist

        • Den Pfad zum Daten-Verzeichnis: Standard: C:\ProgramData\Aurenz\UC-Analytics

      • Wenn Sie unsicher sind prüfen SIe die Pfade in der gesicherten Registry-Datei

    • mit dem Namen „InstallType“ und dem Wert „Hauptinstallation“

• Nun sind die Vorbereitungen abgeschlossen und Sie können Setup.exe aus des aktuellen aurenz Release über die rechte Maustaste als Administrator starten

• Der Installationsassistent erkennt, dass es sich um ein Upgrade handelt. Bitte folgen Sie den Assistenten, bis das Upgrade durchgeführt ist.

• Prüfen Sie nun die korrekte Funktion der Software und passen Sie bei Bedarf Folgendes an:

  • hinterlegte Export-Pfade der Auswertungen (WebSuite)

  • hinterlegte Pfade der automatischen Jobs (klassische Administration) wie Export-Jobs, Datensicherung, Verzeichniss-Bereinigung, …

  • Verarbeiterung der CDR