1.部署前提软件或插件

XWiki14以下

1. JDK1.8

2. Tomcat9

3. Mysql5.7

4. Xwiki13.10.8对应的Flavor包

5. mysql-connector-java.jar

XWiki14及以上（本次采用）

1. JDK11

2. Tomcat9

3. Mysql8.0

4. Xwiki14.6及对应Flavor包

5. mysql-connector-java-8.0.30.jar

2.需求安装

2.1 JDK

1. yum安装

命令行输入，展示对应的jdk版本列表

 

yum search java|grep jdk

 

选择需要的版本安装，例如 java-11-openjdk-src.x86_64（本次部署采用）

 

yum install -y java-11-openjdk-src.x86_64

 

xwiki14以下

 

yum install -y java-1.8.0-openjdk-src.x86_64

 

安装完成后查看版本

 

java -version

 

2. 宝塔界面安装（版本生效需自行配置）

安装Tomcat时会默认安装对应的jdk版本，对应的jdk版本为1.8

安装完成后点击JDK管理即可查看对应jdk地址

命令行输入java -version，可查看是否安装成功以及对应的java版本

3. 删除java版本

查看java相应版本

 

rpm -qa | grep java

 

根据需要删除对应版本

 

yum -y remove java java-1.8.0-openjdk-headless-1.8.0.342.b07-1.el7_9.x86_64

 

2.2 Tomcat

1. 宝塔软件商店安装

安装版本为tomcat9

安装完成后bin目录为 /www/server/tomcat/bin

2.3 Mysql

1. 宝塔软件商店安装

xwiki14及以上安装8.0（本次部署采用），xwiki14以下安装5.7以上版本即可

2.4 XWiki

1. 官网下载

wiki13.10.8：

https://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-distribution-war/13.10.8/xwiki-platform-distribution-war-13.10.8.war

wiki14.6：

https://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-distribution-war/14.6/xwiki-platform-distribution-war-14.6.war

2.5 XWiki对应Flavor

1. 官网下载

wiki13.10.8：

https://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-distribution-flavor-xip/13.10.8/xwiki-platform-distribution-flavor-xip-13.10.8.xip

wiki14.6：

https://nexus.xwiki.org/nexus/content/groups/public/org/xwiki/platform/xwiki-platform-distribution-flavor-xip/14.6/xwiki-platform-distribution-flavor-xip-14.6.xip

2.6 mysql-connector-java

1. 通过yum安装mysql-connector-java

此文件为mysql5.7版本

安装完成后可迁移至对应的XWiki目录下，具体位置见XWiki配置

 

yum install mariadb-server mariadb mysql-connector-java -y

 

2. 外部下载

8.0.16：https://static.runoob.com/download/mysql-connector-java-8.0.16.jar

8.0.30：https://cdn.mysql.com//Downloads/Connector-J/mysql-connector-java-8.0.30.zip（本次部署采用）

zip格式解压后可获取jar文件

3.部署配置

3.1 Mysql数据库配置

宝塔中添加数据库，配置数据库用户密码，确保外部能够连接至数据库

3.2 XWiki配置

1. 将XWiki的jar包放在tomcat的webapps目录下，刷新会自动生成XWiki文件夹

2. 把mysql-connector-java.jar文件放入xwiki/WEB-INF/lib中

xwiki14及以上放入8.0版本

3. 修改xwiki/WEB-INF/hibernate.cfg.xml文件

注释Configuration for the default database默认配置

展示并修改Mysql连接配置（确保此时数据库已配置并可外部连接访问）

4. 配置永久目录

修改xwiki/WEB-INF/xwiki.properties中的environment.permanentDirectory属性

可根据需要修改路径（确保文件夹存在）

5. 放入Flavor包（可不配置）

无网络状态下需放入离线包，有网络可在安装Xwiki时在线安装

将对应包放入<permanentdirectory>/extension/repository文件夹中

permanentdirectory：对应配置的永久目录下

3.1 Tomcat配置

1. 配置Tomcat字符集

• 宝塔软件商店中对Tomcat进行设置

修改为（添加最后四个配置项）

 

    <Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" 
               URIEncoding="UTF-8"
               compression="on"
               compressionMinSize="2048"               compressableMimeType="text/html,text/xml,text/css,text/javascript,application/x-javascript"/>

 

• 也可在 /www/server/tomcat/conf/server.xml文件中修改

 

2. 停止tomcat运行

由于宝塔对Tomcat的启动停止无效，需手动停止Tomcat运行与启动

查看tomcat运行状态

 

ps -ef | grep tomcat

 

在tomcat的bin目录下执行启动与关闭

 

cd /www/server/tomcat/bin

 

关闭

 

./shutdown.sh

 

启动

 

./startup.sh

 

启动后输入对应地址端口号以及Xwiki文件目录，便可进入安装界面

确保Tomcat启动成功

Xwiki安装界面