Operfire 安裝指南

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

安裝指南

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

目錄

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

安裝

Windows

運行Openfire 安裝包. 應用缺省將被安裝於目錄 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) 或之后安裝到你的系統里. 你可以在命令行鍵入 "java -version" 來檢查你的java版本，然后 (如果必要) 訪問 http://java.sun.com更新你的Java安裝.

安裝概述

為了完成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目錄包含了服務器的可執行文件. 根據你安裝的不同分發版, 可用的執行文件也不同.
• jre目錄包含了一個 Java 5 虛擬機，打包在Windows和RPM版本Openfire里面的.
• lib目錄包含了運行Openfire所需要的庫.
• plugins目錄包含了服務器插件. 缺省地, Openfire帶了一個基於web的管理控制台插件.
• resources/database目錄包含 SQL 架構文件，用來新建Openfire數據庫, 以及已有安裝的更新腳本.
• resources/security目錄是Openfire維護keystores的地方，用來支持SSL連接安全性.
• documentation 目錄包含了服務器文檔.

安裝數據庫

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

安裝服務器

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

管理控制台

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

在Windows下運行Openfire

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

Windows服務

如果你正在Windows下運行Openfire, 你或許想在初始化安裝之后把Openfire作為一個標准的Windows來運行. 如果你使用Windows安裝包, 一個 openfire-service.exe 文件將會出現在安裝目錄下的 bin 目錄. 你可以使用這個可執行文件來安裝和控制Openfire服務.

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

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

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

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

自定義參數

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

-Xms512m
-Xmx1024m

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

在Linux/Unix下運行Openfire

如果你正在一個 Red Hat 或類 Red Hat 的系統上運行 (CentOS, Fedora, 等等), 我們建議使用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

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

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

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

自定義參數

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

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

插件

插件給Openfire增加了額外的特性和協議支持. 在安裝完你的Openfire之后, 你可能想下載並安裝插件以增進你的服務器. 插件可從 igniterealtime.org 的 plugins 頁面下載或直接從內部的管理控制台直接下載.

安裝插件

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

管理插件

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