Installation, démarrage et gestion des processus

Prérequis

Les prérequis sont décrits à la page Administrez votre système Spinalcore

Une fois l'archive du template récupérée, veuillez suivre la procédure suivante :

Installation

Extraire le contenu de l'archive

tar -xhzvf "BOS_SpinalCore_&_SpinalTwin_Suite_27-04-20.tar.gz"

Lancement et gestion du système

Nous utilisons PM2 comme gestionnaire de processus pour gérer et maintenir les applications en fonctionnement. Il faut donc que PM2 soit installé sur le serveur sur lequel vous déployez le BOS

Installation de PM2

npm install pm2 -g

Démarrage et management du système en CLI via PM2

Positionnez-vous dans le répertoire contenant les modules du système d'information

cd "BOS_SpinalCore_&_SpinalTwin_Suite_27-04-20/"

pm2 start launch.config.js

Pour relancer tous les processus (ou organes) du système ou les lancer un à un vous pouvez utiliser les commandes suivantes

pm2 start all

pm2 restart all

pm2 start spinal-organ-forge-7777

Pour arrêter le système complet ou un processus (ou organe) spécifique :

pm2 stop launch.config.js

pm2 stop all

pm2 stop spinal-organ-forge-7777

Pour lister les processus et leur états

pm2 list # ou pm2 l

Pour arrêter ou détruire les processus de la liste

pm2 delete launch.config.js

pm2 delete all

pm2 delete spinal-organ-forge-7777

Pour sauvegarder et/ou lancer des processus au démarrage du système c.f : https://pm2.keymetrics.io/docs/usage/startup/


Configuration spécifique de certains processus (ou organes) du système SpinalCore

Les organes sont des applications à part entière qui se connectent au coeur du système pour fonctionner. Ces organes doivent avoir accès aux données du jumeau numérique. Comme un BOS peut contenir plusieurs jumeaux numériques ou graph (même si nous le déconseillons), il est nécessaire de configurer chaque organe pour leur donner le chemin d'accès au graph dans la base du BOS. Ces configurations sont disponibles dans les répertoires de chacun des organes :

  • organs/spinal-organ-ticket/build/config.js

  • organs/spinal-organ-calculate-dashboard-data/config.json

  • organs/- spinal-organ-connector-bacnetIP/config.json5 (c.f organs/spinal-organ-connector-bacnetIP/README.md )