XWiki安装篇之使用deb包方式安装14.10 LTS版本

前置条件

• 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文件）
  

配置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

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：

输入数据库密码：

再次输入密码：

上传插件包

将插件包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正在初始化，等待即可：

点击Continue：

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

点击Continue：

选择XWiki Standard Flavor，点击Install this flavor：

点击Install：

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

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

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

此时进入XWiki首页，这样就可以使用了！

常用文件及目录

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

常见问题

Wiki空白一片

原因：没有安装插件

本文永久地址：https://help.ossdate.com/wiki/xwiki-deb-install/