1. Install Resin Quercus

Make sure you have a proper JDK and a recent Tomcat installed. Download the latest Quercus Release and extract it into a folder mediawiki the Tomcat’s /webapps folder (hint: it’s a ZIP-file, rename and unzip).

2. Extract Mediawiki

Download the latest Mediawiki and extract in the mediawiki – Folder created in the last step. In your Tomcat installation, you should now have a mediawiki – folder in which you have a Mediawiki-Installation plus two special folders, WEB-INF and META-INF. Update the web.xml with the following bold part.

3. Configure Quercus

Quercus comes with a preconfigured web.xml in the WEB-INF – folder. We have to “pimp” it a little to make Mediawiki run properly.

<servlet>
<servlet-name>Quercus Servlet</servlet-name>
<servlet-class>com.caucho.quercus.servlet.QuercusServlet</servlet-class>
<!--
Tells Quercus to use the following JDBC database and to ignore the
arguments of mysql_connect(). We'll configure the MySQL database
pool in the next step.
-->
<init-param>
<param-name>database</param-name>
<param-value>jdbc/mediawiki</param-value>
</init-param>
</servlet>
<!--
Tells the Quercus Servlet to parse all files ending on .php
-->
<servlet-mapping>
<servlet-name>Quercus Servlet</servlet-name>
<url-pattern>*.php</url-pattern>
</servlet-mapping>
<!--
Tells the Quercus Servlet to parse all Requests starting with index.php/
We need this to support the pretty urls in Mediawiki
-->
<servlet-mapping>
<servlet-name>Quercus Servlet</servlet-name>
<url-pattern>index.php/*</url-pattern>
</servlet-mapping>
</servlet>


3. Configure MySQL as JNDI-Datasource in Tomcat

In order to unleash the full power of a JEE-powered Mediawiki, we’ll configure a pooled MySQL datasource. In order to access MySQL from Tomcat, we need a proper MySQL database driver. Download it here and place the contained mysql-connector-java-5.1.12-bin.jar in Tomcat’s /lib directory. Prepare a MySQL database to hold the Mediawiki database tables. Create a MySQL user if necessary.

Then place a file named context.xml in the /webapps/mediawiki/META-INF folder. Fill the variables with values matching your environment:

<?xml version="1.0" encoding="UTF-8"?>
<Context>
<Resource name="jdbc/mediawiki" auth="Container"
type="javax.sql.DataSource"
maxActive="20" maxIdle="2" maxWait="10000"
username="<<MYSQL_USERNAME>>" password="<<MYSQL_PASSWORD>>"
driverClassName="com.mysql.jdbc.Driver"
url="jdbc:mysql://<<MYSQL_HOST>>:<<MYSQL_PORT>>/<<MYSQL_DATABASE_NAME>>"/>
</Context>


4. Run the Mediawiki-Installer

Fire up Tomcat and go to http://localhost:8080/mediakwiki/config/index.php. Follow the installation steps of Mediawiki. For debugging purposes place a phpinfo.php file in the /webapps/mediawiki folder:

<?php
phpinfo();
?>

Enjoy! In the next post I’ll write some lines about Single-Sign-On with NTLM and Tomcat/Apache/Mediawiki.

Gestern war es dann soweit. Der JSP-Parser (der endlich Java 5 & 6 spricht) versagt bei einer doppelten Definition eines Tag-Verzeichnisses:

SRVE0293E: [Servlet-Fehler]-[/WEB-INF/jsp/index.jsp]: com.ibm.ws.jsp.JspCoreException: /WEB-INF/jsp/index.jsp(66,63) /WEB-INF/jsp/other.jsp(5,53) JSPG0240E: Es wurde versucht, das Präfix "ringwelt" in "urn:jsptagdir:/WEB-INF/tags" zu ändern, obwohl es im aktuellen Geltungsbereich bereits mit "/WEB-INF/tags" definiert ist.

Nach einigem Suchen ließ sich das Problem wiefolgt isolieren: Die JSP index.jsp inkludiert die JSP other.jsp statisch. Beide Dateien enthalten eine identische Tagdir-Definition und nutzen den gleichen Taglib-Prefix. Sobald der Include in der index.jsp innerhalb eines JSP-Tags erfolgt, schmeißt der WAS7 die o.g. Exception.

index.jsp
<%@ page contentType="text/html;charset=UTF-8"%>
<%@ taglib prefix="ringwelt" tagdir="/WEB-INF/tags"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<!-- This will work -->
<%@ include file="other.jsp" %>
<!--
This will fail due to the second declaration of
the tagdir prefix above
-->
<c:if test="${1 == 1}">
<%@ include file="other.jsp" %>
</c:if>

other.jsp
<%@ page contentType="text/html;charset=UTF-8"%>
<taglib prefix="ringwelt" tagdir="/WEB-INF/tags"%>
<ringwelt:hello />


Wie kann man so etwas nicht getestet haben? Ist mir unbegreiflich? Wir haben den Bug zur IBM gegeben. Vielleicht zeigt sich “Big Blue” ja erkenntlich und lädt mich zu irgendeiner Webspherekonferenz ein. Gerne in Übersee ;-)

Als ich einen Teil der Buildprozesse beim Deutschen Ring auf den Hudson Buildserver umgestellt habe, bin ich auf das “Red Bear Alert Extreme Feedback Device” gestossen. Die Idee, farbige Lampen über eine USB-Steckdose zu schalten war so einfach und genial – das wollte ich auch. Leider habe ich keinen reine 5V-USB-Lösung gefunden, dafür aber eine relativ kostengünstige Steckdosenleiste, die sich per USB von einem Windowsrechner steuern lässt. Da ich den Spaß privat bezahlt habe, sollten noch ein paar günstige Lampen dazu und fertig.

Die Einzelteile

• SIS-PM Steckdosenleiste über USB schaltbar (EUR 25,- mit Conradgutschein)
• 3 Mal Grönö von IKEA (3 x EUR 3,99)
• je 1 Paket rote, grüne und gelbe Glühbirnen von IKEA (3 x EUR 2,59)

Macht zusammen EUR 44,47 … geht noch.

Der Zusammenbau
Der Zusammenbau ist straight forward. Glühbirne in Lampe, Lampe in Steckdose, Steckdose per USB an einen Windowsrechner.

Dann die Software für die SIS-PM von Gembird herunterladen und installieren (für die man leider lokale Adminrechte benötigt!).

Zur besseren Ansteuerbarkeit habe ich eindeutige, sprechende Namen über die Gembirdsoftware vergeben. Anschließend habe ich das Kommandozeileninterface getestet. Einziges Manko ist, dass man den aktuellen Zustand der Leiste nicht via Kommandozeile abgreifen kann.

pm.exe -on Ampel -Gruen
pm.exe -off Ampel -Gelb

Ansteuern über das Netzwerk
Unser Softwarebuild erfolgt dezentral, deshalb sollte das Device über HTTP angesprochen werden. Getreu dem Motto “Für einen Mann mit einem Hammer ist die Welt voller Nägel” habe ich eine kleine Javakapsel um die Kommandozeilenaufrufe geschrieben, die über HTTP verschiedene Methoden zur Verfügung stellt:

• buildFailed – Der Compile ist fehlgeschlagen, die Ampel wird rot
• testsFailed – Die Tests sind fehlgeschlagen, die Ampel wird gelb
• ok – Alles Schoko, die Ampel wird grün
• building – Ein neuer Build wurde gestartet. Die Ampel blinkt in Ihrer aktuellen Farbe
• disco – Die Vorführfunktion für Gäste ;-)

Intern zieht die Software einen Jetty hoch, der die HTTP-Anfragen verarbeitet und via SWT liegt ein Icon im Tray, mit der sich die Anwendung steuern lässt.

Integration in den Buildprozess
Die Integration in unseren ANT-Buildprozess war denkbar einfach. Über den GET-Task lassen sich URLs aus ANT aufrufen:

<get src="http://bob.intra....de/feedack/ringwelt/ok" dest="${java.io.tmpdir}/.feedback"/>

Fertig. Übrigens: Das Kategoriebild für “Codecrunch” ist die Buildampel beim Deutschen Ring in Aktion!