XWiki installieren: Unterschied zwischen den Versionen
Tim00 (Diskussion | Beiträge) (neues Ansible Skript verlinkt, bei Codeberg, und Versionsnummern aktualisiert) |
Tim00 (Diskussion | Beiträge) 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= | 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: | ||
<syntaxhighlight lang=bash> | |||
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 | |||
</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: | ||
<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 | Ausserdem muss noch der JDBC Treiber für PostgreSQL von https://jdbc.postgresql.org/download/ an die richtige Stelle heruntergeladen werden: | ||
<syntaxhighlight lang=bash> | |||
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: | ||
< | <syntaxhighlight lang="xml" line> | ||
<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> | |||
</ | </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.