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

23rwd

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达到相应的效果