一 应用背景描述
在平时的运维工作中，把常规工作进行文档整理非常重要，无论是平时工作处理或是工作交接，实时的维护文档资料可以提高工作效率。如果采用传统的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安装使用技巧
Linux+Tomcat+XWiki+MySQL安装配置 见
XWiki 安装教程及更改语言配置
Windows下安装Java开源知识库XWiki
Xwiki系统安装说明文档 PDF
二 安装XWIKI目前XWIKI官方最新版本是6.3，可以单独安装也可以结合其他WEB容器如tomcat安装。这里我们使用tomcat作为容器安装XWIKI
各个版本的安装方法都类似
本文使用的是CentOS6系列操作系统1）安装Java和Tomcatyum -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压缩
<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”/>
4）配置JVM的内存大小和安装路径如果是通过yum安装的tomcat需要修改如/etc/tomcat6/tomcat6.conf 这个文件如果是使用的tomcat源码包安装，，则修改bin/catalina.sh 这个文件12 JAVA_HOME=”/usr/lib/jvm/java-1.7.0-openjdk.x86_64/” JAVA_OPTS=”-Xmx300m -XX:MaxPermSize=196m”
5）配置Nginx转发默认XWIKI通过类似:8080/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 :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那一段去掉注释<!– MySQL configuration. Uncomment if you want to use MySQL and comment out other database configurations. –> <property>jdbc:mysql://localhost/xwiki</property> <property>xwiki</property> <property>xwiki</property> <property>com.mysql.jdbc.Driver</property> <property>org.hibernate.dialect.MySQL5InnoDBDialect</property> <property>20</property> <mapping resource=”xwiki.hbm.xml”/> <mapping resource=”feeds.hbm.xml”/> <mapping resource=”activitystream.hbm.xml”/> <mapping resource=”instance.hbm.xml”/>
7）配置Office Server
yum install libreoffice libreoffice-headless编辑xwiki.propertiesopenoffice.autoStart=true openoffice.homePath=/usr/lib64/libreoffice/
更多详情见请继续阅读下一页的精彩内容：
背起简单的行攘，沐浴自由的风。
