xwiki的安装(tomcat+mysql)

总述

xwiki是一个基于Java编写的开源企业级的wiki，支持博客，群组管理，权限管理等功能，下面介绍如何安装xwiki，适合在linux或者window上运行，安装分为Servlet容器的安装、Mysql的安装，Xwiki的安装及配置。这里用的各个版本如下:
tomcat: apache-tomcat 9 (https://tomcat.apache.org/download-90.cgi)
mysql: MySQL Community Server 8.0.21 (https://dev.mysql.com/downloads/mysql/)
Xwiki: xwiki-platform-distribution-war-11.10.10 (https://www.xwiki.org/xwiki/bin/view/Download/DownloadVersion/?projectVersion=11.10.10, 下载production intallation)
（由于xwiki是Java写的，故需要安装java环境，在此假设已经拥有了java环境，至少为1.8，网上有很多Java环境安装的博客，在此不来累赘）

Tomcat的安装

Xwiki需要的只是一个Servlet容器，而Servlet容器包括Tomcat, Jetty, JBoss等很多种，在这用个人比较熟悉的Tomcat作为Servlet容器。通过上面的下载链接下载好tomcat的，直接解压完成后就可以用了，启动之后输入localhost:8080测试安装是否成功，若看到了Tomat的主页则说明安装成功了。由于tomcat默认启动的堆大小无法满足xwiki的需要，故需调整tomcat堆大小，我们将这部分放在xwiki的配置中

MySQL的安装

MySQL的安装网上也有很多说明，在此也不再细说，假如安装好了mysql之后，需要创建一个xwiki名的数据库，因为xwiki默认数据库名字为xwiki

Xwiki的安装

从上面附属的链接下载好对应的xwiki的war文件之后，假设tomcat安装在{tomcat_home}中，则在{tomcat_home}/webapps/目录中新建一个叫xwiki的目录，然后将xwiki的war文件解压到xwiki的目录下，至此，所需要的各种软件基本准备完成，下面就介绍相关的配置。

Xwiki的配置

tomcat的配置

上面提到tomcat的配置主要是堆内存的配置，官方推荐分配给xwiki的堆内存最小的是1024m，最好为2048m, 配置tomcat的堆内存在{tomcat_home}/bin/catalina.bat，设置命令 为：
set JAVA_OPTS= -Xms2048M -Xms2048M -XX:PermSize=256M -XX:MaxNewSize=256M -XX:MaxPermSize=256M
效果如下图所示：

如果是linux则是catalina.sh中设置，设置命令为：
JAVA_OPTS= -Xms2048M -Xms2048M -XX:PermSize=256M -XX:MaxNewSize=256M -XX:MaxPermSize=256M

配置xwiki连接数据库信息

xwiki连接数据库的信息是在{tomcat_home}/webapps/xwiki/WEB-INF/hibernate.cfg.xml中配置，配置信息如下：

在这里请将用户名和密码以及mysql的端口号更改成为你对应的内容。
由于tomcat本身没有连接mysql数据库的驱动，故需要将mysql连接数据的驱动放在{tomcat_home}/lib中，这一步从mysql安装目录的Connector J 8.0目录中找到mysql-connector-java-8.0.21.jar并复制到{tomcat_home}/lib中即可

配置xwiki永久目录

xwiki的数据分为两部分，一部分是页面数据，存在mysql数据中，另一部分数据是页面中附件或者较大的文件，存放在文件系统中，如果没有配置的话，则默认是在{tomcat_home}/webapps/xwiki/data里面，最好还是更改其位置好点，设置在{tomcat_home}/webapps/xwiki/WEB-INF/xwiki.properties中配置，设置如下：

可以自己设置一个目录，方便以后的备份以及移植啥的

xwiki启动

至此，已完成xwiki安装的所有准备，此时就可以启动tomcat, 进入{tomcat_home}/bin目录，启动tomcat，然后在浏览器上输入localhost:8080/xwiki即可访问xwiki, 第一次访问，xwiki加载需要一小会，请耐心等待！最后看到这个页面就说明安装成功了！