XWiki installieren: Unterschied zwischen den Versionen

Aus Hostsharing Wiki
Zur Navigation springen Zur Suche springen
(neues Ansible Skript verlinkt, bei Codeberg, und Versionsnummern aktualisiert)
K (→‎Installation von XWiki: Versionen aktualisiert)
 
(Eine dazwischenliegende Version von einem anderen Benutzer wird nicht angezeigt)
Zeile 31: Zeile 31:
Man kann verschiedene Versionen von XWiki wählen: LTS oder Stable, siehe https://www.xwiki.org/xwiki/bin/view/Download/
Man kann verschiedene Versionen von XWiki wählen: LTS oder Stable, siehe https://www.xwiki.org/xwiki/bin/view/Download/


Wenn man z.B. LTS wählt, kommt man momentan auf https://www.xwiki.org/xwiki/bin/view/Download/DownloadVersion/?projectVersion=14.10.12
Wenn man z.B. LTS wählt, kommt man momentan auf https://www.xwiki.org/xwiki/bin/view/Download/DownloadVersion/?projectVersion=15.10.11


Dort sollte unter "Production Installation" das "WAR Package for Servlet Container" heruntergeladen werden.
Dort sollte unter "Production Installation" das "WAR Package for Servlet Container" heruntergeladen werden.
Zeile 37: Zeile 37:
Es muss ein Verzeichnis <code>webapps/xwiki</code> im Benutzer xyz00-xwiki angelegt werden, und dort muss die heruntergeladene .war Datei extrahiert werden, mit unzip:
Es muss ein Verzeichnis <code>webapps/xwiki</code> im Benutzer xyz00-xwiki angelegt werden, und dort muss die heruntergeladene .war Datei extrahiert werden, mit unzip:


  xwiki_lts_version=14.10.12
<syntaxhighlight lang=bash>
  wget https://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-distribution-war/${xwiki_lts_version}/xwiki-platform-distribution-war-${xwiki_lts_version}.war
xwiki_lts_version=15.10.11
  mkdir -p ~/webapps/xwiki
wget https://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-distribution-war/${xwiki_lts_version}/xwiki-platform-distribution-war-${xwiki_lts_version}.war
  cd ~/webapps/xwiki
mkdir -p ~/webapps/xwiki
  unzip ~/xwiki-platform-distribution-war-$xwiki_lts_version.war
cd ~/webapps/xwiki
unzip ~/xwiki-platform-distribution-war-$xwiki_lts_version.war
</syntaxhighlight>


Es muss ein Datenverzeichnis angelegt werden, dass ausserhalb des app Verzeichnisses liegt:
Es muss ein Datenverzeichnis angelegt werden, dass ausserhalb des app Verzeichnisses liegt:


  mkdir ~/data
<syntaxhighlight lang=bash>
mkdir ~/data
</syntaxhighlight>


Dieses Verzeichnis muss in die Datei <code>~/webapps/xwiki/WEB-INF/xwiki.properties</code> eingetragen werden:
Dieses Verzeichnis muss in die Datei <code>~/webapps/xwiki/WEB-INF/xwiki.properties</code> eingetragen werden:
Zeile 51: Zeile 55:
   environment.permanentDirectory = /home/pacs/xyz00/users/xwiki/data
   environment.permanentDirectory = /home/pacs/xyz00/users/xwiki/data


Ausserdem muss noch der JDBC Treiber für PostgreSQL von https://jdbc.postgresql.org/download.html an die richtige Stelle heruntergeladen werden:
Ausserdem muss noch der JDBC Treiber für PostgreSQL von https://jdbc.postgresql.org/download/ an die richtige Stelle heruntergeladen werden:


  postgresql_jdbc_version=42.6.0
<syntaxhighlight lang=bash>
  wget -O ~/xwiki/WEB-INF/lib/postgresql-${postgresql_jdbc_version}.jar https://jdbc.postgresql.org/download/postgresql-${postgresql_jdbc_version}.jar
postgresql_jdbc_version=42.7.3
wget -O ~/xwiki/WEB-INF/lib/postgresql-${postgresql_jdbc_version}.jar https://jdbc.postgresql.org/download/postgresql-${postgresql_jdbc_version}.jar
</syntaxhighlight>


In der Datei <code>~/webapps/xwiki/WEB-INF/hibernate.cfg.xml</code> muss der Block für die Default Datenbank hsqldb auskommentiert werden, und der Block für PostgreSQL aktiviert werden.
In der Datei <code>~/webapps/xwiki/WEB-INF/hibernate.cfg.xml</code> muss der Block für die Default Datenbank hsqldb auskommentiert werden, und der Block für PostgreSQL aktiviert werden.
Zeile 60: Zeile 66:
Ausserdem müssen die entsprechenden Zeilen angepasst werden:
Ausserdem müssen die entsprechenden Zeilen angepasst werden:


<pre>
<syntaxhighlight lang="xml" line>
    <property name="hibernate.connection.url">jdbc:postgresql://localhost:5432/xyz00_xwiki</property>
<property name="hibernate.connection.url">jdbc:postgresql://localhost:5432/xyz00_xwiki</property>
    <property name="hibernate.connection.username">xyz00_xwiki</property>
<property name="hibernate.connection.username">xyz00_xwiki</property>
    <property name="hibernate.connection.password">MeinDBPasswortTopSecret</property>
<property name="hibernate.connection.password">MeinDBPasswortTopSecret</property>
</pre>
</syntaxhighlight>


Wenn dann noch Monit etc eingerichtet ist, wie auf [[Tomcat Installieren]] beschrieben, dann sollte der XWiki unter der URL https://xwiki.example.org/xwiki erreichbar sein.
Wenn dann noch Monit etc eingerichtet ist, wie auf [[Tomcat Installieren]] beschrieben, dann sollte der XWiki unter der URL https://xwiki.example.org/xwiki erreichbar sein.

Aktuelle Version vom 30. Juli 2024, 19:40 Uhr

Allgemein

XWiki ist eine Wiki Anwendung mit vielen Plugins, die sich als Alternative zu Confluence und MediaWiki sieht. Man kann damit sogar einen Blog mit Kommentaren einrichten.

Siehe auch die Demo auf https://playground.xwiki.org/xwiki

XWiki ist in Java geschrieben, und kann mit Apache Tomcat bei Hostsharing betrieben werden.

Installation mit Ansible Skript

Die gesamte Installation kann mit Hilfe eines Ansible Skriptes durchgeführt werden, siehe https://codeberg.org/tpokorra/hs.ansible/src/branch/main/playbooks/xwiki Dort ist auch eine README Datei, die die Benutzung von Ansible erklärt.

Im folgenden werden die Schritte erklärt, die das Ansible Skript durchführt.

Vorbereitungen für Installation

Benutzer und Postgresql Datenbank einrichten

In HSAdmin müssen folgende Dinge eingerichtet werden:

  • der Benutzer xyz00-xwiki
  • der PostgreSQL Benutzer xyz00_xwiki
  • die PostgreSQL Datenbank xyz00_xwiki

Tomcat installieren

Dazu gibt es eine eigene Anleitung, siehe Tomcat Installieren.

Bitte auch den Hinweis beachten, dass dazu ein eigener Serverdienst laufen muss, der im Shared Hosting eine kostenpflichtige Option ist.

Installation von XWiki

Man kann verschiedene Versionen von XWiki wählen: LTS oder Stable, siehe https://www.xwiki.org/xwiki/bin/view/Download/

Wenn man z.B. LTS wählt, kommt man momentan auf https://www.xwiki.org/xwiki/bin/view/Download/DownloadVersion/?projectVersion=15.10.11

Dort sollte unter "Production Installation" das "WAR Package for Servlet Container" heruntergeladen werden.

Es muss ein Verzeichnis webapps/xwiki im Benutzer xyz00-xwiki angelegt werden, und dort muss die heruntergeladene .war Datei extrahiert werden, mit unzip:

xwiki_lts_version=15.10.11
wget https://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-distribution-war/${xwiki_lts_version}/xwiki-platform-distribution-war-${xwiki_lts_version}.war
mkdir -p ~/webapps/xwiki
cd ~/webapps/xwiki
unzip ~/xwiki-platform-distribution-war-$xwiki_lts_version.war

Es muss ein Datenverzeichnis angelegt werden, dass ausserhalb des app Verzeichnisses liegt:

mkdir ~/data

Dieses Verzeichnis muss in die Datei ~/webapps/xwiki/WEB-INF/xwiki.properties eingetragen werden:

 environment.permanentDirectory = /home/pacs/xyz00/users/xwiki/data

Ausserdem muss noch der JDBC Treiber für PostgreSQL von https://jdbc.postgresql.org/download/ an die richtige Stelle heruntergeladen werden:

postgresql_jdbc_version=42.7.3
wget -O ~/xwiki/WEB-INF/lib/postgresql-${postgresql_jdbc_version}.jar https://jdbc.postgresql.org/download/postgresql-${postgresql_jdbc_version}.jar

In der Datei ~/webapps/xwiki/WEB-INF/hibernate.cfg.xml muss der Block für die Default Datenbank hsqldb auskommentiert werden, und der Block für PostgreSQL aktiviert werden.

Ausserdem müssen die entsprechenden Zeilen angepasst werden:

<property name="hibernate.connection.url">jdbc:postgresql://localhost:5432/xyz00_xwiki</property>
<property name="hibernate.connection.username">xyz00_xwiki</property>
<property name="hibernate.connection.password">MeinDBPasswortTopSecret</property>

Wenn dann noch Monit etc eingerichtet ist, wie auf Tomcat Installieren beschrieben, dann sollte der XWiki unter der URL https://xwiki.example.org/xwiki erreichbar sein.

Es gibt dann zum Anfang einen Assistenten, mit dem man den Administratorzugang einrichtet.

Links