Installation et paramétrage d’un serveur Vigilens web

Ce type d’installation correspond à l’installation d’un serveur Web permettant d’exécuter des requêtes Vigilens depuis un navigateur Web ou d’appeler ces requêtes depuis une application tierce (requêtage http depuis MS Excel, tâche de menu dans ORACLE JD Edwards EnterpriseOne, …).

En plus du composant Web, ce serveur possèdera toutes les caractéristiques de l’installation d’un poste Vigilens (tel que décrit dans le paragraphe 2) et pourra donc tout à fait servir de serveur d’applications pour la suite Vigilens.

Même chose que pour l'installation du poste simple, avec les mêmes remarques.

Vous pouvez choisir d’installer (ou non) les différentes applications Windows de La Vigilens Tools Suite . Le serveur pourra ainsi (éventuellement) servir de serveur d’application.

Le composant Vigilens Web nécessite un serveur PHP. Cet écran vous permet de choisir entre :

• Installer un nouveau serveur EasyPHP : Installation d’EasyPHP 5.3.2 (fourni avec Vigilens)
• Installer dans un serveur Apache existant : Vigilens utilisera une architecture WAMP précédemment installée sur le serveur. La version doit correspondre à celle d’EasyPHP 5.3.2 ou supérieure)
• Mettre à jour une installation existante de Vigilens WEB : Cette option permet de réinstaller Vigilens sans réinstaller le serveur PHP.

Sélection du dossier d’installation d’EasyPHP

Pour utiliser une architecture WAMP existante, vous devez préciser les dossiers contenant les pages Web, le fichier php.ini et le fichier httpd.conf.

Sélection du dossier contenant les pages Web.

Un serveur Vigilens Web étant un poste Vigilens comme les autres, la section paramétrage de Installation et paramétrage d’un poste Vigilens s’applique aussi à ce cas de figure (notamment en ce qui concerne les sources de données).

Les prochaines sections concernent les étapes additionnelles nécessaires pour un serveur Vigilens Web.

PHP utilise par défaut le port 80. Si ce port est utilisé par une autre application (logiciel de messagerie instantanée, par exemple), Apache affichera une erreur indiquant que le port est utilisé. Il pourra alors s’avérer nécessaire de modifier la configuration d’Apache afin qu’il utilise un autre port.

Pour ce faire :

• Faire un clic droit sur l’icône EasyPHP disponible dans la zone de notification de la barre de tâches.
• Choisir « Configuration » puis « Apache », ce qui ouvre le fichier « httpd.conf »

• Rechercher la ligne commençant par Listen.
  • Par défaut, il doit s’agir de la ligne Listen 127.0.0.1:80.
  • Modifier la ligne de façon à remplacer 80 par le numéro de port désiré
  • exemple Listen 127.0.0.1:8080

• Rechercher la ligne commençant par ServerName.
  • Par défaut, il doit s’agir de la ligne ServerName localhost:80.
  • Modifier la ligne de façon à remplacer 80 par le numéro de port désiré
  • exemple ServerName localhost:8080

• Enregistrer le fichier
• Faire un double-clic droit sur l’icône EasyPHP disponible dans la zone de notification de la barre de tâches.
  • Cliquer sur « Apache » pour redémarrer ce serveur.
  • Apache utilisera alors le nouveau port, dans l’exemple, le port 8080.

L’installation crée un sous-groupe de programmes « Web » (dans le groupe de programmes correspondant à Vigilens). Il contient deux raccourcis :

• Restart Service : cette application permet de relancer le service « Service Vigilens Web » si le service a été arrêté ou si des modifications de configuration doivent être prises en compte.
• WebConfig : cette application permet de personnaliser l’interface de Vigilens Web et de modifier certaines options de configuration.

Lancer WebConfig. À la première utilisation, il est nécessaire de saisir le répertoire défini lors de l’installation de type Administrateur.

Cette application est accessible à l’utilisateur « Admin » et aux utilisateurs auxquels le droit d’accès a été donné dans l’application AdminTool (voir les restrictions de droits pour les groupes et les utilisateurs.

L’application dispose de six onglets :

Cet onglet permet de modifier la langue par défaut, la taille initiale des colonnes ainsi que la liste des choix possibles concernant le nombre d’enregistrements affichés sur chaque page. Les modifications apportées à ces valeurs prennent effet après rafraîchissement de la page Web.

Cet onglet permet de modifier les images affichées en entête et en bas de page. Les modifications apportées à ces valeurs prennent effet après rafraîchissement de la page Web.

Les informations contenues dans cet onglet sont relatives au fonctionnement du service « Service Vigilens Web ». Il est fortement recommander de ne pas modifier ces valeurs, sauf cas spécifique.

Cet onglet permet de modifier les données suivantes :

• Calendrier – Premier jour de la semaine : Il s’agit du mode d’affichage de l’assistant calendrier
• Traçage : Possibilité de tracer dans un fichier (choisi par l’utilisateur) les informations transitant entre les pages Web et le moteur Vigilens.

• Service Vigilens Web : Par défaut le service est exécuté avec le compte système local de la machine. Dans certains cas, ce compte ne peut être utilisé. Il est alors possible de modifier le compte à utiliser dans cet onglet. La modification du compte n’est prise en compte qu’après redémarrage du service avec le raccourci « Restart Service ».

• Timeout :
  • Pour la première valeur, il s’agit du nombre de minutes entre la fermeture de toutes les fenêtres Web correspondant à un utilisateur Vigilens et la suppression de la connexion correspondant à cet utilisateur.
  • Pour la seconde, il s’agit du nombre de minutes depuis la dernière activité sur une requête

• Volume de données : Il s’agit du nombre de lignes à partir duquel la requête s’arrête et renvoie un message d’erreur. Ce paramétrage permet de sécuriser le risque de saturation de mémoire du navigateur ou du serveur en cas de volume de données important.
  • La première valeur concerne les restitutions vers un affichage écran de type grille
  • la seconde concerne les restitutions vers un fichier.

Cet onglet permet d’ajouter les domaines susceptibles d’être utilisés dans le cadre de Vigilens Monitor.

Le serveur web doit être défini comme un site de confiance afin d’autoriser l’exécution sans message d’avertissement systématique. Il est également nécessaire de demander l’autorisation de téléchargement des fichiers afin de gérer les restitutions directement sous forme de fichier.

Exemple pour le navigateur MS Internet Explorer :

Le mode habituel d’exécution de l’application se fait via le lancement d’une liste de requêtes en utilisant le lien suivant : http://serveur/vigilens où serveur correspond au nom ou à l’adresse IP du serveur Web).

Si le port a été redéfini au niveau de PHP, il doit être spécifié dans le lien, http://serveur:8080/vigilens, par exemple.

Lors de l’exécution d’une requête, le résultat : grille ou fichier (PDF, Excel…) dépend de ce qui a été spécifié dans Restitution en mode interactif lors de la création de la requête.

Un lancement unitaire est également possible via le lien suivant : http://serveur/vigilens/table.php?vglCtrlName=nomRequete. Voir la page dédiée à la syntaxe des URL

Vigilens Web accède au moteur Vigilens via DCOM. C’est le service Vigilens Web qui active le composant DCOM (processus VigilensSrv.exe). Le composant DCOM est donc exécuté avec l’utilisateur servant à se connecter au service Vigilens Web. Par défaut, il s’agit du compte système local de la machine.

Or le composant DCOM doit avoir accès au répertoire partagé de Vigilens. Ceci ne pose pas de problème dans le cas où le répertoire partagé est situé sur le serveur Web.

Dans le cas contraire, le composant DCOM, s’il est exécuté avec le compte système local de la machine, n’aura pas accès au répertoire partagé (situé sur un autre serveur). Il est alors nécessaire de modifier le compte utilisé pour se connecter au service Vigilens Web (Onglet « Paramètres avancés » de l’application WebConfig).

Pour pouvoir activer le composant DCOM, il faut que l’utilisateur servant à se connecter au service Vigilens Web ait l’autorisation d’exécution et d’activation pour ce composant. Dans le cas où il s’agit du compte système local de la machine, ceci ne pose pas de problème. Dans le cas où il s’agit d’un autre compte, il faut s’assurer qu’il dispose bien de l’autorisation d’activer le composant DCOM. Pour

ce faire, il faut :

• Ouvrir l’interface de gestion de services des composants (raccourci « Services de composants » dans le groupe « Outils d’administration » du panneau de configuration)
• Développer l’arborescence : Services de composants \ Ordinateurs \ Poste de travail \ Configuration DCOM
• Sous cette arborescence effectuer un clic droit sur le composant nommé « Evidens.DataCtrlDoc » et sélectionner le menu « Propriétés ».
• Dans l’onglet « Sécurité », dans le pavé « Autorisations d’exécution et d’activation », sélectionner « Personnaliser » et cliquer sur le bouton [Modifier]
• Dans la boite de dialogue qui s’affiche, sélectionner le compte servant à se connecter au service Vigilens Web, et cocher les 4 cases à cocher « Autoriser », puis valider toutes les boites de dialogues.

Pour pouvoir utiliser Vigilens Web, il faut que PHP soit démarré sur le serveur Web. Pour éviter d’éventuels problème en cas d’ouverture / fermeture de sessions sur le serveur Web, il peut être intéressant de modifier le mode de lancement de PHP de façon à ce que les serveurs soient lancés en tant que services.

Dans le cas d’EasyPHP, en effectuant un clic droit sur le bouton [Apache], et en sélectionnant le menu « Configuration \ EasyPHP », on accède à différentes options, notamment : Démarrer les serveurs en tant que service.

Pour les serveurs n’utilisant pas EasyPHP, il faut vérifier les points suivants :

• L’extension « mbstring » doit être installée.
• Il est nécessaire que la valeur « date.timezone » de la section [Date] du fichier « php.ini » soit définie (par exemple : [Date] date.timezone = Europe/Paris).

Se reporter à la section mise à jour du poste Vigilens.