Testsystem: Unterschied zwischen den Versionen

 
Zeile 33: Zeile 33:
'''Hinweis:''' Ab der Version 2017.20 ist eine [[Automatische Aktualisierung Testsystem|automatische Aktualisierung des Testsystems]] möglich.
'''Hinweis:''' Ab der Version 2017.20 ist eine [[Automatische Aktualisierung Testsystem|automatische Aktualisierung des Testsystems]] möglich.


==== Arbeiten auf Produktivserver ====
==Installation Testsystem==


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


==== Arbeiten auf Testserver ====
==== Arbeiten auf Testserver ====
* Testsystem wird auf neuen Server installiert
*Testsystem wird auf neuen Server installiert
** Die Sicherungsdatei vom Produktivsystem wiederherstellen
**{{Alex}}[[Installation|installieren]]
*** Die Sicherungsdatei in einen neuen leeren Ordner kopieren
***Ordnerstruktur wie folgt anlegen
*** Rechte Maustaste auf die Sicherungsdatei und <code>Öffnen mit...</code> wählen
****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 <code>Bfx.Alex.Instal.exe</code> 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 <code>Öffnen mit...</code> wählen
**** Sollte <code>Restore Mongo Qt</code> in der Liste sein das Programm wählen
*****ansonsten muss das Programm <code>...Testsystem/AlexEXE/Bfx.Alex.RestoreMongo.Qt.exe</code> im selbem Dialog am Computer gesucht werden
****Nach dem öffnen der Datei sind die Ordner bereits korrekt ausgefüllt, <code>Restore</code> 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<syntaxhighlight>
, "service" :
  { "name" : "AlexTestsystem"
  }
</syntaxhighlight>
****Datenbank als Testsystem [[Automatische Aktualisierung Testsystem#Konfiguration|einrichten]]<syntaxhighlight>
, "testSystem" :
  { "sourceBackupPath" : "D:/BitFactory/Backupverzeichnis"
  , "autoUpdateDB" : "false"
  , "timeUpdateDB" : "01:00"
  }
</syntaxhighlight>
****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 <code>Öffnen mit...</code> wählen
*** Sollte <code>Restore Mongo Qt</code> in der Liste sein das Programm wählen
*** Sollte <code>Restore Mongo Qt</code> in der Liste sein das Programm wählen
**** ansonsten muss das Programm <code>...Testsystem/AlexEXE/Bfx.Alex.RestoreMongo.Qt.exe</code> im selbem Dialog am Computer gesucht werden
****ansonsten muss das Programm <code>...Testsystem/AlexEXE/Bfx.Alex.RestoreMongo.Qt.exe</code> im selbem Dialog am Computer gesucht werden
*** Nach dem öffnen der Datei sind die Ordner bereits korrekt ausgefüllt, <code>Restore</code> wählen
***Nach dem öffnen der Datei sind die Ordner bereits korrekt ausgefüllt, <code>Restore</code> wählen
*** Die Wiederherstellung kann je nach Sicherungsgröße viel Zeit in anspruch nehmen und ist abgeschlossen sobald das Programm wieder reagiert
***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
**Die wiederhergestellte Sicherung im Testsystem übernehmen
***<code>...Testsystem/AlexExe/Bfx.Alex.Service.Manager.exe</code> öffnen
***Ordner <code>...Testsystem/AlexDB/[...].mongo</code> öffnen
*** Dienst stoppen
***Es werden zwei Ordner angezeigt: <code>db</code> und <code>backup</code>
*** Ordner <code>...Testsystem/AlexDB/[...].mongo</code> öffnen
***Umbenennen von <code>db</code>-Ordner auf <code>xdb</code> (oder Ordner löschen wenn dieser nicht mehr benötigt wird)
*** Es werden zwei Ordner angezeigt: <code>db</code> und <code>backup</code>
***Kopieren und einfügen des <code>db</code>-Ordners von "Ordner der wiederhergestellten Sicherung/_.mongo"
*** Umbenennen von <code>db</code>-Ordner auf <code>xdb</code> (oder Ordner löschen wenn dieser nicht mehr benötigt wird)
***AlexDB/_.9000.mongo umbenennen auf neuen Port, sodass es keine Kollisionen gibt. (Beispiel AlexDB/_.9001.mongo)
*** Kopieren und einfügen des <code>db</code>-Ordners von "Ordner der wiederhergestellten Sicherung/_.mongo"
***Config-File anpassen
*** Zu <code>...Testsystem/AlexExe/Bfx.Alex.Service.Manager.exe</code> wechseln
****connectionInfo mit dem korrekten Pfad befüllen
*** Dienst starten
****Ports anpassen (man kann hier beispielsweise die alten Ports +1 eingeben. Aus Modelserver Port 4400 wird 4401)
****"service" umbennen und [[Automatisches Upgrade|kennzeichnen als Testsystem]]
***Zu <code>...Testsystem/AlexExe/Bfx.Alex.Service.Manager.exe</code> wechseln
***Dienst starten
***<code>...Testsystem/AlexExe/Bfx.Alex.Client.exe</code> öffnen - Login muss erscheinen.
***<code>...Testsystem/AlexExe/Bfx.Alex.Client.exe</code> öffnen - Login muss erscheinen.
** 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 <code>Öffnen mit...</code> wählen
**** Sollte <code>Restore Mongo Qt</code> in der Liste sein das Programm wählen
***** ansonsten muss das Programm <code>...Testsystem/AlexEXE/Bfx.Alex.RestoreMongo.Qt.exe</code> im selbem Dialog am Computer gesucht werden
**** Nach dem öffnen der Datei sind die Ordner bereits korrekt ausgefüllt, <code>Restore</code> 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 <code>...Testsystem/AlexDB/[...].mongo</code> öffnen
**** Es werden zwei Ordner angezeigt: <code>db</code> und <code>backup</code>
**** Umbenennen von <code>db</code>-Ordner auf <code>xdb</code> (oder Ordner löschen wenn dieser nicht mehr benötigt wird)
**** Kopieren und einfügen des <code>db</code>-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 [[Automatisches Upgrade|kennzeichnen als Testsystem]] 
**** Zu <code>...Testsystem/AlexExe/Bfx.Alex.Service.Manager.exe</code> wechseln
**** Dienst starten
**** <code>...Testsystem/AlexExe/Bfx.Alex.Client.exe</code> öffnen - Login muss erscheinen.


==== Arbeiten im TESTSYSTEM ====
====Arbeiten im TESTSYSTEM====


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


==== Abschluss ====
====Abschluss====


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


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

Aktuelle Version vom 27. April 2023, 14:22 Uhr

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.