Installation du serveur EMS ou du serveur de la console EMS sur un environnement de production

De RAD Studio
Aller à : navigation, rechercher

Remonter à Installation du serveur EMS

Remonter à Installation du serveur de la console EMS


Pour un environnement de production, nous recommandons d'installer le serveur EMS et le serveur de la console EMS sur un serveur Web. Nous prenons actuellement en charge Microsoft IIS Server et Apache Server.

Vous avez besoin de la base de données InterBase et du fichier de configuration (.ini). Pour créer ces fichiers pour la première fois, suivez les étapes indiquées dans la rubrique Configuration du serveur EMS ou du serveur de la console EMS sur Windows.

Remarque : Si vous détenez une licence EMS pour installer une base de données InterBase XE7 cryptée dans votre environnement de production, vous devez d'abord suivre les étapes de Exigences de la base de données EMS pour un environnement de production sur Windows.

Le chemin par défaut des fichiers EMSServer.IB et EMSServer.ini est :

  • C:\Users\Public\Documents\Embarcadero\EMS\
Remarque : Modifiez le fichier ini avec l'emplacement de la base de données une fois celle-ci créée. Vérifiez que le serveur InterBase est en cours d'exécution.

Localisation des fichiers binaires requis par le serveur EMS

Pour exécuter le serveur EMS sur une machine différente de celle où vous avez installé RAD Studio, vous avez besoin des fichiers suivants, présents dans les dossiers d'installation des DLL :

Pour la prise en charge de Microsoft IIS (ISAPI Windows):

  • borlndmm.dll
  • CustomIPTransport250.bpl
  • dbrtl250.bpl
  • EMSConsole.dll
  • EMSServer.dll
  • emsserverapi250.bpl
  • FireDAC250.bpl
  • FireDACCommon250.bpl
  • FireDACCommonDriver250.bpl
  • rtl250.bpl
  • FireDACIBDriver250.bpl
  • IndyCore250.bpl
  • IndyIPClient250.bpl
  • IndyIPCommon250.bpl
  • IndyProtocols250.bpl
  • IndySystem250.bpl
  • inet250.bpl
  • xmlrtl250.bpl
  • Si vous utilisez FireDAC avec un système de gestion de base de données autre que InterBase, vous avez besoin de son pilote FireDAC, tel que FireDACSqliteDriver250.bpl pour SQLite.

Pour la prise en charge du serveur Apache :

  • FireDACCommon250.bpl
  • FireDACCommonDriver250.bpl
  • FireDACIBDriver250.bpl
  • FireDACSqliteDriver250.bpl
  • IndyCore250.bpl
  • IndyIPClient250.bpl
  • IndyIPCommon250.bpl
  • IndyProtocols250.bpl
  • IndySystem250.bpl
  • inet250.bpl
  • mod_emsserver.dll
  • rtl250.bpl
  • xmlrtl250.bpl

Si vous avez créé un ou plusieurs packages de ressources EMS personnalisées, vous devez les construire dans les fichiers de bibliothèque partagée de package, dont vous avez également besoin.

Prise en charge de Microsoft IIS (ISAPI Windows)

Les DLL utilisées pour configurer tant le serveur EMS que la console EMS s'exécutant sur un serveur IIS (EMSServer.dll et EMSConsole.dll) se trouvent dans les dossiers suivants :

  • Windows 32 bits : C:\Program Files (x86)\Embarcadero\Studio\19.0\bin
  • Windows 64 bits : C:\Program Files (x86)\Embarcadero\Studio\19.0\bin64

Suivez ces étapes pour installer un serveur ou une console EMS exécutés sur un serveur IIS.

Installation d'IIS 7

  1. Accédez à Panneau de configuration > Programmes et fonctionnalités > Activer ou désactiver des fonctionnalités Windows.
    Remarque : Vous devez pour cela être en mode privilégié.
  2. Développez le noeud Services Internet (IIS) dans la boîte de dialogue Fonctionnalités de Windows, puis :
    • Dans Outils d'administration Web, cochez Console de gestion IIS.
    • Dans Services World Wide Web, développez Fonctionnalités de développement d'applications puis cochez Extensions ISAPI et Filtres ISAPI.
    • Dans Services World Wide Web, développez Fonctionnalités HTTP communes et assurez-vous que Document par défaut, Exploration de répertoire, Erreurs HTTP et Contenu statique sont également cochées.
  3. Cliquez sur OK pour démarrer l'installation.

Vérification d'IIS 7

  1. Après avoir installé IIS 7, ouvrez l'URL http://localhost/ dans un navigateur standard pour vérifier qu'IIS fonctionne correctement.
    Remarque : Il se peut que vous deviez vérifier vos paramètres de pare-feu et ajouter une exception pour le trafic TCP du port 80, si nécessaire.

Création d'un nouveau site

Ajoutez un nouveau site :

  1. Accédez à C:\inetpub\wwwroot et créez un nouveau dossier, par exemple emsconsole ou emsserver.
  2. Collez le fichier EMSServer.ini créé dans Configuration du serveur EMS ou du serveur de la console EMS sur Windows (l'emplacement par défaut est C:\Users\Public\Documents\Embarcadero\EMS\) dans le dossier.
  3. Copiez les fichiers binaires requis dans le dossier.
  4. (Pour la console EMS seulement) Copiez le dossier webresources issu de C:\Program Files (x86)\Embarcadero\Studio\19.0\ObjRepos\en\EMS dans {path | C:\inetpub\wwwroot\emsconsole}}.

Configuration du fichier EMSServer.ini (seulement pour la console)

Modifiez le fichier EMSServer.ini comme suit : 

[Console.Paths.ISAPI]
ResourcesFiles= C:\inetpub\wwwroot\emsconsole\

Remarque : Vous devez redémarrer le serveur IIS pour que les changements prennent effet.

Configuration d'IIS 7 pour le fichier DLL ISAPI

  1. Ouvrez le Gestionnaire des services Internet (nécessite le mode privilégié).
    Conseil : Entrez Inetmgr dans Rechercher les programmes et fichiers pour ouvrir le Gestionnaire des services Internet.
  2. Sélectionnez le dossier (emsserver ou emsconsole) sous Sites > Site Web par défaut.
  3. Double-cliquez sur Mappages de gestionnaires. La fenêtre Mappages de gestionnaires s'ouvre.
  4. Sélectionnez ISAPI-dll. Il apparaît grisé.
  5. Cliquez sur Modifier dans le panneau Actions.
  6. Dans le champ Exécutable (facultatif), entrez le chemin d'accès au fichier dll et cliquez sur Ouvrir :
    • emsserver.dll, par exemple C:\inetpub\wwwroot\emsserver\emsserver.dll
    • emsconsole.dll, par exemple C:\inetpub\wwwroot\emsconsole\emsconsole.dll.
  7. Cliquez sur OK, puis cliquez sur Oui.
  8. Cliquez sur Modifier les autorisations de fonction… dans le panneau Actions.
  9. La boîte de dialogue Modifier les autorisations de fonction s'ouvre.
  10. Cochez Exécuter.
  11. Cliquez sur OK pour valider les changements.

Activation des modules ISAPI

  1. Cliquez sur le noeud racine dans l'arborescence Connexions.
  2. Double-cliquez sur Restrictions ISAPI et CGI.
  3. Cliquez sur Modifier les paramètres de fonction… dans le panneau Actions.
  4. Cochez l'option Autoriser les modules ISAPI non spécifiés. Cette option permet d'exécuter n'importe quel fichier dll ISAPI sous IIS. Si vous ne l'utilisez pas, vous devez spécifier explicitement la liste des fichiers DLL ISAPI.
  5. Cliquez sur OK.

Activation des fichiers DLL ISAPI 32 bits sur IIS 7 x64

Cette opération est requise uniquement si vous utilisez IIS 7 x64 et que vous souhaitez exécuter des fichiers DLL ISAPI 32 bits sur IIS. Si vos fichiers DLL ISAPI et votre version IIS7 sont tous les deux prévus pour x86 ou x64, vous pouvez ignorer cette étape.

  1. Cliquez sur le noeud Pools d'applications.
  2. Cliquez sur l'élément DefaultAppPool.
  3. Cliquez sur Paramètres avancés… dans le panneau Actions.
  4. Le dialogue Paramètres avancés s'ouvre.
  5. Définissez Activer les applications 32 bits sur True.
  6. Cliquez sur OK pour valider les changements.

Configuration d'IIS pour autoriser les requêtes de domaines croisés

Si votre serveur web héberge les ressources de fichiers web du serveur de la console EMS et que vous voulez autoriser les requêtes HTTP à partir de différents domaines, vous devez configurer l'en-tête de réponse HTTP.

  1. Accédez à C:\inetpub\wwwroot et créez un nouveau dossier, par exemple le dossier de fichiers web.
  2. Collez les dossiers des ressources de fichiers web sous webfilesresources.
    Remarque : Vous ne pouvez pas changer le nom du dossier webresources.
  3. Ouvrez le Gestionnaire des services Internet.
  4. Sélectionnez le dossier des fichiers Web (webfilesresources) sous Sites > Site Web par défaut.
  5. Double-cliquez sur En-têtes de réponse HTTP.
  6. Cliquez sur Ajouter dans le panneau Actions.
  7. Entrez l'une des configurations suivantes (Nom: Valeur) :
    • Access-Control-Allow-Origin : *
    • (Option plus restrictive) Access-Control-Allow-Origin : http://domain:port/
  8. Cliquez sur OK pour valider les changements.


Remarque : Voir Hébergement des ressources de fichiers web du serveur de la console EMS dans un serveur web pour de plus amples informations.

Prise en charge du serveur Apache

Vous trouverez le module serveur Apache EMS (mod_emsserver.dll et la mod_emsconsole.dll) aux emplacements suivants :

  • Windows 32 bits : C:\Program Files (x86)\Embarcadero\Studio\19.0\bin
  • Windows 64 bits : C:\Program Files (x86)\Embarcadero\Studio\19.0\bin64

Suivez ces étapes pour installer votre serveur ou console EMS exécutés sur un serveur Apache.

  1. Téléchargez et installez le serveur HTTP Apache pour Windows.
    Remarque : Le serveur EMS s'exécute uniquement dans le serveur HTTP Apache, versions 2.0, 2.2 et 2.4.
  2. Copiez le module serveur Apache EMS (mod_emsserver.dll) ou le module console Apache EMS (mod_emsconsole.dll) à un emplacement :
    • Par exemple, vous pouvez créer le dossier C:/mod.
  3. Configurez le serveur HTTP Apache afin de charger les modules serveur Apache EMS et console Apache EMS. Modifiez le fichier httpd.conf.
    • Ajoutez la ligne suivante afin de charger le module serveur Apache EMS (mod_emsserver.dll)
    LoadModule emsserver_module C:/mod/mod_emsserver.dll
    • Ajoutez la ligne suivante afin de charger le module console EMS Apache (mod_emsconsole.dll)
    LoadModule emsconsole_module C:/mod/mod_emsconsole.dll
    Remarque : Conformément à la documentation Apache (EN), ajoutez le suffixe '_module' au nom de module. Sinon, Apache ne charge pas le module.
    • Ajoutez les balises Location afin de créer un conteneur où vous pouvez spécifier les règles de contrôle d'accès pour une URL donnée.
    <Location /ems-server> SetHandler mod_emsserver-handler </Location> <Location /ems-console> SetHandler mod_emsconsole-handler </Location>
  4. Changez Listen pour changer le port listener par défaut. Par exemple, remplacez par : Listen 8085
  5. (Uniquement pour la console EMS Console) Copiez le dossier webresources (à partir de C:\Program Files (x86)\Embarcadero\Studio\19.0\ObjRepos\en\EMS) dans le dossier où vous avez copié les DLL des modules Apache (C:/mod).
  6. Pour vérifier si le module serveur Apache EMS s'exécute correctement, ouvrez un navigateur web et tapez : http://localhost:8085/ems-server/version
  7. Vous pouvez accéder au module console Apache EMS en naviguant vers : http://localhost:8085/ems-console/

Configuration du fichier EMSServer.ini (seulement pour la console)

Modifiez le fichier EMSServer.ini comme suit : 

[Console.Paths.Apache]
ResourcesFiles = C:\mod\
;WebFiles =

Remarque : Vous devez redémarrer le serveur Apache pour que les changements prennent effet.

Voir aussi

Récupérée de « http://docwiki.embarcadero.com/RADStudio/Tokyo/f/index.php?title=Installation_du_serveur_EMS_ou_du_serveur_de_la_console_EMS_sur_un_environnement_de_production&oldid=211667 »