Manuelles Bearbeiten der Konfiguration von RAD Server Console

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu Einrichten von RAD Server Console

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:
  • 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:

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.

Siehe auch