(von "humongous" = gigantisch, enorm, riesig)
Betrieb von Alex und MongoDB
Alex kann ab der Version 7.6.4.1 mit MongoDB's arbeiten. Voraussetzungen:
- Version > 7.6.4.1
- 64 bit Betriebssystem für Server oder Standalonebetrieb
- (Client kann überall laufen)
- "connectionInfo" im ALEX-Config-File = LOKALER Ordner in der Form ([drive]:/.../)[name].[port].mongo/.
- zB.: Gültige "connectionInfo" für MongoDB:
- Kunde.mongo/
- .mongo/
- 9000.mongo/
- Kunde.9000.mongo/
- C:/AlexDat/Kunde.9000.mongo/
- D:/AlexDat/Kunde.9000.mongo/
- C:/AlexDat/Kunde.mongo/
- zB.: Gültige "connectionInfo" für MongoDB:
- im Client-Server Betrieb -> Bfx.Alex.Server == Datenbankserver!
- Besonderheit [port] im Pfadname
- im Client Server Betrieb ist ein [port] notwendig damit Sicherung automatisiert werden kann
- Im reinen Standalone Betrieb ist kein [port] im Pfadname notwendig
- siehe auch ALEX-Ports
Die Ordnerstruktur einer MongoDB sieht wie folgt aus:
[drive]:/.../[name].[port].mongo/ // Stammverzeichnis = "connectionInfo"
/db/ // Datenverzeichnis
/log/ // Logverzeichnis
Wenn Alex gestartet wird, wird automatisch das mongod.exe (liegt bei den Alex-Exe) gestartet. Ob dieses exe im Vordergrund oder unsichtbar gestartet wird hängt ab von folgendem:
- im ALEX-Config-File ist 'showMongod' gesetzt -> mongod.exe läuft im Vordergrund
- im ALEX-Config-File ist bei 'connectionInfo' ein Port angegeben -> mongod.exe läuft im Vordergrund
- im ALEX-Config-File ist bei 'connectionInfo' kein Port angegeben -> mongod.exe läuft im Hintergrund
Erstellen neuer Datenbanken
Gleiches Vorgehen mit Bfx.Alex.Tools wie Sybase. Siehe Form von "connectionInfo".
Konvertieren bestehender Datenbanken
ALEX-Config-File "convertFrom"
Um eine SQL-Datenbank umzuwandeln, muß man sie im ALEX-Config-File unter (db.)"convertFrom" eintragen.
Die zu erzeugende neue MongoDB gibt man im (db.)"connectionInfo" an -> der angegebene Ornder wird automatisch erzeugt und darf NICHT zuvor händisch im WindowsExplorer angelegt werden.
mit Bfx.Alex.Standalone.exe einsteigen -> Alex konvertiert altes DB-Format in MongoDB-Format.
Richtwert für die Dauer: getestet BitFactory CRM: 600.000 Objekte (= select count(*) from TBfxXObject) -> ca. 10 min
- 1.000.000 Objekte -> ca. 15 min
- 2.000.000 Objekte -> ca. 30 min
- 4.000.000 Objekte -> ca. 60 min
- 8.000.000 Objekte -> ca. 120 min
- 16.000.000 Objekte -> ca. 240 min
AKH Linz: ca. 12.000.000 Objekte -> ca. 180 min
Alex-V7.7-Sybase-DB mit 1,8 GB: nur 1.648.741 Objekte -> ca. 210 min!
MongoDB und Abfragen
Mögliche Fehlermeldungen
Fehlermeldung nach Konvertierung:
"ACHTUNG: \'convertFrom\' -> connectionInfo [drive]:/.../[name].[port].mongo/ nicht leer!"
-> "convertFrom" herauslöschen aus Config-File.
Log-File "Bfx.Alex.MongoConverter.Client.log" durchschauen ob [error] vorhanden.
-> Falls Ja und nicht selbsterklärend, bei Kollegen nachfragen.
Fehlermeldung beim Einstieg:
für ältere Serverbetriebssysteme < Windows 2008 R2 kann die Mongoinstallation übersteuert werden. dazu einfach https://s3.amazonaws.com/downloads.bitfactory.at/%23legacy%23.zip in den exe Ordner extrahieren und mind. Version 7.8.6.31 einspielen (aufgefallen Altenhof) Ordnerstruktur muss sein:
exe\#legacy#\mongod.exe
\mongo.exe
\mongorestore.exe
\mongodump.exe
genauer Ablauf bei Umstellung: Mongo - Umstellung
Sicherung
ab V7.8
Alex-Server sichert automatisch jeden Tag um 3 Uhr früh in den "backup" Unterordner.
Dieser "backup"-Ordner wird autom. in eine ".bfx_BACKUP"-Datei gezippt - diese wird neben dem "backup"-Ordner abgelegt.
-> Alle ".bfx_BACKUP"-Datei müssen vom Kunden täglich weggesichert werden. (Es gibt immer nur die Sicherung vom letzten Tag.)
Dazu muß der Mongo-Server Port im Mongo-Pfad codiert werden!
siehe auch: ALEX-Ports Mongo-Server Port
Beispiel:
C:\BitFactory\AlexDat\Kunde.1234.mongo
^
|
Port (darf nicht mit anderen Ports kollidieren)
Sicherung wiederherstellen
- mit Bfx.Alex.RestoreMongo.exe
- mit Rechtsklick auf eine *.bfx_BACKUP-Datei
Die wiederhergestellte Datenbank kann dann mit der vorhandenen ausgetauscht werden.
Datenbank reparieren
- zB.: manchmal notwendig bei Problemen von Upgrade "alte" 7.8 auf neueste 7.8
> mongod.exe --dbPath C:\Bitfactory\AlexDat\_.9000.mongo\db --repair
Datenbank in ein Testsystem kopieren
Achtung: Die folgenden Schritte sind nur bei bestehendem Testsystem möglich!
- Letzte Version, welche im Echtsystem eingespielt wurde im Testsystem einspielen
- Shutdown (ohne Dienst neu Starten) im Echtsystem einplanen
- Der Dienst des Echtsystems sowie des Testsystems müssen über den ALEX Service Manager gestoppt werden
- Im Anschluss kann der Ordner "db" aus dem Echtsystem kopiert und der "db" Ordner im Testsystem durch diesen ersetzt werden
- Abschließend müssen die beiden Dienste wieder gestartet werden
- Um Verwechslungen zu vermeiden, sollte im Testsystem unter Systemeinstellungen die "Anzeige in Titel des Hauptfensters" geändert werden (z.B. "Testsystem")
Migration auf einen anderen Server
- Shutdown (ohne Dienst neu Starten) im Echtsystem einplanen.
- Dienst über den ALEX Service Manager stoppen. (zur Sicherheit vielleicht noch im Windows ServerManager kontrollieren, ob es keine geöffneten Dateien gibt)
- Gesamten Bitfactory-Ordner vom alten Server auf den neuen Server kopieren. (Sowohl AlexExe als auch AlexDB müssen auf den neuen Server kopiert werden)
- Am neuen Server: Im Config-File muss nun folgendes geändert werden: Pfad für AlexDB; IP-Adresse und falls es am neuen Server bereits einen anderen Alex gibt auch die Ports und den Service-Namen
- Am neuen Server: ALEX Service Manager ausführen: Dienst neu anlegen und anschließend starten.
- Link zum Alex Client auf dem neuen Server verteilen
- Bei Zeiterfassung: Config-File vom neuen Server auf die Stempeluhren verteilen
