Web-Service-Installation

Der easyLogic-Web-Service (el-ws) bildet die Schicht zwischen Client und Datenbank. Er basiert auf ASP.NET 3.5. Die Kommunikation findet über SOAP via HTTP statt, d.h. es wird XML über (üblicherweise) Port 80 übertragen.

Voraussetzungen

• .NET Framework 3.5 SP1. Ab Windows 7 bzw. Windows Server 2008 R2 ist dies als optionale Komponente über "Windows-Funktionen aktivieren" zu installieren (die dortige Version 3.5.1 weicht nur minimal ab, und erfüllt die Voraussetzungen).
• Web Service Enhancements 3.0
• IIS 7.0 mit folgenden Komponenten:
  • ASP.NET
  • Basic-Authentifizerung
  • Statische und dynamische Kompression (empfohlen)

IIS 6.0 funktioniert, wird jedoch nicht unterstützt. Unsere Dokumentation geht von 7.0 oder 7.5 aus.

Installation

Die Versionsnummer findet sich hier. Den aktuellen Code erhält man als zip-Archiv, indem man die Version in folgende URL einfügt: http://ws5.easylogic.de/el-ws/easyLogic-WS-%VERSIONSNUMMER%.zip, z.B. http://ws5.easylogic.de/el-ws/easyLogic-WS-14426.zip

Konfiguration

Der Web-Service ist als Ordner zu entpacken sowie in IIS als Anwendung anzulegen. Es wird empfohlen, für diese einen eigenen Anwendungspool zu erstellen. Im Weiteren wird von einem Pool namens eLAppPool ausgegangen.

Der Benutzer des Anwendungspools sollte auf den Ordner Vollzugriff haben. Der Explorer in Windows Server 2008 findet die Anwendungspool-Benutzer nicht; der Explorer in Windows Server 2008 R2 macht das Finden etwas umständlich. In beiden Fällen ist es deutlich einfacher, über die Eingabeaufforderung zu arbeiten. Heißt der Benutzer des Anwendungspools z.B. IIS AppPool\eLAppPool und liegt der Web-Service bei C:\inetpub\wwwroot\el-ws, so setzt folgender Befehl die Rechte korrekt:

icacls c:\inetpub\wwwroot\el-ws /grant "IIS AppPool\eLAppPool":(OI)(CI)(F) /T

Datenbank-Verbindung

Es wird empfohlen, im Datenbank-Server den Anwendungspool-Benutzer als SQL-Benutzer via Windows-Authentifizerung anzulegen. Auf diesem Wege ist kein Passwort erforderlich und dennoch eine hohe Sicherheit gewährleistet.

Für die Verbindung über integrated security ist folgende Einstellung im Webservice (web.config) erforderlich:

 
	<appSettings>
		<add key="ConnectionStringOhneDBundServer" value="integrated security=true;connect timeout=30" />
	</appSettings>

Updates

Eine korrekte Installation aktualisiert sich ggfs. selbst. Eine Versionsprüfung findet immer dann statt, wenn eine Session gestartet wird, also z.B. beim Starten des Clients (direkt vor dem Erscheinen des Fortschrittsbalkens). Üblicher Grund für fehlschlagende Updates sind falsche Dateisystemrechte (s.o.).