Modification manuelle de la configuration de votre console RAD Server
Remonter à Configuration de votre console RAD Server
Sommaire
- 1 Configuration de la base de données de RAD Server
- 2 Configuration de la connexion à la console RAD Server
- 3 Connexion à la console RAD Server
- 4 Paramètres du navigateur de la console RAD Server
- 5 Fichiers Web de ressource RAD Server
- 6 Hébergement des ressources de fichiers web dans un serveur web
- 7 Voir aussi
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] :
- UserName. Utilisateur par défaut pour l'accès à l'interface utilisateur de la console RAD Server.
- Password. Mot de passe pour l'accès à la console RAD Server.
[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
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:
- Si WebFiles est vide, la console RAD Server utilisera le chemin ResourcesFiles pour trouver les fichiers web.
- Si WebFiles n'est pas vide, il est défini sur l'URL des fichiers web.
- Si WebFiles est utilisé dans un serveur web, vous devez autoriser les requêtes de domaines croisés dans un serveur web.
- 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:
- Si WebFiles est vide, le dossier webresources est situé dans le dossier des fichiers dll.
- Si WebFiles n'est pas vide, il est défini sur l'URL des fichiers web.
- Si WebFiles est utilisé dans un serveur web, vous devez autoriser les requêtes de domaines croisés dans un serveur web.
- Pour plus d'informations sur l'installation de la console RAD Server sur un environnement de production, voir Installation de RAD Server ou de la console RAD Server sur un environnement de production sous Windows.
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.