共计 5433 个字符，预计需要花费 14 分钟才能阅读完成。
一、Xwiki 简介
XWiki 是一个由 Java 编写的基于 LGPL 协议发布的开源 wiki 和应用平台。XWiki 是一款基于 java 所编写的 wiki，它可以运行在如 Tomcat，Jetty，JBoss，WebLogic，WebSphere 等 Servlet 容器上并利用关系型数据库(HSQL, MySQL 等) 来存储数据，大部分数据库产品都可以在 XWiki 上运行但是必须进行正确的设置。
中文网站：http://www.xwikichina.com/xwiki/bin/view/Main/
二、Xwiki 安装
1. 软件下载
http://download.forge.ow2.org/xwiki/xwiki-10.1.war
三种安装方式，本文采用的 war 包安装
使用已包含 Servlet 容器（Jetty）和数据库（HSQL）并带有默认 wiki 首页的打包版本的 XWiki 安装。如果你是新手并且想快速尝试 XWiki 的功能，推荐使用这种方式安装。
使用 war 包来安装 XWiki，但是你必须设置好你的 Servlet 容器和数据库让 XWiki 工作起来。
使用 deb 包安装最新版本的 XWiki 和相关的插件。
2. 安装需求
jdk1.8
mysql-connector-java-5.1.34.jar
tapache-tomcat-8.5.29.tar.gz
mysql
xwiki-10.1.war
3.apache 和 xwiki 安装
下载地址（8.5.29）：http://mirror.bit.edu.cn/apache/tomcat/tomcat-8/v8.5.29/bin/apache-tomcat-8.5.29.tar.gz
解压缩：tar -xzvf apache-tomcat-8.5.29.tar.gz
安装：mv apache-tomcat-8.5.29 /usr/local/apache
cd /usr/local/apache/webapps
mkidr xwiki
unzip xwiki-10.1.war -d /usr/local/apache/webapps/xwiki/
配置：编辑 tomcat 的 server.xml 修改 8080 端口描述设置编码为 UTF8，并允许 gzip 压缩
<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”/>
配置 JVM 的内存大小和安装路径
如果是通过 yum 安装的 tomcat 需要修改如 /etc/tomcat6/tomcat6.conf 这个文件
如果是使用的 tomcat 源码包安装，则修改 bin/catalina.sh 这个文件
JAVA_OPTS=”-Xmx300m -XX:MaxPermSize=196m”
JAVA_HOME=”/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.20-3.b26.el6.x86_64″
配置数据库，新建 xwiki 的数据库并授权
create database xwiki default character set utf8 collate utf8_bin;
grant all privileges on xwiki.* to xwiki@’%’ identified by ‘xwiki’;
下载 MySQL JDBC Driver Jar 放到 /usr/local/apache/webapps/xwiki/WEB-INF/lib/ 目录下
wget http://repo1.maven.org/maven2/mysql/mysql-connector-java/5.1.34/mysql-connector-java-5.1.34.jar
cp -rp mysql-connector-java-5.1.34.jar /usr/local/apache/webapps/xwiki/WEB-INF/lib/
配置 xwiki 应用
cd /usr/local/apache/webapps/xwiki/WEB-INF
vi hibernate.cfg.xml（注释掉无用的数据源配置）
<property name=”connection.url”>jdbc:mysql://localhost/xwiki?useSSL=false</property>
<property name=”connection.username”>xwiki</property>
<property name=”connection.password”>xwiki</property>
<property name=”connection.driver_class”>com.mysql.jdbc.Driver</property>
<property name=”dialect”>org.hibernate.dialect.MySQL5InnoDBDialect</property>
<property name=”connection.charSet”>UTF-8</property>
<property name=”connection.characterEncoding”>UTF-8</property>
<property name=”connection.useUnicode”>true</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”/>
编辑 xwiki.cfg
vi xwiki.cfg
xwiki.readonly=no
xwiki.encoding=UTF-8
xwiki.store.main.hint=hibernate
xwiki.store.hibernate.path=/WEB-INF/hibernate.cfg.xml
xwiki.superadminpassword=system
配置 office server
yum install libreoffice libreoffice-headless
XWIKI 字符集编码配置
vi web.xml
encoding=”UTF-8″
4.xwiki 初始化
使用. /usr/local/apache/bin/startup.sh 启动 tomcat 后，通过 http://ipaddr:8080/xwiki 做 xwiki 初始化工作
设置中文
三、Xwiki 管理
四、附录
1、安装错误信息 01
错误信息：根据查看 tomcat 的启动日志 /usr/local/apache_bak/logs/catalina.2018-03-25.log , /usr/local/apache_bak/logs/catalina.out
Mar 25, 2018 9:44:05 AM org.apache.catalina.loader.WebappClassLoaderBase validateJarFile
INFO: validateJarFile(/usr/local/apache/webapps/xwiki/WEB-INF/lib/javax.el-3.0.0.jar) – jar not loaded. See Servlet Spec 3
.0, section 10.7.2. Offending class: javax/el/Expression.class
Mar 25, 2018 9:44:22 AM org.apache.catalina.startup.TldConfig execute
INFO: At least one JAR was scanned for TLDs yet contained no TLDs. Enable debug logging for this logger for a complete lis
t of JARs that were scanned but no TLDs were found in them. Skipping unneeded JARs during scanning can improve startup tim
e and JSP compilation time.
处理方法：
根据错误信息，根据查询原因大致是因为 tomcat7 以上启动需要检查 tld，这里开启 debug 模式查看具体需要检查哪些 jar 包，然后跳过处理
开启 tld 检查 jar 日志记录
vi /usr/local/apache/conf/logging.properties
org.apache.jasper.servlet.TldScanner.level = FINE
然后关闭 tomcat，启动并检查 catalina.out
egrep “No TLD files were found in” catalina.out |egrep “jar”|awk -F'[‘ ‘{print $3}’|awk -F’]’ ‘{print $1}’|awk -F’lib/’ ‘{print $2}’>a.txt
将里面的 jar 包设置跳过检查处理
vi /usr/local/apache/conf/catalina.properties 文件中的“tomcat.util.scan.StandardJarScanFilter.jarsToSkip=”处，保存该文件
2、安装错误信息 02
上面报错信息处理后，发现启动 tomcat 还是无法访问 xwiki(404 错误），这里只能开启 xwiki 的 debug 模式查看具体报错信息
设置 debug 日志模式：
cd /usr/local/apache/webapps/xwiki/WEB-INF/classes
touch logging.properties
## 具体添加内容如下
handlers = org.apache.juli.FileHandler, java.util.logging.ConsoleHandler
############################################################
# Handler specific properties.
# Describes specific configuration info for Handlers.
############################################################
org.apache.juli.FileHandler.level = FINE
org.apache.juli.FileHandler.directory = /usr/local/apache/logs
org.apache.juli.FileHandler.prefix = error-debug.
java.util.logging.ConsoleHandler.level = FINE
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
重启 tomcat，查看错误日志内容
错误信息主要如下：
Unsupported major.minor version 52.0
处理方法：
根据错误信息，基本可以确认是由于 jdk 版本导致的，查看需要 1.8 版本的 Jdk, 下载高版本的 jdk 安装后，重启问题解决
wget “http://download.Oracle.com/otn-pub/java/jdk/8u161-b12/2f38c3b165be4555a1fa6e98c45e0808/jdk-8u161-linux-x64.rpm”
rpm -ivh jdk-8u161-linux-x64.rpm
