Installation — vue d'ensemble
NomaUBL se livre comme une application Java unique et autonome — le JAR (nomaubl.jar sous Linux / macOS, nomaubl-fat.jar sous Windows) accompagné de deux scripts de pilotage équivalents : nomaubl.sh (Bash) et nomaubl.cmd (batch Windows). Les deux exposent les mêmes sous-commandes (start / stop / restart / status / log / install / upgrade / modes de traitement) et appellent le JAR avec les mêmes arguments — choisir celui qui correspond à l'hôte. Il n'existe pas d'image Docker ; le JAR s'exécute sur un processus JDK 17 et enregistre ses données de cycle de vie dans une base Oracle ou PostgreSQL. L'interface web, l'API REST et l'ordonnanceur d'arrière-plan résident tous dans ce processus unique.
Cette section déroule chaque étape, d'un serveur Linux vierge jusqu'à un environnement opérationnel.
Les composants
| Composant | Rôle |
|---|---|
| JDK 17 | Le runtime Java qui héberge le JAR. |
| Base de données | Le stockage persistant de NomaUBL — cycle de vie des factures, données de référence, historique de configuration. Oracle (19c+) ou PostgreSQL (13+) ; même instance que votre JD Edwards / SAP / NetSuite / ERP personnalisé, ou schéma dédié. |
| Le JAR | Le binaire applicatif — interface web embarquée, CLI, ordonnanceur. Livré sous le nom nomaubl.jar (Linux / macOS) ou nomaubl-fat.jar (Windows). |
| Le script de pilotage | Un script de gestion de service qui orchestre le cycle de vie du JAR par environnement et propose une forme courte pour chaque mode CLI. nomaubl.sh sous Linux / macOS, nomaubl.cmd sous Windows. |
| Un répertoire d'environnement | L'état par instance sur disque — config/, input/, process/, ubl/, single/, template/, xslt/, .versions/. Créé par <script> install <targetDir> (qui appelle -install sur le JAR). |
| Ressources partagées | Un niveau au-dessus de l'environnement — fonts/ (génération PDF) et images/ (ressources projet). Créées à l'installation. |
Un même hôte peut héberger plusieurs environnements (demo, uat, prod) côte à côte, chacun avec son propre port et son propre fichier PID.
En un coup d'œil
À lire dans l'ordre
| Étape | Page |
|---|---|
| 0 | Cette vue d'ensemble. |
| 1 | Prérequis — JDK, base, OS, ports, reverse proxy optionnel. |
| 2 | Installation et arborescence — lancer install, comprendre l'arborescence des répertoires, installer plusieurs environnements. |
| 3 | Configurer — démarrer le service, se connecter, configurer les connecteurs et les paramètres système depuis l'interface. |
| 4 | Service et systemd — cycle de vie du script, unité systemd optionnelle (Linux) / service Windows (Windows), reverse proxy nginx optionnel. |
| 5 | Mise à niveau — quand une nouvelle version sort, déposer le nouveau JAR et lancer <script> upgrade <env>. |
Test rapide — à quoi ressemble une installation réussie
Après les quatre étapes :
./nomaubl.sh status(ounomaubl.cmd status) affiche votre / vos environnement(s) enrunning.curl http://<host>:8090/api/build-inforenvoie la version et l'horodatage de build.curl http://<host>:8090/api/licenserenvoie l'état de la licence.- La page de connexion s'affiche sur
http://<host>:8090/. - L'utilisateur administrateur créé (via l'étape Init Database in-app à la première ouverture) parvient à se connecter.
Si l'un de ces points fait défaut, la page de l'étape correspondante couvre le diagnostic.
Ce que cette section ne couvre PAS
| Sujet | Où le trouver |
|---|---|
| Les opérations CLI quotidiennes. | Gestion → Ligne de commande. |
| L'interface web page par page. | Les sections Application / Synchronisation / Traitement / Outils UBL de la barre latérale. |
| La mise à niveau d'un environnement existant. | Mise à niveau. |
| L'observation du runtime en direct. | Supervision. |
| Ce qu'est un modèle de Plateforme Agréée et comment le configurer. | Configuration → Système → E-invoicing. |
À suivre
- Prérequis — ce que l'hôte doit posséder avant de commencer.
- Installation et arborescence — provisionner le premier environnement.