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
- XWiki Homepage
- XWiki Download (das „XWiki-Enterprise“ WAR file muss heruntergeladen werden)
- Debian 4 (etch)
- PostgreSQL 8.2.7 (oder aktueller) ODER MySQL 5
- Root-Zugriff (sudo/su)
- Nach jeder Code-Zeile muss der „Enter-Button“ betaetigt werden
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!