Installation — vue d'ensemble
Mettre en service un serveur NomaUBL — JDK 17 + une base Oracle ou PostgreSQL + le JAR. S'exécute comme un processus Java permanent, un par environnement, démarré via le script nomaubl.sh. Unité systemd et reverse proxy optionnels pour la production.
Prérequis
Ce que l'hôte doit posséder avant d'installer NomaUBL — JDK 17, une base Oracle ou PostgreSQL, matrice des OS pris en charge, ports, permissions du système de fichiers et la couche reverse proxy / TLS optionnelle.
Installation et arborescence
Exécuter -install (directement via java -jar, ou via le wrapper nomaubl.sh / nomaubl.cmd) pour provisionner un environnement. Comprendre l'arborescence produite — config / input / process / ubl / template / ressources partagées — et installer plusieurs environnements côte à côte sous Linux, macOS ou Windows.
Configurer
Après l'installation, chaque connecteur, intervalle d'ordonnanceur et paramètre opérationnel se configure depuis l'interface Settings — sans édition manuelle des fichiers de configuration. Démarrer le service, se connecter, puis parcourir la section Configuration.
Supervision du service
Exécuter NomaUBL comme service permanent sous Linux/macOS ou Windows — nomaubl.sh ou nomaubl.cmd pour start/stop/status, une unité systemd (Linux) ou un service Windows via NSSM (Windows) pour le redémarrage automatique au boot, et un reverse proxy nginx optionnel en façade pour TLS et un nom d'hôte lisible.
Mise à niveau
Faire évoluer un environnement NomaUBL installé vers une nouvelle version. Une seule commande — nomaubl.sh upgrade sous Linux/macOS ou nomaubl.cmd upgrade sous Windows — gère le remplacement du JAR, les migrations de schéma, la fusion des données de référence, la fusion des XSL client et le redémarrage du service. Un rapport complet est produit et une sauvegarde de retour arrière est conservée.