使用开源软件XWiki搭建安装公司内部Wiki系统

一 应用背景描述

在平时的运维工作中,把常规工作进行文档整理非常重要,无论是平时工作处理或是工作交接,实时的维护文档资料可以提高工作效率。如果采用传统的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和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压缩

<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

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/16808.html