meta data for this page
Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
en:v8_0_0:installation:installationweb [2020/07/28 14:01] sylvainair [Setting up the web component] |
en:v8_0_0:installation:installationweb [2021/02/01 15:35] (current) sylvainair |
||
---|---|---|---|
Line 7: | Line 7: | ||
===== Execution of installation ===== | ===== Execution of installation ===== | ||
- | |||
==== Language selection ==== | ==== Language selection ==== | ||
+ | {{:en:v8_0_0:installation:pasted:20210201-150154.png?nolink&300}} | ||
- | {{:v8_0_0:installation:pasted:20200706-163328.png?nolink}} | ||
==== Select an installation directory ==== | ==== Select an installation directory ==== | ||
- | [[:en:v8_0_0:installation:installationposte#Select an installation directory|Selection of the installation folderSame as for the installation of the single workstation.]], and same remarks. | + | [[:en:v8_0_0:installation:installationposte#Select an installation directory|Selection of the installation folder]] Same as for the installation of the single workstation, and same remarks. |
==== Select components to be installed ==== | ==== Select components to be installed ==== | ||
- | {{:v8_0_0:installation:pasted:20200707-085016.png?nolink}} | + | {{:en:v8_0_0:installation:pasted:20210201-150801.png?nolink}} |
You can choose to install (or not) the various Windows applications making the [[:en:start#vigilens_tools_suite|Vigilens Tools Suite]]. The server can thus (possibly) serve as an application server. | You can choose to install (or not) the various Windows applications making the [[:en:start#vigilens_tools_suite|Vigilens Tools Suite]]. The server can thus (possibly) serve as an application server. | ||
Line 25: | Line 24: | ||
</WRAP> | </WRAP> | ||
+ | ==== Installation of the PostgreSQL database ==== | ||
+ | {{:en:v8_0_0:installation:pasted:20210201-152602.png?nolink}} | ||
- | ==== PHP server installaiton==== | + | * Listening Port: Network port used by the database to listen for incoming queries. The default value is 5432, which is the default PostgreSQL port. |
- | + | * Administrator Name: Name of the user who will be the administrator of this database. | |
- | {{:v8_0_0:installation:pasted:20200706-164221.png?nolink}} | + | * Administrator Password: Password to be used to connect to the PostgreSQL database.\\ A default password is randomly generated at each installation. You can either use the one generated or specify one that suits you. |
- | + | ||
- | The Vigilens Web component requires a PHP server. This screen allows you to choose between : | + | |
- | * ''Installing a new EasyPHP server'' : Installation of EasyPHP 5.3.2 (supplied with Vigilens) | + | |
- | * ''Installing in an existing Apache server'' : Vigilens will use a WAMP architecture previously installed on the server. **Version must match EasyPHP 5.3.2** or higher) | + | |
- | * ''Update an existing installation of Vigilens WEB'' : This option allows you to reinstall Vigilens without reinstalling the PHP server. | + | |
- | + | ||
- | <WRAP round alert> | + | |
- | The installation of Vigilens may require the modification of the php.ini and httpd.conf files. | + | |
- | If this is the case, a backup copy is then created under the name: php.ini.vigi_backup and httpd.conf.vigi_backup.</WRAP> | + | |
- | + | ||
- | === Installing a new PHP server === | + | |
- | {{:v8_0_0:installation:pasted:20200707-085347.png?nolink}} | + | |
- | + | ||
- | Selecting the EasyPHP installation folder | + | |
- | + | ||
- | === Installing in an existing Apache server === | + | |
- | + | ||
- | {{:v8_0_0:installation:pasted:20200707-085427.png}} | + | |
- | + | ||
- | To use an existing WAMP architecture, you must specify the folders containing the web pages, the php.ini file and the httpd.conf file. | + | |
- | + | ||
- | <WRAP round info> | + | |
- | On some platforms several of these folders may be identical. | + | |
- | </WRAP> | + | |
- | + | ||
- | + | ||
- | === Update an existing installation of Vigilens WEB === | + | |
- | {{:v8_0_0:installation:pasted:20200707-085629.png?nolink}} | + | |
- | + | ||
- | Select the folder containing the web pages. | + | |
- | + | ||
- | <WRAP round info> | + | |
- | Usually this value will be initialized based on what was entered during previous installations. | + | |
- | </WRAP> | + | |
=== Chosen options summary === | === Chosen options summary === | ||
- | + | {{:en:v8_0_0:installation:pasted:20210201-153027.png?nolink}} | |
- | {{:v8_0_0:installation:pasted:20200707-085726.png?nolink}} | + | |
===== Setup ===== | ===== Setup ===== | ||
==== General ==== | ==== General ==== | ||
- | A Vigilens Web server is a Vigilens station like any other Vigilens station, [[:en:v8_0_0:installation:installationposte#setup|setup section]] of [[v8_0_0:installation:installationposte|]] also applies to this case (especially with regard to data sources). | + | A Vigilens Web server is a Vigilens station like any other Vigilens station, [[:en:v8_0_0:installation:installationposte#setup|setup section]] of [[:en:v8_0_0:installation:installationposte|]] also applies to this case (especially with regard to data sources). |
The next sections deal with the additional steps required for a Vigilens Web server. | The next sections deal with the additional steps required for a Vigilens Web server. | ||
- | ==== Setting up the PHP server ==== | + | ==== Vigilens Web server settings ==== |
- | + | Web server settings are done from the application [[:en:v8_0_0:webcnfg:start|WebConfig]]. | |
- | PHP uses port 80 by default. If this port is used by another application (such as instant messaging software), Apache will display an error indicating that the port is in use. It may be necessary to change Apache's configuration to use a different port. | + | |
- | + | ||
- | In order to do so: | + | |
- | * Right click on the EasyPHP icon available in the notification area of the taskbar. | + | |
- | * Choose "Configuration" then "Apache", which opens the file "httpd.conf". | + | |
- | + | ||
- | {{:v8_0_0:installation:pasted:20200707-090432.png?nolink}} | + | |
- | + | ||
- | * Look for the line beginning with ''Listen''. | + | |
- | * By default, it must be the line ''Listen 127.0.0.1:80''. | + | |
- | * Change the line to replace ''80'' by the desired port number. | + | |
- | * example ''Listen 127.0.0.1:8080''. | + | |
- | {{:v8_0_0:installation:pasted:20200707-090506.png?nolink}} | + | |
- | + | ||
- | * Find the line beginning with ''ServerName''. | + | |
- | * By default, this must be the ''ServerName localhost:80'' line. | + | |
- | * Modify the line to replace ''80'' with the desired port number | + | |
- | * example ''ServerName localhost:8080'' | + | |
- | + | ||
- | {{:v8_0_0:installation:pasted:20200707-090524.png?nolink}} | + | |
- | + | ||
- | * Save the file | + | |
- | * Right double-click on the EasyPHP icon available in the notification area of the taskbar. | + | |
- | * Click on "Apache" to restart this server. | + | |
- | * Apache will then use the new port, in the example, port 8080. | + | |
- | + | ||
- | {{:v8_0_0:installation:pasted:20200707-090546.png?nolink}} | + | |
- | + | ||
- | <WRAP round alert> | + | |
- | It may also be necessary to configure the firewall to allow access to the Apache server.</WRAP> | + | |
- | + | ||
- | ==== Vigilens Web setup ==== | + | |
- | + | ||
- | The installation creates a subgroup of "Web" programs (in the Vigilens program group ). It contains two shortcuts : | + | |
- | * Restart Service: this application allows you to restart the "Vigilens Web Service" service if the service has been stopped or if configuration modifications have to be taken into account. | + | |
- | * WebConfig: this application allows you to customize the Vigilens Web interface and to modify some configuration options. | + | |
- | + | ||
- | {{:v8_0_0:installation:pasted:20200707-092523.png?nolink&300}} | + | |
- | + | ||
- | === Setting up the web component === | + | |
- | + | ||
- | Launch WebConfig. The first time you use it, you must enter the directory defined during the admin installation. | + | |
- | + | ||
- | {{:v8_0_0:installation:pasted:20200707-091350.png?nolink}} | + | |
- | + | ||
- | This application is accessible to the "Admin" user and to users who have been given access rights in the AdminTool application (see rights restrictions for [[:en:v8_0_0:admintool:menus:gestion:groupe:start#rights_restrictions|groups]] and [[:en:v8_0_0:admintool:menus:gestion:utilisateur:start#rights_restrictions|users]]). | + | |
- | + | ||
- | {{:en:v8_0_0:installation:pasted:20200728-134420.png?nolink}} | + | |
- | + | ||
- | The application has 6 tabs : | + | |
- | + | ||
- | == Global == | + | |
- | + | ||
- | This tab allows you to change the default language, the initial size of the columns as well as the list of possible choices regarding the number of records displayed on each page. Changes made to these values take effect after the web page is refreshed. | + | |
- | + | ||
- | {{:en:v8_0_0:installation:pasted:20200728-134920.png?nolink}} | + | |
- | + | ||
- | == Graphic Customisation == | + | |
- | + | ||
- | This tab allows you to modify the images displayed at the top and bottom of the page. Changes made to these values take effect after the web page is refreshed. | + | |
- | + | ||
- | {{:en:v8_0_0:installation:pasted:20200728-134944.png?nolink}} | + | |
- | + | ||
- | == Server == | + | |
- | + | ||
- | The information contained in this tab is related to the operation of the "Vigilens Web Service" service. It is strongly recommended not to modify these values, except in specific cases. | + | |
- | + | ||
- | {{:en:v8_0_0:installation:pasted:20200728-135035.png?nolink}} | + | |
- | + | ||
- | == Advanced Parameters == | + | |
- | + | ||
- | This tab allows you to modify the following data: | + | |
- | * Calendar - First day of the week: This is the display mode of the calendar wizard. | + | |
- | * Tracing: Possibility to trace in a file (chosen by the user) the information transiting between the Web pages and the Vigilens engine. | + | |
- | <WRAP round important> | + | |
- | lorsque le traçage est activé, les temps de réponses peuvent être dégradés, c’est pourquoi il est recommandé de n’utiliser cette option que ponctuellement, en cas de problème. | + | |
- | </WRAP> | + | |
- | + | ||
- | * Web Vigilens Service: By default the service is executed with the local system account of the machine. In some cases, this account cannot be used. It is then possible to modify the account to be used in this tab. The modification of the account is only taken into account after restarting the service with the shortcut " Restart Service". | + | |
- | + | ||
- | {{:en:v8_0_0:installation:pasted:20200728-135440.png?nolink}} | + | |
- | + | ||
- | == Limits == | + | |
- | + | ||
- | * Timeout : | + | |
- | * The first value is the number of minutes between the closing of all Web windows corresponding to a Vigilens user and the deletion of the connection corresponding to this user. | + | |
- | * The second value is the number of minutes since the last activity on a request. | + | |
- | <WRAP round important> | + | |
- | it is recommended that this duration should be longer than the execution time of the requests | + | |
- | </WRAP> | + | |
- | * Data volume: This is the number of rows at which the query stops and returns an error message. This setting is used to secure the risk of memory saturation of the browser or server in the event of a large volume of data. | + | |
- | * The first value concerns the output to a grid screen display. | + | |
- | * the second one is for file outputs. | + | |
- | + | ||
- | {{:en:v8_0_0:installation:pasted:20200728-135657.png?nolink}} | + | |
- | + | ||
- | == HTTP access== | + | |
- | + | ||
- | This tab allows you to add domains that can be used in Vigilens Monitor. | + | |
- | + | ||
- | {{:en:v8_0_0:installation:pasted:20200728-140101.png?nolink}} | + | |
- | === Information Importantes === | + | |
- | == Prérequis du navigateur == | + | |
- | + | ||
- | 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 : | + | |
- | + | ||
- | {{:v8_0_0:installation:pasted:20200707-093849.png?nolink}} | + | |
- | + | ||
- | {{:v8_0_0:installation:pasted:20200707-093902.png?nolink}} | + | |
- | + | ||
- | {{:v8_0_0:installation:pasted:20200707-093914.png?nolink}} | + | |
- | + | ||
- | == Exécution de Vigilens Web == | + | |
- | + | ||
- | 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 [[v8_0_0:designer:menus:accueil:nouvellerequete:restitution#restitution_en_mode_interactif|Restitution en mode interactif]] lors de la [[v8_0_0:designer:menus:accueil:nouvellerequete:start|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 [[v8_0_0:howto:url|page dédiée à la syntaxe des URL]] | + | |
- | + | ||
- | == Compte servant à se connecter au service Vigilens Web == | + | |
- | + | ||
- | 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). | + | |
- | + | ||
- | + | ||
- | <WRAP round info> | + | |
- | Après avoir modifié le compte, il est nécessaire d’utiliser le raccourci « Restart Service » pour redémarrer le service Vigilens Web. | + | |
- | </WRAP> | + | |
- | + | ||
- | <WRAP round alert> | + | |
- | Il se peut que le service ne redémarre pas si le compte utilisateur ne possède pas les droits d’activation de service. Dans ce cas, le plus simple est de modifier directement le service lui-même. | + | |
- | Pour ce faire, il faut : | + | |
- | * Ouvrir l’interface de gestion des services (raccourci « Services » dans le groupe « Outils d’administration » du panneau de configuration) | + | |
- | * Effectuer un clic droit sur le service nommé « Service Vigilens Web » et sélectionner le menu « Propriétés ». | + | |
- | * Dans l’onglet « Connexion » de la boite de propriétés, renseigner le compte utilisateur et son mot de passe puis valider la boite de propriétés. Le compte utilisateur se verra alors attribuer les droits manquant. | + | |
- | * Il est alors possible d’utiliser le raccourci « Restart Service » pour redémarrer le service. | + | |
- | </WRAP> | + | |
- | + | ||
- | == Modifier les droits d’accès au composant DCOM == | + | |
- | 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. | + | |
- | + | ||
- | == Modification du mode de lancement de PHP == | + | |
- | 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. | + | |
- | + | ||
- | <WRAP round alert> | + | |
- | il peut être nécessaire, dans certains contextes, de configurer le pare-feu de façon à autoriser les accès au port utilisé par PHP. | + | |
- | </WRAP> | + | |
- | + | ||
- | == Configuration de PHP == | + | |
- | + | ||
- | 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). | + | |
- | + | ||
- | ===== Mise à jour ===== | + | |
- | + | ||
- | Se reporter à la [[v8_0_0:installation:installationposte#mise_a_jour|section mise à jour du poste Vigilens]]. | + | |
+ | ===== Update ===== | ||
+ | see [[:en:v8_0_0:installation:installationposte#update|update section of vigilens station]]. | ||