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. | ||
== | ==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 | ||
***Ordner <code>...Testsystem/AlexDB/[...].mongo</code> öffnen | |||
***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. | ||
==== 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
- Bitfactory
- 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
- ansonsten muss das Programm
- 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
- _.9000.mongo (Datenbank) in AlexDB-Ordner legen
- Ordnerstruktur wie folgt anlegen
- Alex®installieren
- 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
- ansonsten muss das Programm
- 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
undbackup
- Umbenennen von
db
-Ordner aufxdb
(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.
- Ordner
- Die Sicherungsdatei vom Produktivsystem wiederherstellen
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.