XWiki in Debian 4 (Etch) – Tomcat – PostgreSQL (oder MySQL)

XWiki in Debian 4 (Etch) – Tomcat – MySQL

XWiki in Debian 4 (Etch) – Tomcat – PostgreSQL (oder MySQL) (aus dem Englischen Original; uebersetzt vom Autor)

XWiki ist ein professionelles wiki mit Features wie Blog, ausgefeiltes Rechtemanagment, LDAP Authentifizierung, PDF-Export, Template-Support und vieles mehr. Ausserdem bietet XWiki einen fortschrittlichen Formular und Skript Generator, welcher XWiki zu einer vollstaendigen Entwicklungsumgebung fuer datenbasierende Applikationen macht. Weiter werden maechtige Funktionen zur Erweiterung, wie Skripting innerhalb von XWiki-Seiten, Plugins und eine stark modulare Architektur, bereitgestellt. Fuer weitere Informationen sei auf die (englische) Feature-Liste verwiesen.

Installation

Voraussetzungen

Hier geht’s los

1. Zuerst installieren wir JAVA JDK 5

apt-get install sun-java5-jdk
JAVA_OPTS=“-Xmx512M“
export JAVA_HOME
export JAVA_OPTS

Die Variable „-Xmx512M“ setzt das Maximum an RAM, welches fuer JAVA bereit steht und variert je nach Serverausstattung.

2. Wir installieren Tomcat 5.5

apt-get install tomcat5.5 tomcat5.5-admin tomcat5.5-webapps
/etc/init.d/tomcat5.5 stop

3. Wir deaktivieren Tomcat security

vi /etc/init.d/tomcat5.5

TOMCAT5_SECURITY=no

4. Wir erstellen die XWiki Datenbank

PostgreSQL


CREATE DATABASE xwiki
WITH OWNER = mit_dem_admin-user_ersetzen_bspw_pgsql
ENCODING = ‚UNICODE‘
TABLESPACE = pg_default;

CREATE USER xwiki PASSWORD ‚xwiki‘ VALID UNTIL ‚infinity‘;

CREATE GROUP xwiki;
ALTER GROUP xwiki ADD USER xwiki;
GRANT ALL ON SCHEMA public TO xwiki;

MySQL

mysql -u root -e „create database xwiki“
mysql -u root -e „grant all privileges on xwiki.* to xwiki@127.0.0.1 identified by ‚xwiki'“

5. Nun laden wir das WAR-File in unseren neuen Tomcat webapps Ordner herunter

cd /var/lib/tomcat5.5/webapps/
wget http://download.forge.objectweb.org/xwiki/xwiki-enterprise-web-1.3.war

Einfach den Direkt-Link von der XWiki-Seite nach dem „wget“ kopieren.

6. Das WAR-File umbenennen und Tomcat neustarten

mv /var/lib/tomcat5.5/webapps/* /var/lib/tomcat5.5/webapps/xwiki.war
/etc/init.d/tomcat5.5 restart

Nach „webapps“ ersetze den „Stern“mit dem Dateinamen des eben kopierten Links.

7. Wir muessen den PostgreSQL oder MySQL JDBC Treiber herunterladen

PostgreSQL Prozedere

cd /var/lib/tomcat5.5/webapps/xwiki/WEB-INF/lib/
wget http://jdbc.postgresql.org/download/postgresql-8.3-603.jdbc4.jar

chown tomcat55:nogroup /var/lib/tomcat5.5/webapps/xwiki/WEB-INF/lib/postgresql-8.3-603.jdbc4.jar
/etc/init.d/tomcat5.5 restart

MySQL Prozedere
http://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-5.1.5.tar.gz/from/pick#mirrors.
Lade die Datei herunter, entzippe sie und lade die „mysql-connector-java-5.1.5-bin.jar“ Datei (661KB) in den Ordner „/home/user“ (ich hoffe Root-Logins sind auf dem Server nicht moeglich!!).

mv /home/user/mysql-connector-java-5.1.5-bin.jar /var/lib/tomcat5.5/webapps/xwiki/WEB-INF/lib/mysql-connector-java-5.1.5-bin.jar
chown tomcat55:nogroup /var/lib/tomcat5.5/webapps/xwiki/WEB-INF/lib/mysql-connector-java-5.1.5-bin.jar
/etc/init.d/tomcat5.5 restart

8. Editiere hibernate.cfg.xml

vi /var/lib/tomcat5.5/webapps/xwiki/WEB-INF/hibernate.cfg.xml

    <!-- PostgreSQL configuration.
         Uncomment if you want to use PostgreSQL and comment out other database configurations.
         Note that the database will be created automatically if it doesn't already exist.-->
    <property name="connection.url">jdbc:postgresql://localhost:5432/xwiki</property>
    <property name="connection.username">xwiki</property>
    <property name="connection.password">xwiki</property>
    <property name="connection.driver_class">org.postgresql.Driver</property>
    <property name="dialect">org.hibernate.dialect.PostgreSQLDialect</property>
    <property name="connection.provider_class">com.xpn.xwiki.store.DBCPConnectionProvider</property>
    <property name="connection.pool_size">2</property>
    <property name="statement_cache.size">2</property>
    <mapping resource="xwiki.hbm.xml"/>
    <mapping resource="feeds.hbm.xml"/>
<!-- MySQL configuration.
         Uncomment if you want to use MySQL and comment out other database configurations.
         Note that the database will be created automatically if it doesn't already exist.-->
    <property name="connection.url">jdbc:mysql://localhost/xwiki</property>
    <property name="connection.username">xwiki</property>
    <property name="connection.password">xwiki</property>
    <property name="connection.driver_class">com.mysql.jdbc.Driver</property>
    <property name="dialect">org.hibernate.dialect.MySQLDialect</property>
    <property name="connection.provider_class">com.xpn.xwiki.store.DBCPConnectionProvider</property>
    <property name="connection.pool_size">2</property>
    <property name="statement_cache.size">2</property>
    <mapping resource="xwiki.hbm.xml"/>
    <mapping resource="feeds.hbm.xml"/>

Achtung! Stelle bitte sicher, dass korrekt unkommentiert wurde („<!–“ startet einen Kommentar „–>“ beendet einen Kommentar) also entweder den PostgreSQL-Teil oder den MySQL-Teil. Auch muss der User-Name (sofern ein anderer als ‚xwiki‘ unter Schritt 4 gewaehlt wurde) und das Passwort (!) entsprechend angepasst werden!

9. Apache & Domain (optional)

Wenn man auf XWiki nur mittels IP-Adresse zugreifen moechte, kann man den nachfolgenden Schritt weglassen, da man bereits jetzt auf XWiki mit http://MyIP:8180/xwiki sehen sollte.

Falls dies nicht genuegt, muessen ein paar Anpassungen in der Apache Konfiguration vorgenommen werden. Falls bereits ein Domain-Eintrag vorhanden sein sollte, muss diese entsprechen angepasst werden. Ansonsten kopiert man einfach den untenstehenden Text in die neue Datei, welche folgendermassen erstellt wird:

vi /etc/apache2/sites-enabled/domain.conf

NameVirtualHost MyIP:80

<VirtualHost MyIP:80>

DocumentRoot /var/www/
<Directory "/var/www/">
 Options -Indexes Includes FollowSymLinks
 AllowOverride All
 Allow from all
</Directory>

RedirectMatch permanent ^/$ http://domain/xwiki/

ProxyPass /xwiki http://domain:8082/xwiki/
ProxyPassReverse /xwiki  http://domain:8082/xwiki/

</VirtualHost>

Ersetze „domain“ mit dem entsprechenden Domain-Namen.

Die Module „mod_alias“ und „mod_proxy“ muessen aktiviert werden. Mod_alias wird fuer die RedirectMatch Anweisung und mod_proxy wird fuer den ProxyPass und ProxyPassReverse benoetigt.

Falls alias.conf und proxy.conf nicht unter dem Ordner /etc/apache2/mods-enabled zu sehen sind, muessen diese manuell aktiviert werden:

a2enmod alias
a2enmod proxy

Anschliessend den Apache neustarten:

/etc/init.d/apache2 restart

Nun sollte das XWiki unter der Adresse http://domain/ erscheinen

10. Aendere /var/lib/tomcat5.5/conf/tomcat-users.xml

<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
<role rolename="admin"/>
<role rolename="manager"/>
<role rolename="tomcat"/>
<user username="tomcat"
password=”tomcatpassword”
roles="tomcat,admin,manager"/>
</tomcat-users>

Achtung! Dies stellt uU. ein Sicherheitsrisiko dar. Ich habe saemtliche Rollen einem User zugeteilt, da ich der Einzige bin, welcher die Seite administriert. Passe „username“ und „password“ entsprechend an.

11. Import des initialen Contents & Settings

Gehe auf: http://platform.xwiki.org/xwiki/bin/view/AdminGuide/Installation#HInstallingtheDefaultWikiXAR und folge den Anweisungen.

Das war’s!

Das könnte dich auch interessieren …