【原】CentOS7安装Xwiki8.2.1

环境
CentOS 7
内核版本为 3.10.0-327.el7.x86_64
JDK8（jdk1.8.0_101)+Tomcat7.0.67+MySQL5.6.32
XWIKI 8.2.1 xwiki-enterprise-web-8.2.1.war

一、安装JDK8

JDK包下载回来jdk-8u101-linux-x64.tar，放到服务端解压到/usr/java(可以提前新建此文件夹）就完成安装了，接下来是配置环境变量才为重要步骤。

vim /etc/profile
在底部添加以下内容

JAVA_HOME=/usr/java/jdk1.8.0_101 #视你自己安装的实际版本和路径为准
PATH=$JAVA_HOME/bin:$PATH
CLASSPATH=$JAVA_HOME/jre/lib/ext:$JAVA_HOME/lib/tools.jar
export PATH JAVA_HOME CLASSPATH

修改完后使用 source /etc/profile 使之立即生效

另最好手打，并修改完后敲javac 或java -version命令看能运行不，能运行则表示变量设置正确。

二、配置Tomcat 与 JAVA变量环境

tomcat7同样在官网下好tar包解压到/usr/local/tomcat上，通常解压得出的根目录是apache_tomcat版本什么的，为了以后使用方便还得将此根目录下的文件全mv到tomcat上。

注意xwiki官网提示最好不要用7.0.70的版本（使用中有回滚的bug未处理），所以这里建议用的是tomcat7.0.67的版本

设置tomcat开机启动

1.tomcat 需要增加一个pid文件
在tomca/bin目录下面，增加setenv.sh 配置，catalina.sh启动的时候会调用，同时配置java内存参数。

JAVA_HOME=/usr/java/jdk1.8.0_101
TOMCAT_USER=tomcat
#add tomcat pid
CATALINA_PID=”$CATALINA_BASE/tomcat.pid”
#add java opts
JAVA_OPTS=”-server -XX:PermSize=256M -XX:MaxPermSize=1024m -Xms512M -Xmx1024M -XX:MaxNewSize=256m”

给脚本一个执行权限
chmod -R 755 setnev.sh

2.增加tomcat.service
在/usr/lib/systemd/system目录下增加tomcat.service，目录必须是绝对目录。

[Unit]
Description=Tomcat
After=syslog.target network.target remote-fs.target nss-lookup.target

[Service]
Type=forking
PIDFile=/usr/local/tomcat/tomcat.pid
ExecStart=/usr/local/tomcat/bin/startup.sh
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s QUIT $MAINPID
PrivateTmp=true

[Install]

WantedBy=multi-user.target

[unit]配置了服务的描述，规定了在network启动之后执行。[service]配置服务的pid，服务的启动，停止，重启。[install]配置了使用用户。

3.使用tomcat.service

配置开机启动
systemctl enable tomcat

启动tomcat
systemctl start tomcat

停止tomcat
systemctl stop tomcat

重启tomcat
systemctl restart tomcat

因为配置pid，在启动的时候会再tomcat根目录生成tomcat.pid文件，停止之后删除。
同时tomcat在启动时候，执行start不会启动两个tomcat，保证始终只有一个tomcat服务在运行。
多个tomcat可以配置在多个目录下，互不影响。

修改conf/server.xml

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”

配置java内存

此处有做上面setnev.sh脚本的话可以跳过
修改bin/catalina.sh：
JAVA_HOME=”/usr/java/jdk1.8.0_101/”
JAVA_OPTS=”-Xmx800m -XX:MaxPermSize=196m” #优化java内存

三、YUM安装mysql

先安装带有可用的mysql5系列社区版资源的rpm包

rpm -Uvh http://dev.mysql.com/get/mysql-community-release-el7-5.noarch.rpm

查看可用的mysql安装资源

yum repolist enabled | grep “mysql.-community.”

一般来说，只要安装mysql-server跟mysql-client
这个时候我们可以直接使用yum的方式安装MySQL了

yum -y install mysql-community-server

注意安装完成后将mysql服务加入开机启动后需重启一次生效
加入开机启动 systemctl enable mysqld

启动mysql服务进程 systemctl start mysqld

准备mysql数据库

1、设置字符集为utf8
vim /etc/my.cnf

在[mysqld]下添加
default-character-set=utf8

底部再添加
[mysql]
default-character-set=utf8

2、创建xwiki数据库
create database xwiki character set utf8 collate utf8_general_ci;

3、创建xwiki用户及授予权限+密码给xwiki用户
grant all privileges on xwiki.* to xwikiadmin@localhost identified by ‘你设置的密码’;

四、安装xwiki

1、将xwiki的WAR文件解压到tomcat的webapps目录下：

unzip xwiki-enterprise-web-8.2.1.war -d /usr/local/tomcat/webapps/xwiki/

2、下载mysql jdbc driver到xwiki/WEB-INF/lib目录

wget http://repo1.maven.org/maven2/mysql/mysql-connector-java/5.1.39/mysql-connector-java-5.1.39.jar

建议到官网手动下载 mysql-connector-java-5.1.39_bin.jar 然后再放lib目录

3、修改xwiki/WEB-INF/hibernate.cfg.xml
在选择数据库那块区域将默认的hsql给注释掉，然后将MySQL那一段去掉注释（请参照官网操作，而不是乱去掉注释）
注：这里强烈建议你将此XML文件导出或叫上传到win的系统上用Notepad++之类的软件编辑注释再下载回centos7的系统上。

<– MySQL configuration.
Uncomment if you want to use MySQL and comment out other database configurations.
Notes:
- if you want the main wiki database to be different than “xwiki”
you will also have to set the property xwiki.db in xwiki.cfg file
–>

<property name="connection.url">jdbc:mysql://localhost/xwiki</property>
<property name="connection.username">xwikiadmin</property>
<property name="connection.password">此处为密码</property>
<property name="connection.driver_class">com.mysql.jdbc.Driver</property>
<property name="connection.useUnicode">true</property>
<property name="connection.characterEncoding">UTF-8</property>
<property name="dialect">org.hibernate.dialect.MySQL5InnoDBDialect</property>
<property name="dbcp.poolPreparedStatements">true</property>
<property name="dbcp.maxOpenPreparedStatements">20</property>
<mapping resource="xwiki.hbm.xml"/>
<mapping resource="feeds.hbm.xml"/>
<mapping resource="activitystream.hbm.xml"/>
<mapping resource="instance.hbm.xml"/>
<mapping resource="mailsender.hbm.xml"/>

新增的两行是：
< property name=”connection.useUnicode”>true< /property>
< property name=”connection.characterEncoding”>UTF-8< /property>

试运行并初始化安装

1、运行tomact
2、在浏览器打开：http://127.0.0.1:8080/xwiki，出现初始化和安装设置界面

安装的时候其实出现过很多问题，都是上官网和自己推理排障解决的。有些问题很简单，你犯的可能就是很简单的错，但你没有遇上和解决过就是会折腾你很久。

by 铁乐与猫（食梦貘）