r-io suitereference docsFrom an archive to a first deduced collaborative process in one sitting: run the standalone, open r-ioga, load the IMT Albi Crisis use case, replay a sensor scenario in r-iosemit, watch the alerts in r-iota, then deduce, deploy and follow a process.
The standalone ships its own JRE and starts an embedded Neo4j and an embedded MongoDB. No database, application server or Python installation is required for a first run; the AI assistants only need an LLM provider key if you want to use them.
Download the Linux or Windows archive from the Nexus distribution site listed in Quick start & releases (stable v2026-01-01 or the current 1.0-SNAPSHOT), then unzip it in a path without spaces. The archive weighs about 1.3 GB because it bundles a JRE and every web application.
Follow the README: JDK 26, Maven 3.9, Python 3.13, long path support on Windows. Build ts/ first, then java/, with mvn clean install -Dmaven.test.skip -T 1C -Dlicense.skip=true. Generate the distribution from java/packaging/gind-r-io-standalone with -Ddistrib=windows or -Ddistrib=linux; the archive lands in target/.
bin/ start and stop scripts, lib/ the launcher jar (gind-r-io-standalone-<version>.jar), conf/ the unified_config.properties and the generated per-component configurations, jre/<os>/ the bundled Java runtime, plus the process repository and logs created at run time.
The scripts adjust the host key of the configuration files (startup-local-distrib forces localhost, startup keeps the network name) and then run the launcher with the start command. The launcher checks that every configured port is free, starts the embedded databases, the backend services in four waves and finally the web applications, then opens r-ioga in your browser.
# Linux cd bin ./startup-local-distrib.sh # or ./startup.sh on a machine reachable by its network name # Windows cd bin startup-local-distrib.bat # equivalent command run by the scripts ../jre/<os>/bin/java -Dfile.encoding=UTF-8 -Xmx4048m --add-opens=... -jar ../lib/gind-r-io-standalone-<version>.jar start
The console then shows the r-iosuite> prompt. Type info to list the started web services with their host and port, shutdown to stop the suite and exit to leave the console. The first start takes a few minutes: embedded MongoDB and Neo4j initialise, metamodels and domains are published, and the predefined use cases listed in load-predefined-usecases are loaded.
| Application | URL | Use it to |
|---|---|---|
| r-ioga | http://localhost:9100/r-ioga | Sign in, manage collaborations, knowledge spaces, projects and use cases; deploy and follow processes |
| r-ioda | http://localhost:9102/r-ioda | Model partners, resources, functions, objectives and risks |
| r-iosemit | http://localhost:9112/r-iosemit | Replay sensor datasets and mock partner endpoints |
| r-iota | http://localhost:9108/r-iota | Follow alerts, detection and the situation on the map |
| r-ioded | http://localhost:9120/r-ioded | Pick and edit deduction strategies |
| Others | see web application ports | r-iose 9110, r-iored 9118, r-iosepe 9114, r-ioplay 9104, r-iome 9116, r-iocal 9122, r-iomega 9124, r-iote 9128 |
When defaultAdmin is true (the default), an administrator account is created at first start; its credentials are those of your installation and are not reproduced here. You can also create a user from the sign-in page (register) and, once an administrator exists, manage accounts in r-ioga.
A collaboration groups users and knowledge spaces; a knowledge space is the graph you will work in. Create both from r-ioga, or select the ones a use case created. Every application you open afterwards shares this context.
r-ioga lists the projects of the collaboration. A project ties a domain, its model extensions, a detection strategy and shared resources together; use cases are ready-made projects.
Two use cases are on the runtime classpath: IMT Albi Crisis and Crisis Event Show Parc des Princes. The released distribution pre-loads IMT Albi Crisis into the knowledge space named after it, inside the “R-IO Suite” collaboration; if your configuration does not, load it from r-ioga.
downloadRemoteUsecase).The use case ships game scenarios (for example “3 sensors IMT - 1 sensor Cathedral” for the Albi scenarios). Selecting one recreates the sensor controllers and mock endpoints it describes.
Start a dataset on a sensor controller (period, frequency, step by step or breakpoints). Each replayed reading follows the real path: sensor manager, time series, event broker, CEP or ML rules.
Interpreted facts (dangers, effects, emerging risks) appear as alerts and on the map; CEP alerts are sure, ML alerts ask for validation. The detection page compares the expected situation with the field.
r-iosuite> shutdown # stops services, web applications and embedded databases, waits for ports to free r-iosuite> exit # or, from another terminal ./stop.sh # Linux stop.bat # Windows
| Symptom | Cause | Fix |
|---|---|---|
| “This port is not available” at start | The launcher checks every configured port before booting. | Free the port or change the key in conf/unified_config.properties (see Configuration & ports). |
| Out of memory or very slow start | Sixteen services and fourteen web applications in one JVM. | Keep the 4 GB heap of the scripts; close other Java processes; prefer a lighter profile when embedding the container yourself. |
| Windows: path too long | Deeply nested WebJar and Neo4j paths. | Enable LongPathsEnabled and Git core.longpaths as described in the README; unzip near the drive root. |
| Embedded MongoDB does not start | Port 27017 busy or a previous instance left data. | Stop the other MongoDB or set mongodb-database-port; the embedded launcher removes stale instances at start. |
| No alert after playing a scenario | The sensor node is not ACTIVE or no CEP/ML rule is deployed for it. | Check the sensor in r-iose and its rule in r-iored; the Sensor interceptor deploys the configuration when the node is published. |
| Deduction ends with no solution | No actor provides the required functions, or resources cannot be assigned. | Read the campaign observation in r-iosepe; complete Provides relations and resources in r-ioda. |
De l’archive à un premier processus collaboratif déduit, en une séance : lancer le standalone, ouvrir r-ioga, charger le cas d’usage IMT Albi Crisis, rejouer un scénario de capteurs dans r-iosemit, suivre les alertes dans r-iota, puis déduire, déployer et suivre un processus.
Le standalone livre son propre JRE et démarre un Neo4j et un MongoDB embarqués. Aucune base, serveur d’applications ni installation Python n’est requis pour un premier essai ; les assistants IA n’ont besoin d’une clé de fournisseur de LLM que si vous voulez les utiliser.
Téléchargez l’archive Linux ou Windows depuis le site de distribution Nexus listé dans Démarrage & releases (stable v2026-01-01 ou 1.0-SNAPSHOT courant), puis décompressez-la dans un chemin sans espace. L’archive pèse environ 1,3 Go car elle embarque un JRE et toutes les applications web.
Suivez le README : JDK 26, Maven 3.9, Python 3.13, prise en charge des chemins longs sous Windows. Construisez d’abord ts/, puis java/, avec mvn clean install -Dmaven.test.skip -T 1C -Dlicense.skip=true. Générez la distribution depuis java/packaging/gind-r-io-standalone avec -Ddistrib=windows ou -Ddistrib=linux ; l’archive arrive dans target/.
bin/ scripts de démarrage et d’arrêt, lib/ le jar du lanceur (gind-r-io-standalone-<version>.jar), conf/ le unified_config.properties et les configurations générées par composant, jre/<os>/ le runtime Java embarqué, plus le dépôt de processus et les journaux créés à l’exécution.
Les scripts ajustent la clé host des fichiers de configuration (startup-local-distrib force localhost, startup garde le nom réseau) puis lancent le lanceur avec la commande start. Le lanceur vérifie que chaque port configuré est libre, démarre les bases embarquées, les services backend en quatre vagues et enfin les applications web, puis ouvre r-ioga dans votre navigateur.
# Linux cd bin ./startup-local-distrib.sh # ou ./startup.sh sur une machine joignable par son nom réseau # Windows cd bin startup-local-distrib.bat # commande équivalente exécutée par les scripts ../jre/<os>/bin/java -Dfile.encoding=UTF-8 -Xmx4048m --add-opens=... -jar ../lib/gind-r-io-standalone-<version>.jar start
La console affiche ensuite l’invite r-iosuite>. Tapez info pour lister les services web démarrés avec leur hôte et leur port, shutdown pour arrêter la suite et exit pour quitter la console. Le premier démarrage prend quelques minutes : MongoDB et Neo4j embarqués s’initialisent, métamodèles et domaines sont publiés, et les cas d’usage prédéfinis listés dans load-predefined-usecases sont chargés.
| Application | URL | Pour |
|---|---|---|
| r-ioga | http://localhost:9100/r-ioga | Se connecter, gérer collaborations, espaces de connaissance, projets et cas d’usage ; déployer et suivre les processus |
| r-ioda | http://localhost:9102/r-ioda | Modéliser partenaires, ressources, fonctions, objectifs et risques |
| r-iosemit | http://localhost:9112/r-iosemit | Rejouer des jeux de données capteurs et simuler les endpoints partenaires |
| r-iota | http://localhost:9108/r-iota | Suivre alertes, détection et situation sur la carte |
| r-ioded | http://localhost:9120/r-ioded | Choisir et éditer les stratégies de déduction |
| Autres | voir ports des applications | r-iose 9110, r-iored 9118, r-iosepe 9114, r-ioplay 9104, r-iome 9116, r-iocal 9122, r-iomega 9124, r-iote 9128 |
Quand defaultAdmin vaut true (valeur par défaut), un compte administrateur est créé au premier démarrage ; ses identifiants sont ceux de votre installation et ne sont pas reproduits ici. Vous pouvez aussi créer un utilisateur depuis la page de connexion (register) et, dès qu’un administrateur existe, gérer les comptes dans r-ioga.
Une collaboration regroupe des utilisateurs et des espaces de connaissance ; un espace de connaissance est le graphe dans lequel vous travaillez. Créez les deux depuis r-ioga, ou sélectionnez ceux créés par un cas d’usage. Toutes les applications ouvertes ensuite partagent ce contexte.
r-ioga liste les projets de la collaboration. Un projet relie un domaine, ses extensions de modèle, une stratégie de détection et des ressources partagées ; les cas d’usage sont des projets prêts à l’emploi.
Deux cas d’usage sont sur le classpath runtime : IMT Albi Crisis et Crisis Event Show Parc des Princes. La distribution publiée précharge IMT Albi Crisis dans l’espace de connaissance qui porte son nom, au sein de la collaboration « R-IO Suite » ; si votre configuration ne le fait pas, chargez-le depuis r-ioga.
downloadRemoteUsecase).Le cas d’usage livre des scénarios de jeu (par exemple « 3 sensors IMT - 1 sensor Cathedral » pour les scénarios d’Albi). En sélectionner un recrée les contrôleurs de capteurs et les mock endpoints qu’il décrit.
Lancez un jeu de données sur un contrôleur (période, fréquence, pas à pas ou points d’arrêt). Chaque mesure rejouée suit le chemin réel : gestionnaire de capteurs, séries temporelles, broker, règles CEP ou ML.
Les faits interprétés (dangers, effets, risques émergents) apparaissent en alertes et sur la carte ; les alertes CEP sont sûres, les alertes ML demandent validation. La page de détection compare la situation attendue au terrain.
r-iosuite> shutdown # arrête services, applications web et bases embarquées, attend la libération des ports r-iosuite> exit # ou, depuis un autre terminal ./stop.sh # Linux stop.bat # Windows
| Symptôme | Cause | Correctif |
|---|---|---|
| « This port is not available » au démarrage | Le lanceur vérifie chaque port configuré avant de démarrer. | Libérez le port ou changez la clé dans conf/unified_config.properties (voir Configuration & ports). |
| Mémoire insuffisante ou démarrage très lent | Seize services et quatorze applications web dans une seule JVM. | Gardez les 4 Go de heap des scripts ; fermez les autres processus Java ; préférez un profil plus léger si vous embarquez le conteneur vous-même. |
| Windows : chemin trop long | Chemins WebJar et Neo4j profondément imbriqués. | Activez LongPathsEnabled et core.longpaths de Git comme décrit dans le README ; décompressez près de la racine du disque. |
| MongoDB embarqué ne démarre pas | Port 27017 occupé ou données d’une instance précédente. | Arrêtez l’autre MongoDB ou changez mongodb-database-port ; le lanceur embarqué supprime les instances obsolètes au démarrage. |
| Aucune alerte après un scénario | Le nœud capteur n’est pas ACTIVE ou aucune règle CEP/ML n’est déployée pour lui. | Vérifiez le capteur dans r-iose et sa règle dans r-iored ; l’intercepteur Sensor déploie la configuration à la publication du nœud. |
| La déduction se termine sans solution | Aucun acteur ne fournit les fonctions requises, ou les ressources ne peuvent pas être affectées. | Lisez l’observation de la campagne dans r-iosepe ; complétez les relations Provides et les ressources dans r-ioda. |