一 应用背景描述

  在平时的运维工作中，把常规工作进行文档整理非常重要，无论是平时工作处理或是工作交接，实时的维护文档资料可以提高工作效率。如果采用传统的TXT文档或者Word文档来记录的话修改不太方便，采用在线WIKI可以更好的让大家实时地查看或者修改文档资料。

  Wiki系统做得比较好的是Confluence，但是Confluence需要购买License才能使用，网上也有破解版本的。对比多个开源WIKI系统，我们选择XWIKI作为我们的WIKI系统，因为它提供的功能与Confluence的功能非常相似，不需要学习任何语法格式，可以直接在线像编辑Word一样编辑WIKI页面。

  XWIKI有以下几个显著的功能特性：

  1）多语言支持，可以支持英文，中文，韩文，日文等

  2）可以上传附件

  3）支持LDAP方式认证登录

  4）可以将Office文档直接导入为WIKI页面，也可以将WIKI页面导出成Office文档或PDF文档

  5）使用者不需要学习任何WIKI语法格式，直接使用WYSIWYG编辑器进行WIKI页面的编辑。

  6）具有版本控制管理的功能，并且可以回退到之前的历史版本

  7）界面友好，功能丰富，内置搜索引擎，可以进行站内搜索。

  8）用户和组权限管理，空间和页面的权限管理

  9）邮件通知功能

  10）支持多种WIKI的语法格式，如Confluence，Markdown，Jspwiki，meidawiki，twiki等

二 安装XWIKI

目前XWIKI官方最新版本是6.3，可以单独安装也可以结合其他WEB容器如tomcat安装。这里我们使用tomcat作为容器安装XWIKI

各个版本的安装方法都类似

本文使用的是CentOS6系列操作系统

1）安装Java和Tomcat

yum -y install java-1.7.0-openjdk

安装中文字体库

yum install autocorr-zh.noarch    libreoffice-langpack-zh-Hans.x86_64 libreoffice-langpack-zh-Hant.x86_64   

wget 

wget 

2）进入到tomcat的安装目录下，根据自己的tomcat安装目录而定。

cd /data/app_platform/xwiki_tomcat/webapps/

mkdir xwiki

将xwiki-enterprise-web-6.3.war放到xwiki目录下

cd /data/app_platform/xwiki_tomcat/webapps/xwiki/

unzip xwiki-enterprise-web-6.3.war

3）编辑tomcat的server.xml修改8080端口描述设置编码为UTF8，并允许gzip压缩

4）配置JVM的内存大小和安装路径

如果是通过yum安装的tomcat需要修改如/etc/tomcat6/tomcat6.conf 这个文件

如果是使用的tomcat源码包安装，则修改bin/catalina.sh 这个文件

JAVA_HOME="/usr/lib/jvm/java-1.7.0-openjdk.x86_64/"JAVA_OPTS="-Xmx300m -XX:MaxPermSize=196m"

5）配置Nginx转发

默认XWIKI通过类似

的方式访问，可以配置Nginx转发

server {    listen       80;    server_name  xwiki.xxx.xxx;    root  /data/app_platform/xwiki_tomcat/webapps/xwiki/;    location / {        rewrite ^ $scheme://$server_name/xwiki$request_uri? permanent;    }    location ^~ /xwiki {# If path starts with /xwiki - then redirect to backend: XWiki application in Tomcat       proxy_pass http://localhost:8080/xwiki;    }}

6)配置MySQL数据库

MySQL版本建议使用5.0以上，不要使用MyISAM存储引擎，因为MyISAM不支持事务处理，推荐使用InnoDB存储引擎。

创建XWIKI数据库

create database xwiki default character set utf8 collate utf8_bin;  

赋予相应的权限

grant all privileges on xwiki.* to xwiki identified by 'xwiki,./';

flush privileges;

下载MySQL JDBC Driver Jar放到/data/app_platform/xwiki_tomcat/webapps/xwiki/WEB-INF/lib目录下

wget

编辑/data/app_platform/xwiki_tomcat/webapps/xwiki/WEB-INF/hibernate.cfg.xml

将默认的给注释掉，然后将MySQL那一段去掉注释

         
     
      jdbc:mysql://localhost/xwiki    
      
       xwiki    
       
        xwiki    
        
         com.mysql.jdbc.Driver    
         
          org.hibernate.dialect.MySQL5InnoDBDialect    
          
           20    
               
               
               
           
          
         
        
       
      
     

7）配置Office Server

 yum install libreoffice   libreoffice-headless

编辑xwiki.properties

openoffice.autoStart=trueopenoffice.homePath=/usr/lib64/libreoffice/

8）XWIKI字符集编码配置

/data/app_platform/xwiki_tomcat/webapps/xwiki/WEB-INF/web.xml

 
     
          
      
       Set Character Encoding
          
      
       org.xwiki.container.servlet.filters.internal.SetCharacterEncodingFilter
          
          
      
             
       
        encoding
             
       
        UTF-8
           
          
          
      
             
       
        ignore
             
       
        false
           
        
     

/data/app_platform/xwiki_tomcat/webapps/xwiki/WEB-INF/xwiki.cfg

#-# The encoding to use when transformin strings to and from byte arrays. This causes the jvm encoding to be ignored,#-# since we want to be independend of the underlying system.xwiki.encoding=UTF-8

hibernate.cfg.xml中添加

    
     
      true    
      
       UTF-8
      
     

MySQL的配置文件my.cnf

[client]default-character-set=utf8[mysqld]default-character-set=utf8character-set-server=utf8collation-server=utf8_bin

9)管理附件

默认情况下，XWIKI使用数据库存储附件，上传的附件最大为30M左右，同时MySQL的配置文件my.cnf中要设置max_allowed_packet为最大值的3倍左右，因为存储历史版本也会耗费空间

使用文件系统存储可以上传更大的附件，XWIKI使用一个临时目录来存储从数据库中调出的图片或附件。

附件的存储目录在xwiki.properties中设定，不可以随意增加或删除这个目录下的内容，因为每个附件在数据库中都有相应的元数据

#-# Note if the system property xwiki.data.dir is set then this property is not used.#-# If neither the system property nor this configuration value here are set then the Servlet container's temporary#-# directory is used; This is absolutely not recommended since that directory could be wiped out at any time and you#-# should specify a value.environment.permanentDirectory=/data/xwiki/

最好在第一次运行XWIKI的时候就设定好附件的存储方式

在xwik.cfg文件中设置

xwiki.store.p_w_upload.hint=filexwiki.store.p_w_upload.versioning.hint=filexwiki.store.p_w_upload.recyclebin.hint=file

10)通过xwiki.xxx.xxx的方式可以直接访问XWIKI，然后进入安装页面

参考文档：