2018-05-13

Mac XMPP Openfire 服务器配置

1、配置准备工作

1）配置服务器准备工作
- 下载相关软件
  - jdk-8u91-macosx-x64.dmg
  - openfire_4_1_1.dmg
  - spark_2_8_3.dmg
  - Openfire 官网
  - MySQL 官网
  - JDK 官网
  - Openfire 服务器配置软件下载地址
    - Openfire v4.1.2 for Mac，密码：p5gv。
    - Spark v2.8.3 for Mac，密码: fvw6。
2）配置服务器注意事项
- 提前下载好相关软件，且安装目录最好安装在全英文路径下。如果路径有中文名，那么可能会出现一些莫名其妙的问题。
- 在安装配置 Openfire 或其他 xmpp 服务器前，需要先安装 MySQL 数据库。
  - MySQL 安装具体讲解见 MySQL 数据库配置。
3）示例配置环境
- macOS 10.11.6
- macOS 10.13.3

2、下载安装 Openfire

在 Openfire 官网下载最新的 Mac 版本 Openfire 安装包。
下载完后双击安装包，点击 pkg 文件，在安装引导下进行傻瓜式安装。安装完成后，进入系统偏好设置，点击 Openfire 图标。
进入 Openfire 偏好设置界面。点击 Start Openfire，让 OpenFire 服务开始启动（默认是启动的），启动完毕后，我们就可以点击 Administration 下的按钮 Open Admin Console，进入服务器后台，然后会要求输入管理员账号密码。

2.1 Openfire 服务启动不了问题解决

安装好之后，第一次是可以启动 openfire 服务器的，但是电脑重启后，就再也不能启动服务器了，每次一点击 “Start Openfire”，然后加载一下，状态还是 “Start Openfire” 没变化，有时甚至还会跳出错误提示框，提示 “Could not start the Openfire server”。解决方案如下：
1）首先需要确认是否已经安装了 Java 的运行环境，以及 JAVA jdk 是否与当前 macOS 系统版本，Openfire 版本成对应，如果不是，就请先安装相匹配对应的软件。
- 在终端中输入 java -version，就可以查看电脑有没有安装 JAVA 运行环境。

2）如果软件，环境对应的，最终的解决办法是，打开终端，输入以下命令：

# 获取 Openfire 目录的访问权限  
$ sudo chmod -R 777 /usr/local/openfire/bin
 
# 以超级管理员的权限运行脚本  
$ sudo su
  
# 打开 openfire 路径
cd /usr/local/openfire/bin
 
# 设置 Java 的环境变量  
export JAVA_HOME=`/usr/libexec/java_home`
 	
# 输出检验环境变量的值
echo $JAVA_HOME

输入上面的命令后回车，就会出现后面的这些语句
1
/Library/Java/JavaVirtualMachines/jdk1.8.0_121.jdk/Contents/Home

3）接着在终端，输入以下命令：

cd /usr/local/openfire/bin  
 
# 运行 Openfire shell 脚本  
./openfire.sh

输入上面的命令后回车，就会出现后面的这些语句

Openfire 4.1.2 [2016-2-21 2:47:51]
管理平台开始监听:
    http://qianchia-macbookair.local:9090
    https://qianchia-macbookair.local:9091
Successfully loaded plugin 'admin'.

4）执行完这些命令之后，服务器就可以启动了，每次开机后，都启动不了的话，都试下这个方法。

3、配置 Openfire 服务器

在 Openfire 偏好设置界面中，点击 Open Admin Console，进入 web 配置页面，开始配置 Openfire 服务器。

3.1 选择语言

简体中文

3.2 服务器设置

域：如果只是本地机器上登录，可以设置为本地的域 127.0.0.1。需要远端登录的话，设置为相应的 IP 地址或域名即可。此处设置为 Mac 的机器名。
Server Host Name (FQDN)：服务器名，不能为 IP 地址。

3.3 数据库设置

3.3.1 选择数据库

前期 MySQL 数据库准备工作
- MySQL 安装具体讲解见 MySQL 数据库配置。
1) 设置 /usr/local/openfire 文件夹的访问权限为可读写
- 方法 1：在 finder 中前往文件夹 /usr/local/，右键 openfire 文件夹，显示简介，点击如图右下角中的锁图标解锁，并设置权限为可以读写。
- 方法 2：打开终端，输入如下命令，其中 777 表示授权可读写权限，000 表示无访问权限。
  1
  $ sudo chmod 777 /usr/local/openfire

2) 在终端中登陆 MySQL，输入以下命令，然后输入数据库的 root 密码登录

1 2	# 登录 mysql $ mysql -u root -p

输入原 root 账户密码，登录成功后终端会输出：

Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 946
Server version: 5.7.17 MySQL Community Server (GPL)
    
Copyright (c) 2000, 2016, Oracle and/or its affiliates. All rights reserved.
    
Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective 
owners.
    
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

如果终端输出以下提示，需将 mysql 添加到系统环境变量。
1
-bash: mysql: command not found

3) 在终端输入以下命令，创建数据库 openfire
1
create database openfire;
- 回车后，终端输出
  1
  Query OK, 1 row affected (0.03 sec)

4) 在终端输入以下命令，导入 openfire 资源文件夹 resources/database 下的数据表

1
2
3

use openfire;

source /usr/local/openfire/resources/database/openfire_mysql.sql

在终端出现一排导入过程

Query OK, 1 row affected (0.00 sec)

Query OK, 1 row affected (0.00 sec)

Query OK, 1 row affected (0.00 sec)

mysql>

5) 在终端输入以下命令，刷新权限
1
flush privileges;
- 回车后，终端输出
  1
  Query OK, 0 rows affected (0.07 sec)

6) 在终端输入以下命令，退出 MySQL
1
exit
如果要设置外部数据库（推荐，比如：MySQL），选择标准数据库连接。

3.3.2 设置数据库连接

设置标准数据库连接
1) 数据库驱动选项
- 选择 MySQL，前提是已安装 MySQL。
2) JDBC 驱动程序类
- 默认不变，默认为：
  1
  com.mysql.jdbc.Driver

3) 数据库 URL
- 形式如下：
  1
  2
  3
  jdbc:mysql://你的主机名:端口号/数据库名称
  
  jdbc:mysql://[host-name]:3306/[database-name]?rewriteBatchedStatements=true
  - [host-name] ：主机名
  - [database-name]：数据库名称
- 这里设置为：
  1
  jdbc:mysql://localhost:3306/openfire
  - 其中主机名 [host-name] 改为 localhost。
  - 其中数据库名称 [database-name] 改为 openfire。
- 解决数据库字符编码问题，可以在后面加
  1
  ?useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8
- 最终的 url 形式是
  1
  jdbc:mysql://localhost:3306/openfire?useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8
- 注意：前提是已存在一个名为 openfire 的数据库，否则会报如下错误，连接配置不成功。openfire 数据库的创建具体见前面所讲的 “前期 MySQL 数据库准备工作”。
  - The Openfire database schema does not appear to be installed. Follow the installation guide to fix this error.
4) 用户名和密码
- 这里的用户名密码，是访问 MySQL 数据库时使用的帐号和密码。
  - 用户名：root
  - 密码：root 账户密码

3.4 配置文件设置

如果不打算使用 LDAP，则保持默认设置即可。
特性设置时出错问题解决
- 解决方法
  - 在 OpenFire 偏好设置中重启 OpenFire，然后重新进入 OpenFire web 配置页面，重新开始配置 Openfire 服务器即可。

3.5 管理员账户设置

可以随便填写一个管理员邮箱，输入要设置的密码即可。管理员账号默认为 “admin”，如果不设置密码，则默认密码为 “admin”。
自定义管理员账户名方法
- 在终端输入以下命令，输入数据库的 root 密码，登陆具体的数据库（openfire）
  1
  $ mysql -u root -p openfire
- 删除表 “ofUser” 中的 admin 帐户
  1
  delete from ofUser where username = 'admin';
- 创建自定义管理员（用户名：qianchia，密码：123456）
  1
  insert into ofUser (username, plainPassword, encryptedPassword, name, email, creationDate, modificationDate) values('qianchia','123456','123456','Administrator','qianchia@icloud.com','0','0');
- 查看用户
  1
  select * from ofUser;
  - 如果可以往数据库里插入用户但是在用户摘要却没有数据，这是因为 openfire 的数据库驱动包太旧了，而安装的数据库太新了，把 openfire 里的驱动包换成新的就行了，路径：/usr/local/openfire/lib。

3.6 登陆管理控制台

完成安装后可以输入用户名和密码登陆管理控制台
默认的管理员帐号是 “admin”，默认管理员密码 “admin”，如果上面设置了新密码，则管理员密码是新密码。如果重设了用户名，必须重启 openfire 服务器。

3.6.1 无法登录管理控制平台问题解决

安装 Openfire 后 admin 无法登录管理控制平台。登录时提示：Login failed:make sure your username and password are correct and that you’re an admin or moderator。
解决方案如下：
- 1）使用 MySQL 管理工具（如 MySQL Workbench）进入数据库，进入表 “ofuser”，将该表清空
  - 然后执行该 SQL
    1
    INSERT INTO ofUser (username, plainPassword, name, email, creationDate, modificationDate) VALUES ('admin', 'admin', 'Administrator', 'admin@example.com', '0', '0');
- 2）关闭 Openfire 服务，就是从其控制台 stop 然后再 start，再用用户名：admin，密码：admin 登录即可。

4、测试 Openfire 服务器

4.1 添加测试账户

服务器配置完成之后，我们可以创建几个用户，然后客户端可以使用这些用户信息登录，互相传输消息。

4.2 XMPP 客户端设置与使用

有许多通信聊天客户端可以支持 XMPP 协议，比如，Mac 电脑就自带了一个 “信息” app，“信息” app 就支持 jabber 通信协议（XMPP 的别名）。
打开 Mac 的 “信息” app，点击菜单信息 -> 添加账户，选择其他 “信息” 账户…
选择 jabber 账户类型，填写相关信息
- 账户类型：Jabber
- 用户名：上边添加的测试账户名，格式必须为：名称@openfire服务器名称
- 密码：用户名对应的密码
- 服务器：openfire 服务器地址，可以使用自动查找服务器和端口
- 端口：openfire 服务器客户端端口
然后，提示验证证书，选择继续。
登录成功。
登录成功后在 openfire 服务器端可以看到用户的登录状态。

5、卸载 Openfire 服务器

1）卸载之前首先要停止 Openfire 服务。
- 系统偏好中点击 Openfire 图标，如下图
- 在 Openfire 偏好设置界面中，点击 Stop Openfire。

2）删除 Openfire 文件。

在终端里，输入以下三条命令执行即可。

1	$ sudo rm -rf /Library/PreferencePanes/Openfire.prefPane

以上执行后需要输入管理员密码。

1
2
3

$ sudo rm -rf /usr/local/openfire
    
$ sudo rm /Library/LaunchDaemons/org.jivesoftware.openfire.plist

6、常见问题

1）每次重启 Mac 电脑都需要重新配置 Openfire 问题
- 解决方法：
  - 打开 /usr/local/openfire/conf/ 文件夹。
  - 将 openfire.xml 和 security.xml 两个文件的权限设置为读与写。
  - 重新完成 Openfire 配置。

如果您觉得阅读本文对您有帮助，请用微信、支付宝 or QQ 扫码赞助，您的支持是我写作最大的动力！欢迎各位转载，但是未经作者本人同意，转载文章之后必须在文章页面明显位置给出作者和原文链接，否则保留追究法律责任的权利。

Qian Chia

Posted @ 2018-05-13 06:01

Qian Chia's Blog

赞助

搜索

分类

标签