Guide d installation d Opti-Time Strategic GEOCONCEPT SAS

(1)

Guide d’installation d’Opti-Time Strategic

GEOCONCEPT SAS

(2)

Guide d’installation d’Opti-Time Strategic...

Introduction ... 3

Informations sur le document ... 3

Préambule au déploiement ... 3

Déploiement et configuration ... 5

Clé d’activation ... 5

Webapp Java ... 5

Changement de la base de données de Strategic ... 8

Installation du moteur d’optimisation de Strategic ... 10

(Option) Configuration des emplacements d'échange de données avec Strategic ... 10

(Option) Modification du vocabulaire de l’application ... 11

(Option) Changement d’accès à l’application Strategic via SSO ... 11

Intégration de Strategic dans OT ... 13

(3)

Introduction

Opti-Time Strategic (dit Strategic) est un module complémentaire à Opti-Time (dit OT).

Il est livré dans l’installateur d'Opti-Time depuis la version 8.5.1 mais n’est pas déployé.

L’objectif de ce document est donc de répondre à la question : Comment déployer et configurer Opti-Time Strategic après une installation d’Opti-Time ?

Informations sur le document

Version

Les informations figurant dans le présent document décrivent les procédures et les données à manipuler pour déployer Opt-Time Strategic au 3ème trimestre 2018.

Elles sont sujettes à révision sans préavis.

Le logiciel décrit dans ce document est diffusé dans le cadre d’un contrat de droit d’utilisation et ne peut être utilisé, copié ou cédé qu’en conformité avec les stipulations de ce contrat.

Toute copie des logiciels Opti-Time Strategic, Opti-Time sur disque ou autre support à des fins autres que l’usage du programme par l’acheteur pour ses besoins propres est interdite.

Informations légales

Geoconcept est une marque déposée de Geoconcept S.A.S..

Préambule au déploiement Pré-requis

Actuellement, Strategic nécessite un environnement Windows pour exécuter le moteur de lissage.

Une version Linux est à l'étude.

Strategic version 1.0.18 est livré avec OT 8.5.2 et 8.5.3 et est soumis à une clé d’activation lors de l’installation d'OT.

Répertoire de livraison

Suite à l’installation d’OT via l’installateur, Strategic est copié sur le disque dur du serveur sous : Opti- Time_PATH\otstrategic

Dans la suite du document, nous prendrons comme référence d’installation d’OT (c’est-à-dire Opti- Time_PATH) le répertoire : C:\Opti-Time

et donc C:\Opti-Time\otstrategic pour Strategic avant déploiement.

Il contient des sous-répertoires contenant les éléments de programme et de configuration à copier et paramétrer :

(4)

(5)

Déploiement et configuration

Strategic est constitué :

• d’une clé d’activation du module ;

• d’une webapp en Java ;

• d’une configuration Tomcat ;

• d’une configuration Apache ;

• d’un moteur d’optimisation en C++ (DLL) ;

• d’une configuration de la Base de données ;

• d’un paramétrage de droits dans OT.

Clé d’activation

Pour savoir si la clé d’installation utilisée contient ou non le module Strategic, il faut dans OT, se connecter en tant qu’administrateur, allez dans le module d' Administration et cliquer sur le lien

License… situé sous le numéro de version.

Si la clé autorise Strategic, l’affichage de la licence doit montrer le module comme activable :

Webapp Java Installation

Dans le répertoire C:\Opti-Time\webapps\, vous devez y trouver la webapp ^otsp.war :

(6)

Vous pouvez créer le répertoire otsp et y dézipper le contenu de ^otsp.war :

Configuration dans Tomcat

Dans le répertoire C:\Opti-Time\tomcat\conf\Catalina\localhost\, vous devez y trouver les fichiers de configuration des différentes webapp publiées par votre Tomcat (htc, otgs, ugc-admin, smartrouting- admin, otmobile).

Il vous faut dupliquer le fichier otmobile.xml.bck en otsp.xml.bck, puis l'éditer avec un éditeur de texte pour remplacer les références à otmobile en otsp :

(7)

Webapp Java

Enregistrer puis dupliquer le fichier otsp.xml.bck en ^otsp.xml. Redémarrer le service « Opti-Time Tomcat » :

Test depuis une URL externe à OT

A ce stade, il est possible de tester la bonne installation de la webapp Strategic, même si le moteur d’optimisation (lissage des charges) n’est pas encore configuré.

Se connecter sur http://localhost/otsp/ avec le compte par défaut d’OT et Strategic (qui est admin / admin) :

(8)

Une fois connecté, vous devez arriver sur la page suivante :

Changement de la base de données de Strategic

Par défaut, l’application est déployée par l’installateur pour se connecter à une base de données PostgreSQL.

Vous pouvez changer l’accès à la base de données en modifiant le fichier hibernate.properties de Strategic.

(9)

Changement de la base de données de Strategic

• Dans le répertoire C:\Opti-Time\otstrategic\config\param\, vous devez y trouver le fichier

hibernate.properties.

Le répertoire de configuration de Strategic est référencé par une variable d’environnement système.

Sous une invite de commandes (^cmd.exe), tapez :

set

Vous verrez alors toutes les variables d’environnement instanciée, et parmi elles, vous trouverez :

FILE_STRATEGIC_PATH=C:\Opti-Time\otstrategic\config\param\

• Arrêter le service Tomcat.

• Modifier le fichier hibernate.properties.

• Redémarrer le service Tomcat.

(10)

Installation du moteur d’optimisation de Strategic

Dans le répertoire C:\Opti-Time\otstrategic\config\param\, vous devez y trouver le fichier

strategic.properties.

Dans ce fichier, trouvez la propriété permettant de définir l’emplacement du moteur d’optimisation :

balancing.pathStrategicDLL = C:\Opti-Time\otstrategic\native\win64-amd64

Attention : en version 1.0 de Strategic, le moteur d’optimisation fonctionne uniquement sous Windows 64 bits.

Dans ce répertoire déclaré, on doit trouver les composants nécessaires :

• le moteur : Strategic.dll

• le moteur de logs : log4cpp.dll

• la config du moteur de logs : logger.prop

• exécutable du moteur en mode ligne de commande : OtStrategicCmdLine.exe

Dans le fichier logger.prop, il est possible de définir le niveau de log (EMERG, FATAL, ALERT, CRIT, ERROR, WARN, NOTICE, INFO, DEBUG).

(Option) Configuration des emplacements d'échange de données avec Strategic

Dans le répertoire C:\Opti-Time\otstrategic\config\param\, vous devez y trouver le fichier

strategic.properties.

Dans ce fichier, trouvez les propriétés permettant de définir les différents emplacements utilisés par le moteur d’optimisation pour échanger ses données :

balancing.exportDir = C:\Opti-Time\work\otstrategic\export balancing.inputDir = C:\Opti-Time\work\otstrategic\input balancing.invalidDir = C:\Opti-Time\work\otstrategic\invalid

(11)

(Option) Modification du vocabulaire de l’application

balancing.outputDir = C:\Opti-Time\work\otstrategic\output

balancing.importCsvFolder = C:\Opti-Time\work\otstrategic\importCSV balancing.createJunitFolder = C:\Opti-Time\work\otstrategic\Junit

(Option) Modification du vocabulaire de l’application

Il est possible de personnaliser le vocabulaire utilisé dans l’application.

Dans le répertoire C:\Opti-Time\webapps\otsp\conf, vous devez y trouver le fichier vocabulary.properties

qui contient les termes anglophones par défaut employés dans l’application.

Dupliquer au même emplacement ce fichier pour chaque langue que vous souhaitez personnaliser, par exemple vocabulary_fr.properties.

Rechercher dans ce fichier les mots clés concernés et modifier les lignes identifiées.

Ces "nouveaux" termes viendront surcharger ceux du fichier initial vocabulary.properties.

(Option) Changement d’accès à l’application Strategic via SSO

Par défaut, l’application est déployée par l’installateur pour se connecter à une base de données PostgreSQL, dans laquelle un utilisateur administrateur a été défini.

Il est possible de se connecter à Strategic en mode SSO (Signe Sign On) si votre authentification est gérée par un service tiers tel que Google.

• Dans le répertoire C:\Opti-Time\otstrategic\config\param\, vous devez y trouver le fichier

sso.properties.

• Arrêter le service Tomcat.

• Modifier le fichier sso.properties.

• Redémarrer le service Tomcat.

Les différents paramètres de config SSO et leur signification

Les paramètres du fichier sso.properties faisant référence à l’application Strategic :

(12)

sso.callback.url=http\://localhost:8080/otstrategic/SsoServlet

sso.provider.saml.serviceproviderentityid=http\://localhost:8080/otstrategic

(13)

Intégration de Strategic dans OT

Il est possible d’intégrer Strategic directement dans OT pour ne pas avoir sortir d'OT pour utiliser Strategic.

Dans un premier temps, il convient de vérifier que votre clé d’activation d’OT vous donne bien le droit d’utiliser Strategic.

Puis aller dans le menu vous permettant de gérer les droits, et se donner le droit d’accès au module (STRATEGIC_PLANNING_GUEST).

Il faut ensuite se déconnecter et se reconnecter pour que ce droit soit pris en compte au niveau de l’application.

En se reconnectant, un nouveau module apparait intégré dans OT.

(14)

Vous pouvez dès lors importer vos données sous forme de fichiers plats en vous référant à la

documentation d’intégration [https://mygeoconcept.com/privatedoc/FGbav68AWn24nD75/ot-strategic- doc/docs/fr/ots-integration-book/index.html] des données dans Strategic.