CentOS 7上安装XWiki 8.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/jdk.1.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那一段去掉注释

<!-- 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,出现初始化和安装设置界面

XWiki 的详细介绍:请点这里
XWiki 的下载地址:请点这里

相关推荐