2. Installation

2.1 Prérequis#

MIRAJ est distribué sous forme de binaires prêts à l'emploi pour Windows 64 bits (éditions Entreprise et Express), sans dépendance externe à installer. Choisissez l'archive correspondant à l'édition souhaitée (voir 1.3) : elle contient miraj-server.exe, miraj-cli.exe et, pour l'usage embarqué depuis une application Delphi, C++ ou tout langage capable de charger une DLL C, miraj.dll.

Une bibliothèque 32 bits (miraj.dll compilée pour des applications Win32) est disponible séparément pour les applications qui en ont besoin ; l'exécutable 64 bits par défaut ne peut pas être chargé par un processus 32 bits.

Aucune installation au sens d'un programme d'installation n'est nécessaire : copiez les exécutables où vous le souhaitez et lancez-les. Le dossier depuis lequel miraj-server ou miraj-cli est lancé n'a pas d'importance : c'est le dossier de données (--root) qui détermine où vivent vos bases.

Pour compiler MIRAJ vous-même (autres plateformes, débogage, contribution), voir 2.7.

2.2 Démarrer miraj-server#

miraj-server.exe --root D:\donnees --log

Cette commande ouvre (ou crée s'il n'existe pas) le dossier de données D:\donnees, puis se met à l'écoute sur 127.0.0.1:7007. Le compte root local, sans mot de passe, est créé automatiquement à la première ouverture du dossier.

Options de la ligne de commande#

Toutes les options acceptent un nom insensible à la casse (--Root et --root sont équivalents). miraj-server --help affiche la liste complète.

Chaque option de la ligne de commande peut aussi être fixée durablement dans miraj_config.xml (voir 2.4) ; en cas de conflit, la ligne de commande l'emporte.

2.3 Installer et utiliser miraj-cli#

miraj-cli n'a besoin d'aucune installation particulière : c'est un exécutable autonome qui ouvre directement un dossier de données, sans passer par un serveur réseau.

miraj-cli.exe --root D:\donnees

MIRAJ 1.0.0 Entreprise - tapez \help pour l'aide, \q pour quitter.
miraj>

Options de la ligne de commande#

Voir 13. miraj-cli pour la référence complète des commandes du mode interactif (\d, \l, \history, source, etc.).

2.4 Fichier de configuration#

À l'image d'un fichier de configuration classique d'un serveur SQL, MIRAJ lit un fichier XML au démarrage :

• <dossier de données>/miraj_config.xml — vos réglages, lu au démarrage. S'il n'existe pas encore, MIRAJ en crée un squelette commenté.
• <dossier de données>/miraj_default.xml — régénéré à chaque démarrage, liste toutes les variables reconnues avec leur valeur par défaut. C'est un document de référence uniquement : il n'est jamais relu par le serveur.

Ordre de priorité, du plus faible au plus fort : valeur par défaut du moteur, puis miraj_config.xml, puis argument de la ligne de commande.

2.5 Organisation du dossier de données#

Le dossier de données (--root) est l'unité d'administration d'un serveur ou d'une console MIRAJ : tout ce qui appartient à une installation y réside.

D:\donnees\
├── miraj_config.xml         (vos réglages)
├── miraj_default.xml        (référence, régénéré à chaque démarrage)
├── miraj\
│   ├── accounts.mra         (coffre chiffré des comptes)
│   ├── server.log           (avec --log : erreurs, bugs, incidents)
│   └── slow.log             (avec --slow-query-log)
└── ma_base\                 (une base = un sous-dossier)
    ├── journal.mrl          (journal d'écriture de la base)
    ├── clients.mrj          (une table = un fichier .mrj)
    └── clients.bmrj         (BLOB externalisés de la table, si présents)

• Une base = un sous-dossier du dossier de données.
• Une table = un fichier .mrj dans le sous-dossier de sa base, au format interne MIRA v2.
• Les valeurs BLOB d'une table dont la taille dépasse --lob-threshold sont conservées dans un magasin séparé, <table>.bmrj, à côté du fichier .mrj.
• Chaque base a son propre journal d'écriture, journal.mrl, rejoué à l'ouverture si le dernier arrêt n'a pas été propre.
• Le coffre des comptes (accounts.mra) est commun au dossier de données ; il est chiffré, et sa clé est rangée par défaut hors du dossier de données (voir ci-dessous et 11. Administration du serveur).

2.6 Sécurité par défaut#

• Écoute locale uniquement. Sans --bind, miraj-server n'écoute que sur 127.0.0.1 : aucune machine distante ne peut s'y connecter tant que vous n'avez pas explicitement choisi une autre adresse d'écoute.
• Compte administrateur créé au premier lancement. À la création du dossier de données, un compte root local, sans mot de passe, est créé automatiquement ; c'est le seul type de compte habilité à gérer les autres comptes. Donnez-lui un mot de passe dès que possible :

  ALTER USER root@localhost IDENTIFIED BY 'un-mot-de-passe-solide';

• Clés du coffre des comptes rangées hors du dossier de données, par défaut dans le profil du compte qui exécute le serveur (--key-dir pour choisir un autre emplacement).

Le détail de la gestion des comptes, des privilèges, du chiffrement en transit (TLS) et de la supervision est traité dans 11. Administration du serveur et 10. Comptes et privilèges.

2.7 Compiler depuis les sources#

Cette section s'adresse aux utilisateurs avancés qui veulent compiler MIRAJ eux-mêmes (autre plateforme, débogage, intégration continue).

Prérequis#

• rustup ; la chaîne de compilation exacte (1.98.1) est installée automatiquement grâce au fichier rust-toolchain.toml du dépôt.
• Sous Windows, si cargo n'est pas dans le PATH :

  $env:Path = "$env:USERPROFILE\.cargo\bin;$env:Path"

Compiler l'édition Entreprise (multi-cœur)#

cargo build --workspace --release

Compiler l'édition Express (gratuite, mono-fil)#

Les éditions sont choisies par la fonctionnalité Cargo parallel, active par défaut :

cargo build --workspace --release --no-default-features

Vérifier la compilation#

cargo test --workspace
cargo test --workspace --no-default-features
cargo clippy --workspace --all-targets

Démarrer les binaires compilés#

target/release/miraj-server --root D:\donnees --lang fr
target/release/miraj-cli --help

L'édition Cluster se compile avec la fonctionnalité Cargo cluster (cargo build --workspace --release --features cluster) ; voir 12. Cluster et réplication.