(von "humongous" = gigantisch, enorm, riesig)
Betrieb von Alex und MongoDB
Alex kann ab der Version 7.6.4.1 mit MongoDBs 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/.
- z.B.: 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/
- z.B.: 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 von Folgendem ab:
- 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, muss man sie im ALEX-Config-File unter (db.)"convertFrom" eintragen.
Die zu erzeugende neue MongoDB gibt man im (db.)"connectionInfo" an -> der angegebene Ordner 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
Kundendatenbank / Kunde mit knapp 4.000 Mitarbeitern: 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 muss 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
- z.B.: manchmal notwendig bei Problemen von Upgrade "alte" 7.8 auf neueste 7.8
> mongod.exe --dbPath C:\Bitfactory\AlexDat\_.9000.mongo\db --repair
