本文的英文原文來自 http://www.igniterealtime.org/builds/openfire/docs/latest/documentation/install-guide.html

安裝指南

Openfire是一個強大的即時消息（IM）和聊天服務(wù)器，它實現(xiàn)了XMPP協(xié)議。這份文件將引導(dǎo)您通過安裝Openfire。對于更多的功能和信息的完整列表，請訪問Openfire網(wǎng)站：http://www.igniterealtime.org/projects/openfire/

目錄

• 1 安裝
  • 1.1 Windows
  • 1.2 Linux/Unix
• 2 安裝概述
• 3 分發(fā)版里的文件
• 4 安裝數(shù)據(jù)庫
• 5 安裝服務(wù)器
• 6 管理控制臺
• 7 在Windows下運行Openfire
  • 7.1 Windows服務(wù)
  • 7.2 自定義參數(shù)
• 8 在Linux/Unix下運行Openfire
  • 8.1 自定義參數(shù)
• 9 插件
  • 9.1 安裝插件
  • 9.2 管理插件

安裝

Windows

運行Openfire 安裝包. 應(yīng)用缺省將被安裝于目錄 c:\Program Files\Openfire .

Linux/Unix

可選擇RPM包或tar.gz包. 如果使用RPM包, 用你的包管理器運行把它Openfire安裝到目錄 /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虛擬機(JRE). 所以, 你必須之前就有 JDK 或 JRE 1.5.0 (Java 5) 或之后安裝到你的系統(tǒng)里. 你可以在命令行鍵入 "java -version" 來檢查你的java版本，然后 (如果必要) 訪問 http://java.sun.com 更新你的Java安裝.

安裝概述

為了完成Openfire的安裝, 你需要執(zhí)行以下步驟:

1. 數(shù)據(jù)庫 - 如果你選擇使用一個外部數(shù)據(jù)庫, 你必須準(zhǔn)備為Openfire準(zhǔn)備好你的數(shù)據(jù)庫.
2. 安裝 - 使用內(nèi)置的基于web的安裝工具來安裝和驗證服務(wù)器的配置.
3. 管理控制臺 - 使用基于web的管理工具來管理服務(wù)器.

本文也包括以下信息:

• 在Windows下運行
• 在Unix/Linux下運行
• 安裝和使用插件

分發(fā)版里的文件

你的分發(fā)版里的文件應(yīng)該像下面這樣 (為了簡短一點，一些子目錄被忽略了):

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

• conf 目錄Openfire用來存放配置文件.
• bin 目錄包含了服務(wù)器的可執(zhí)行文件. 根據(jù)你安裝的不同分發(fā)版, 可用的執(zhí)行文件也不同.
• jre 目錄包含了一個 Java 5 虛擬機，打包在Windows和RPM版本Openfire里面的.
• lib 目錄包含了運行Openfire所需要的庫.
• plugins 目錄包含了服務(wù)器插件. 缺省地, Openfire帶了一個基于web的管理控制臺插件.
• resources/database 目錄包含 SQL 架構(gòu)文件，用來新建Openfire數(shù)據(jù)庫, 以及已有安裝的更新腳本.
• resources/security 目錄是Openfire維護keystores的地方，用來支持SSL連接安全性.
• documentation 目錄包含了服務(wù)器文檔.

安裝數(shù)據(jù)庫

Openfire能把它的數(shù)據(jù)存儲在一個嵌入式的數(shù)據(jù)庫里，你也能選擇使用一個外部數(shù)據(jù)庫,例如MySQL或Oracle. 如果你喜歡使用外部數(shù)據(jù)庫, 你必須在開始安裝之前準(zhǔn)備好它. 更多信息見數(shù)據(jù)庫安裝.

安裝服務(wù)器

Openfire內(nèi)建了一個基于web的, "向?qū)?驅(qū)動的安裝和配置工具. 簡單地啟動Openfire(分平臺的指引如下) 并使用瀏覽器連接到管理控制臺. 基于web的管理控制臺的缺省端口是9090. 如果你和Openfire在同一臺機器, 以下URL通常會起作用: http://127.0.0.1:9090.

管理控制臺

在完成上述步驟之后, Openfire將被配置，你可以用基于web的管理控制臺管理服務(wù)器. URL應(yīng)該和你用來安裝服務(wù)器用的那個一樣，除非你在安裝期間修改了那個端口.

在Windows下運行Openfire

如果你使用了Openfire安裝包, 在你的開始菜單里會有一個快捷方式來啟動圖形化啟動器. 否則, 在你的 Openfire 安裝位置的 bin/ 目錄運行 openfire.exe . 在啟動界面上有一個按鈕，允許你自動打開你的web瀏覽器連接正確的URL來完成服務(wù)器的安裝

Windows服務(wù)

如果你正在Windows下運行Openfire, 你或許想在初始化安裝之后把Openfire作為一個標(biāo)準(zhǔn)的Windows來運行. 如果你使用Windows安裝包, 一個 openfire-service.exe 文件將會出現(xiàn)在安裝目錄下的 bin 目錄. 你可以使用這個可執(zhí)行文件來安裝和控制Openfire服務(wù).

從控制臺窗口, 你可以運行以下命令:

• openfire-service /install -- 安裝服務(wù).
• openfire-service /uninstall -- 卸載服務(wù).
• openfire-service /start -- 啟動服務(wù).
• openfire-service /stop -- 停止服務(wù).

你也可以在Windows控制面板使用服務(wù)工具來啟動和停止服務(wù).

注意: 那個圖形化的啟動器目前和Windows服務(wù)還不兼容. 如果你安裝了服務(wù), 你應(yīng)該使用上述的服務(wù)控制臺來控制服務(wù)而不是這個圖形啟動器.

自定義參數(shù)

高級用戶可能希望傳遞參數(shù)到Java虛擬機(VM)來定制Openfire的運行時環(huán)境. 你可以在你的Openfire安裝目錄下的 bin/ 目錄建立 vmoptions 文件來做到這一點. 對于 Windows服務(wù), 你要建一個新文本文件，名為 openfire-service.vmoptions. 每個給VM的參數(shù)應(yīng)該獨立占用文件中的一行. 例如, 設(shè)置最小堆棧大小為 512 MB 和最大 VM 堆棧為 1024 MB, 你可以用:

-Xms512m
-Xmx1024m

要新建參數(shù)給普通的啟動器, 新建一個文件，名為 openfired.vmoptions (因為 openfire.exe 啟動器會調(diào)用 openfired.exe 可執(zhí)行文件來實際地啟動服務(wù)器).

在Linux/Unix下運行Openfire

如果你正在一個 Red Hat 或類 Red Hat 的系統(tǒng)上運行 (CentOS, Fedora, 等等), 我們建議使用RPM，因為它包含一些標(biāo)準(zhǔn)的類Red Hat環(huán)境的自定義處理. 假設(shè)你使用了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

如果你想把Openfire安裝成一個服務(wù), 在 bin/extra 目錄提供了兩個腳本:

• redhat-postinstall.sh -- 自動把Openfire安裝為Red Hat的服務(wù). 它會新建一個"jive"用戶，然后拷貝 openfired 腳本到你的 init.d 目錄. 這個腳本必須以root身份來運行. 更多信息請看腳本里的注釋.
• openfired -- 把Openfire當(dāng)成服務(wù)運行的腳本. 你必須手工配置這個腳本. 更多信息請看腳本里的注釋.

如果你通過RPM安裝，不推薦你使用這些腳本. RPM已經(jīng)把這些腳本照顧得很好了.

自定義參數(shù)

你可以在你的Openfire安裝目錄下的 bin/ 目錄建立 vmoptions 文件來做到這一點. 對于 Windows服務(wù), 你要建一個新文本文件，名為 openfire-service.vmoptions. 每個給VM的參數(shù)應(yīng)該獨立占用文件中的一行. 例如, 設(shè)置最小堆棧大小為 512 MB 和最大 VM 堆棧為 1024 MB, 你可以用:

高級用戶可能希望傳遞參數(shù)到Java虛擬機(VM)來定制Openfire的運行時環(huán)境. 如果你是通過RPM安裝的, 你可以編輯 /etc/sysconfig/openfire 文件并找到 OPENFIRE_OPTS 選項來定制它. 如果你通過.tar.gz安裝的, 你要調(diào)整你的啟動腳本來滿足你的需要.

插件

插件給Openfire增加了額外的特性和協(xié)議支持. 在安裝完你的Openfire之后, 你可能想下載并安裝插件以增進你的服務(wù)器. 插件可從 igniterealtime.org 的 plugins 頁面下載或直接從內(nèi)部的管理控制臺直接下載.

安裝插件

如果你從Openfire內(nèi)部的管理控制臺下載了一個插件, 它將被自動安裝. 如果你手工下載這個插件(打包成一個.jar文件), 你可以通過把插件文件拷貝到Openfire安裝目錄下的 plugins/ 目錄來布署它. 一個插件監(jiān)控器將自動解包這個插件到一個目錄并安裝這個插件到Openfire. 你也可以在管理控制臺使用"上傳插件"功能(在 插件 標(biāo)簽頁) 來從本地文件系統(tǒng)裝入一個插件到服務(wù)器.

管理插件

插件可通過內(nèi)部的Openfire管理控制臺來管理. 你也可以在任何時候通過刪除插件的JAR文件來手工刪除一個插件(當(dāng)你這么干了，Openfire將從內(nèi)存自動移除這個插件并刪除它的目錄).

版權(quán)所有，歡迎轉(zhuǎn)載，轉(zhuǎn)載請注明出處，謝謝