Testsystem

Version vom 27. April 2023, 14:22 Uhr von Christoph Pichlbauer (Diskussion | Beiträge) (→‎Arbeiten auf Testserver)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)

ALEX® bietet die Möglichkeit ein Testsystem zu betreiben.

Je nach Leistung des Produktivservers kann ein Testsystem neben dem Produktivsystem am gleichen Server betrieben werden, oder auf einem eigenen Testserver.

Die erstmalige Installation des Testsystems wird von Bit Factory vorgenommen. Hierbei wird eine aktuelle Datenbank bereitgestellt und das Config-File des Testsystems angepasst.

VORSICHT BEI ZEITERFASSUNG/REPORTSCHNITTSTELLEN

ACHTUNG! Kunden mit Zeiterfassung mit anderen Stempeluhren als die Alex-Stempeluhr (z.B. Gantner, KABA etc.): Hier muss sichergestellt werden, dass die Stempelungen nicht vom Testsystem ausgelesen werden.

Im Config-File vom Testsystem muss deswegen folgender Eintrag GELÖSCHT werden:

"serverDaemonPlugins" :
{ "1" : "Bfx.Alex.AttendanceRecorder.Interface.Model.dll"
}

Das gleiche gilt für Kunden mit automatischen Reports, hier muss sichergestellt werden, dass die Reportschnittstellen vom Testsystem nicht in den gleichen Ordner geschrieben werden wie jene vom Produktivsystem.

Deswegen muss auch in diesem Fall im Config-File vom Testsystem folgender Eintrag GELÖSCHT werden:

"serverDaemonPlugins" :
{   "1" : "Bfx.Alex.AccountsReport.Model.dll"
}


Aktualisierung der Programmversion

Versionsupdate im Client-/Serverbetrieb

Aktualisierung der Datenbank

Hinweis: Ab der Version 2017.20 ist eine automatische Aktualisierung des Testsystems möglich.

Installation Testsystem

Arbeiten auf Produktivserver

  • Ordner "...Produktivsystem/AlexDB/[...].mongo" öffnen
  • In diesem Ordner ist eine Sicherungsdatei die mit dem Dateitype .bfx_BACKUP zu finden
  • Diese Sicherungs-Datei muss auf den Computer des Testsystems kopiert werden

Arbeiten auf Testserver

  • Testsystem wird auf neuen Server installiert
    • Alex®installieren
      • Ordnerstruktur wie folgt anlegen
        • Bitfactory
          • AlexExe
          • AlexDB
            • _.9000.mongo
      • Alex-Version AlexExe-Ordner legen
        • CurrentVersion.zip & "_.bfx_ignore_locked_ports" vom Echtsystem zum Testsystem kopieren
        • Version entpacken
        • Rechtklick auf Bfx.Alex.Instal.exe und "als Administrator ausführen" auswählen
      • Die Sicherungsdatei vom Produktivsystem wiederherstellen
        • Die Sicherungsdatei in einen neuen leeren Ordner kopieren
        • Rechte Maustaste auf die Sicherungsdatei und Öffnen mit... wählen
        • Sollte Restore Mongo Qt in der Liste sein das Programm wählen
          • ansonsten muss das Programm ...Testsystem/AlexEXE/Bfx.Alex.RestoreMongo.Qt.exe im selbem Dialog am Computer gesucht werden
        • Nach dem öffnen der Datei sind die Ordner bereits korrekt ausgefüllt, Restore wählen
        • Die Wiederherstellung kann je nach Sicherungsgröße viel Zeit in anspruch nehmen und ist abgeschlossen sobald das Programm wieder reagiert
      • Configfile vom Echtsystem kopieren und anpassen:
        • _.9000.mongo (Datenbank) in AlexDB-Ordner legen
          • Port der Datenbank ändern Beispiel _.9001.mongo
        • Pfad ändern (zB "connectionInfo" : "D:/BitFactory/AlexDB/_.9001.mongo")
        • IP-Adresse ändern (IPConfig) - Ausführen-->cmd-->ipconfig-->IP4-Adresse
        • Bezeichnung des Dienstes ändern
          , "service" :
            { "name" : "AlexTestsystem"
            }
        • Datenbank als Testsystem einrichten
          , "testSystem" :
            { "sourceBackupPath" : "D:/BitFactory/Backupverzeichnis"
            , "autoUpdateDB" : "false"
            , "timeUpdateDB" : "01:00" 
            }
        • Einstieg Standalone testen
        • Neuen Dienst anlegen --> Dienst starten
        • Einstieg Client testen
  • Testsystem wird auf gleichen Server installiert wie Echtsystem
    • Die Sicherungsdatei vom Produktivsystem wiederherstellen
      • Die Sicherungsdatei in einen neuen leeren Ordner kopieren
      • Rechte Maustaste auf die Sicherungsdatei und Öffnen mit... wählen
      • Sollte Restore Mongo Qt in der Liste sein das Programm wählen
        • ansonsten muss das Programm ...Testsystem/AlexEXE/Bfx.Alex.RestoreMongo.Qt.exe im selbem Dialog am Computer gesucht werden
      • Nach dem öffnen der Datei sind die Ordner bereits korrekt ausgefüllt, Restore wählen
      • Die Wiederherstellung kann je nach Sicherungsgröße viel Zeit in anspruch nehmen und ist abgeschlossen sobald das Programm wieder reagiert
    • Die wiederhergestellte Sicherung im Testsystem übernehmen
      • Ordner ...Testsystem/AlexDB/[...].mongo öffnen
      • Es werden zwei Ordner angezeigt: db und backup
      • Umbenennen von db-Ordner auf xdb (oder Ordner löschen wenn dieser nicht mehr benötigt wird)
      • Kopieren und einfügen des db-Ordners von "Ordner der wiederhergestellten Sicherung/_.mongo"
      • AlexDB/_.9000.mongo umbenennen auf neuen Port, sodass es keine Kollisionen gibt. (Beispiel AlexDB/_.9001.mongo)
      • Config-File anpassen
        • connectionInfo mit dem korrekten Pfad befüllen
        • Ports anpassen (man kann hier beispielsweise die alten Ports +1 eingeben. Aus Modelserver Port 4400 wird 4401)
        • "service" umbennen und kennzeichnen als Testsystem
      • Zu ...Testsystem/AlexExe/Bfx.Alex.Service.Manager.exe wechseln
      • Dienst starten
      • ...Testsystem/AlexExe/Bfx.Alex.Client.exe öffnen - Login muss erscheinen.

Arbeiten im TESTSYSTEM

  • ins Testsystem einsteigen und in den Systemeinstellungen folgende Änderungen einpflegen
  • unter Allgemein: Anzeige im Titel des Hauptfensters auf "TESTSYSTEM" ändern
  • unter Exporteinstellungen: Pfad für Lohnartenexport und Abwesenheitsexport ändern
  • unter Exporteinstellungen: eventuell vorhandene automatische Kontoreport-Export löschen
  • bei externer Zeiterfassung: unter Zeiterfassung/Stempeluhr den Zeitstempel-Import-Pfad ändern

Abschluss

  • Aufräumen von kopierten Ordnern
  • ...Testsystem/AlexExe/Bfx.Alex.Service.Manager.exe und ...Testsystem/AlexExe/Bfx.Alex.Client.exe schliessen
  • Benutzern Bescheid geben

Bei Problemen stehen wir Ihnen telefonisch oder per Email zur Verfügung.