Comunes/Kune 项目安装与配置完全指南

前言

Comunes/Kune 是一个基于Wave协议的协作平台，提供了实时协作、文档编辑、即时通讯等功能。本文将详细介绍Kune的安装与配置过程，涵盖开发环境和生产环境两种场景。

开发环境安装指南

重要警告

本文档主要面向开发者，如果您只需要部署Kune供用户使用，建议使用DEB包在Debian/Ubuntu环境下安装，这样更加简单快捷。

系统要求

在开始安装前，请确保系统满足以下要求：

1. 基础软件包：
   • Java JDK (版本7或更高)
   • Maven 2
   • MySQL (版本5.0以上)
   • Eclipse (或其他IDE，可选)

对于Debian/Ubuntu系统，可以使用以下命令安装：

sudo apt-get install subversion maven2 mercurial openjdk-6-jdk mysql-server libjmagick6-jni

2. 可选组件：
   • OpenFire (用于Jabber/XMPP聊天服务)
   • SMTP服务器 (用于邮件通知)

MySQL数据库配置

1. 创建开发数据库：

CREATE DATABASE kune_dev;
GRANT ALL PRIVILEGES ON kune_dev.* TO kune@localhost IDENTIFIED BY 'db4kune';
FLUSH PRIVILEGES;

CREATE DATABASE kune_test;
GRANT ALL PRIVILEGES ON kune_test.* TO kune@localhost IDENTIFIED BY 'db4kune';
FLUSH PRIVILEGES;

2. 创建生产数据库：

CREATE DATABASE kune_prod;
GRANT ALL PRIVILEGES ON kune_prod.* TO kune@localhost IDENTIFIED BY 'db4kune';
FLUSH PRIVILEGES;

3. 设置字符集：

ALTER DATABASE kune_dev CHARACTER SET utf8 DEFAULT CHARACTER SET utf8 COLLATE utf8_bin DEFAULT COLLATE utf8_bin;
ALTER DATABASE kune_test CHARACTER SET utf8 DEFAULT CHARACTER SET utf8 COLLATE utf8_bin DEFAULT COLLATE utf8_bin;
ALTER DATABASE kune_prod CHARACTER SET utf8 DEFAULT CHARACTER SET utf8 COLLATE utf8_bin DEFAULT COLLATE utf8_bin;

安全提示：强烈建议修改默认密码'db4kune'，并在相关配置文件中同步更新。

域名配置

确保您计划使用的域名能够正确解析。开发环境建议使用localhost或类似local.net的本地域名。

源代码编译

1. 获取Kune源代码（参考DEVGUIDE）
2. 使用Maven编译：

mvn compile -Dliquibase.should.run=false && mvn gwt:compile -P development

目录配置

创建必要的系统目录并设置权限：

sudo mkdir -p /usr/share/kune/
sudo chown yourUser:yourUser /usr/share/kune/

sudo mkdir -p /var/lib/kune/uploads/
sudo chown yourUser:yourUser /var/lib/kune/uploads

sudo mkdir -p /var/lib/kune/sitemap/
sudo chown yourUser:yourUser /var/lib/kune/sitemap

OpenFire Jabber服务器

1. 下载并安装OpenFire
2. 配置数据库连接（使用之前创建的kune_openfire数据库）
3. 启用HTTP绑定（默认端口5280）
4. 禁用内置账户注册和密码修改功能

数据库初始化

1. 导入初始SQL：

mysql -p -u kune kune_dev < src/main/resources/db/kune_initialize.sql

2. 执行数据库迁移：

bin/liquibase-migrate.sh

启动服务器

开发环境：

bin/server.sh # 或 mvn exec:java

生产环境：

bin/server.sh -j kune.jar

访问系统

开发环境访问：

http://localhost:8888/?locale=en

生产环境部署

打包生成

生成可执行JAR包：

mvn assembly:assembly -P production

启动服务

使用生成的JAR包启动：

bin/server.sh -j kune.jar

高级配置

自定义配置

您可以自定义以下文件来适配您的站点需求：

• kune.properties
• wave-server.properties
• log4j.properties
• ws.html
• kune-client-actions.xml

建议将这些自定义文件放在独立目录中，并通过resource_bases配置指定优先级。

附录A：OpenFire详细配置

1. 安装OpenFire后，通过9090端口访问管理界面

2. 配置MySQL数据库连接：

   • JDBC驱动类：com.mysql.jdbc.Driver
   • 数据库URL：jdbc:mysql://localhost:3306/kune_openfire
   • 用户名：kune
   • 密码：db4kune

3. 配置群聊服务，建议使用"rooms"作为房间主机名

系统优化

1. 增加系统文件打开限制： 编辑/etc/security/limits.conf文件，添加：

   * soft nofile 65535
   * hard nofile 65535
   

2. 安装JMagick：

   sudo apt-get install libjmagick6-jni
   sudo ln -s /usr/lib/jni/libJMagick.so /usr/lib/libJMagick.so
   

常见问题解决

1. 数据库迁移失败：

   • 确保数据库用户有足够权限
   • 检查liquibase.properties中的配置
   • 可以尝试手动执行SQL脚本

2. OpenFire启动问题：

   • 检查/etc/init.d/openfire中的JAVA_HOME设置
   • 确保端口未被占用

3. 开发环境语言限制： 开发模式下仅支持英语(locale=en)，尝试其他语言可能导致循环问题

总结

本文详细介绍了Comunes/Kune项目从开发环境搭建到生产部署的全过程。通过遵循这些步骤，您可以成功安装并配置一个功能完整的Kune协作平台。对于特定需求，可以通过自定义配置文件进行进一步调整。