Operfire 安裝指南

原文地址: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的安裝, 你需要執行以下步驟:

  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來完成服務器的安裝

launcher.png

Windows服務

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

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

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

windows_service.png

你也可以在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將從內存自動移除這個插件並刪除它的目錄).

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章