Installation du serveur EMS ou du serveur de la console EMS sur un environnement de production
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 le serveur Microsoft IIS et le serveur Apache.
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.
- Remarque : Si vous détenez une licence EMS pour installer une base de donnée 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.
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.
Sommaire
- 1 Localisation des fichiers binaires requis par le serveur EMS
- 2 Prise en charge de Microsoft IIS (ISAPI Windows)
- 3 Support du serveur Apache
- 4 Voir aussi
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 Prise en charge de Microsoft IIS (ISAPI Windows):
borlndmm.dll
CustomIPTransport240.bpl
dbrtl240.bpl
EMSConsole.dll
EMSServer.dll
emsserverapi240.bpl
FireDAC240.bpl
FireDACCommon240.bpl
FireDACCommonDriver240.bpl
rtl240.bpl
FireDACIBDriver240.bpl
IndyCore240.bpl
IndyIPClient240.bpl
IndyIPCommon240.bpl
IndyProtocols240.bpl
IndySystem240.bpl
inet240.bpl
vcl240.bpl
vcldb240.bpl
vclFireDAC240.bpl
vclx240.bpl
xmlrtl240.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
FireDACSqliteDriver240.bpl
pour SQLite.
For Support du serveur Apache:
FireDACCommon240.bpl
FireDACCommonDriver240.bpl
FireDACIBDriver240.bpl
FireDACSqliteDriver240.bpl
IndyCore240.bpl
IndyIPClient240.bpl
IndyIPCommon240.bpl
IndyProtocols240.bpl
IndySystem240.bpl
inet240.bpl
mod_emsserver.dll
rtl240.bpl
xmlrtl240.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 à 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\18.0\bin
- Windows 64 bits:
C:\Program Files (x86)\Embarcadero\Studio\18.0\bin64
Suivez ces étapes pour installer un serveur ou une console EMS exécutés sur un serveur IIS.
Installation d'IIS 7
- 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é.
- 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 les options Document par défaut, Exploration de répertoire, Erreurs HTTP et Contenu statique sont également cochées.
- Cliquez sur OK pour démarrer l'installation.
Vérification d'IIS 7
- 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
- Choisissez
C:\inetpub\wwwroot
et créez un nouveau dossier, par exemple emsconsole ou emsserver. - Collez le fichier EMSServer.ini créé dans Configuration du serveur EMS ou du serveur de la console EMS (l'emplacement par défaut est
C:\Users\Public\Documents\Embarcadero\EMS\
) sur le dossier. - Copiez les fichiers binaires requis dans le dossier.
- (Pour la console EMS seulement) Copiez le dossier webresources issu de
C:\Program Files (x86)\Embarcadero\Studio\18.0\ObjRepos\fr\EMS
dansC:\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
- Ouvrez le Gestionnaire des services Internet (nécessite le mode privilégié).
- Conseil : Entrez Inetmgr sur Rechercher les programmes et fichiers pour ouvrir le Gestionnaire des services Internet.
- Sélectionnez le dossier (emsserver ou emsconsole) sous Sites > Site Web par défaut.
- Double-cliquez sur Mappages de gestionnaires. La fenêtre Mappages de gestionnaires s'ouvre.
- Sélectionnez ISAPI-dll. Il apparaît grisé.
- Cliquez sur Modifier dans le panneau Actions.
- 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
.
- emsserver.dll, par exemple
- Cliquez sur OK, puis cliquez sur Oui.
- Cliquez sur Modifier les autorisations de fonction… dans le panneau Actions.
- La boîte de dialogue Modifier les autorisations de fonction s'ouvre.
- Cochez Exécuter.
- Cliquez sur OK pour valider les changements.
Activation des modules ISAPI
- Cliquez sur le noeud racine dans l'arborescence Connexions.
- Double-cliquez sur Restrictions ISAPI et CGI.
- Cliquez sur Modifier les paramètres de fonction… dans le panneau Actions.
- 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.
- 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.
- Cliquez sur le noeud Pools d'applications.
- Cliquez sur l'élément DefaultAppPool.
- Cliquez sur Paramètres avancés… dans le panneau Actions.
- Le dialogue Paramètres avancés s'ouvre.
- Définissez Activer les applications 32 bits sur True.
- 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.
- Accédez à
C:\inetpub\wwwroot
et créez un nouveau dossier, par exemple le dossier de fichiers web. - Collez les dossiers des ressources de fichiers web sous webfilesresources.
- Remarque : Vous ne pouvez pas changer le nom du dossier webresources.
- Ouvrez le Gestionnaire des services Internet.
- Sélectionnez le dossier des fichiers web (webfilesresources) sous Sites > Site Web par défaut.
- Double-cliquez sur En-têtes de réponse HTTP.
- Cliquez sur Ajouter dans le panneau Actions.
- Entrez l'une des configurations suivantes (Nom: Valeur) :
- Access-Control-Allow-Origin : *
- (Option plus restrictive) Access-Control-Allow-Origin : http://domain:port/
- 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.
Support 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\18.0\bin
- Windows 64 bits:
C:\Program Files (x86)\Embarcadero\Studio\18.0\bin64
Suivez ces étapes pour installer votre serveur ou console EMS exécutés sur un serveur Apache.
- 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.
- 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
.
- Par exemple, vous pouvez créer le dossier
- 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
)
- Ajoutez la ligne suivante afin de charger le module console EMS Apache (
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.
- Ajoutez la ligne suivante afin de charger le module serveur Apache EMS (
- Changez
Listen
afin de changer le port d'écoute par défaut. Par exemple, changez-le en 8085. Listen 8085 - (Uniquement pour la console EMS Console) Copiez le dossier webresources (à partir de
C:\Program Files (x86)\Embarcadero\Studio\18.0\ObjRepos\en\EMS
) au dossier où vous avez copié les DLL modules Apache (C:/mod
). - 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
- Vous pouvez accéder au module console Apache EMS en accédant à :
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.