CentOS7安装Xwiki8.2.1

g87616758

环境

　　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内存
CATALINA_OPTS="-server-Xms800m -Xmx1480m -XX:MaxPermSize=222m -Dfile.encoding=utf-8 -Djava.awt.headless=true -XX:+UseParallelGC -XX:MaxGCPauseMillis=100"
三、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，出现初始化和安装设置界面
　　----------------------------------------
安装的时候其实出现过很多问题，都是上官网和自己推理排障解决的。有些问题很简单，你犯的可能就是很简单的错，但你没有遇上和解决过就是会折腾你很久。