Web Front-End Installation Guide HOPEX V1R2-V1R3 FR. Révisé le : 17 août 2015 Créé le : 12 mars Olivier SCHIAVI

Transcription

1 Révisé le : 17 août 2015 Créé le : 12 mars 2014 Auteurs : Noé LAVALLEE Olivier SCHIAVI

2 SOMMAIRE Sommaire... 2 Conditions préalables... 4 Système d exploitation... 4.Net... 4 Rôles nécessaires... 5 Configuration de la Desktop Heap... 6 Configuration de SSL / TLS... 7 Utilisateur Windows pour MEGA HOPEX... 8 Définir les permissions de groupe... 8 Définir l'accès à la licence MUST... 9 Définir les droits d'accès COM... 9 Installer MEGA HOPEX Choisir le type d'installation Installation autonome de Web Front-End Installation avancée Écran multi-choix Paramètres avancés Terminer l'installation Définir les droits d'accès aux fichiers de l'utilisateur Windows pour MEGA HOPEX Configuration IIS Configurer l'expiration du contenu Web Tester l'installation Tester MEGA HOPEX Web Front-End Suppléments sur la configuration requise Exports Word, Excel et PDF Rapports (MS Word) Configuration des options requise Que faire ensuite? Dépannage Vérifier que le Mega Site Service Provider est lancé Relancer Internet Information Services Référencer un nouvel environnement Désactiver la prévention de l'exécution des données page 2/40

3 Baisser le niveau de sécurité d'internet Explorer Résumé Ce document décrit les étapes nécessaires à l'installation de MEGA HOPEX Web Front-End sur Windows Server 2008 R2 et versions ultérieures. page 3/40

4 CONDITIONS PREALABLES Système d exploitation MEGA HOPEX Web Front-End peut être installé sur les systèmes suivants : 1. Windows Server 2008 R2 2. Windows Server Windows Server 2012 R2 Pour installer MEGA HOPEX Web Front-End, vous devez ouvrir une session Windows avec un utilisateur du domaine qui possède des droits d'administration sur la machine serveur. Ce document décrit les étapes nécessaires à l'installation pour Windows Server 2008 R2. Certaines étapes peuvent nécessiter d'être adaptées pour Windows Server Net.Net 4.5 est nécessaire. Il est déjà installé par défaut avec Windows Server 2012 and 2012 R2. Pour plus d'informations sur l'installation de.net 4.5 sur un serveur Windows Server 2008 R2, voir l'article: page 4/40

5 Rôles nécessaires Vérifiez que les rôles "Web Server (IIS)" et "File Services" sont installés correctement. Vous pouvez le vérifier dans la fenêtre "Server Manager" des outils d'administration. De plus, les "Roles Services" suivants et leurs dépendances doivent être installés pour le rôle "Web Server (IIS)". 4. ASP.Net 5. CGI page 5/40

6 Vous pouvez le vérifier et l'ajouter via le nœud "Roles". Configuration de la Desktop Heap La Desktop Heap est une mémoire interne de Windows. Elle est très sollicitée par l'application Web. Il est donc obligatoire de mettre à jour cette valeur. Quand un nombre important d'utilisateurs emploient simultanément le même serveur, la session Windows de l'utilisateur d'impersonnification peut commencer à être à court de Dektop Heap. Cela va créer des erreurs d'exécution. L'utilisateur d'impersonification utilise une session non-interactive et la valeur par défaut de la mémoire de type Desktop Heap non-interactive est très basse dans ce cas. Avec la dernière version de l'application, nous vérifions que la Desktop Heap est au moins à 8 Mo. Si ce n'est pas le cas, toute personne qui accède au site Web reçoit un message d'avertissement. Cette modification doit être faite dans l'editeur du Registre de Windows. Consultez la valeur de Windows dans HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\SubSystems. Cette valeur est une longue chaine qui se présente sous la forme suivante : %SystemRoot%system32csrss.exe ObjectDirectory=Windows SharedSection=1024,3072,512 Windows page 6/40

7 C'est la partie SharedSection qui doit être modifiée. Les trois valeurs correspondent, dans l'ordre à : la Heap partagée, la Desktop Heap interactive, et la Desktop Heap non-interactive. Elles sont exprimées en Ko. Les valeurs par défaut varient de manière significative en fonction des versions de Windows. Vous devrez modifier la desktop heap non-interactive. Attention à ne pas utiliser des valeurs excessives, ceci pourrait vous empêcher de vous connecter à votre serveur. Il est recommandé de changer cette valeur par petits incréments. La valeur minimale à saisir est donc : Cela vaut pour les déploiements modérés. Lorsqu'un grand nombre d'utilisateurs concurrents sont attendus sur le Web Front-End server, veuillez contacter votre interlocuteur MEGA qui fera le lien avec les personnes compétentes. Configuration de SSL / TLS Pour assurer la protection des données, il est fortement recommandé d'utiliser SSL/TLS. L'outil d'installation permet d'installer l'application Web sur un site Web où HTTPS est déjà déployé. Si vous voulez activer cette fonctionnalité, il est obligatoire, en condition préalable, de configurer votre plateforme IIS afin d'activer SSL/TLS. Vous aurez besoin d'un certificat. Vous pouvez lier le protocole HTTPS à n'importe quel port, l'outil d'installation vous demandera sur quel site vous voulez installer HOPEX, et sur quel port. Notez que pour cela vous aurez besoin de choisir le type d'installation "Customized Setup"/"Installation personnalisée" (voir section "Installer MEGA HOPEX" pour plus de détails). Dans un déploiement Web autonome, nous déployons sans SSL/TLS. Vous trouverez de la documentation sur IIS sur le lien suivant : Nous fournissons également un article technique qui explique comment sécuriser la plateforme HOPEX ; il contient des informations sur SSL/TLS ainsi qu'un exemple de configuration. Veuillez vous référer à l'article "Web Front-End - Securing the platform.doc".!! Avertissement!! Ne choisissez pas d'utiliser SSL/TLS lorsque vous installez HOPEX à moins que vous ayez fait le déploiement sur votre serveur Web, avec le bon certificat sur le port adéquat. page 7/40

8 Utilisateur Windows pour MEGA HOPEX Lorsque vous installez MEGA HOPEX, un utilisateur est nécessaire pour gérer l'authentification des processus. Il est recommandé de ne pas exécuter les processus de l'application Web avec un utilisateur administrateur. Vous avez par conséquent besoin d'un second utilisateur du domaine. Cet utilisateur sera impersonnifié dans les deux applications Web. Toutes les actions réalisées dans MEGA HOPEX le seront sous l'identité de cet utilisateur Windows. Définir les permissions de groupe Cet utilisateur doit appartenir à des groupes Windows spécifiques : Il doit appartenir au groupe "Distributed COM Users" du serveur. Pour ajouter cet utilisateur à ce groupe, utilisez la fenêtre "Computer Management" des outils d'administration. Naviguez jusqu'au nœud "Groups". Faites un clic-droit sur "Distributed COM Users" et sélectionnez "Add to Group". page 8/40

9 Cet utilisateur doit aussi appartenir au groupe IIS_IUSRS du serveur. Définir l'accès à la licence MUST Il doit être enregistré dans l'outil de gestion des licences MUST, avoir le droit de lire et écrire les données dans le dossier des licences MUST et de partager des données. Pour plus de détails, voir l'article technique "Must License Installation Guide" dans le dossier Documentation de l'installation MEGA. Définir les droits d'accès COM Il doit pouvoir lancer les applications COM par défaut. Pour donner ce droit, continuez sur la fenêtre «Services de composants» des outils d'administration : 1. Dépliez le nœud «Services de composants» puis «Ordinateurs». page 9/40

10 2. Faites un clic droit sur «Poste de Travail» et sélectionnez «Propriétés». 1. Sélectionnez l'onglet «Sécurité COM» et cliquez sur «Modifier» du groupe «Autorisations d exécution et d activation». page 10/40

11 2. Ajoutez l'utilisateur, ou le groupe Distributed COM Users, et donnez-lui les droits «Exécution local» et «Activation locale». page 11/40

12 INSTALLER MEGA HOPEX Choisir le type d'installation HOPEX offre deux façons d'installer le Web Front-End : - Installation autonome : installe automatiquement le Web Front-End et ses dépendances (SSP, etc.) sur un serveur autonome sans SSL/TLS. - Installation avancée : permet des scénarios d'installation plus complexes. Utilisez-la pour toute installation multi-serveurs (scale out ou scale up), ou s'il vous faut SSL/TLS. Installation autonome de Web Front-End 1. Double-cliquez sur le programme Setup pour le lancer. 2. Si le message Voulez-vous autoriser le programme suivant à effectuer des modifications sur votre ordinateur? apparaît, cliquez sur Oui. 3. Passez par les différentes étapes suivantes : page 12/40

13 page 13/40

14 4. Sélectionnez le répertoire d'installation du logiciel MEGA : 5. Sélectionnez Web Standalone Setup. page 14/40

15 6. Saisissez le nom d'utilisateur et le mot de passe du Windows User for Mega Hopex que vous avez choisi dans la section précédente de ce document. Il sera utilisé pour l'utilisateur d'impersonnification de l'application Web. 7. Saisissez l'url complète que les utilisateurs finaux utiliseront pour se connecter à HOPEX Web Front-End. Il s'agit généralement d'un nom de domaine pleinement qualifié suivi de /Hopex. page 15/40

16 8. Vous pouvez maintenant lancer l'installation en cliquant sur Install. page 16/40

17 Installation avancée L'installation avancée est similaire à l'installation autonome, excepté pour le choix initial et des paramétrages additionnels. Écran multi-choix 1. Sélectionnez Customized Setup : page 17/40

18 2. Indiquez si vous souhaitez activer ou non l'utilisation de SSL/TLS. SSL/TLS est fortement recommandé, cependant cela requiert une configuration de IIS au préalable (voir la section Conditions préalables). De plus, ne choisissez "Oui" que si le certificat est déployé sur IIS. Sans quoi l'installation fera un retour en arrière : 3. Choisissez le site Web IIS où vous voulez installer HOPEX Web Front-End. Notez que l'assistant d'installation vérifiera si un site Web tourne sur le port choisi, et fera l'installation sur le premier site utilisant ce port qui sera disponible. Veillez donc à bien administrer vos sites Web et leurs ports avant d'en choisir un pour le déploiement d'hopex. page 18/40

19 4. Si vous choisissez un port qui n'est relié à aucun site, et qui n'est pas en écoute pendant l'installation, l'installation fera un retour en arrière : 5. Sélectionnez les composants que vous voulez installer (référez-vous au guide de déploiement pour voir quel composant installer sur quel serveur et pour quel besoin) : page 19/40

20 Paramètres avancés Les paramètres avancés dépendent des composants que vous avez choisi d'installer. Voici la liste des paramètres qui ne sont pas proposés dans l'installation autonome. URL de MEGA Site Provider (SSP) Jeton de sécurité (Security Token) Ce paramètre devrait être identique sur chaque installation d'hopex (Web, Windows, Advisor, SSP, etc.) qui fonctionne dans un scénario scale up ou scale out. page 20/40

21 Protection des pages d administration Indique s'il faut protéger ou non le sous-répertoire /admin de l'installation d'hopex (fortement recommandé) Expiration automatique des sessions page 21/40

22 URL du site Web HOPEX MWAS Définie sur un serveur Web pour indiquer le serveur d'applications. URL du site Web MWAS pour Advisor Définie sur un serveur Web pour indiquer le serveur d'applications. page 22/40

23 TERMINER L'INSTALLATION Définir les droits d'accès aux fichiers de l'utilisateur Windows pour MEGA HOPEX 1. Allez dans le dossier d'installation de MEGA HOPEX (par défaut C:\Program Files (x86)\mega\mega HOPEX V1R2\ pour les systèmes 64 bits, c:\program Files\MEGA\MEGA HOPEX V1R2\ pour les systèmes 32 bits) et donnez les droits d'accès en lecture/écriture au groupe IIS_IUSRS qui contient votre utilisateur Windows chargé de l'impersonnification. Ainsi, si vous changez cet utilisateur, vous n'aurez pas à modifier la sécurité mais seulement à mettre à jour le groupe. 2. Répétez cette opération pour: Le dossier d'installation de MEGA HOPEX Web Front-End (par défaut C:\Inetpub\wwwroot\hopex). Les dossiers des environnements auxquels MEGA doit accéder. Par défaut, les environnements de démonstration sont dans des sous-dossiers de C:\Users\Public\Documents. Le Dossier temporaire utilisé pour Web Access. Il s'agit généralement de C:\Windows\Temp. page 23/40

24 3. Faites en sorte que votre utilisateur soit correctement configuré pour la licence MUST (pour plus de détails, voir l'article technique Must License Installation Guide dans le dossier Documentation\Articles de votre installation MEGA). 4. Pour le premier test, lancez l'application MEGA avec l'utilisateur Windows pour MEGA HOPEX". Pour cela, allez dans le dossier d'installation MEGA. 5. Maintenez la touche <Maj> enfoncée, faites un clic droit sur Mega.exe et sélectionnez "Exécuter en tant qu'autre utilisateur". Vous devez pouvoir lancer MEGA. Configuration IIS Une option par défaut d IIS fait redémarrer toutes les 29 heures le processus de travail de HOPEX/HOPEX2/Advisor. Microsoft a fait cette configuration afin d'assurer la stabilité du processus w3wp.exe, qui administre les sites Web et/ou les applications Web au sein des sites Web. Cependant, le fait que ce processus redémarre peut perturber la navigation des utilisateurs connectés qui perdent leur contexte de navigation. Afin d'éviter cela, l'outil d installation désactive le recyclage du processus de travail et utilise le délai d'inactivité par défaut, c'est-à-dire qu'après 20 minutes d'inactivité complète, le processus de travail stoppe automatiquement (il redémarrera automatiquement lorsqu'un utilisateur essaiera d'accéder au site Web). Nous vous recommandons d'ajouter manuellement un redémarrage à une heure fixe, où personne n'est connecté au site, afin de vous assurer que le processus redémarre au moins une fois par jour. page 24/40

25 Pour cela : 1. Ouvrez le Internet Information Services (IIS) Manager et allez sur Application Pools. 2. Sélectionnez HOPEX (ou Advisor si vous avez seulement déployé l'application Web Advisor ). 3. Dans le panneau "Edit Application Pool", cliquez sur l'option des paramètres avancés. page 25/40

26 4. Dans la section Recycling, sélectionnez la ligne Specific Times et cliquez sur le bouton. 5. Cliquez sur Ajouter : page 26/40

27 6. Saisissez l'heure de redémarrage voulue (dans cet exemple 2h du matin) et cliquez sur "OK" pour valider : 7. Fermez les paramètres avancés. Recommencez cette procédure pour l'application Pool HOPEX2 si vous avez déployé HOPEX, et pour Advisor si vous avez installé à la fois HOPEX et Advisor sur le serveur Web. Il est nécessaire de redémarrer IIS pour activer cette configuration. Configurer l'expiration du contenu Web 1. Dans le Gestionnaire des services Internet (IIS)", dépliez Sites puis Default Web Site. 2. Sélectionnez HOPEX 3. Double-cliquez sur la fonctionnalité En-têtes de réponse HTTP. 4. Cliquez sur Définir les en-têtes communs dans le volet droit. page 27/40

28 5. Dans le Gestionnaire des services Internet (IIS), dépliez HOPEX 6. Sélectionnez le dossier script et choisissez En-têtes de réponse HTTP. 7. Cliquez sur Définir les en-têtes communs dans le volet droit. 8. Paramétrez l'expiration du contenu Web après 31 jours. 9. Répétez cette étape pour les dossiers css and images. page 28/40

29 TESTER L'INSTALLATION Avant de procéder au test, vous devez avoir installé l'environnement exemple (appelé "Démonstration"). Sur le serveur, lancez la console d'administration MEGA (Administration.exe). Cliquez sur le menu "Aide" > "A propos de MEGA" et vérifiez la licence utilisée. Il doit s'agir du nom de la licence MUST générée pour l'installation. Si la console d'administration ne se lance pas ou si la licence n'est pas celle attendue, vous devez revoir le paramétrage de la licence avant d'aller plus loin. page 29/40

30 Tester MEGA HOPEX Web Front-End Sur le serveur, ouvrez un navigateur supporté et tapez l'adresse La page de connexion apparaît. Utilisez une autre machine cliente avec un des navigateurs supportés et allez à l'adresse suivante : du serveur>/hopex/. La page de connexion apparaît. Connectez-vous à l'environnement de démonstration avec le login "mega", sans saisir de mot de passe. Puis sélectionnez : page 30/40

31 L'espace de travail Web apparaît : Le contenu affiché peut varier en fonction des licences disponibles. Suppléments sur la configuration requise Exports Word, Excel et PDF Veillez à ce que votre navigateur vous autorise à télécharger des fichiers. IE peut afficher le message suivant dans la barre d'état et empêcher d'ouvrir le fichier PDF : Rapports (MS Word) Avant d'utiliser les documents avec MEGA HOPEX Web Front-End, vous devez convertir vos documents pour les rendre compatibles Web. Vous devez quitter votre session Web en publiant ou abandonnant votre transaction. page 31/40

32 Ensuite, sur le poste où Microsoft Word est installé, lancez l'outil d'administration, ouvrez l'environnement de démonstration avec l'utilisateur 'Administrator', dans le dossier référentiels, faites un clic droit sur SystemDB et sélectionnez Convertir > Utilitaires. Sélectionnez : "MEGA Repository - Convert Report templates (MS Word) to RTF Format" et validez. page 32/40

33 Configuration des options requise Vous devez définir plusieurs options de site dans Administration.exe: Les options suivantes sont nécessaires pour que MEGA HOPEX Web Front-End fonctionne : 1. Dans le dossier Installation > Application Web : o Le chemin de l'application Web ( est déjà défini par l'installation. page 33/40

34 2. Dans le dossier Installation > Messagerie Electronique : o o o Adresse par défaut de l'expéditeur via SMTP Serveur SMTP Toute configuration SMTP (port, SSL, authentification, etc.) nécessaire pour votre infrastructure. En V1R3, veuillez noter que votre MegaSite.ini contient le numéro de version. Ainsi, si vous avez mis à jour une version V1R2 en V1R3, et voulez conserver vos paramètres, assurez-vous que ces informations apparaissent dans la section [System] de votre fichier MegaSite : MegaCurrentVersion=30208 page 34/40

35 QUE FAIRE ENSUITE? Vous avez installé avec succès MEGA HOPEX Web Front-end. Vous devez maintenant personnaliser votre installation. Les deux principales étapes sont : 3. La mise en place d'un environnement RDBMS 4. La configuration de l'authentification Référez-vous à la documentation d'administration de MEGA. page 35/40

36 DEPANNAGE Vérifier que le Mega Site Service Provider est lancé Si vous obtenez le message suivant, alors que les environnements sont accessibles depuis Administration.Exe et Mega.exe : Vous devez vérifier que le «Mega Site Service Provider» est lancé en utilisant l'outil d'administration des Services : S'il n'est pas lancé, vérifiez que son lancement est «Automatique» et Démarrez le service. S'il est lancé, redémarrez le service. Ensuite redémarrez IIS (voir ci-dessous). page 36/40

37 Relancer Internet Information Services Si des problèmes apparaissent, la première étape est de redémarrer le serveur Web. Depuis le "Gestionnaire des services Internet IIS", sélectionnez le nom du serveur et cliquez sur "Redémarrer" dans le panneau "Actions". Référencer un nouvel environnement Pour qu'un nouvel environnement soit accessible dans MEGA HOPEX, pensez à donner à l'utilisateur "Windows pour MEGA" tous les droits d'accès sur le dossier de l'environnement. Si vous avez un déploiement multi-serveur, vous devez le référencer et vérifier les droits sur chaque serveur (excepté pour les serveurs Web frontaux). Désactiver la prévention de l'exécution des données Dans de rares cas, il peut être nécessaire de désactiver la prévention de l'exécution des données pour les programmes MEGA. Pour accéder aux paramètres de prévention de l'exécution des données : Dans le menu Démarrer, faîtes un clic droit sur Ordinateur et sélectionnez Propriétés. Dans l'écran suivant, cliquez sur "Paramètres système avancés". Dans l'onglet "Paramètres système avancés", dans le groupe "Performances" cliquez sur "paramètres" et sélectionnez l'onglet "Prévention de l'exécution des données". page 37/40

38 Vous pouvez soit activer la prévention de l'exécution des données sur les programmes et services Windows indispensables, soit ajouter des exceptions sur les programmes MEGA suivants (emplacements d'installation par défaut) : C:\Program Files (x86)\mega\mega HOPEX V1R2\System\mgwspro.exe C:\Program Files (x86)\mega\mega HOPEX V1R2\System\mgwmapp.exe C:\Program Files (x86)\mega\mega HOPEX V1R2\System\mgwmwas.exe Baisser le niveau de sécurité d'internet Explorer Même si les paramètres de sécurité par défaut sur les machines clientes suffisent pour utiliser l'application Web MEGA, certaines machines, particulièrement les serveurs, peuvent avoir des règles de sécurité plus strictes. Elles peuvent par exemple empêcher l'exécution de JavaScript, nécessaire à l'utilisation de l'application Web MEGA. page 38/40

39 Pour résoudre ce problème, suivez la procédure ci-dessous : Étape 1 : Activer le paramètre Scripts ASP sur la zone des sites de confiance Allez dans le menu Outils\Options Internet. Sélectionnez l'onglet Sécurité. Cliquez sur "Sites de confiance" puis sur "Personnaliser le niveau". page 39/40

40 Pour le paramètre Scripts ASP, sélectionnez Activer. Étape 2 : Ajouter l'application Web MEGA à la liste des sites de confiance Allez dans le menu Outils\Options Internet. Sélectionnez l'onglet Sécurité. Cliquez sur "Sites de confiance" puis sur "Sites". Saisissez l'adresse de votre site Web puis cliquez sur "Ajouter". Validez. page 40/40