原文地址:http://www.cnblogs.com/hoojo/archive/2012/05/13/2498151.html
本文的英文原文來自 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的安裝, 你需要執行以下步驟:
- 數據庫 - 如果你選擇使用一個外部數據庫, 你必須準備爲Openfire準備好你的數據庫.
- 安裝 - 使用內置的基於web的安裝工具來安裝和驗證服務器的配置.
- 管理控制檯 - 使用基於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將從內存自動移除這個插件並刪除它的目錄).