xwiki Installation

1

(% class="jumbotron" %)

2

(((

3

(% class="container" %)

4

(((

5

= So installierst du XWiki unter Ubuntu 22.04 =

6

7

XWiki ist eine freie und quelloffene Wikisoftware, die in Java geschrieben wurde und auf Tomcat läuft. Sie hilft den Nutzern, effizienter zusammenzuarbeiten. Sie bietet viele nützliche Funktionen wie WYSIWYG-Bearbeitung, OpenOffice-basierten Dokumentenimport/-export, semantische Annotationen und Tagging sowie eine erweiterte Rechteverwaltung. Es nutzt eine Datenbank wie MySQL oder PostgreSQL, um seine Informationen zu speichern.

8

9

Diese Anleitung zeigt dir, wie du XWiki auf einem Ubuntu 22.04 Server installierst.

)))

)))

(% class="row" %)

(((

(% class="col-xs-12 col-sm-8" %)

16

(((

17

== Voraussetzungen ==

18

19

* Ein Server, auf dem Ubuntu 22.04 läuft.

20

* Ein gültiger Domainname ist auf die IP deines Servers verweist.

21

* Ein Root-Passwort ist auf dem Server eingerichtet.

== Erste Schritte ==

Bevor du beginnst, aktualisiere alle Systempakete mit dem folgenden Befehl auf die neueste Version:

{{{apt update -y

apt upgrade -y}}}

Sobald alle Pakete aktualisiert sind, kannst du mit dem folgenden Befehl weitere erforderliche Abhängigkeiten installieren:

31

32

{{{apt-get install wget curl unzip git name gnupg2 -y}}}

33

34

Sobald du damit fertig bist, kannst du mit dem nächsten Schritt fortfahren.

35

36

== Java JDK installieren ==

37

38

XWiki ist eine Java-basierte Anwendung, daher musst du Java auf deinem Server installieren. Du kannst es mit dem folgenden Befehl installieren:

39

40

{{{apt-get install default-jdk -y}}}

41

42

Sobald Java installiert ist, kannst du die Java-Version mit dem folgenden Befehl überprüfen:

{{{java --version}}}

Du erhältst die folgende Ausgabe:

47

48

{{{openjdk 11.0.17 2022-10-18

49

OpenJDK Runtime Environment (build 11.0.17+8-post-Ubuntu-1ubuntu222.04)

50

OpenJDK 64-Bit Server VM (build 11.0.17+8-post-Ubuntu-1ubuntu222.04, mixed mode, sharing)

51

}}}

52

53

== XWiki-Repository hinzufügen ==

54

55

Standardmäßig ist das XWiki-Paket nicht im Standard-Repository von Ubuntu enthalten. Daher musst du das offizielle XWiki-Repository zu deinem Server hinzufügen.

56

57

Lade zunächst den GPG-Schlüssel herunter und füge ihn mit dem folgenden Befehl hinzu:

58

59

{{{wget https://maven.xwiki.org/xwiki-keyring.gpg -O /usr/share/keyrings/xwiki-keyring.gpg}}}

60

61

Als nächstes fügst du das XWiki-Repository mit dem folgenden Befehl zu APT hinzu:

62

63

{{{wget "https://maven.xwiki.org/stable/xwiki-stable.list" -O /etc/apt/sources.list.d/xwiki-stable.list}}}

64

65

Sobald das Repository zur APT hinzugefügt wurde, kannst du den Repository-Cache mit dem folgenden Befehl aktualisieren:

66

67

{{{apt-get update -y}}}

68

69

Als Nächstes suchst du mit folgendem Befehl nach dem XWiki-Paket:

70

71

{{{apt-cache search xwiki}}}

72

73

Du solltest alle XWiki-Pakete in der folgenden Ausgabe sehen:

74

75

{{{xwiki-solr-all - XWiki is a free wiki software platform written in Java with a design emphasis

76

xwiki-solr-core - XWiki is a free wiki software platform written in Java with a design emphasis

77

xwiki-solr-data - XWiki is a free wiki software platform written in Java with a design emphasis

78

xwiki-solr-events - XWiki is a free wiki software platform written in Java with a design emphasis

79

xwiki-solr-extension_index - XWiki is a free wiki software platform written in Java with a design emphasis

80

xwiki-solr-like - XWiki is a free wiki software platform written in Java with a design emphasis

81

xwiki-solr-ratings - XWiki is a free wiki software platform written in Java with a design emphasis

82

xwiki-tomcat7-common - XWiki is a free wiki software platform written in Java with a design emphasis

83

xwiki-tomcat7-mysql - XWiki is a free wiki software platform written in Java with a design emphasis

84

xwiki-tomcat7-pgsql - XWiki is a free wiki software platform written in Java with a design emphasis

85

xwiki-tomcat8-common - XWiki is a free wiki software platform written in Java with a design emphasis

86

xwiki-tomcat8-mariadb - XWiki is a free wiki software platform written in Java with a design emphasis

87

xwiki-tomcat8-mysql - XWiki is a free wiki software platform written in Java with a design emphasis

88

xwiki-tomcat8-pgsql - XWiki is a free wiki software platform written in Java with a design emphasis

89

xwiki-tomcat9-common - XWiki is a free wiki software platform written in Java with a design emphasis

90

xwiki-tomcat9-mariadb - XWiki is a free wiki software platform written in Java with a design emphasis

91

xwiki-tomcat9-mysql - XWiki is a free wiki software platform written in Java with a design emphasis

92

xwiki-tomcat9-pgsql - XWiki is a free wiki software platform written in Java with a design emphasis

}}}

== XWiki auf Ubuntu 22.04 installieren ==

97

98

Wähle nun die neueste Version von XWiki und installiere sie mit dem folgenden Befehl:

99

100

{{{apt-get install xwiki-tomcat9-common xwiki-tomcat9-mariadb -y}}}

101

102

Während der Installation wirst du aufgefordert, die Datenbank wie unten gezeigt zu konfigurieren:

103

104

[[image:https://www.howtoforge.de/images/so-installierst-du-xwiki-unter-ubuntu-2204/upload-1.png||height="217" width="748"]]

105

106

Wähle Ja und drücke die Eingabetaste. Du wirst aufgefordert, ein MySQL-Passwort für XWiki festzulegen:

107

108

[[image:https://www.howtoforge.de/images/so-installierst-du-xwiki-unter-ubuntu-2204/upload-2.png||height="228" width="746"]]

109

110

Lege dein Passwort fest und klicke auf **OK**, um die Installation abzuschließen.

111

112

Sobald das XWiki installiert ist, kannst du den Tomcat-Dienst mit dem folgenden Befehl überprüfen:

113

114

{{{systemctl status tomcat9.service}}}

115

116

Du erhältst die folgende Ausgabe:

117

118

{{{? tomcat9.service - Apache Tomcat 9 Web Application Server

119

Loaded: loaded (/lib/systemd/system/tomcat9.service; enabled; vendor preset: enabled)

120

Drop-In: /etc/systemd/system/tomcat9.service.d

121

??xwiki-tomcat9-systemd.conf

122

Active: active (running) since Mon 2022-11-28 16:49:48 UTC; 6s ago

123

Docs: https://tomcat.apache.org/tomcat-9.0-doc/index.html

124

Process: 27582 ExecStartPre=/usr/libexec/tomcat9/tomcat-update-policy.sh (code=exited, status=0/SUCCESS)

125

Main PID: 27586 (java)

126

Tasks: 20 (limit: 464122)

127

Memory: 272.6M

128

CGroup: /system.slice/tomcat9.service

129

??27586 /usr/lib/jvm/default-java/bin/java -Djava.util.logging.config.file=/var/lib/tomcat9/conf/logging.properties -Djava.util.>

130

131

Nov 28 16:49:49 ubuntu22041 tomcat9[27586]: Loaded Apache Tomcat Native library [1.2.31] using APR version [1.7.0].

132

Nov 28 16:49:49 ubuntu22041 tomcat9[27586]: APR capabilities: IPv6 [true], sendfile [true], accept filters [false], random [true], UDS [true].

133

Nov 28 16:49:49 ubuntu22041 tomcat9[27586]: APR/OpenSSL configuration: useAprConnector [false], useOpenSSL [true]

134

Nov 28 16:49:49 ubuntu22041 tomcat9[27586]: OpenSSL successfully initialized [OpenSSL 3.0.2 15 Mar 2022]

135

Nov 28 16:49:50 ubuntu22041 tomcat9[27586]: Initializing ProtocolHandler ["http-nio-8080"]

136

Nov 28 16:49:50 ubuntu22041 tomcat9[27586]: Server initialization in [1204] milliseconds

137

Nov 28 16:49:50 ubuntu22041 tomcat9[27586]: Starting service [Catalina]

138

Nov 28 16:49:50 ubuntu22041 tomcat9[27586]: Starting Servlet engine: [Apache Tomcat/9.0.58 (Ubuntu)]

139

Nov 28 16:49:50 ubuntu22041 tomcat9[27586]: Deploying deployment descriptor [/etc/tomcat9/Catalina/localhost/xwiki.xml]

140

}}}

141

142

Tomcat wird nicht ausgeführt und lauscht auf Port 8080. Du kannst ihn mit dem folgenden Befehl überprüfen:

143

144

{{{ss -antpl | grep 8080}}}

145

146

Du solltest die folgende Ausgabe sehen:

147

148

{{{LISTEN 1 100 *:8080 *:* users:(("java",pid=27586,fd=39))

149

}}}

150

151

== Nginx als Reverse Proxy konfigurieren ==

152

153

Als Nächstes musst du Nginx als Reverse Proxy konfigurieren, damit du über Port 80 auf das XWiki zugreifen kannst. Installiere zunächst das Nginx-Paket mit dem folgenden Befehl:

154

155

{{{apt-get install nginx -y}}}

156

157

Nachdem du Nginx installiert hast, erstelle eine Nginx-Konfigurationsdatei:

158

159

{{{nano /etc/nginx/conf.d/xwiki.conf}}}

160

161

Füge die folgende Konfiguration hinzu:

{{{server {

listen 80;

server_name xwiki.example.com;

167

168

access_log /var/log/nginx/xwiki-access.log;

169

error_log /var/log/nginx/xwiki-error.log;

170

171

location / {

172

proxy_set_header X-Real-IP $remote_addr;

173

proxy_set_header Host $host;

174

proxy_http_version 1.1;

175

proxy_set_header Upgrade $http_upgrade;

176

proxy_set_header Connection 'upgrade';

177

proxy_cache_bypass $http_upgrade;

178

proxy_pass http://127.0.0.1:8080;

}

}

}}}

Speichere und schließe die Datei und starte den Nginx-Dienst neu, um die Änderungen zu übernehmen:

185

186

{{{systemctl restart nginx}}}

187

188

Du kannst den Nginx-Status auch mit folgendem Befehl überprüfen:

189

190

{{{systemctl status nginx}}}

191

192

Du erhältst die folgende Ausgabe:

193

194

{{{? nginx.service - A high performance web server and a reverse proxy server

195

Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)

196

Active: active (running) since Mon 2022-11-28 16:51:25 UTC; 5s ago

197

Docs: man:nginx(8)

198

Process: 27892 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)

199

Process: 27894 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)

200

Main PID: 27895 (nginx)

201

Tasks: 3 (limit: 464122)

202

Memory: 3.4M

203

CGroup: /system.slice/nginx.service

204

??27895 "nginx: master process /usr/sbin/nginx -g daemon on; master_process on;"

205

??27896 "nginx: worker process" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" ""

206

??27897 "nginx: worker process" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" ""

207

208

Nov 28 16:51:25 ubuntu22041 systemd[1]: Starting A high performance web server and a reverse proxy server...

209

Nov 28 16:51:25 ubuntu22041 systemd[1]: Started A high performance web server and a reverse proxy server.

210

}}}

211

212

An diesem Punkt ist XWiki mit Nginx als Reverse Proxy installiert. Du kannst nun mit dem nächsten Schritt fortfahren.

213

214

== XWiki Web-Installation durchführen ==

215

216

Öffne nun deinen Webbrowser und rufe den XWiki-Webinstallationsassistenten über die URL **http:~/~/xwiki.example.com/xwiki/bin/view/Main/** auf **.** Du solltest den folgenden Bildschirm sehen:

217

218

[[image:https://www.howtoforge.de/images/so-installierst-du-xwiki-unter-ubuntu-2204/upload-3.png||height="487" width="742"]]

219

220

Klicke auf die Schaltfläche **Weiter**. Du solltest den Registrierungsbildschirm sehen:

221

222

[[image:https://www.howtoforge.de/images/so-installierst-du-xwiki-unter-ubuntu-2204/upload-4.png||height="455" width="740"]]

223

224

Gib deinen Namen, deinen Admin-Benutzernamen, dein Passwort und deine E-Mail-Adresse ein und klicke auf die Schaltfläche **Registrieren und anmelden**. Du solltest den folgenden Bildschirm sehen:

225

226

[[image:https://www.howtoforge.de/images/so-installierst-du-xwiki-unter-ubuntu-2204/upload-5.png||height="308" width="740"]]

227

228

Klicke auf die Schaltfläche “ **Weiter“**. Du solltest den Bildschirm zur Auswahl des Flavors sehen:

229

230

[[image:https://www.howtoforge.de/images/so-installierst-du-xwiki-unter-ubuntu-2204/upload-6.png||height="493" width="748"]]

231

232

Wähle dein XWiki-Flavor aus und klicke auf die Schaltfläche **Dieses Flavor installieren**. Du solltest den folgenden Bildschirm sehen:

233

234

[[image:https://www.howtoforge.de/images/so-installierst-du-xwiki-unter-ubuntu-2204/upload-7.png||height="366" width="740"]]

235

236

Klicke auf die Schaltfläche **Installieren**. Du solltest den folgenden Bildschirm sehen:

237

238

[[image:https://www.howtoforge.de/images/so-installierst-du-xwiki-unter-ubuntu-2204/upload-8.png||height="495" width="741"]]

239

240

Klicke auf die Schaltfläche **Weiter**. Du solltest den folgenden Bildschirm sehen:

241

242

[[image:https://www.howtoforge.de/images/so-installierst-du-xwiki-unter-ubuntu-2204/upload-9.png||height="487" width="741"]]

243

244

Klicke auf die Schaltfläche **Fortfahren**. Auf dem folgenden Bildschirm solltest du das XWiki-Dashboard sehen:

245

246

[[image:https://www.howtoforge.de/images/so-installierst-du-xwiki-unter-ubuntu-2204/upload-10.png||height="348" width="744"]]

== Fazit ==

Glückwunsch! Du hast XWiki mit Nginx erfolgreich auf dem Ubuntu 22.04 Server installiert.

)))

(% class="col-xs-12 col-sm-4" %)

(((

[[image:Templates.Article.Template.WebHome@image1.jpg]]

261

//Figure 1: [[Sea>>https://commons.wikimedia.org/wiki/File:Isle_of_Icacos_II.jpg]]//

262

263

[[image:Templates.Article.Template.WebHome@image2.jpg]]

264

//Figure 2: [[Waves>>https://commons.wikimedia.org/wiki/File:Culebra_-_Playa_de_Flamenco.jpg]]//

265

)))

266

)))

Wiki source code of xwiki Installation