前言
提前下载好相关软件，且安装目录最好安装在全英文路径下。如果路径有中文名，那么可能会出现一些莫名其妙的问题。
-
提前准备好的软件：
-
在安装配置 Openfire 或其他 xmpp 服务器前，需要先安装 MySQL 数据库。
- MySQL 安装具体讲解见 iOS - MySQL 的安装配置。
1、下载安装 Openfire
-
在 Openfire 官网下载最新的 Mac 版本 Openfire 安装包。
-
下载完后双击安装包，点击 pkg 文件，在安装引导下进行傻瓜式安装。安装完成后，进入系统偏好设置，点击 Openfire 图标。
-
进入 Openfire 偏好设置界面。点击 Start Openfire，让 OpenFire 服务开始启动（默认是启动的），启动完毕后，我们就可以点击 Administration 下的按钮，进入服务器后台，然后会要求输入管理员账号密码。
-
Openfire 服务启动不了问题解决
安装好之后，第一次是可以启动 openfire 服务器的，但是电脑重启后，就再也不能启动服务器了，每次一点击 “Start Openfire”，然后加载一下，状态还是 “Start Openfire” 没变化，有时甚至还会跳出错误提示框，提示 “Could not start the Openfire server”。
-
解决方案如下：
-
1）首先需要确认是否已经安装了 Java 的运行环境，以及 JAVA jdk 是否与当前 OS 系统版本，Openfire 版本成对应，如果不是，就请先安装相匹配对应的软件。
- 在终端中输入
java -version，就可以查看电脑有没有安装 JAVA 运行环境。
- 在终端中输入
-
2）如果软件，环境对应的，最终的解决办法是
-
打开终端，输入以下命令：
// 获取 Openfire 目录的访问权限 sudo chmod -R 777 /usr/local/openfire/bin // 以超级管理员的权限运行脚本 sudo su cd /usr/local/openfire/bin // 设置 Java 的环境变量 export JAVA_HOME=`/usr/libexec/java_home` // 输出检验环境变量的值 echo $JAVA_HOME-
输入上面的命令后回车，就会出现后面的这些语句
/Library/Java/JavaVirtualMachines/jdk1.8.0_51.jdk/Contents/Home
-
-
接着在终端，输入以下命令：
cd /usr/local/openfire/bin // 运行 Openfire shell 脚本 ./openfire.sh-
输入上面的命令后回车，就会出现后面的这些语句
Openfire 4.1.2 [2016-2-21 2:47:51] 管理平台开始监听: http://jhq0228-macbookair.local:9090 https://jhq0228-macbookair.local:9091 Successfully loaded plugin 'admin'.
-
执行完这些命令之后，服务器就可以启动了，每次开机后，都启动不了的话，都试下这个方法。
-
-
2、配置 Openfire
- 在 Openfire 偏好设置界面中，点击 Open Admin Console，进入 web 配置页面，开始配置 Openfire 服务器。
2.1 选择语言
-
简体中文
2.2 服务器设置
域：如果只是本地机器上登录，可以设置为本地的域 127.0.0.1。需要远端登录的话，设置为相应的 IP 地址或域名即可。此处设置为 Mac 的机器名。
-
Server Host Name (FQDN)：服务器名，不能为 IP 地址。
2.3 数据库设置
-
1、选择数据库
-
如果要设置外部数据库（推荐，比如：MySQL），选择标准数据库连接。
-
前期 MySQL 数据库准备工作
MySQL 安装具体讲解见 iOS - MySQL 的安装配置。
-
1）设置 /usr/local/openfire 文件夹的访问权限为可读写
方法1：在 finder 中前往文件夹 /usr/local/，右键 openfire 文件夹，显示简介，点击如图右下角中的锁图标解锁，并设置权限为可以读写。
-
方法2：打开终端，输入如下命令
$ sudo chmod 777 /usr/local/openfire- 其中 777 表示授权可读写权限，000 表示无访问权限。
-
2）在终端中登陆 MySQL，输入以下命令，然后输入数据库的 root 密码登录
$ mysql -u root -p-
回车后，终端输出
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.
-
-
3）在终端输入以下命令，创建数据库 openfire
create database openfire;-
回车后，终端输出
Query OK, 1 row affected (0.03 sec)
-
-
4）在终端输入以下命令，导入 openfire 资源文件夹 resources/database 下的数据表
use openfire; source /usr/local/openfire/resources/database/openfire_mysql.sql-
在终端出现一排导入过程
-
-
5）在终端输入以下命令，刷新权限
flush privileges;-
回车后，终端输出
Query OK, 0 rows affected (0.07 sec)
-
-
6）在终端输入以下命令，退出 MySQL
exit
-
-
2、设置数据库连接
-
设置标准数据库连接
-
1）数据库驱动选项
- 选择 MySQL，前提是已安装 MySQL。
-
2）JDBC 驱动程序类
-
默认不变，默认为：
com.mysql.jdbc.Driver
-
-
3）数据库 URL
-
形式如下：
jdbc:mysql://你的主机名:端口号/数据库名称 jdbc:mysql://[host-name]:3306/[database-name]?rewriteBatchedStatements=true- [host-name] ：主机名
- [database-name]：数据库名称
-
这里设置为：
jdbc:mysql://localhost:3306/openfire- 其中主机名 [host-name] 改为 localhost。
- 其中数据库名称 [database-name] 改为 openfire。
-
解决数据库字符编码问题，可以在后面加
?useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8 -
最终的 url 形式是
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，和安装 MySQL 设置的 root 密码。
-
2.4 特性设置
-
如果不打算使用 LDAP，则保持默认设置即可。
-
特性设置时出错问题解决
-
解决方法
- 在 OpenFire 偏好设置中重启 OpenFire，然后重新进入 OpenFire web 配置页面，重新开始配置 Openfire 服务器即可。
-
2.5 管理员账户设置
-
可以随便填写一个管理员邮箱，输入要设置的密码即可。管理员账号默认为 "admin"，如果不设置密码，则默认密码为 "admin"。
-
自定义管理员账户名方法
-
在终端输入以下命令，输入数据库的 root 密码，登陆具体的数据库（openfire）
mysql -u root -p openfire -
删除表 “ofUser” 中的 admin 帐户
delete from ofUser where username = 'admin'; -
创建自定义管理员（用户名：qianchia，密码：123456）
insert into ofUser (username, plainPassword, encryptedPassword, name, email, creationDate, modificationDate) values('qianchia','123456','123456','Administrator','qianchia@icloud.com','0','0'); -
查看用户
select * from ofUser;-
如果可以往数据库里插入用户但是在用户摘要却没有数据，这是因为 openfire 的数据库驱动包太旧了，而安装的数据库太新了，把 openfire 里的驱动包换成新的就行了，路径：/usr/local/openfire/lib。
-
-
2.6 登陆管理控制台
-
完成安装后可以输入用户名和密码登陆管理控制台
-
默认的管理员帐号是 “admin”，默认管理员密码 “admin”，如果上面设置了新密码，则管理员密码是新密码。如果重设了用户名，必须重启 openfire 服务器。
-
无法登录管理控制平台问题解决
安装 Openfire 后 admin 无法登录管理控制平台。登录时提示：Login failed:make sure your username and password are correct and that you’re an admin or moderator。
-
解决方案如下：
-
1）使用 MySQL 查看工具进入数据库，进入表 “ofuser”，将该表清空，然后执行该 SQL
INSERT INTO ofUser (username, plainPassword, name, email, creationDate, modificationDate) VALUES ('admin', 'admin', 'Administrator', 'admin@example.com', '0', '0'); 2）关闭 Openfire 服务，就是从其控制台 stop 然后再 start，再用用户名：admin，密码：admin 登录即可。
-
-
每次重启 Mac 电脑都需要重新配置 Openfire 问题解决
-
解决方法：
打开 /usr/local/openfire/conf/ 文件夹。
将 openfire.xml 和 security.xml 两个文件的权限设置为读与写。
重新完成 Openfire 配置。
-
3、卸载 Openfire 方法
-
1、卸载之前首先要停止 Openfire 服务。
-
系统偏好中点击 Openfire 图标，如下图
-
在 Openfire 偏好设置界面中，点击 Stop Openfire。
-
-
2、删除 Openfire 文件。
-
在终端里，输入以下三条命令执行即可。
sudo rm -rf /Library/PreferencePanes/Openfire.prefPane -
以上执行后需要输入管理员密码。
sudo rm -rf /usr/local/openfire sudo rm /Library/LaunchDaemons/org.jivesoftware.openfire.plist
-
4、测试服务器
4.1 添加测试账户
-
服务器配置完成之后，我们可以创建几个用户，然后客户端可以使用这些用户信息登录，互相传输消息。
4.2 XMPP 客户端设置与使用
有许多通信聊天客户端可以支持 XMPP 协议，比如，Mac 电脑就自带了一个 “信息” app，“信息” app 就支持 jabber 通信协议（XMPP 的别名）。
-
打开 Mac 的 “信息” app，点击菜单 信息 -> 添加账户，选择其他 “信息” 账户...
-
选择 jabber 账户类型，填写相关信息
- 账户类型：Jabber
- 用户名：上边添加的测试账户名，格式必须为：
名称@openfire服务器名称 - 密码：用户名对应的密码
- 服务器：openfire 服务器地址，可以使用自动查找服务器和端口
- 端口：openfire 服务器客户端端口
-
然后，提示验证证书，选择继续。
-
登录成功。
-
登录成功后在 openfire 服务器端可以看到用户的登录状态。
