搭建基于xwiki的知识管理平台

由于企业运作的需要，需要搭建一个供员工进行知识管理和共享的平台。之前，个人用过JSPWiki来管理自己的一些资料，但一则由于其采用的是文件形式信息存储，而非数据库；再则就是对其文本编辑时的非所见即所得感到有点不爽。因此，此次就没有考虑它。由于个人的技术背景，Java及相关技术是主要的，因此也就把精力放在了基于Java的开源Wiki软件。通过查找对比，最终对xwiki发生了兴趣，并决定基于它来试验搭建一个初步的知识管理和共享的平台。之所以选择xwiki，除它是一个Java的方案外，还考虑到它没有JSPwiki几个缺陷，即它是支持各种数据库的，同时也是默认支持所见即所得的编辑器。另外，就是感觉xwiki的功能要比JSPWiki来得强大些。

 

一. 运行环境：

   Tomcat 6 + MySQL 5.1 + xwiki 3.0

 

二、安装步骤：

   1. 下载必要的软件包，如JDK 1.6， Tomcat 5， MySQL5.1等。

 

   2. 从 http://forge.ow2.org/project/download.php?group_id=170&file_id=16517 下载xwiki 3.0。安装xwiki的介绍，其安装方式有几种。一种是下载包含了Jetty容器和HSQLDB数据库的带图形界面的安装文件包，进行直接安装；另一种就是下载xwiki的war包，但需要进行手工的配置，包括预先安装并配置一个servlet容器（如Tomcat），安装并配置数据库（如MySQL）。然后按照步骤手动安装该war包。在这里采用的就是第二种安装方式：

 

      1）安装并配置Tomcat 6.0服务器

      2）安装并配置MySQL 5.1数据库

           创建xwiki数据库：

                     mysqld --console

                     mysql -u root -e “create database xwiki default character set utf8" （创建xwiki数据库）

                     mysql -u root -e "grant all privileges on xwiki.* to xwiki@localhost identified by 'xwiki'" （授权xwiki用户访问xwiki数据库的所有权限）

 

          确保MySQL JDBC驱动的jar文件包安装在xwiki的war文件（xwiki之WEB-INF/lib目录）

 

          配置xwiki使用所创建的MySQL数据库： 编辑WEB-INF/hiberate.cfg.xml文件，替换如下匹配的属性：

 

                <property name="connection.url">jdbc:mysql://localhost/xwiki</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.MySQLDialect</property>

 

          3）按照步骤安装并配置好Tomcat和MySQL数据库后，通过浏览器访问xwiki： http://localhost:8080/xwiki/ 。如果访问时遇到”packet for query is too large(max_allowd_packet)"错误，并看到"packet too large error"页面。则在启动MySQL服务器时可以通过增加packet大小来解决该问题，如： mysqld --console --max_allowed_packet=32M。其中的原因是MySQL缺省只接受小于1MB的包。

 

          4）导入缺省的Wiki xar。 缺省的wiki XAR是一个完全配置的wiki，可以使用该wiki作为创建自己wiki内容的起点。导入该XAR时，用浏览器访问：http://localhost:8080/xwiki/bin/import/XWiki/XWikiPreferences， 点击右上角的“Administration"链接。然后点击Import图标。

 

     该缺省的wiki提供如下功能：

• 一个博客
• 一个最近变更页面
• 面板应用
• 搜索
• 管理页面（权限、组和用户管理，等）
• 更多的特性.....

       导入该XAR包后，会配置好一个“Admin”用户（密码同用户名）。在导入了该缺省wiki后，需要该用户名/密码进行登录。

 

 

       5）  可以通过下载管理工具http://extensions.xwiki.org/xwiki/bin/download/Extension/AdminTools/xwiki-application-admintools-2.0.xar，来验证本次xwiki安装（Tomcat+MySQL）的一些基本设置。

 

 

 

 

至此，xwiki算是基本安装完成。接下来就是对xwiki进行深入的学习，从而完成搭建满足自己要求和风格习惯的wiki系统的完整建设。