windows10部署XWiki流程

最近需要做一个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等

好了，废话不多说，开始安装。

1. 首先，进入XWiki官网，进入右上角的DOWNLOAD，选择Stable版本，在这里有多种安装方式：
   
   xwiki-download.png

选择前记得先根据对应的jdk版本进行匹配（具体请查看System Requirements)，如下图所示：

系统要求.PNG

我选择的是war包部署，版本号11.5，jdk11，Docker和Linux的安装略过。

2. 在该页面下载war包和下方的XIP Package，后面要用到。

3. 安装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，在中添加
  即可。
  最后记得把XIP包解压到永久目录下的extension\repository里，供离线安装standard flavor使用，因为默认在线安装跟蜗牛一样慢

4. 配置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，找到类似下方的默认数据库连接配置，修改为：

jdbc:mysql://localhost/xwiki?serverTimezone=UTC

xwiki
xwiki
com.mysql.jdbc.Driver
org.hibernate.dialect.MySQL5InnoDBDialect
true
UTF-8

• 最后把之前下的mysql-connector-java-5.1放到WEB-INF\lib中。

5. 添加tomcat\bin到环境变量Path中，打开cmd窗口输入startup.bat，启动后浏览器输入localhost:8080/xwiki即可进入xwiki界面

TIPS:

1. 若是tomcat启动乱码，可以修改tomcat目录下conf\logging.properties，找到：
   java.util.logging.ConsoleHandler.encoding = UTF-8
   把UTF-8改为GBK即可。
2. 第一次进入可能会让你注册，不用管，直接点Later跳过，在主界面点右上角Log in，用superadmin登录，退出后重启tomcat再进入即可直接用superadmin安装。