【原】CentOS7安装Xwiki8.2.1

灰太狼 2022-09-25 15:25 50阅读 0赞

**环境**  
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][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][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][http_127.0.0.1_8080_xwiki]，出现初始化和安装设置界面

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

by 铁乐与猫（食梦貘）

[http_dev.mysql.com_get_mysql-community-release-el7-5.noarch.rpm]: http://dev.mysql.com/get/mysql-community-release-el7-5.noarch.rpm
[http_repo1.maven.org_maven2_mysql_mysql-connector-java_5.1.39_mysql-connector-java-5.1.39.jar]: http://repo1.maven.org/maven2/mysql/mysql-connector-java/5.1.39/mysql-connector-java-5.1.39.jar
[http_127.0.0.1_8080_xwiki]: http://127.0.0.1:8080/xwiki