Procedure-Systel/START/Mise en place de l'Aide à la décision.md

Mettre en place l'Aide à la décision

1. Installer et initialiser la base StartDB

Récupérer les scripts d'installation correspondant au SGBD utilisé (SQL Server ou Oracle) dans :

\\cloud\Produits\Produits_systel\Gestion operationnelle\AD\Installation

Se connecter à la base StartDB et exécuter les scripts dans cet ordre :

1. Alter_suppression_AD.sql
2. Alter_creation_AD.sql
3. alter_init_param_AD.sql
4. init_AD_restreinte.sql
5. init_droits.sql
6. init_questionnaire_pgr_win1252.sql

Régulariser ensuite les paramètres à l'aide des scripts correspondant au SGBD :

\\cloud\Produits\Produits_systel\Gestion operationnelle\AD\Adaptation_apres_premiere_install\SQL
\\cloud\Produits\Produits_systel\Gestion operationnelle\AD\Adaptation_apres_premiere_install\ORACLE

2. Configurer les serveurs ActiveMQ dans StartDB

Adapter la commande du paramètre AD.service.local.commande à la plateforme. Les adresses ci-dessous sont les exemples fournis dans la procédure source; les remplacer par les adresses validées pour l'environnement.

Pour une plateforme disposant de deux serveurs ActiveMQ :

UPDATE PARAMETRES_CTA_COMPLEMENTAIRES
SET valeur = 'D:\Start\Progs\SysAD\java\bin\java -jar d:\\start\\progs\\SysAD\\ServAD.jar ACTIVEMQ_PRIMARY=10.108.1.14 ACTIVEMQ_SECONDARY=10.108.1.24 BROAKER_CONNECTOR=ActiveMQ CONTEXT_CLEAN_INTERVAL=15 CONTEXT_TTL=45 LOCAL_COMMUNICATION=false'
WHERE CLE = 'AD.service.local.commande';

Pour une plateforme avec un seul serveur ActiveMQ (exemple Formation/Test) :

UPDATE PARAMETRES_CTA_COMPLEMENTAIRES
SET valeur = 'D:\Start\Progs\SysAD\java\bin\java -jar d:\\start\\progs\\SysAD\\ServAD.jar ACTIVEMQ_PRIMARY=10.108.7.14 BROAKER_CONNECTOR=ActiveMQ CONTEXT_CLEAN_INTERVAL=15 CONTEXT_TTL=45 LOCAL_COMMUNICATION=false'
WHERE CLE = 'AD.service.local.commande';

Conserver les noms de paramètres tels qu'attendus par l'application, notamment BROAKER_CONNECTOR. Le paramétrage StartDB est terminé une fois les valeurs propres à la plateforme appliquées.

3. Déployer les sources CopyStart

Récupérer les sources de l'Aide à la Décision correspondant à la version de référence dans :

\\cloud\Qualité\Alerte

Exemple pour SGO 11.7 :

\\cloud\Qualité\Alerte\Version de référence SGO_117\Version Start\Progs\SysAD

Copier le répertoire récupéré dans les sources Start de l'environnement client. Un CopyStart sur un poste opérateur distribuera ensuite l'application et son paramétrage.

3.1 Configurer jdbc_config.xml

Créer ou modifier D:\Start\Progs\SysAD\jdbc_config.xml pour qu'il pointe vers la base StartDB de l'environnement.

Exemple de structure pour Oracle :

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<systel.ressource.jdbcconfig
    systel.ressource.jdbcconfig.driver="oracle.jdbc.OracleDriver"
    systel.ressource.jdbcconfig.password="REMPLACER_PAR_LE_SECRET_RDM"
    systel.ressource.jdbcconfig.port="1521"
    systel.ressource.jdbcconfig.prefix="jdbc:oracle:thin"
    systel.ressource.jdbcconfig.sid="start"
    systel.ressource.jdbcconfig.url="jdbc:oracle:thin:@(DESCRIPTION = (ADDRESS_LIST = (ADDRESS = (PROTOCOL = TCP)(HOST = 10.164.1.11)(PORT = 1521)) (ADDRESS = (PROTOCOL = TCP)(HOST = 10.164.1.21)(PORT = 1521)) (LOAD_BALANCE = yes) ) (CONNECT_DATA = (SERVER = DEDICATED) (SERVICE_NAME = START_TAF) (FAILOVER_MODE = (TYPE = select) (METHOD = basic) (RETRIES = 180) (DELAY = 5) ) ) )"
    systel.ressource.jdbcconfig.user="REMPLACER_PAR_LE_COMPTE_BDD"/>

Exemple de structure pour SQL Server :

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<systel.ressource.jdbcconfig
    systel.ressource.jdbcconfig.driver="com.microsoft.sqlserver.jdbc.SQLServerDriver"
    systel.ressource.jdbcconfig.password="REMPLACER_PAR_LE_SECRET_RDM"
    systel.ressource.jdbcconfig.url="jdbc:sqlserver://10.108.1.25;databaseName=StartDB"
    systel.ressource.jdbcconfig.user="REMPLACER_PAR_LE_COMPTE_BDD"/>

Les adresses IP, le compte et le mot de passe de ces exemples doivent être adaptés à la base cible. Récupérer les secrets dans RDM et ne pas les enregistrer en clair dans la documentation ou dans les sources partagées.

4. Installer Java sur les postes opérateurs

Pour éviter les conflits avec la version de Java déjà installée sur un poste, utiliser une copie locale de Java à côté de l'application Aide à la Décision.

La procédure source indique un JDK 8u141 au minimum, disponible dans :

\\cloud\Produits\Produits_systel\Gestion operationnelle\AD\Java\jdk1.8.0_141

Sur chaque poste opérateur concerné, copier le sous-répertoire java dans le répertoire local de SysAD. Exemple de destination source :

\\10.108.1.55\d$\Start\Progs\SysAd\java

Adapter le serveur et le chemin de destination à l'environnement client. Vérifier que l'exécutable Java attendu se trouve bien sous java\bin.

5. Adapter les GPO selon l'environnement

Adapter les GPO aux environnements opérationnel, Formation ou Test. La procédure source indique de déposer les fichiers jdbc_config.xml correspondants dans :

\\CTA08.local\SYSVOL\CTA08.LOCAL\scripts\CopyFiles\jdbc_config

Le domaine CTA08.local et les noms d'exemples ci-dessous sont propres à l'exemple source; les remplacer par les chemins de l'environnement cible.

Pour l'exemple SDIS 08, les GPO mentionnées sont :

• USER-USERS-SESSION_OPE-SQL pour l'environnement opérationnel;
• USER-USERS-SESSION_FORMATION-SQL pour l'environnement Formation.

Le contenu précis des paramètres GPO n'étant pas transcrit dans la source, reprendre les réglages d'une configuration validée pour l'environnement concerné.

6. Adapter les scripts de copie de base Formation/Test

Pour les imports de la base opérationnelle vers Formation/Test, ajouter ou adapter le paramètre de commande SysAD dans les scripts de copie de base de données. L'adresse ActiveMQ doit correspondre à l'environnement cible.

Exemple fourni pour une plateforme Formation/Test avec un seul serveur ActiveMQ :

UPDATE PARAMETRES_CTA_COMPLEMENTAIRES
SET VALEUR = 'D:\Start\Progs\SysAD\java\bin\java -jar d:\\start\\progs\\SysAD\\ServAD.jar ACTIVEMQ_PRIMARY=10.108.7.14 BROAKER_CONNECTOR=ActiveMQ CONTEXT_CLEAN_INTERVAL=15 CONTEXT_TTL=45 LOCAL_COMMUNICATION=false'
WHERE CLE = 'AD.service.local.commande';

Remplacer l'adresse d'exemple par celle de l'environnement cible et vérifier que la commande copiée correspond à la configuration StartDB de cet environnement.

7. Activer l'Aide à la Décision dans Start

Dans Start, ouvrir Paramètres > OCN 2, puis activer l'OCN d'Aide à la Décision.