(pour utilisateurs avancés)
Le logiciel de pilotage du matériel est composé de 3 parties
- Un script Visual Basic, qui gère le démarrage et re-démarrage du Device Drivers Manager
- Le "Device Drivers Manager", qui est une application java permettant de démarrer l'Agent de pilotage du matériel au moment où l'utilisateur se connecte à SecuTix.
- L'Agent de pilotage du matériel (Device Drivers Agent), qui permet l'utilisation des imprimantes, terminaux de paiements, ...
Résumé du processus de démarrage
- L'utilisateur se connecte sur le poste de travail
- Un raccourcis situé dans le sous-menu "startup" du menu "Démarrer" démarre le script Visual Basic
- Le script Visual Basic démarre le manager
- L'utilisateur se connecte à SecuTix
- SecuTix se connecte au manager
- Le manager démarre l'Agent correspondant à l'environnement
- SecuTix se connecte à l'agent
- L'impression est disponible
Les logs sont dans le répertoire utilisateur, p.ex. c:\users\sca\secutix\devicedrivers\logs
Le script Visual Basic
Le script (devicedrivers-agent-manager.vbs) contrôle l'exécution du Manager. Le script vérifie chaque minute si le Manager est démarré, et va le démarrer si il nécessaire.
Il est situé soit dans le répertoire deviceDriversManager du kit Firefox, ou dans le répertoire d'installation si le logiciel d'installation Secutix.DeviceDrivers.Manager.Installer.exe a été utilisé.
Ce répertoire contient également les scriptes suivants:
- start-devicedrivers-agent-manager.bat, permet de manuellement démarrer le script dans une fenêtre de terminal
- stop-devicedrivers-agent-manager.bat, permet d'arrêter le script, le Manager et l'Agent
- restart-devicedrivers-agent-manager.bat, permet d'arrêter le Manager et l'Agent (qui seront redémarrés par le script - l'icône de la barre des tâches peut aussi être utilisée)
Le script est démarré automatiquement lorsque l'utilisateur se connecte sur le poste de travail via un raccourcis présent dans le sous-menu "Startup" du menu "Démarrer".
Il s'exécute dans un processus cscript.exe.
Le script détecte la version de java à utiliser de la manière suivante:
- Java spécifié dans la base de registre
HKEY_CURRENT_USER\SOFTWARE\SecuTix\DeviceDriversManager\JavaExe
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SecuTix\DeviceDriversManager\JavaExe - Javaw.exe situé dans le répertoire <répertoire du script>\java\bin\
- Javaw.exe situé dans le répertoire <répertoire du script>\..\CommonFiles\java\bin\
- 1er javaw.exe trouvé dans les répertoires spécifiés dans la variable d'environnement PATH
Le Device Drivers Manager
Le manager est l'application java qui démarre l'Agent correspondant à l'environnement utilisé (production, pré-production, ...)
Lorsque il est démarré, une icône apparaît dans la barre de notifications.
Cette icône permet
- De visualiser les numéro de versions (option About)
- De visualiser le nombre de connections établies depuis le navigateur
- D'accéder aux logs (option Logs)
- De fermer le Manager et l'Agent (option Exit). Le manager sera redémarré par le script Visual Basic
Lorsque l'utilisateur se connecte sur SecuTix, le navigateur va se connecter au manager en utilisant une WebSocket (port tcp 8555) et lui transmettre les informations permettant de démarrer l'Agent.
Pour des raisons de sécurité, le manager vérifie l'adresse du site web transmis par le navigateur avant de démarrer l'application.
Le manager démarre l'agent en utilisant l'exécutable javaws situé dans le même répertoire que le javaw.exe utilisé pour exécuter le Manager.
L'archive (.jar) contenant le manager est située dans le même répertoire que le script Visual Basic.
Une information est affichée à l'utilisateur si le manager n'est plus à jour, demandant à l'utilisateur d'installer un nouveau kit.
Le device Drivers Agent
L'agent est l'application java qui accède au matériel.
Lorsque l'utilisateur se connecte sur SecuTix, le navigateur va se connecter à l'Agent utilisant une WebSocket (port tcp spécifique à chaque environnement).
Une fois la connexion effectuée, l'icône de l'impression change de en
L'agent s'exécute dans un processus jp2launcher.exe, qui télécharge les mises à jour depuis le site secutix.com
Une information est affichée à l'utilisateur si l'agent n'est plus à jour, demandant à l'utilisateur de redémarrer l'application à l'aide de l'icône de la barre de notification.
Dépannage
Vérifier que: le script Visual Basic est démarré? le manager est démarré? l'agent est démarreé?
Dans une fenêtre msdos, exécutez la commande: wmic process where "commandLine like '%javaw.exe%' or commandLine like '%cscript%' or commandLine like '%jp2launcher%'" get commandLine
Le processus montre les informations suivantes (exemples, les répertoires peuvent changer):
- Indique que le script est démarré: cscript "C:\Users\sca\secutix\Matterhorn_V3\deviceDriversManager\"\devicedrivers-agent-manager.vbs
- Indique que le manager est démarré: "C:\Users\sca\secutix\Matterhorn_V3\CommonFiles\java\bin\javaw.exe" -DpackageVersion=1.0.25 -Xmx32m -jar "C:\Users\sca\secutix\Matterhorn_V3\deviceDriversManager\devicedrivers-agent-manager-1.0-SNAPSHOT-fulljar.jar"
- Indique que l'agent est démarré "C:\Users\sca\secutix\Matterhorn_V3\CommonFiles\java\bin\jp2launcher.exe" -secure -javaws -jre C:\Users\sca\secutix\Matterhorn_V3\CommonFiles\java -vma ...
Si le script Visual Basic n'est pas démarré
- Vérifiez que le lien est bien présent dans le menu "Démarrer". Ouvrez le menu "Démarrer", cliquez sur une icône SecuTix avec le bouton droit de la souris, sélectionnez "Ouvrir le répertoire", allez dans le sous-menu "Startup", une icône "SecuTix DeviceDrivers Manager" doit exister.
Si non, créez le raccourcis(exemple):- Commande: C:\Users\sca\secutix\Matterhorn_V3\deviceDriversManager\SilentCMD.exe cscript.exe C:\Users\sca\secutix\Matterhorn_V3\deviceDriversManager\devicedrivers-agent-manager.vbs
- Répertoire: C:\Users\sca\secutix\Matterhorn_V3\deviceDriversManager
- Icône: C:\Users\sca\secutix\Matterhorn_V3\deviceDriversManager\secutix.ico
- Dans une fenêtre de terminal, essayez de démarrer le programme "start-devicedrivers-agent-manager.bat". Le script peut afficher un message d'erreur
Si le manager n'est pas démarré
- Arrêtez le script à l'aide du script stop-devicedrivers-agent-manager.bat
- Dans une fenêtre de terminal, essayez de démarrer le programme "start-devicedrivers-agent-manager.bat". Le script indique quelle version de java et quel jar va être utilisé pour démarrer le manager.
- Vérifiez si les logs contiennent des erreurs, p.ex. "manager-2016-11-14.log".
Si l'agent n'est pas démarré
- Vérifiez si les logs contiennent des erreurs, p.ex. "manager-2016-11-14.log" ou "devicedriver-agent-2016-11-14.log".
Vérifier que: Firefox essaie bien de se connecter au manager et à l'agent
Ouvrez la console de logs de firefox (Menu -> Developers -> Browser Console)
Indique une tentative de connexion vers le manager (port 8555, /devicedrivers/)
Indique une tentative de connexion vers l'agent (port autre que 8555, /printing/)
Vérifiez que: les certificats sont bien installés
Dans le navigateur, connectez vous à l'url https://127.0.0.1:8555. Une page blanche doit s'ouvrir (pas d'erreur affichée)
Si, dans le cas d'une installation séparée de firefox une erreur de certificat apparaît, ajoutez le certificat dans firefox