Guide d exploitation - TIMi server 1. Installation Pour installer TIMi, téléchargez et exécutez le fichier "TIMiSetup.exe". Suivez ensuite les instructions à l'écran. Vous pouvez télécharger le fichier "TIMiSetup.exe" ici: http://demouser:telecharger@www.business-insight.com/tim/timisetup.exe Si le lien ci-dessus ne marche pas, essayez celui-ci: http://www.business-insight.com/tim/timisetup.exe Si une fenêtre de login apparaît lors du téléchargement, utilisez: login: demouser password: telecharger La version serveur et la version "poste client" de TIMi ont le même programme d installation. C est le "serial number" qui décide quelle version de TIMi (serveur ou poste client) est installée. Un "serial number" de type "serveur" débloque les fonctionnalités "serveurs" de TIMi (gestion des utilisateurs & des traces). La version serveur de TIMi refusera de fonctionner tant que le gestionnaire des utilisateurs sur le serveur n est pas proprement configuré. Il est suggéré de choisir comme option d'installation "Typcial large install" (grande installation typique). Référez-vous à l illustration ci-dessous:
Page 2 of 20 L'installateur de TIMi vous propose d'installer d'autres logiciels additionnels standards qui vous aideront dans vos tâches d'analyse des données. Ces autres logiciels sont: WINRAR: Habituellement les datasets à analyser avec TIMi sont stockés dans des fichiers plats compressés au format RAR. Le logiciel WinRAR vous permet de manipuler (créer) les fichiers RAR de façon à optimiser votre espace de stockage disque. IrFanView: Le logiciel TIMi crée de nombreux graphiques et de nombreuses figures. Ces graphiques vous permettent d'explorer de manière intuitive et amusantes vos données. La plupart des graphiques de TIMi sont des fichiers PNG. Le logiciel IrFanView vous permet de rapidement parcourir les milliers de graphiques PNG générés avec TIMi. IrFanView est un complément agréable au visualiseur d'images intégré à Windows. EMEditor: Certains rapports d'analyse générés avec TIMi peuvent être des fichiers extrêmement volumineux. Le logiciel EMEditor est le seul éditeur de fichier texte supportant l unicode et capable de manipuler des rapports textes pouvant atteindre les 100MB. Le logiciel EMEditor est particulièrement intéressant lorsque les datasets analysés contiennent plus de 100.000 colonnes car, dans ce cas, les rapports de TIMi peuvent devenir très grands (il est courant d'obtenir des rapports textes de plus de 80 MB). JAVA virtual machine: La moteur principal de TIMi est écrit en code C++ hautement optimisé et, pour quelques parties, en assembleur. Néanmoins, l'interface graphique conviviale de TIMi a été développée en JAVA v1.6. Il est donc nécessaire d'installer une "JAVA virtual machine" (compatible avec la "SUN JAVA virtual machine v1.6") pour pouvoir faire fonctionner l'interface de TIMi. Par défaut, le logiciel d'installation de TIMi installe aussi quelques petits datasets de test ("Census- Income", "bodyweight", "wine", ) dans le répertoire "{Mes Documents}\TIMi\DATASETS". 1.1. Drivers OleDB & Liens ODBC Pour pouvoir exploiter dans TIMi les datasets créés à l aide de SAS (fichier.sas7bdat), il est nécessaire d installer le pilote OleDB de SAS. Une copie de ce pilote est disponible ici : http://www.anatella.com/downloads/sasoledb.zip Le pilote OleDB de SAS est aussi disponible sur le siteweb de SAS : Plus précisément : Sur cette page : http://support.sas.com/demosdownloads/setupintro.jsp cliquez sur "SAS Providers for OLE DB". Pour pouvoir exploiter dans TIMi les datasets stockés dans votre base de données relationnelle, il est nécessaire de : 1. Installer le pilote ODBC de votre base de données. Par exemple : o Teradata Le driver ODBC pour Teradata est disponible ici : http://downloads.teradata.com/download/connectivity/odbc-driver/windows Pour votre plus grand confort une copie du driver ODBC pour Teradata est aussi disponible ici : http://www.anatella.com/downloads/tdodbc WINDOWS_i386.13.10.00.01.zip o MySQL Le driver ODBC pour MySQL est disponible ici : http://dev.mysql.com/downloads/connector/odbc/ Pour votre plus grand confort une copie du driver ODBC pour MySQL est aussi disponible ici : http://www.anatella.com/downloads/mysql-connector-odbc-5.1.6- win32.msi
Page 3 of 20 2. Configurer les liens ODBC. Chaque utilisateur peut avoir des liens ODBC différents qui autorisent des niveaux d accès différents à la base de données. Les liens ODBC sont configurés à l aide du logiciel "Gestionnaire Microsoft ODBC" disponible dans le panneau de contrôle de Windows. Voici une capture d écran du "Gestionnaire Microsoft ODBC": Pour plus d information, veuillez-vous référer à la documentation de MSWindows relative aux liens ODBC et à la documentation relative aux liens ODBC de votre base de données. 1.2. Excel Plug-in La procédure pour installer le plug-in dans MSExcel est : 1. Ouvrir les options de MSExcel : cliquer sur "File" et ensuite sur Options :.
Page 4 of 20 2. Ouvrir le gestionnaire de sécurité : cliquer sur "Trust Center" et sélectionner "Trust Center Settings" : 3. Trouver le répertoire contenant les fichiers approuvés comme étant sécurisé : typiquement, il s agit de "C:\Program Files\Microsoft Office\Templates\" :
Page 5 of 20 4. Copier dans le répertoire sécurisé (tel que trouvé à l étape précédente), le fichier contenant les macros de TIMi à installer dans MSExcel. Typiquement, il s agit de copier le fichier "C:\Program Files\TIMi\bin\aggregate_modality_TIMi_excel_macro.xlam" dans le répertoire "C:\Program Files\Microsoft Office\Templates\". 5. Dans le panneau des options de MSExcel (Cliquez sur "File" et ensuite sur "Options" pour obtenir ce panneau), cliquez sur "Add-Ins" et sur le bouton "Go" : 6. Dans le gestionnaire de d Add-Ins, cliquer sur le bouton "Browse" et sélectionnez le fichier "aggregate_modality_timi_excel_macro.xlam" qui se trouve dans le répertoire sécurisé (typiquement "C:\Program Files\Microsoft Office\Templates\"). Vous devriez maintenant avoir :
Page 6 of 20 Cliquez sur le bouton "Ok". 7. Dans le panneau des options de MSExcel (Cliquez sur "File" et ensuite sur "Options" pour obtenir ce panneau), cliquez sur "Quick Access Toolbar" et sélectionnez "Macros" dans la combobox "Chose commands from" :
Page 7 of 20 8. Sélectionnez une à une les 3 macros de TIMi ("assign_aggregate_keys", "aggregate_modality", "undo_aggregate_modality") et cliquez sur le bouton"add" pour les ajouter à la "Quick Access Toolbar". Vous devriez obtenir : Cliquez sur le bouton "Ok". 9. Le Plugin MSExcel de TIMi est installé correctement lorsque vous pouvez voir les 3 icones ("assign_aggregate_keys", "aggregate_modality", "undo_aggregate_modality") dans la "Quick Access Toolbar" de MSExcel :
Page 8 of 20 2. Configuration Minimale du gestionnaire d utilisateurs Le gestionnaire d utilisateurs de TIMi (aussi appelé «AMS» : «Account Management System») n est disponible que sur la version serveur de TIMi (et non sur la version "poste client" de TIMi). C est le "serial number" de TIMi qui décide quelle version de TIMi (serveur ou poste client) est installée. La version serveur de TIMi refusera de fonctionner tant que le gestionnaire d utilisateurs n est pas proprement configuré. Par exemple, à l exécution de Stardust, vous obtenez le message suivant : Toutes les informations relatives à la gestion des utilisateurs (en d autres termes toutes les données de l «Account Management System» sont regroupées dans un seul fichier nommé «main.timiams» (aussi appelé le "Credential file"). A chaque exécution, TIMi authentifie l utilisateur en cours en consultant le fichier «main.timiams». Ce fichier doit donc être disponible (ou accessible) sur toutes les machines sur lesquelles la version serveur de TIMi est installée. Vous pouvez éditer le fichier «main.timiams» grâce au gestionnaire d utilisateurs de TIMi. Cet outil n est pas installé à l aide de l installateur standard (i.e. le programme "TIMiSetup.exe") car il est personnalisé pour chaque client. Vous pouvez télécharger le gestionnaire d utilisateurs de TIMi ici: http://demouser:telecharger@www.business-insight.com/tim/amsmanager_bouygues.zip Si le lien ci-dessus ne marche pas, essayez celui-ci: http://www.business-insight.com/tim/amsmanager_bouygues.zip Si une fenêtre apparaît lors du téléchargement, utilisez: login: demouser password: telecharger Il est suggéré de décompresser l archive du gestionnaire d utilisateurs dans un répertoire accessible uniquement à l administrateur système. Pour plus de sécurité, le gestionnaire d utilisateur refusera de fonctionner pour les utilisateurs sans les droits systèmes suffisants. Exécutez le gestionnaire d utilisateurs (cliquez sur ok pour faire disparaitre le message d avertissement), ouvrez le panel "License & Environnement" et entrez les informations de licence reçue : par exemple :
Page 9 of 20 Après avoir rentré le "Registration name" et le "Serial Number", cliquez sur le bouton "Save License Infos in Registry" : Nous devons maintenant créer le fichier «main.timiams» contenant toutes les informations relatives à la gestion des utilisateurs. Cliquez sur "Save Credential File" : et sauvez le fichier «main.timiams» dans un répertoire accessible à TOUS les utilisateurs de TIMi (ce répertoire doit être accessible en lecture à tous les utilisateurs de TIMi sur le serveur). Cliquez ensuite sur le bouton "Set As Active Credential File on this PC". La procédure minimale d installation et de configuration de la version serveur de la TIMi Suite est maintenant terminée. Dès maintenant, il est déjà possible d utiliser TIMi, Stardust & Anatella. 3. Configuration Avancée du gestionnaire d utilisateurs Exécutez le gestionnaire d utilisateurs, sélectionnez le panel "General" et cliquez sur "Enable Advanced Credential Management". Dans le gestionnaire d utilisateurs, l expression «system account» désigne un compte windows. Par exemple, l option «Deny access to the following system accounts» désigne une liste de login windows qui ne pourront pas être employés pour utiliser TIMi. Il est conseillé (mais pas obligatoire) d utiliser comme login dans TIMi des "Interactive Users" et des "Applicative Users", les même logins que les "system account" du serveur. De cette façon, l option "Deny interactive access to system accounts that matches the name of an applicative user et l option Deny applicative access to system accounts that matches the name of an interactive user fonctionneront de manière optimale.
Page 10 of 20 Les utilisateurs sont répartis en 2 groupes : utilisateurs interactifs, compte applicatifs : Il est interdit d utiliser TIMi à partir des acomptes systèmes guest, administrator, etc. qui ne présentent pas les garanties de sécurité satisfaisantes. Vous pouvez empêcher les comptes applicatifs d utiliser des connections interactives (c est configurable à l aide de la case à cocher visible ici : ). Pour ajouter de nouveaux utilisateurs interactifs à la TIMi Suite, cliquez ici : Ajoutez tous les utilisateurs requis et ensuite cliquez sur le bouton "Save Credential File", ici sauver vos changements., pour Attention! Les logins sont case-sensitive.
Page 11 of 20 Attention! Il est nécessaire de cliquer sur le bouton "Save Credential File" pour que les changements effectués soient pris en compte (et cela est valable quel que soit les changements effectués dans le gestionnaire d utilisateurs. Avant chaque utilisation de la TIMi Suite, l utilisateur doit s identifier grâce au logiciel "TIMi Login- Logout". Voici une capture d écran du logiciel "TIMi Login-Logout" : La première fois qu un utilisateur de TIMi désire utiliser TIMi, il rentre uniquement son Login. Le logiciel détecte que l utilisateur doit définir son mot de passe et affiche l écran de définition de mot de passe : Dans ce cas de figure, le mot de passe "précédent" est inexistant. Il ne faut donc pas le donner.
Page 12 of 20 Une fois l utilisateur identifié et authentifié avec un mot de passe, nous accédons à cet écran : Vous remarquerez qu il y a un «automatic logoff» après 162 minutes (ce délai est configurable sur le panel «General» du gestionnaire d utilisateurs) Pour pouvoir utiliser TIMi en mode non-interactif à l intérieur d un script batch par exemple, il est aussi possible d utiliser l outil de login en ligne de commande: Par exemple, la commande suivante : timilogin <applicative_login> <password> permet d identifier l utilisateur applicatif ayant le login <applicative_login> sur le serveur. Sur la ligne de commande, vous pouvez uniquement identifier les comptes applicatifs. Vous pouvez définir de nouveaux comptes applicatifs dans le panel «Applicative Account» : Il est possible de créer des comptes applicatifs différents, pour les différentes étapes de la mise en production : production et préproduction.
Page 13 of 20 Typiquement, la «TIMi suite» accède aux données via des connections de type ODBC (ou OleDB). Ces connections ODBC nécessitent des logins et mots de passes qui sont séparés des logins et mots de passes du système Windows ou de la TIMi suite : par exemple, pour définir une nouvelle connection ODBC dans Anatella on aura: L administrateur système peut donc décider de mettre à disposition de chaque analyste des connections ODBC différentes, associées à des données différentes, en fonction de leur sensibilité. Chaque utilisateur peut, à tout moment, changer son mot de passe en cliquant ici :
Page 14 of 20 l administrateur peut aussi imposer un mot de passe en cliquant ici : Les paramètres d accès sont définis par l administrateur grâce aux «cases à cocher ici» : Ces paramètres sont : accès (ou non) à TIMi, Anatella, Stardust ; accès (ou non) en lecture aux bases de données (teradata, sqlserver, etc.); accès (ou non) en écriture aux bases de données. TIMi vérifie que les mots de passes ne sont pas triviaux : les mots de passes doivent être constitués d au moins 8 caractères qui combinent au moins des lettres majuscules et minuscules ainsi que des chiffres et des caractères spéciaux ou accentués. Les utilisateurs doivent changer leur mot de passe à intervalle paramétrable par l administrateur. Pour activer la création des fichiers logs, cliquez ici : Ensuite, sélectionnez les répertoires qui contiendront les fichiers logs. Ces répertoires doivent être accessibles en écriture à tous les utilisateurs de TIMi sur le serveur.
Page 15 of 20 Lorsque le système de logging est activé, chaque utilisation de TIMi donne lieu à une trace dans les fichiers de logs. Ces fichiers logs permettent de remonter la "bonne alerte" à l'exploitant pour qu'il puisse identifier de manière précise les actions à effectuer pour retour au mode nominal. La finalité n'est pas de tracer l'activité des utilisateurs. Les fichiers logs contiennent les informations suivantes : 1. <date> est la date de production du message, au format «mmm jj HH:MM:SS». 2. <host> est le nom de la machine qui a produit le message. 3. <prog> est le nom de l exécutable qui a produit le message. 4. <pid> est le numéro de processus qui a produit le message. 5. <user> est le nom de l utilisateur au nom duquel le process qui a produit le message est exécuté. 6. <sév.> est la sévérité du message, il existe 8 sévérités différentes : EMERG, ALERT, CRIT, ERROR, WARNING, NOTICE, INFO, DEBUG 7. <func> est le nom de la fonction qui a produit le message. 8. <appli> est le code du système applicatif concerné (sur 3 caractères). 9. <code> est le code identifiant le message de manière unique pour l application dans le dictionnaire des messages. 10. <message> est le libellé du message, Il peut contenir des parties variables, qui seront instanciées lors de l exécution de l API LOGS ARE. 11. Optionnel : <action> est l action corrective associée au message (si elle est présente dans le dictionnaire). Les logs produits par TIMi ont pour objectif de dépanner le système (par exemple : nom du lien ODBC utilisé, paramètres de modélisation, etc.). Ils ne contiennent pas de données sensibles extraites hors de la base de données. L ensemble des traces est centralisé dans deux répertoires (pour plus de facilité, ces répertoires peuvent être des répertoires «distants» sur un serveur central). On peut à tout moment détruire (ou déplacer dans un autre répertoire) les fichiers logs. La purge des répertoires contenant les fichiers logs peut éventuellement être automatisée à l aide de Anatella (voir, par exemple, l action nommée "move files" ) 4. Exploitation nominale 4.1. Remote Desktop Typiquement, on accède à TIMi sur le serveur à l aide de la fonctionnalité "Remote Desktop" de MSWindows. Sur le poste client, ouvrez le "menu démarrer", sélectionnez "Exécuter" et entrez "mstsc" :
Page 16 of 20 Le client "Remote Desktop" de MSWindows se lance : Une fois la connection vers le serveur correctement paramétrée, vous pouvez sauver tous les paramètres de connection dans un petit fichier d extension.rdp (typiquement sauvé sur le bureau). Dorénavant, pour se connecter au serveur, il suffira de double-cliquer le fichier.rdp pour accéder instantanément au serveur. Pour créer le fichier.rdp, cliquez sur le bouton "Options>>", configurez la connection, cliquez sur le bouton "Save" : Pour plus d informations sur la configuration et la gestion du "Remote Desktop" sur le serveur, veuillez-vous référer à la documentation Microsoft. Par défaut, les connections de type Remote Desktop vous permettent d aisément copier des fichiers sur trouvant sur le serveur vers le poste client : Pour ce faire, il suffit d activer sur le poste client l option "partage à distance de mes disque locaux" qui se trouve dans le panneau de configuration du client Remote Desktop, sur le panel "Local Resources", bouton "more", cliquer sur "Drives".
Page 17 of 20 Cette fonctionnalité est bien pratique mais elle peut constituer un "trou de sécurité" car il est possible de recopier en local des fichiers se trouvant sur le serveur. C est pourquoi, il est possible de désactiver cette fonctionnalité sur le serveur : pour plus d informations à ce sujet : http://technet.microsoft.com/fr-fr/library/cc775863%28ws.10%29.aspx (en français) http://technet.microsoft.com/en-us/library/cc775863%28ws.10%29.aspx (en anglais) Les firewalls situés entre les postes clients et le serveur doivent autoriser le passage du protocole RDP (= "Remote Desktop Protocol"). Veuillez contacter le gestionnaire de l infrastructure réseau pour effectuer le paramétrage requis des firewalls. 4.2. Serveur Java Stardust et Anatella sont des logiciels conçus 100% en C++ avec une architecture simple et ne seront pas discuté dans cette section. L architecture de l outil prédictif "TIMi" est plus complexe. Elle est divisée en 3 couches : 1. Couche présentation : réalisée en Java. 2. Couche analytique : le moteur de calcul est réalisé en C++ et en assembleur. 3. Couche reporting : la génération des rapports est effectuée en partie en C++ (par exemple, pour les rapports MSWord ou MSExcel) et en Java (par exemple, pour les rapports au format.html). Chaque couche communique avec la couche suivante grâce à des fichiers XML écris dans le répertoire de travail. Pour que l interface de TIMi reste rapide et réactive, nous avons réalisé la couche présentation sous la forme d un serveur Java (et non d une simple application Java). Le serveur java reste en permanence actif en RAM et permet d afficher instantanément les différentes fenêtres de configuration de TIMi. Il existe un serveur java qui tourne pour chaque utilisateur différent de TIMi sur le serveur. Ce serveur se lance de façon transparente lorsque l utilisateur demande pour la première fois l affichage d une fenêtre de l interface de TIMi. Après une très longue période d inactivité, il peut arriver que le serveur java "freeze" : Plus aucune fenêtre de l interface de TIMi ne s affiche. Pas de soucis : il suffit de forcer l arrêt du serveur java. Après un arrêt forcé du serveur, lorsque l utilisateur demandera de nouveau à voir une fenêtre de l interface de TIMi, un nouveau serveur 100% opérationnel se lancera automatiquement et de façon transparente. Nous travaillons actuellement à produire une nouvelle version de l interface de TIMi qui est 100% en C++. Cette nouvelle version ne présentera plus cette limitation qui est due à Java.
Page 18 of 20 Pour forcer l arrêt du serveur java: 1. Ouvrir le "Gestionnaire des tâches" de MSWindows : typiquement on appuie sur CTRL+ALT+DEL et on sélectionne "Démarrer le Gestionnaire des tâches". 2. Sur le panneau "Processus", sélectionnez (cliquez sur) le processus appelé "javaw.exe" 3. Cliquer sur le bouton "End Process" et confirmer votre choix dans la fenêtre pop-up. Vous pouvez à tout moment forcer l arrêt du serveur java sans perdre les calculs effectués par le moteur analytique de TIMi. Lorsque le serveur java s arrête, les calculs continuent sans soucis (ces calculs sont effectués dans un autre processus que "javaw.exe" : Les processus de calcul sont nommés "timm.exe" ou "timu.exe"). 4.3. Répertoire Temporaire TIMi et Stardust ne créent aucun fichier temporaire volumineux. (tout au plus existe-t-il de tous petits fichiers XML de configuration). Anatella, par contre, génère des fichiers temporaires (nommés "HD Cache Files") qui peuvent parfois être très volumineux. Par défaut, ces fichiers temporaires sont sauvés dans le répertoire temporaire de chaque utilisateur Windows. Il est intéressant de changer ce répertoire temporaire vers une partition séparée de la partition système car, habituellement, cette partition devient très rapidement très fragmentée (et donc très lente). Chaque utilisateur de Anatella doit avoir un répertoire temporaire différent (sinon il est possible d avoir des "collisions" entre plusieurs copie de Anatella qui tournent en même temps et qui veulent toutes écrire dans le même fichier"). Vous pouvez purger, à intervalle régulier, les répertoires temporaires (par exemple en enlevant, avec Anatella, les fichiers qui sont vieux de plusieurs jours).
Page 19 of 20 Pour changer le répertoire temporaire de Windows, il faut changer les variables d environnement TMP et TEMP (utilisateur par utilisateur). Par exemple : Pour changer, dans Anatella, le répertoire temporaire du graphe de transformation en cours de développement (et uniquement de ce graphe): Sélectionnez dans le menu déroulant "Edit", l option "Graph Global Parameters". Vous pouvez changer le répertoire temporaire ici :
Page 20 of 20 L utilisateur d Anatella peut, à tout moment, demander une purge manuelle des fichiers temporaires créés par Anatella. Pour purger les fichiers temporaires, cliquez ici: ou ici:.