Manuelles Bearbeiten der Konfiguration von RAD Server Console
Nach oben zu Einrichten von RAD Server Console
Inhaltsverzeichnis
Sie müssen die Datei EMSServer.ini bearbeiten, um den EMS-Konsolenserver zu konfigurieren.
Das Standardpfad lautet: C:\Benutzer\Öffentlich\Öffentliche Dokumente\Embarcadero\EMS
- Hinweis:
Wenn Sie diese Datei ändern, müssen Sie den EMS-Konsolenserver beenden und neu starten, um die Datei emsserver.ini neu zu laden.
Konfiguration der EMS-Datenbank
Sie können die Standardinformationen der EMS-Datenbank ändern, die der EMS-Konsolenserver verwendet. Suchen Sie in der Datei EMSServer.ini den Abschnitt [Data]:
- InstanceName.
Gibt die InterBase-Instanz an, auf der sich die EMS-Datenbank befindet.
- InstanceName hat das folgende Format:
[[<Host>/]<Instanz>]
. Folgende Kombinationen sind möglich:- Wert ist ein leerer String: Standardinstanz der Datenbank wird auf dem lokalen Host ausgeführt.
<Instanz>
: angegebene Instanz der Datenbank wird auf dem lokalen Host ausgeführt.<Host>/<Instanz>
: angegebene Instanz der Datenbank wird auf dem angegebenen Host ausgeführt.
- Database.
Lokales oder Remote-Verzeichnis der EMS-Datenbankdatei.
- UserName.
Benutzername für den Zugriff auf die EMS-Datenbank.
- Password.
Passwort für den Zugriff auf die EMS-Datenbank.
- SEPassword.
Passwort für die Verbindung mit einer verschlüsselten InterBase-Datenbank.
- Pooled.
Aktiviert das FireDAC-Verbindungs-Pooling mit der EMS-Datenbank, um die Wartezeit zu reduzieren.
- PooledMax.
Maximal zulässige Anzahl der in den Pool gestellten Verbindungen zur EMS-Datenbank.
[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.
Anmeldekonfiguration der EMS-Konsole
Sie können die Standardanmeldeinformationen ändern, um auf die EMS-Konsole mit einem normalen Browser zuzugreifen. Suchen Sie in der Datei EMSServer.ini den Abschnitt [Console.Login]:
- UserName. Standardbenutzer für den Zugriff auf die EMS-Konsole.
- Password.
Passwort für den Zugriff auf die EMS-Konsole.
[Console.Login] UserName=consoleuser Password=consolepass
Verbindung zur EMS-Konsole
Sie können die Standardinformationen für die Verbindung mit Ihrem EMS-Konsolenserver in einer Entwicklungsumgebung ändern. Suchen Sie in der Datei EMSServer.ini den Abschnitt [Console.Connection.Dev]:
- Port. Legt den Verbindungs-Port für die HTTP-Anforderung an die EMS-Konsole fest. Der Standard-Port für den EMS-Konsolenserver in einer Entwicklungsumgebung ist
8081
. - HTTPS. Aktiviert die HTTPS-Unterstützung für die EMS-Konsole. Falls aktiviert, müssen Sie OpenSSL auf Ihrem System installieren und die Zertifizierungsdateiinformationen konfigurieren.
- CertFile. Absoluter Pfad zu der selbstsignierten Zertifizierungsdatei (
.pem
-Datei), die von der EMS-Konsole verwendet wird. - RootCertFile. Absoluter Pfad zu der CA-Zertifizierungsdatei (
.pem
-Datei), die von der EMS-Konsole verwendet wird. Wenn Sie ein selbstsigniertes Zertifikat verwenden, lassen Sie diese Angabe frei. - KeyFile. Absoluter Pfad zu der selbstsignierten Schlüsseldatei (
.pem
-Datei). - KeyFilePassword. Passwort, das für die Verwendung der Zertifizierungsdatei festgelegt wurde.
[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
Browser-Einstellungen für die EMS-Konsole
Sie können die Standardeinstellungen ändern, anhand derer Daten in den Tabellen der EMS-Konsole in einem Webbrowser formatiert werden. Suchen Sie in der Datei EMSServer.ini den Abschnitt [Console.Browser]:
- LimitRows. Maximale Zeilenanzahl, die in den Tabellen angezeigt wird. Der Vorgabewert ist
15
. - DateFormat. Format für die angezeigten Datumsangaben in der Datumsauswahl der EMS-Konsole. Sie können die Reihenfolge der Datumskomponenten oder die Komponententrennzeichen ändern. Das Standardformat ist
Monat/Tag/Jahr
.
[Console.Browser] LimitRows=15 DateFormat=mm/dd/yy
Webdateien für EMS-Ressourcen
Sie können die Skripte und Ressourcendateien zur Darstellung des EMS-Konsolenservers in einem Webbrowser ändern. Suchen Sie in der Datei EMSServer.ini den Abschnitt [Console.Paths.Dev] (für die Entwicklung) oder den Abschnitt [Console.Paths.ISAPI] (für die Produktion):
- Standardkonfiguration in einer Entwicklungsumgebung:
[Console.Paths.Dev]
ResourcesFiles = C:\Program Files (x86)\Embarcadero\Studio\21.0\ObjRepos\en\EMS
//Folder that contains the template folder (\webresources\templates\)
WebFiles= http://localhost/<folder_name> // URL to the WebFiles folder
- Hinweise:
- Wenn WebFiles leer ist, sucht der EMS-Konsolenserver die Webdateien im Pfad ResourcesFiles.
- Wenn der Parameter WebFiles nicht leer ist, dann wird er auf den URL der Webdateien gesetzt.
- Wenn WebFiles in einem Webserver verwendet wird, müssen Sie domäneübergreifende Anforderungen auf einem Webserver zulassen.
- Beispiel der Konfiguration für eine Produktionsumgebung mit einem Microsoft IIS-Server:
[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
- Hinweise:
- Wenn WebFiles leer ist, befindet sich der Ordner "webresources" im selben Ordner wie die DLL-Dateien.
- Wenn der Parameter WebFiles nicht leer ist, dann wird er auf den URL der Webdateien gesetzt.
- Wenn WebFiles in einem Webserver verwendet wird, müssen Sie domäneübergreifende Anforderungen auf einem Webserver zulassen.
- Weitere Informationen zur Installation des EMS-Konsolenservers in einer Produktionsumgebung finden Sie unter Installieren des EMS-Servers oder des EMS-Konsolenservers in einer Produktionsumgebung unter Windows.
Hosten von Webdateiressourcen auf einem Webserver
Sie können den EMS-Konsolenserver so konfigurieren, dass Webdateiressourcen, die sich auf einem anderen Host befinden, abgerufen werden (durch Ändern der Eigenschaft WebFile der INI-Datei).
Die Webdateiressourcen des EMS-Konsolenservers sind in den folgenden Ordnern enthalten:
- /webresources/css/
- /webresources/fonts/
- /webresources/ico/
- /webresources/img/
- /webresources/js/
Um auf die Webdateiressourcen auf einem anderen Webserver zuzugreifen, müssen Sie domäneübergreifende Anforderungen auf dem Webserver zulassen, auf dem sich die Ressourcen befinden. Domäneübergreifende Anforderungen ermöglichen HTTP-Anforderungen von Ressourcen aus einer anderen Domäne (für die die Anforderung erfolgt ist).
Sie müssen die Option Access-Control-Allow-Origin als einen HTTP-Response-Header einfügen:
- Access-Control-Allow-Origin: *
- Access-Control-Allow-Origin: http://domain:8081/ (restriktivere Option)
Informationen zum Hosten von Webdateiressourcen mit Microsoft IIS Server finden Sie unter Konfigurieren von Microsoft IIS Server für domäneübergreifende Anforderungen.