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

XWiki简介

XWiki是Java语言开发的企业级开源Wiki知识库平台，以下一代Wiki为口号，具有第一代Wiki的页面编辑、版本控制、权限管理、搜索、导出功能，又具备下一代Wiki的博客、文件管理器、会议、论坛、任务等功能。官网宣称可替代Confluence。

前置条件

• Rocky Linux 9.2 系统（兼容CentOS）
• war包（下载地址，下载最大的文件xwiki-platform-distribution-war-14.10.19.war）
• 插件包（下载地址，下载最大的文件xwiki-platform-distribution-flavor-xip-14.10.19.xip，并修改后缀为zip）
• mariadb驱动（下载地址）

配置MariaDB数据库

更新软件：dnf update
安装MariaDB：dnf install mariadb-server
启动MariaDB：systemctl start mariadb

# 创建xwiki用户和数据库
mysql
mysql> create database xwiki default character set utf8mb4 collate utf8mb4_bin;
mysql> CREATE USER 'xwiki'@'localhost' IDENTIFIED BY 'xwikixwiki';
mysql> grant all privileges on *.* to xwiki@localhost;
mysql> quit;

安装Java 17和Tomcat 9

dnf update
dnf install java-17-openjdk java-17-openjdk-devel wget tar unzip

验证安装java -version：

# 新增组
groupadd tomcat
# 新增用户
useradd -g tomcat -d /opt/tomcat tomcat
# 切换到tomcat目录
cd /opt/tomcat
# 从清华源下载Tomcat 9
wget https://mirrors.tuna.tsinghua.edu.cn/apache/tomcat/tomcat-9/v9.0.82/bin/apache-tomcat-9.0.82.tar.gz
# 解压tomcat
tar -xvf apache-tomcat-9.0.82.tar.gz --strip-components=1
# 给tomcat启停命令授予执行权限
sh -c 'chmod +x /opt/tomcat/bin/*.sh'

将Tomcat注册为系统服务：vi /etc/systemd/system/tomcat.service

[Unit]
Description=Apache Tomcat Web Application Container
Wants=network.target
After=network.target

[Service]
Type=forking

Environment=JAVA_HOME=/usr/lib/jvm/jre

Environment=CATALINA_PID=/opt/tomcat/temp/tomcat.pid
Environment=CATALINA_HOME=/opt/tomcat
Environment='CATALINA_OPTS=-Xms512M -Xmx1G -Djava.net.preferIPv4Stack=true'
Environment='JAVA_OPTS=-Djava.awt.headless=true'

ExecStart=/opt/tomcat/bin/startup.sh
ExecStop=/opt/tomcat/bin/shutdown.sh
SuccessExitStatus=143

User=tomcat
Group=tomcat
UMask=0007
RestartSec=10
Restart=always

[Install]
WantedBy=multi-user.target

使服务配置生效：systemctl daemon-reload

上传war包至服务器

博主是在本地将war包解压后，使用编辑器修改几个文件后再打包，这样就省的在服务器上操作命令行了。

解压war包后，WEB-INF/hibernate.cfg.xml文件存放数据库信息，这里注释掉默认数据库部分，修改MariaDB部分为上边创建数据库时的信息，具体如下：

注释这一部分：

取消注释并修改这一部分：

xwiki.properties文件存放XWiki配置信息，在91行处找到environment.permanentDirectory，取消注释并修改为自己想要的目录，示例：

environment.permanentDirectory = /home/xwiki/

将mariadb-java-client-3.3.0.jar文件复制到WEB-INF/lib文件夹中。

将war包文件夹重新压缩为zip格式上传至服务器：

mkdir -p /opt/tomcat/webapps/xwiki
# 执行静默解压
unzip -q xwiki-platform-distribution-war-14.10.19.zip
# 授权
chown -R tomcat: /opt/tomcat

上传插件包至数据目录

# 创建插件仓库目录
mkdir -p /home/xwiki/extension/repository
# 切换目录
cd /home/xwiki/extension/repository
# 静默解压插件包
unzip -q xwiki-platform-distribution-flavor-xip-14.10.19.zip
# 授权
chown -R tomcat: /home/xwiki

启动安装向导

# 关闭防火墙
systemctl stop firewalld
# 启动Tomcat
systemctl start tomcat

使用浏览器打开：http://your_ip:8080/xwiki/

安装向导的内容在上一篇文章（《XWiki 14.10安装图文教程（deb包方式）》）中已经介绍过了，内容一致，不再赘述。

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