Windows » IIS Konfiguration für XWiki

IIS Konfiguration für XWiki

Zuletzt geändert von XWikiGuest am 20.10.2010, 22:32

Damit XWiki unter IIS 7.5 ohne Problme läuft müssen für die Website auf der sie betrieben werden soll einige Einstellungen vorgenommen werden. Diese müssen in der Webconfig durchgeführt werden. Das kann man entweder lokal, oder global durchführen.

Variante 1: Lokale konfigurieren der Website des IIS 7.5 ändern

Diese Einstellunge werden in jener Website durchgeführt in der XWiki laufen soll.

Einstellungen in der Webconfig der Seite

Sämtliche Einstellungen sind Sicherheitseinstellungen und erfolgen innerhalb des <security>...</secuity> Tags.

Double Escaping erlauben:

Folgenden Code in die web.config der Website eintragen (innerhalb <system.webserver>...</system.webserver>):

<security>
<requestFiltering allowDoubleEscaping="true"></requestFiltering>
</security>

Damit wird double escaping erlaubt.

Bin Ordner als auführbar und aufrufbar erlauben:

Auch diesen Code innerhalb von <system.webserver>...</system.webserver> bzw. <security>...</security> eintragen:

<hiddenSegments>
<remove segment="bin" />
</hiddenSegments>

Damit wird der Ordner <bin> von der Liste der hiddenSegements genommen.

Einstellungen in der Webconfig des virtuellen Ordners in der Website

Erlauben der Useranmeldung:

Als letzten Schritt muss man im virtuellen Ordner von Tomcat (in meinem Fall jakarta) die Fehlermeldung für Fehler 500 für alle Hosts aktivieren. dies kann man entweder über die Verwaltungskonsole vom IIS machen oder indem man folgenden Code in der web.config des virtuellen Ordners einträgt (auch hier innerhalb <system.webserver>...</system.webserver>):

<httpErrors errorMode="Detailed" />

Mit diesen Einstellungen sollte nun die XWiki ohne Probleme funktionieren. Natürlich können diese Einstellungen auch alle in der web.config des virtuellen Ordners durchgeführt werden.

Hier nochmals die Beispieldateien für die Konfiguration des Webservers für XWiki:

web.config für die Website:

<security>
<requestFiltering allowDoubleEscaping="true">
<hiddenSegments>
<remove segment="bin" />
</hiddenSegments>
</requestFiltering>
</security>

web.config für den virtuellen Ordner:

<system.webServer>
<handlers accessPolicy="Read, Execute, Script" />
<httpErrors errorMode="Detailed" />
</system.webServer>

Variante 2: Globale Konfiguration des IIS 7.5 ändern

Diese Vorgangsweise wird nicht! empfohlen!

Diese sind am besten in der webconfig.conf Datei von IIS 7 durchzuführen.

Achtung: Bevor man dort was ändert nicht vergessen ein Backup der Datei anzulegen!!!!

Zunächst muss man double escaping erlauben:

<security>
<requestFiltering allowDoubleEscaping="true" />
</security>

Außerdem muss man (ab IIS 7.5???) für Error 500 etwa eintragen damit etwa die Anmeldung an die XWiki funktioniert:

<httpErrors errorMode="Detailed">
<remove statusCode="500" subStatusCode="-1" />
<error statusCode="500" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="500.htm" />
</httpErrors>

Das wird wohl nur ein Workaround sein, sonst bekomme ich eine Fehlermeldung, dass ich nicht die Berechtigungen habe die Seite anzuzeigen, wenn ich das Selbe am Server direkt probiere wird die Seite ohne Probleme geladen.

Eine kompletter funktionierender conf Abschnitt für eine Seite auf der XWiki läuft schaut so aus:

<location path="NTADevelopment">
       <system.webServer>
           <isapiFilters>
               <filter name="Tomcat" path="C:\Program Files (x86)\Apache Software Foundation\jakarta\NTADevelopment\isapi_redirect.dll" preCondition="bitness64" />
           </isapiFilters>
    <httpErrors errorMode="Detailed">
               <remove statusCode="500" subStatusCode="-1" />
               <error statusCode="500" prefixLanguageFilePath="%SystemDrive%\inetpub\custerr" path="500.htm" />
           </httpErrors>
    <security>
 <requestFiltering allowDoubleEscaping="true" />
           </security>
       </system.webServer>
   </location>
Tags:
Erstellt von Administrator am 08.01.2010, 22:26

This wiki is licensed under a Creative Commons 2.0 license
XWiki Enterprise 3.1 - Documentation