Installation Guide 安装指南

Openfire 是用xmpp协议实现的一个强大的即时信息和对话服务（IM），这个文档将指导你从头到尾安装openfire。对于完整的参数列表和更多的信息，请访问openfie 网站：http://www.igniterealtime.org/projects/openfire/

安装：

windows平台：

运行openfire 安装程序。这个应用程序将默认安装到  c:\Program Files\Openfire

Linux/Unix平台

选择RPM 或者 tar.gz 其中一个构建。如果用RPM 直接运行你的包安装到  /opt/openfire

rpm -ivh openfire_3_0_0.rpm

如果使用.tar.gz  解压文件到/opt 或/usr/bin目录

tar -xzvf openfire_3_0_0.tar.gz
mv openfire /opt

注意：tar.gz构建，不包含捆绑运行Java runtime (JRE) ,因此，你必需有 JDK or JRE 1.5.0 (Java 5) 或者以后版本安装到你的系统。在命令行键入你检测你的java 版本 “java -version”命令，如果有必要更新你的java 安装，访问http://java.sun.com.

安装概述：

完整安装openfire到你的平台，你必需完成如下的每个步骤：

1.数据库--如果你选择使用一个外部的数据库，你必需为openfire准备你的数据库。

2.设置--使用内置的基于web的安装工具安装和验证服务器配置。

3.管理控制--用基于web管理工具，管理后台服务

这个文档也包含信息如下：

。windows 下运行

。Unix/Linux 下运行

。安装和使用插件

文件分配

这些文件在你的安装目录下应该如下（为了简便起见,省略了一些子目录中的文件）

openfire/ |- readme.html |- license.html |- conf/ |- bin/ |- jre/ |- lib/ |- plugins/     |- admin/ |- resources/     |-database/     |-security/ |- documentation/

• conf 目录是openfire 配置文件存取文件
• bin 目录包含服务可执行文件，依赖于你的安装部署，不同的是可执行将被执行可用
• The jre directory contains a Java 5 runtime that is bundled with the Windows and RPM versions of Openfire.
• jre目录文件包含一个java 5运行环境这个是附带 windows和RPM 版本的openfire
• lib 目录包含openfire运行时必要的库
• plugins目录包含服务插件，默认情况下，openfire用基于web控制平台管理插件
• resources/database  目录包含SQL模式文件，创建新的openfire 数据库，以及更新现有的脚本
  
• The resources/security directory is where Openfire maintains keystores to support SSL connection security.
• resources/security 目录是openfire维护keystores的地方，支持ssl安全连接。
• 文档目录包含服务器文档

数据库设置

Openfire可以将其数据存储在一个嵌入式数据库或你能选择用一个外部的数据库如mysql 或者Oracle,如果你想用一个外部数据库，你必需准备他，在它安装处理前。查看数据安装文档了解更多的信息。

服务设置

一个基于web的，向导驱动安装和配置工具安装openfire,简单启动openfdire 和用一个用web浏览器连接的openfire 管理控制台，给web管理控制是9090做为默认端口。如果你是同一台机器上访问openfire,你的url通常是 http://127.0.0.1:9090 初始化设置 和 如果管理员能解决远程路由，可以用远程ip 访问。。如果在internet 浏览器上增强安全配置，windows 服务管理员肯添加 http://127.0.0.1  地址到网络浏览器信用的站点列表。否则他们看到空白的屏幕。

管理控制台

完成上面的步骤。openfire 将配置你用得web 管理控制台服务。这个url 同样用设置服务，除非你在安装期间更改呢端口。

在windows 下运行Openfire

如果你用openfire 的安装程序，在你的开始菜单提供快捷方式开始图形界面。否则，运行openfire.exe 在你的安装openfire目录的 bin/目录下，在一个按钮启动允许你自动启动你的，打开你的web浏览器连接你的url 完成你的服务设置。

windows 服务

如果你在windows 下运行你的openfire.你将会想运行openfire 像标准的openfire 服务运行服务然后初始设置。如果用windows 安装程序， 一个openfire-serveic.exe文件将放在bin 目录下，你用这个可执行的安装和控制openfire服务

从一个控制台窗口,您可以运行下面的命令:

• openfire-service /install -- installs the service.
• openfire-service /uninstall -- uninstalls the service.
• openfire-service /start -- starts the service
• openfire-service /stop -- stops the service.

你用在windwos下用服务工具，控制面板开始和停止服务。

注意：如果你安装服务,您应该使用服务控制，如上所述控制服务器而不是图形界面控制。这时是windows下不兼容的


自定义参数
高级用户希望传递参数到Java虚拟机(VM)来定制运行时环境的Openfire，您可以安装Openfire bin/目录下创建vmoptions文件。对于Windows服务,您需要创建一个新的文本文件称为openfire-service.vmoptions每个参数的VM应该在新的一行上的文件 例如,将最小的堆大小为512 MB,最大VM堆大小为1024 MB
-Xms512m
-Xmx1024m
Openfire 运行在Linux / Unix 
如果你正在运行Red Hat或Red Hat  （CentOS, Fedora, etc）像这样的系统，我们推荐使用RPM，因为他包含一些自定义标准配置 Red Hat环境，假如你已经用呢RPM,你能用脚本/etc/init.d/openfire 启动或停止使用openfire
# /etc/init.d/openfire
Usage /etc/init.d/openfire {start|stop|restart|status|condrestart|reload}
# /etc/init.d/openfire start
Starting openfire:

如果 你运行的是不同的Linux/Unix 变体。和(或) 你用得事.tar.gz 安装。你能启动和停止openfire用 bin/openfire 脚本在你安装openfire

# ./openfire
Usage: ./openfire {start|stop}
# ./openfire start
Starting openfire