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

122次阅读

没有评论

共计 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

初始化授权库
cd /usr/local/mysql
./scripts/mysql_install_db –user=mysql
ls /usr/local/mysql/data/mysql/ -l
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

正文完