最近需要做一个wiki系统，于是接触到了XWiki这个开源项目。总而言之，xwiki对各个软件的版本要求比较高，很多必须严格一致。
在开始之前，先列出所有必需项：
- apache-tomcat
- mysql-5.7
- mysql-connector-java-5.1
- xwiki-platform-distribution-flavor-xip-11.5
- xwiki-platform-distribution-war-11.5
- vc++ 2013（mysql运行必需）
- jdk11
- chrome/firefox等
好了，废话不多说，开始安装。
-
首先，进入XWiki官网，进入右上角的DOWNLOAD，选择Stable版本，在这里有多种安装方式：
xwiki-download.png
选择前记得先根据对应的jdk版本进行匹配（具体请查看System Requirements)，如下图所示：
系统要求.PNG
我选择的是war包部署，版本号11.5，jdk11，Docker和Linux的安装略过。
- 在该页面下载war包和下方的XIP Package，后面要用到。
-
安装Tomcat：
Tomcat的版本注意官网上的说明，不要用到下列版本，会出问题：
xwiki-tomcat-select.png
具体安装很简单，到官网下载zip包解压即可。
- 配置xwiki存储用的永久目录（permanent directory)
首先把下载的xwiki的war包全部解压到tomcat\webapps\xwiki下，进入WEB-INF 目录，编辑xwiki.properties文件，在空白处添加environment.permanentDirectory=D:\xwiki，目录可以自己定。 - 激活超级管理员模式
编辑xwiki.cfg，找到#xwiki.superadminpassword=system，把#去掉，激活超级管理员模式（实测不打开超级管理员模式而自己创建用户进行安装，会出现bug），system是密码。 - 配置Tomcat最大内存限制
编辑tomcat/conf/context.xml，在<context></context>中添加
<Resources cachingAllowed="true" cacheMaxSize="100000" />即可。
最后记得把XIP包解压到永久目录下的extension\repository里，供离线安装standard flavor使用，因为默认在线安装跟蜗牛一样慢
-
配置MySQL：
MySQL官方推荐mysql-5.7和mysql-connector-java-5.1，8.x版本有bug。
到官网下载mysql后，解压，在根目录新建my.ini文件和Data文件夹：
[mysqld]
# 设置3306端口
port=3306
# 设置mysql的安装目录
basedir=D:\\mysql-5.7.27-winx64
# 设置mysql数据库的数据的存放目录
datadir=D:\\mysql-5.7.27-winx64\\Data
# 允许最大连接数
max_connections=200
# 允许连接失败的次数。这是为了防止有人从该主机试图攻击数据库系统
max_connect_errors=10
# 服务端使用的字符集默认为UTF8
character-set-server=utf8
# 创建新表时将使用的默认存储引擎
default-storage-engine=INNODB
# 默认使用“mysql_native_password”插件认证
default_authentication_plugin=mysql_native_password
[mysql]
# 设置mysql客户端默认字符集
default-character-set=utf8
[client]
# 设置mysql客户端连接服务端时默认使用的端口
port=3306
default-character-set=utf8
编辑保存.
- 添加mysql-5.7\bin到环境变量
- 接着打开PowerShell（必须管理员模式），逐步输入：
#初始化数据库，切记要记住打印出来的root初始密码
mysqld --initialize --console
mysqld install
#启动服务
net start mysql
mysql -u root -p
#输入初始密码，进入后更改密码方便以后操作
#创建数据库和用户
create database xwiki default character set utf8 collate utf8_bin;
create user 'xwiki'@'localhost' identified by 'xwiki';
#给与权限
grant all privileges on *.* to xwiki@localhost identified by 'xwiki';
mysql配置完了？还没完，再次进入到tomcat\webapps\xwiki\WEB-INF，打开hibernate.cfg.xml，找到类似下方的默认数据库连接配置，修改为：
<property name="connection.url">jdbc:mysql://localhost/xwiki?serverTimezone=UTC</property>
<!--serverTimezone=UTC必加，否则报错500-->
<property name="connection.username">xwiki</property>
<property name="connection.password">xwiki</property>
<property name="connection.driver_class">com.mysql.jdbc.Driver</property>
<property name="dialect">org.hibernate.dialect.MySQL5InnoDBDialect</property>
<property name="connection.useUnicode">true</property>
<property name="connection.characterEncoding">UTF-8</property>
- 最后把之前下的mysql-connector-java-5.1放到WEB-INF\lib中。
- 添加tomcat\bin到环境变量Path中，打开cmd窗口输入startup.bat，启动后浏览器输入localhost:8080/xwiki即可进入xwiki界面
TIPS:
- 若是tomcat启动乱码，可以修改tomcat目录下conf\logging.properties，找到：
java.util.logging.ConsoleHandler.encoding = UTF-8
把UTF-8改为GBK即可。 - 第一次进入可能会让你注册，不用管，直接点Later跳过，在主界面点右上角Log in，用superadmin登录，退出后重启tomcat再进入即可直接用superadmin安装。
