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

De RAD Studio
Aller à : navigation, rechercher

Remonter à Installation du serveur EMS


Vous pouvez configurer le serveur EMS sur votre machine Linux avec les options suivantes :

Prérequis

Pour configurer le serveur EMS sous Linux, vous avez besoin des éléments suivants :

  • RAD Studio sur Windows
  • Une machine Linux (vous pouvez utiliser une machine virtuelle)
  • InterBase installé sur votre machine Linux
Pour tester le développement EMS sur Linux, téléchargez InterBase XE7 pour Linux depuis https://downloads.embarcadero.com/free/ibdev et enregistrez-vous.
  • Apache installé sur votre machine Linux (pour la prise en charge du serveur Apache)

Remarque : Pour les installations Ubuntu 16.04 LTS, le package "libcurl3" est requis pour RAD Server.

Prise en charge de Linux

Les fichiers LinuxEMSServer.tar et ems_install.sh d'EMS se trouvent à l'emplacement suivant :

Linux 64 bits C:\Program Files (x86)\Embarcadero\Studio\19.0\EMSServer

L'installateur EMS sous Linux est composé de deux fichiers :

  • LinuxEMSServer.tar : l'archive qui comprend les serveurs, les outils, les packages et les fichiers statiques.
  • ems_install.sh : le fichier qui décompresse les fichiers et les place aux emplacements requis, puis assigne les attributs et les droits.

LinuxEMSServer.tar inclut les éléments suivants :

  • Serveurs :
    • server\EMSDevServerCommand (pour le serveur autonome)
    • server\libmod_emsserver.so (pour la prise en charge du serveur Apache)
    • server\EMSMultiTenantConsole (pour la prise en charge multi-client de RAD Studio)
  • Outils :
    • EMSDevConsoleCommand (pour le serveur autonome)
    • server\libmod_emsconsole.so (pour la prise en charge du serveur Apache)
  • Fichiers objrepos requis par EMSDevConsoleCommand :
    • objrepos\webresources
    • objrepos\ems\EMSMSERVER.IB
    • objrepos\ems\EMSMSERVER.SQL
    • objrepos\ems\emsserver.ib
    • objrepos\ems\emsserver.sql
    • objrepos\ems\emsserver.ini
  • Packages requis par les serveurs ou les outils :
    • rtl\bplFireDACSqliteDriver250.so
    • rtl\bplrtl250.so
    • rtl\bplFireDACCommonDriver250.so
    • rtl\bplFireDAC250.so
    • rtl\bpldbrtl250.so
    • rtl\bplFireDACIBDriver250.so
    • rtl\bplFireDACCommon250.so
    • rtl\bplxmlrtl250.so
    • rtl\bplemsserverapi250.so

Si vous utilisez FireDAC avec un système de gestion de base de données autre qu'InterBase, vous avez besoin de son pilote FireDAC, tel que bplFireDACSqliteDriver250.so pour SQLite.

Une fois configuré, le serveur EMS utilise les chemins par défaut :

  • EMSDevServerCommand, EMSDevConsoleCommand sont situés dans in /usr/lib/ems
  • mod_emsconsole, mod_emsserver est situé dans /usr/lib/apache2/modules (au cas où Apache est installé) ; il se trouve sinon à l'emplacement suivant : /usr/lib/ems)
  • Les dossiers ib, sql, ini et webresources se trouvent dans /etc/ems
  • Les packages RTL et DBRTL (*.so) se trouvent dans /usr/lib/ems
  • L'installateur crée également le fichier /var/emsserver_install.log.

Installation autonome

  1. Pour installer le serveur autonome, vous devez exécuter le fichier ems_install.sh.
  2. Pour exécuter le serveur autonome, vous devez exécuter le fichier EMSDevServerCommand.

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

  • Fichiers objrepos requis par EMSDevServerCommand :
    • objrepos\ems\emsserver.ib
    • objrepos\ems\EMSMSERVER.SQL
    • objrepos\ems\EMSMSERVER.IB
    • objrepos\ems\emsmserver.sql
    • objrepos\ems\emsserver.ini

Prise en charge du serveur Apache

Avec des privilèges ayant été correctement élevés, 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 ou Linux.
    Remarque : Le serveur EMS s'exécute uniquement dans le serveur HTTP Apache version 2.4.
  2. Installez le serveur EMS en utilisant ems_install.sh.
  3. Configurez le serveur HTTP Apache afin de charger les modules serveur Apache EMS et console Apache EMS.
    Pour les distributions Red Hat et les distributions non Debian de Linux, modifiez le fichier httpd.conf d'Apache comme suit 
    • Ajoutez la ligne suivante afin de charger le module serveur Apache EMS (libmod_emsserver.so) :
    LoadModule emsserver_module /usr/lib/ems/libmod_emsserver.so
    • Ajoutez la ligne suivante afin de charger le module console EMS Apache (libmod_emsconsole.so) :
    LoadModule emsconsole_module /usr/lib/ems/libmod_emsconsole.so
    • 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 libmod_emsserver-handler </Location> <Location /ems-console> SetHandler libmod_emsconsole-handler </Location>
    Pour Ubuntu et les distributions Debian similaires de Linux, suivez ces étapes pour configurer les modules du serveur Apache EMS et de la console Apache EMS.
    • Créez un nouveau fichier appelé ems.load dans le répertoire mods-available d'Apache pour charger les modules du serveur Apache EMS et de la console.
    LoadModule emsserver_module /usr/lib/ems/libmod_emsserver.so LoadModule emsconsole_module /usr/lib/ems/libmod_emsconsole.so
    • Ensuite, créez un autre fichier ems.conf, également placé dans le répertoire mods-available d'Apache. Il contiendra les balises d'emplacement utilisées pour spécifier les règles d'accès d'une URL donnée.
    <Location /ems-server> SetHandler libmod_emsserver-handler </Location> <Localtion /ems-console> SetHandler libmod_emsconsole-handler </Location>
    • Activez ensuite le module EMS en utilisant a2enmod comme ci-dessous.
    a2enmod ems
    • S'il est nécessaire de désactiver le module EMS, utilisez a2dismod comme suit :
    a2dismod ems
  4. Assurez-vous que Interbase Server est exécuté et que le serveur EMS ou la console EMS a été correctement configuré pour garantir que la base de données EMS est disponible pour Interbase.
  5. Redémarrez le serveur Apache de façon appropriée pour que votre distribution Linux puisse charger le module EMS récemment configuré.
  6. Pour vérifier si le module serveur Apache EMS s'exécute correctement, ouvrez un navigateur web et tapez : http://localhost/ems-server/version
  7. Vous pouvez accéder au module console Apache EMS en accédant à http://localhost:8085/ems-console/


Remarque : Désactivez SELinux pour permettre à Apache de se connecter à des ports et des IP externes.

Voir aussi