tomcat+mysql+xwiki搭建开源wiki系统

xwiki是使用java语言编写的开源wiki系统

   xwiki有多种版本，standalone的版本可以直接下载之后独立安装，默认集成了jetty运行，但是这种方式安装xwiki，运行速度比较慢，在大部分的情况下不能满足企业的需求。

   在linux系统上实现部署xwiki也有多种方式：

其中serlet container就有许多：

      tomcat

     glassfish  

      jboss等

关系型数据库的选择也是比较广泛的，在此使用tomcat和mysql

  

第一步：下载xwiki的war包

第二步：安装jdk

     安装jdkde要点主要就是环境变量

   导出JAVA_HOME

      JRE_HOME

      导出可执行程序到PATH变量

第三步：安装tomcat

     1.设定CATALINA_HOME，测试tomcat是否可以正常启动，之后关闭tomcat，将xwiki的包解压到CATALINA_HOME/webapps/xwiki目录下

     2.编辑tomcat的配置文件server.xml，设定为utf-8的编码格式

  <Connector port="8080" ... URIEncoding="UTF-8"/>

      3.如果linux的系统上没有安装X11相关库文件

      激活headless mode：在CATALINA_HOME/bin下新建一个名为serenv.sh的文件

      #!/bin/sh
export JAVA_OPTS="${JAVA_OPTS} -Djava.awt.headless=true"

      4.如果要开启gzip压缩功能

   <Connector port="8080" ... compression="on" compressionMinSize="2048" compressableMimeType="text/html,text/xml,text/css,text/javascript,application/x-javascript"/>

    

第四步：安装mysql

     1.先用yum安装mysql

      编辑mysql的配置文件：[mysqld]段添加default-storage-engine=Inonodb一项，将Innodb设定为默认存储引擎（因为xwiki经常需要进行事务回滚）

      2.创建数据库

     mysql> create database xwiki default character set utf8 collate utf8_bin

      3.创建用户及授权

     mysql>grant all privileges on *.* to xwiki@localhost identified by 'xwiki'

      4.配置xwiki使用mysql数据库

 因为xwiki是使用java语言编写的，所以要使用mysql数据库就需要java的mysql连接器

      mysql-connector-java*.jar 下载之后放到CATALINA_HOME/webapps/xwiki/WEB-INF/lib目录下

      5.修改xwiki的配置文件，使用mysql数据库，将默认相关选项修改为如下：

  <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.MySQL5InnoDBDialect</property>
<property name="connection.useUnicode">true</property>
<property name="connection.characterEncoding">UTF-8</property>

启动tomcat：访问本机的8080/xwiki,然后进行xwiki初始化

如果启动失败，查看tomcat的日志文件catalina.out

    一般会出现out of memory error的错误：默认内存不够使用

解决办法：在上述的serenv.sh文件中添加：

     CATALINA_OPTS="-Xmx1024m -XX:MaxPermSize=1000m"

具体使用的数字可以自己设定

至此，xwiki就可以在系统上跑起来，xwiki是一个功能比较强大的开源wiki系统，所以最主要的还是wiki的后续使用，如何使用好xwiki达到相应的效果