Modification manuelle de la configuration de votre console RAD Server

De RAD Studio
Aller à : navigation, rechercher

Remonter à Configuration de votre console RAD Server

Vous devez modifier le fichier EMSServer.ini pour configurer la console RAD Server.

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

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

Configuration de la base de données de RAD Server

Vous pouvez modifier les informations par défaut de la base de données RAD Server utilisée par la console RAD Server. 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 de RAD Server.
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. Fichier local du fichier de la base de données de RAD Server ou son répertoire distant.
  • UserName. Nom d'utilisateur pour l'accès à la base de données de RAD Server.
  • Password. Mot de passe pour l'accès à la base de données de RAD Server.
  • 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 RAD Server pour réduire la latence.
  • PooledMax. Nombre maximal de connexions en pool autorisées sur la base de données de RAD Server.
  • ClientLib. Chemin facultatif vers la bibliothèque du client InterBase.
  • DriverFile. Chemin facultatif vers le fichier FDDrivers.ini de FireDAC.
  • ConnectionDefFile. Chemin facultatif vers le fichier FDConnectionDef.ini de FireDAC.
[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 RAD Server

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

[Console.Login]
UserName=consoleuser
Password=consolepass

Connexion à la console RAD Server

Vous pouvez modifier les informations par défaut pour la connexion à la console RAD Server 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 RAD Server. Le port par défaut de la console RAD Server dans un environnement de développement est le port 8081.
  • HTTPS. Active le support HTTPS pour la console RAD Server. 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 RAD Server.
  • RootCertFile. Chemin d'accès absolu au fichier de certification CA (fichier .pem) utilisé par la console RAD Server. Si vous utilisez un certificat auto-signé, laissez ce paramètre vide.
  • KeyFile. Chemin d'accès absolu au fichier de 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 RAD Server

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 RAD Server. 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 RAD Server. 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 RAD Server

Vous pouvez modifier les scripts et les fichiers ressource pour afficher la console RAD Server 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\22.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 la console RAD Server pour récupérer les ressources de fichiers web qui sont hébergées sur un hôte différent (en modifiant la propriété WebFile du fichier .ini).

Les ressources de fichiers web de la console RAD Server 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