Konfigurations-Files

Generelle Informationen zur Konfigurationsinfrastruktur

Das MSI-Setup installiert auf jeder Maschine die sogenannte Konfigurationsinfrastruktur im Verzeichnis Configuration unter dem für die Installation angegebenen Verzeichnispfad

C:\Program Files (x86)\Garaio\ROOMS\Configuration"

Das Konzept sieht vor, dass die Konfigurationsdateien immer nur in diesem Verzeichnis angepasst werden (Originale); mittels der mit installierten Datei Config.bat können sie jederzeit in die Verzeichnisse der Webapplikation und des Windows Services verteilt werden (Kopien).


Anmerkung: Die Datei Config.bat muss also immer ausgeführt werden, nachdem Anpassungen an den Konfigurationsdateien gemacht worden sind.

Dieses Vorgehen wird auch von den MSI-Setups angewendet, welche nach einem Update die bestehenden Konfigurationsdateien automatisch neu verteilen - so wird sichergestellt, dass die Konfigurationsdateien im Configuration Verzeichnis unverändert erhalten bleiben. Normalerweise sind Anpassungen an diesen Dateien nach der Erstinstallation (auch bei einem Update) nicht notwendig.

C:\Program Files (x86)\Garaio\ROOMS\Configuration

Falls nötig:

  1. Config.bat als Admin ausführen.
  2. xy.config als Admin ausführen/bearbeiten.
  3. Restart ROOMS Windows Service, nach der Ausführung von Config.bat

Anforderungen:

  1. Download Configuration Template

  2. Konfigurationsdateien in das Configuration Verzeichnis kopieren und anpassen.

     C:\Program Files (x86)\Garaio\ROOMS\Configuration
    
  3. AppSettings.config

    DefaultMandator: Unter value den Namen eines im ConnectionStrings.config hinterlegten ConnectionStrings eintragen, der auf diejenige Datenbank zeigt, die als Standard verwendet werden soll.

    Konfigurationsdateien in das Configuration Verzeichnis kopieren und anpassen.
     <appSettings>
         <add key="DefaultMandator" value="PROD"/>
     </appSettings>
    
  4. ConnectionStrings.config

    Für jede zu verwendende Datenbank muss ein add Eintrag vorhanden sein, bestehend aus einem frei wählbaren Namen (ohne Sonderzeichen) und einem ConnectionString, gemäß Defintion (Beispiele siehe hier). Der Name wird in der Webapplikation als Teil der URL sichtbar sein http(s)://SERVER/NAME/etc..

     <connectionStrings>
         <clear/>
         <add name="PROD" connectionString="Data Source=SERVER;Initial Catalog=DATABASE1;Integrated Security=SSPI;MultipleActiveResultSets=True"/>
         <add name="DEMO" connectionString="Data Source=SERVER;Initial Catalog=DATABASE2;Integrated Security=SSPI;MultipleActiveResultSets=True"/>
     </connectionStrings>
    

    Üblicherweise enthält ein ConnectionString folgende Angaben:

    • Datenquelle (Data Source): MS SQL Server (Servername oder IP Adresse) (mit Instanznamen, wenn es sich nicht um die Default-Instanz handelt)
    • Datenbank (Initial Catalog): Name der ROOMS Datenbank
    • Verbindungsart: Windows Authentication (Integrated Security=SSPI) oder SQL Benutzer (User Name=XXX; Password=YYY; Persist Security Info=True)

  5. DiagnosticsWeb.config / DiagnosticsWindowsService.config

    Hier kann das Logging angepasst werden, wobei normalerweise keine Änderungen vorgenommen werden sollten. Sollen zusätzliche Informationen geloggt werden, sind weitere Einträge mit folgendem Format möglich (die Werte NAME, LOGLEVEL und NAMESPACES müssen angepasst werden - 3volutions liefert bei Bedarf die entsprechenden Angaben):

    <...>
        <add name="NAME" type="Garaio.Products.Rooms.Core.Helpers.LogListenerSql, Garaio.Products.Rooms.Core">
    	    <filter type="Garaio.Library.Core.Diagnostics.LogFilterContext, Garaio.Library.Core" initializeData="LOGLEVEL|^NAMESPACE$"/>
        </add>
    <...>
    
  6. MachineKey.config

    Die Verschlüsselung der ROOMS Cookies muss immer mit demselbem Schlüssel vorgenommen werden. 3volutions liefert einen Standard-Schlüssel aus, der normalerweise nicht angepasst werden muss.

Anmerkung: Bei einer WebFarm muss zwingend auf allen Webservern derselbe Schlüssel verwendet werden.

Zuletzt geändert July 24, 2024: fix: update delegated access doc (56a050a)