XWiki 14.10 LTS 图文安装教程(deb包方式)

390 阅读2分钟

前置条件

  • Debian 12系统:添加Debian 11软件源deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bullseye main contrib non-free
  • Java 11或Java 17环境(XWiki版本和对应Java版本如下图所示)
  • 官网插件包:xwiki-platform-distribution-flavor-xip-14.10.19.xip(重命名为zip文件)

image.png

配置XWiki软件库

wget https://maven.xwiki.org/xwiki-keyring.gpg -O /usr/share/keyrings/xwiki-keyring.gpg
wget "https://maven.xwiki.org/stable/xwiki-stable.list" -O /etc/apt/sources.list.d/xwiki-stable.list

更新软件并安装XWiki

配置完毕后更新软件:apt update

image.png

XWiki Maven库中预装了很多环境,这里本站选择安装xwiki-tomcat9-mariadb版本:

apt install xwiki-common=14.10.19 xwiki-mariadb-common=14.10.19 xwiki-tomcat9-common=14.10.19 xwiki-tomcat9-mariadb=14.10.19

安装过程中会提示可视化配置数据库,选择Yes:

image.png

输入数据库密码:

image.png

再次输入密码:

image.png

上传插件包

将插件包xwiki-platform-distribution-flavor-xip-14.10.19.zip上传至/var/lib/xwiki/data/extension/repository目录并解压

cd /var/lib/xwiki/data/extension/repository
mv /home/xwiki-platform-distribution-flavor-xip-14.10.19.zip /var/lib/xwiki/data/extension/repository
# 解压插件
unzip -q xwiki-platform-distribution-flavor-xip-14.10.19.zip
# 对插件目录进行授权
chown -R tomcat: /var/lib/xwiki/data/extension/repository
# 重启tomcat使权限生效
systemctl restart tomcat9

安装完毕后使用浏览器打开:http://your_id:8080/xwiki

使用安装向导安装XWiki

出现XWiki is initializing,证明之前的步骤都对了,XWiki正在初始化,等待即可:

image.png

点击Continue:

image.png

创建管理员用户,此处以ossdate为例,输入两遍密码,点击Register and login:

image.png

点击Continue:

image.png

选择XWiki Standard Flavor,点击Install this flavor:

image.png

点击Install:

image.png

如果下图方框内的内容很快展示出来,证明是从本地插件文件夹找到的文件,点击Continue:

image.png

耐心等待一会儿即可,此时CPU负载较高,安装完成后点击Continue:

image.png

最后会出来一个插件安装报告页面,划到页面最底下,点击Continue:

image.png

此时进入XWiki首页,这样就可以使用了!

image.png

常用文件及目录

  • XWiki配置文件目录:/etc/xwiki
    • xwiki.properties
    • hibernate.cfg.xml
  • 持久数据目录:/var/lib/xwiki/data
    • 插件目录:/var/lib/xwiki/data/extension/repository
  • Web目录:/usr/lib/xwiki/

常见问题

Wiki空白一片

image.png

原因:没有安装插件

本文永久地址:help.ossdate.com/wiki/xwiki-…