Menü der Dokumentation

Konfigurationsdatei

Mithilfe einer Konfigurationsdatei können Sie weitere, allgemeinere Einstellungen für die Anwendung vornehmen.Die Konfigurationsdatei finden Sie sich im Installationsverzeichnis im Unterordner conf. Die Konfigurationsdatei heißt appsettings.config.

Beispiel:

Ist d.ecs monitor for d.3 hostimp im Verzeichnis

C:\d3\d.ecs monitor for d.3 hostimp\

installiert, sodass die Anwendung im Verzeichnis

C:\d3\d.ecs monitor for d.3 hostimp\bin\

liegt, dann sollte dieKonfigurationsdatei folgenden Pfad besitzen:

C:\d3\d.ecs monitor for d.3 hostimp\conf\appsettings.config

Anmerkung

Gegebenenfalls müssen Sie Ordner sowie Konfigurationsdatei vorher anlegen.

Anmerkung

Änderungen an der Konfigurationsdatei werden erst bei einem Programmneustart übernommen.

Die leereappsettings.configDatei besteht aus den folgenden XML-Wurzelelementen:

<?xml version="1.0" encoding="utf-8"?>
<appSettings>
</appSettings>

Für jede vorzunehmende Einstellung wird anschließend jeweils ein Element unterhalb des <appSettings>-Knoten hinzugefügt. Der Aufbau dieser Elemente ist immer wie folgt:

<add key="[key]" value="[value]" />

Für folgende Schlüssel können Werte eingetragen werden:

port

  • Mithilfe dieses Schlüssels kann ein fester Port vorgegeben werden. Die Anwendung versucht beim Start anschließend den vorgegebenen Port zu nutzen. Ist der Port bereits belegt kann die Anwendung nicht starten.

  • Mögliche Werte sind Ganzzahlen.

  • Ist der Schlüssel nicht angegeben, wird ein zufälliger Port genutzt.

protocol

  • Dieser Schlüssel bestimmt, mit welchem Protokoll der Webserver der Anwendung gestartet werden soll.

  • Mögliche Werte sind "http" und "https".

  • Ist der Schlüssel nicht angegeben, wird standardmäßig "http" genutzt.

Warnung

Soll die Anwendung mit HTTPS ausgeführt werden, müssen noch weitere Einstellungen vorgenommen werden.

Setzen Sie einen festen Port. Ein festgelegter Port ist notwendig, da für diesen Port das HTTPS Protocol mit einem entsprechenden Zertifikat aus dem Windows-Zertifikatsspeicher aktiviert werden muss.

Registieren Sie die Addresse Ihrer Anwendung mithilfe des folgenden Befehls (ersetzen Sie dabei ggf. "Jeder" durch "Everyone" bei englischen Systemen):

netsh http add urlacl url=https://[HOST]:12345/ user=Jeder

Registrieren Sie ihr Zertifikat mithilfe des folgenden Befehls:

netsh http add sslcert ipport=0.0.0.0:12345 certhash=[Fingerabdruck des zu verwendenden Zertifikats] appid={[GUID]}

Beachten Sie, dass die GUID nur einmal pro System vergeben werden darf.

enableErrorhandling

  • Beeinflusst das Feature, die aufgetretenen Nutzdaten der Fehler mit Hilfe des d.ecs monitor for d.3 hostimp zu visualisieren. Die Funktion kann aus Sicherheitsgründen deaktiviert werden. Weitere Information zu diesem Feature finden Sie im Kapitel Verwaltung von d.3 hostimp Fehlerdateien.

  • Mögliche Werte sind "true" und "false".

  • Ist der Schlüssel nicht angegeben, wird standardmäßig "true" genutzt. Wird ein anderer Wert als einer der möglichen Werte gegeben, wird der Wert "false" genutzt.

Beispiel:

Eine Konfigurationsdatei mit allen möglichen Anpassungen könnte wie folgt aussehen:

<?xml version="1.0" encoding="utf-8"?>
<appSettings>
  <add key="enableErrorhandling" value="false" />
  <add key="port" value="4200" />
  <add key="protocol" value="https" />
</appSettings>