Tomcat+MySQL+XWiki搭建开源Wiki系统

共计 7158 个字符，预计需要花费 18 分钟才能阅读完成。

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

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

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

    其中 serlet container 就有许多：
    tomcat
    glassfish 

    jboss 等

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

第一步：下载 xwiki 的 war 包

    wget http://download.forge.ow2.org/xwiki/xwiki-enterprise-web-6.3.war

第二步：安装 jdk
    安装 jdkde 要点主要就是环境变量
    导出 JAVA_HOME
    JRE_HOME

1. 导出可执行程序到 PATH 变量

    tar -zxvf jdk-8u73-linux-x64.tar.gz

    mv jdk1.8.0_73 /usr/local/jdk
    echo “JAVA_HOME=/usr/local/jdk” >>/etc/profile
    echo “CLASSPATH=.:$JAVA_HOME/lib.tools.jar” >>/etc/profile
    echo “PATH=/usr/local/jdk/bin:/bin:/sbin:/usr/sbin:/bin:/usr/bin:/root/bin” >>/etc/profile
    echo “export JAVA_HOME CLASSPATH PATH” >>/etc/profile
    source /etc/profile

2. 查看 jdk 的版本

    usr/local/jdk/bin/java -version
    java version “1.8.0_73”
    Java(TM) SE Runtime Environment (build 1.8.0_73-b02)
    Java HotSpot(TM) 64-Bit Server VM (build 25.73-b02, mixed mode)

第三步：安装 tomcat（/usr/local/tomcat/）
    tar  -zxvf  apache-tomcat-6.0.32.tar.gz  -C    /usr/local/
    cd /usr/local/
    mv  apache-tomcat-6.0.32    tomcat
1.tomcat 的命令
    cd  tomcat
    bin/startup.sh  启动服务命令
    bin/shutdown.sh  停止服务命令
    webapps/ROOT/  网页目录
    conf  配置文件存放目录

2. 查看端口

    netstat  -untnalp | grep :8080
    cd /usr/local/tomcat/webapps/
    mkdir xwiki
    mv xwiki-enterprise-web-6.3.war /usr/local/tomcat/webapps/xwiki/
    unzip xwiki-enterprise-web-6.3.war

第四步：安装 mysql(数据库存放目录 /usr/local/mysql/data/)
安装配置工具 cmake
 [root@localhost cmake-2.8.10.2]# ./bootstrap  –prefix=/usr/local/cmake
[root@localhost cmake-2.8.10.2]# make
[root@localhost cmake-2.8.10.2]# make install

[root@localhost local]# /usr/local/cmake/bin/cmake  –version
cmake version 2.8.10.2

使用 camke 配置安装源码 mysql
tar -zxvf mysql-5.5.13.tar.gz
cd mysql-5.5.13

/usr/local/cmake/bin/cmake  -DCMAKE_INSTALL_PREFIX=/usr/local/mysql    -DSYSCONFDIR=/etc  -DMYSQL_DATADIR=/home/mysql  -DMYSQL_TCP_PORT=3306  -DMYSQL_UNIX_ADDR=/tmp/mysqld.sock  -DMYSQL_USER=mysql  -DEXTRA_CHARSETS=all  -DWITH_READLINE=1  -DWITH_SSL=system  -DWITH_EMBEDDED_SERVER=1  -DENABLED_LOCAL_INFILE=1  -DWITH_INNOBASE_STORAGE_ENGINE=1

make

make install

1. 初始化授权库
   cd /usr/local/mysql
   ./scripts/mysql_install_db –user=mysql
   ls /usr/local/mysql/data/mysql/ -l

2. chmod 777 data

    创建 mysql 数据库的主配置文件
    cd  mysql-5.5.13/support-files/
    cp  my-medium.cnf  /etc/my.cnf

3. 启动数据库服务
    /usr/local/mysql/bin/mysqld_safe  –user=mysql    &

4. 使用数据库管理员从数据库服务器本机登录（没密码）
    /usr/local/mysql/bin/mysql    -uroot    -p

5. 设置数据库管理员从本机登录的密码
    /usr/local/mysql/bin/mysqladmin  -hlocalhost    -uroot    password    “123”

    kill  -9  %1 
    pkill    -9    mysqld
    /usr/local/mysql/bin/mysqld_safe  –user=mysql    &

   /usr/local/mysql/bin/mysql    -uroot    -p123  (不加密码无法登录)

6. 把 mysql 命令所在的路径添加到系统环境变量 PATH 里
    export  PATH=/usr/local/mysql/bin:$PATH

    vim /etc/bashrc
    export  PATH=/usr/local/mysql/bin:$PATH
    :wq

7. 给源码 mysql 服务编写启动脚本
    cd    mysql-5.5.13/support-files/
    cp  mysql.server    /etc/init.d/mysqldd
    chmod  +x    /etc/init.d/mysqldd

    chkconfig –add mysqldd
    chkconfig –list mysqldd
    mysqldd      0: 关闭 1: 关闭 2: 启用 3: 启用 4: 启用 5: 启用 6: 关闭

[root@localhost support-files]# netstat -untlap | grep :3306
tcp        0      0 0.0.0.0:3306                0.0.0.0:*                  LISTEN      38572/mysqld       
[root@localhost support-files]# pkill  -9  mysqld
[1]+  已杀死              /usr/local/mysql/bin/mysqld_safe –user=mysql
[root@localhost support-files]# netstat -untlap | grep :3306
service  mysqldd status
 service  mysqldd start
service  mysqldd status
service  mysqldd stop
service  mysqldd start

 更改包大小：默认是 1M，WiKi 导入超过 1M 的文件会出错。

    vi /etc/my.cnf

更改 max_allowed_packet = 1M 为 max_allowed_packet = 32M创建 XWiki 的数据库：

 8. 创建 xwiki 的数据库：

    mysql -uroot -p
    mysql> create database xwiki
    mysql> grant all privileges on xwiki.* to xwiki@127.0.0.1 identified by ‘xwiki’;

    不要使用 MyISAM 存储引擎，因为 MyISAM 不支持事务处理，推荐使用 InnoDB 存储引擎。

    vi /etc/my.cnf

[client]
#password      = your_password
port            = 3306
socket          = /tmp/mysqld.sock
default-character-set=utf8

[mysqld]
port            = 3306
socket          = /tmp/mysqld.sock
skip-external-locking
key_buffer_size = 16M
max_allowed_packet = 32M
table_open_cache = 64
sort_buffer_size = 512K
net_buffer_length = 8K
read_buffer_size = 256K
read_rnd_buffer_size = 512K
myisam_sort_buffer_size = 8M
default-storage-engine=INNODB

第五步：下载 wiki 和 MySQL 连接工具
    下载 MySQL JDBC Driver Jar 放到 /data/app_platform/xwiki_tomcat/webapps/xwiki/WEB-INF/lib 目录下
    wget http://repo1.maven.org/maven2/mysql/mysql-connector-java/5.1.34/mysql-connector-java-5.1.34.jar
    mv mysql-connector-java-5.1.34.jar /usr/local/tomcat/webapps/xwiki/WEB-INF/lib/
    cd  /usr/local/tomcat/webapps/wiki/WEB-INF/lib/
    cp -p hibernate.cfg.xml hibernate.cfg.xml-bak
    vi  hibernate.cfg.xml  删除所有多余的配置文件。
    [root@fanxh WEB-INF]# cat hibernate.cfg.xml
<?xml version=”1.0″ encoding=”UTF-8″?>
<!DOCTYPE hibernate-configuration PUBLIC
  “-//Hibernate/Hibernate Configuration DTD//EN”
  “http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd”>
<hibernate-configuration>
  <session-factory>
    <!– MySQL configuration.
        Uncomment if you want to use MySQL and comment out other database configurations.
    –>
    <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=”dbcp.ps.maxActive”>20</property>
    <mapping resource=”xwiki.hbm.xml”/>
    <mapping resource=”feeds.hbm.xml”/>
    <mapping resource=”activitystream.hbm.xml”/>
    <mapping resource=”instance.hbm.xml”/>

  </session-factory>
</hibernate-configuration>

1.XWIKI 字符集编码配置
  修改 web.xml 文件
 /data/app_platform/xwiki_tomcat/webapps/xwiki/WEB-INF/xwiki.cfg

#-# The encoding to use when transformin strings to and from byte arrays. This causes the jvm encoding to be ignored,
#-# since we want to be independend of the underlying system.
xwiki.encoding=UTF-8
2. 修改 hibernate.cfg.xml
    hibernate.cfg.xml 中添加
<property name=”connection.useUnicode”>true</property>
<property name=”connection.characterEncoding”>UTF-8</property>

3.MySQL 的配置文件 my.cnf
[client]
default-character-set=utf8
[mysqld]
default-character-set=utf8
character-set-server=utf8
collation-server=utf8_bin

4. 管理附件(/var/local/xwiki/)

默认情况下，XWIKI 使用数据库存储附件，上传的附件最大为 30M 左右，同时 MySQL 的配置文件 my.cnf 中要设置 max_allowed_packet 为最大值的 3 倍左右，因为存储历史版本也会耗费空间
使用文件系统存储可以上传更大的附件，XWIKI 使用一个临时目录来存储从数据库中调出的图片或附件。

附件的存储目录在 xwiki.properties 中设定，不可以随意增加或删除这个目录下的内容，因为每个附件在数据库中都有相应的元数据
#-# Note if the system property xwiki.data.dir is set then this property is not used.
#-# If neither the system property nor this configuration value here are set then the Servlet container’s temporary
#-# directory is used; This is absolutely not recommended since that directory could be wiped out at any time and you
#-# should specify a value.
environment.permanentDirectory=/var/local/xwiki/

最好在第一次运行 XWIKI 的时候就设定好附件的存储方式

在 xwik.cfg 文件中设置
xwiki.store.attachment.hint=file
xwiki.store.attachment.versioning.hint=file
xwiki.store.attachment.recyclebin.hint=file

用管理员登陆的话，需要修改 xwiki.cfg，将 xwiki.superadminpassword=system 前面 #去掉，用 superadmin/system 登陆即可。

Linux+Tomcat+XWiki+MySQL 安装配置 见 http://www.linuxidc.com/Linux/2013-11/93033.htm

XWiki 安装教程及更改语言配置 http://www.linuxidc.com/Linux/2014-10/108173.htm

Windows 下安装 Java 开源知识库 XWiki  http://www.linuxidc.com/Linux/2014-10/108176.htm

Xwiki 系统安装说明文档 PDF http://www.linuxidc.com/Linux/2014-10/108360.htm

使用开源软件 XWiki 搭建安装公司内部 Wiki 系统 http://www.linuxidc.com/Linux/2015-02/113290.htm

CentOS 7 上安装 XWiki 8.2.1 详解 http://www.linuxidc.com/Linux/2016-08/134408.htm

XWiki 的详细介绍：请点这里
XWiki 的下载地址：请点这里

本文永久更新链接地址：http://www.linuxidc.com/Linux/2016-11/136751.htm