Modification manuelle de la configuration de votre console RAD Server

De RAD Studio
Aller à : navigation, rechercher

Remonter à Installation de votre console RAD Server

Vous devez modifier le fichier EMSServer.ini pour configurer le serveur de la console EMS.

L'emplacement par défaut est  : C:\Users\Public\Documents\Embarcadero\EMS

Remarque : Si vous modifiez ce fichier, vous devez interrompre et redémarrer le serveur de la console EMS pour recharger le fichier emsserver.ini.

Configuration de la base de données EMS

Vous pouvez modifier les informations par défaut de la base de données EMS utilisée par le serveur de la console EMS. Dans le fichier EMSServer.ini, accédez à la section [Data] :

  • InstanceName. Spécifie l'instance d'InterBase qui héberge la base de données EMS.
InstanceName a le format suivant : [[<host>/]<instance>]. Voici les combinaisons de valeurs possibles :
  • La valeur est une chaîne vide : l'instance de la base de données par défaut est exécutée sur l'hôte local.
  • <instance> : instance spécifiée exécutée sur l'hôte local.
  • <host>/<instance> : instance spécifiée exécutée sur l'hôte spécifié.
  • Database. Répertoire local ou distant du fichier de la base de données EMS.
  • UserName. Nom d'utilisateur d'accès à la base de données EMS.
  • Password. Mot de passe d'accès à la base de données EMS.
  • SEPassword. Mot de passe pour la connexion à une base de données InterBase encryptée.
  • Pooled. Active le pooling de connexion FireDAC sur la base de données EMS pour réduire la latence.
  • PooledMax. Nombre maximal de connexions en pool autorisées sur la base de données EMS.
[Data]
; Interbase connection parameters
InstanceName=EMS
Database=C:\Users\Public\Documents\Embarcadero\EMS\emsserver.ib
UserName=sysdba
Password=masterkey
SEPassword=
;# SEPassword connects to an encrypted database
Pooled=
;# Set Pooled=0 to disable connection pooled, Pooled=1 to enable. Default value is 1.
PooledMax=
;# Set PooledMax=10 to limit maximum pooled connection.  Default value is 50.

Configuration de la connexion à la console EMS

Vous pouvez modifier les informations d'identification par défaut pour accéder à la console EMS à partir d'un navigateur standard. Dans le fichier EMSServer.ini, accédez à la section [Console.Login] :

  • UserName. Nom d'utilisateur d'accès à la console EMS.
  • Password. Mot de passe d'accès à la console EMS.
[Console.Login]
UserName=consoleuser
Password=consolepass

Connexion à la console EMS

Vous pouvez modifier les informations par défaut pour la connexion au serveur de la console EMS dans un environnement développeur. Dans le fichier EMSServer.ini, accédez à la section [Console.Connection.Dev] :

  • Port. Définit le port de connexion pour la requête HTTP à la console EMS. Le port par défaut du serveur de la console EMS dans un environnement de développement est le port 8081.
  • HTTPS. Active la prise en charge HTTPS pour la console EMS. Si ce paramètre est activé, vous devez installer OpenSSL dans votre système et configurer les informations du fichier de certification.
  • CertFile. Chemin d'accès absolu au fichier de certification auto-signé (fichier .pem) utilisé par la console EMS.
  • RootCertFile. Chemin d'accès absolu au fichier de certification CA (fichier .pem) utilisé par la console EMS. Si vous utilisez un certificat auto-signé, laissez ce paramètre vide.
  • KeyFile. Chemin d'accès absolu au fichier clé auto-signé (fichier .pem).
  • KeyFilePassword. Mot de passe défini pour utiliser le fichier de certification.
[Console.Connection.Dev]
Port=8081
;# The following options enable HTTPS support.
HTTPS=1
;# Set HTTPS=1 to enable HTTPS, HTTPS=0 to disable.
 CertFile=C:\Users\Public\Documents\Embarcadero\EMS\cacert.pem
; RootCertFile=
;# When using a self-signed certificate, RootCertFile is left blank.
 KeyFile=C:\Users\Public\Documents\Embarcadero\EMS\cakey.pem
 KeyFilePassword=certpassword

Paramètres du navigateur de la console EMS

Dans un navigateur Web, vous pouvez modifier les paramètres par défaut utilisés pour formater les données dans les tables de la console EMS. Dans le fichier EMSServer.ini, accédez à la section [Console.Browser] :

  • LimitRows. Nombre maximum de lignes de données apparaissant dans les tables. La valeur par défaut est 15.
  • DateFormat. Format utilisé pour les dates affichées dans le sélecteur de date de la console EMS. Vous pouvez modifier l'ordre des composants date ou des séparateurs de composants. Le format par défaut est Mois/Jour/Année.
[Console.Browser]
LimitRows=15
DateFormat=mm/dd/yy

Fichiers Web de ressource EMS

Vous pouvez modifier les scripts et les fichiers ressource pour afficher le serveur de console EMS dans un navigateur Web. Dans le fichier EMSServer.ini, accédez à la section [Console.Paths.Dev] (pour le développement) ou à la section [Console.Paths.ISAPI] (pour la production) :

  • Configuration par défaut sur un environnement de développeur :
[Console.Paths.Dev]
ResourcesFiles = C:\Program Files (x86)\Embarcadero\Studio\20.0\ObjRepos\en\EMS //Folder that contains the template folder (\webresources\templates\)
WebFiles= http://localhost/<folder_name> // URL to the WebFiles folder

Remarques :
  • Exemple de configuration pour un environnement de production, en utilisant un serveur Microsoft IIS :
[Console.Paths.ISAPI]
ResourcesFiles= C:\inetpub\wwwroot\<folder_name>  //Folder that contains the template folder (\webresources\templates\)
WebFiles=  http://localhost/<folder_name> // URL to the WebFiles folder 
Remarques :

Hébergement des ressources de fichiers web dans un serveur web

Vous pouvez configurer le serveur de la console EMS pour récupérer les ressources de fichiers web qui sont hébergées dans un hôte différent (en modifiant la propriété WebFile du fichier .ini).

Les ressources de fichiers web du serveur de la console EMS sont incluses dans les dossiers suivants :

  • /webresources/css/
  • /webresources/fonts/
  • /webresources/ico/
  • /webresources/img/
  • /webresources/js/

Pour accéder aux ressources de fichiers web dans un autre serveur web, vous devez autoriser la requête de domaine croisé sur le serveur web qui héberge les ressources. La requête de domaine croisé autorise la requête HTTP pour les ressources d'un autre domaine (à partir duquel la requête a été effectuée).

Vous devez inclure l'option Access-Control-Allow-Origin en tant qu'en-tête de réponse HTTP :

  • Access-Control-Allow-Origin: *
  • Access-Control-Allow-Origin: http://domain:8081/ (option plus restrictive)

Si vous utilisez le serveur Microsoft IIS pour héberger les ressources de fichiers web, voir la configuration du serveur Microsoft IIS pour autoriser les requêtes de domaines croisés.

Voir aussi