帝國反抗君之古戰場。PowerOp請您速至 blog.yam.com/ystuan 支援前線！

[繁體中譯]OpenNMS Quick Start Guide

[2005/12/19]請注意，這篇網誌已經過時了，請到OpenNMS Project Documentation，Language選Trad. Chinese，就會看到我提交給官方的繁體中文安裝手冊，或者直接點選這裡。對這個主題有興趣，歡迎到我的新基地逛逛

原始網址http://www.opennms.org/users/docs/docs/html/quick.html
譯者: Austin Tuan (ystuan 老鼠 hotmail 點 com) 歡迎來信,請於主旨欄加上[Linux]字樣,萬一被hotmail當作spam,我好撿回來 :)

OpenNMS快速起步指南

OpenNMS.org 2001 年出版 版本: 1.0.0 版權(c) 1999, 2000, 2001, Oculan Corp. www.opennms.org

序言

誌謝和版權

版權

以下版權與OpenNMS 源碼或文獻是相關的:

• Copyright (c) 1999-2001 Oculan Corp. All rights reserved.

• Copyright (c) 1996-2001 PostgresSQL, Inc.

• Copyright (c) 1994 Regents of California, Inc.

• Copyright (c) 1994-2001 Sun Microsystems, Inc

• Copyright (c) 1994-2001 IBM Corporation

• Copyright (c) 2001 Microsoft Corporation

• Copyright (c) 2001 Netscape

• Copyright (c) 2001 Red Hat, Inc.

• Copyright (c) 1999-2001 ExoLab Group

• Copyright (c) 1999-2001 Apache Software Foundation

• Copyright (c) 1998-2001 The Mozilla Organization

有用的資訊鏈結

以下URLs 與OpenNMS 源碼或文獻是相關的:

• XSLFO Spec, Oct 2000

• XSLFO 聖經

• XSL 資訊站台

• XML 組織

• Docbook 組織

• O'Reilly 的DocBook大全

• OpenNMS.org - OpenNMS 網站

• apache.org - Xerces, XML4J 等的官方網站

• Sun - JAVA 的官方網站

• W3C 組織 - XSLFO 和 XML 的官方網站

• PostgreSQL - PostgreSQL 的官方網站

1 第一章

最低需求

1.1 最低需求

這個指南的目的在於引導用戶迅速安裝和設定。為達到此目的, 所列的需求非常明確。您的實際系統需求可能依情況變化 。

指南需求

資源	最低需求	可利用的資源
OpenNMS 安裝套件	版本0.9.0 或更高	www.OpenNMS.org
Linux 作業系統	Redhat Linux	www.redhat.com
JAVA Virtual Machine (JVM)	版本1.4 或更高	java.sun.com
磁碟空間	25Mb (+8Mb/SNMP 設備) 在/opt, 25Mb 在/tmp
記憶體	192 MB available (建議 256MB)

2 第二章

套件相依性設定

就這個快速起步指南而言, 它假設網路安裝程式(web installer)將會安裝和設定大多數的相依套件。因此, 在執行網路安裝前, 您應該確認這些相依套件並未安裝, 以確保網路安裝能正確執行。

2.1 移除被預先安裝的套件

如果下列軟體您想自行安裝和設定, 您應該參照OpenNMS 安裝指南。如果您決定繼續參照這份指南,首先我們將由檢查這些套件是否預裝開始, 因為它們的預設值會導致無法執行OpenNMS。

下面列出我們需要確定沒有預裝的套件, 以及用來確認這些RPM檔沒有預裝的指令。

	PostgreSQL         # rpm -qa | grep -i postgres
	Tomcat             # rpm -qa | grep -i tomcat
	RRDTool            # rpm -qa | grep -i rrdtool
	OpenNMS            # rpm -qa | grep -i opennms
		

2.2 JAVA

為了從源碼來編譯,並在Tomcat web介面下執行OpenNMS, JDK 套件是必須的; 因為JDK 的編譯器 components被用來在運行時把JSP 網頁變成Java。環境變數JAVA_HOME 應該被設定成/usr/java/j2sdk1.4.0 或JDK安裝的目錄。
[譯者註: 這一段我翻的很有問題,歡迎來信指教]

3 第三章

安裝

3.1 目錄結構

安裝時, OpenNMS 預設為以下目錄:

安裝目錄

檔案	目錄
OpenNMS 可執行檔	/opt/OpenNMS/
OpenNMS 設定檔	/opt/OpenNMS/etc/
SQL 函式庫	/usr/lib/pgsql/opennms/
開機自動啟動服務的指令稿	/etc/rc.d/init.d/opennms
資料庫	/var/

3.2 使用網路安裝程式(web installer)安裝OpenNMS

在一個被支援的RPM平台上安裝或升級, 請以root身分執行:

	lynx -source http://install.opennms.org | sh
		

注意: 在某些情況下, 安裝程式裝完了OpenNMS RPM檔案後, 會"掛"在那裡。其實,唯一還沒做的, 是文件的安裝。如果您注意到這個狀況在您安裝期間發生了,您可以安全地用<ctrl>C終止。

此時您可以再執行一次安裝程式來安裝文件, 或者輸入底下的指令來簡單地確認OpenNMS已經安裝成功...

	rpm -qa | grep -i opennms
			

3.3 安裝後

在使用網路安裝程式裝好OpenNMS後, 您需要登出, 再次以root身分登入, 讓重要的環境變數能正確設定。其中, 最重要的環境變數可能是$OPENNMS_HOME,它的預設值應該是/opt/OpenNMS.

4 第四章

設定OpenNMS

4.1 增加網路位址

接下來我們必須定義接受輪詢(Polling)的網路位址以及被監控的網路服務。OpenNMS的設定檔在 $OPENNMS_HOME/etc 目錄下。這些文件可用vi或其他大多數*nix下的文字編輯程式來修改。它們大多數是XML 格式, 修改上應該相當直觀。(我想, 嚴格地說, 這是個見仁見智的問題。)

首要任務是指定網路位址。我們將由設定發掘(discovery)範圍開始。這個設定檔為 discovery-configuration.xml, 看起來應該像這樣...

	<include-range retries="2" timeout="3000">
	<begin>192.168.0.1</begin>
	<end>192.168.0.254</end>
	</include-range>
			

接下來我們要確定輪詢者(pollers)知道這個網路地址的範圍. 這個設定檔為 poller-configuration.xml.

	<include-range begin="192.168.0.1" end="192.168.0.254"/>
			

注意: 您可能還要確認, 在capsd-configuration.xml中, 您將您的網路管理政策設為"managed"。預設對所有non-local, 有效的網路位址均為"managed"。

4.2 其他設定

在(OpenNMS的)etc目錄下還有很多其他的設定檔。您可能希望去修改它們以達到您的目的。底下是一些較常見的, 您可能想要修改的設定

snmp-config.xml

設定 snmp community 字串

log4j.properties

改變預設的紀錄檔(logging)等級

views.xml + viewsdisplay.xml

改變預設分類(catagories)和顯示屬性

5 第五章

監看網路

5.1 啟動 OpenNMS

確定您記得啟動需要的相依套件

	/sbin/service postgresql start 
		

那些相依套件啟動後, 您可以啟動OpenNMS

	/sbin/service opennms start
		或
	/opt/OpenNMS/bin/opennms.sh start
		

您也要確定tomcat伺服器正常運作

	/sbin/service tomcat4 start
		

您可以用下列指令檢查OpenNMS的狀態

	# /opt/OpenNMS/bin/opennms.sh status
	OpenNMS.Poller                          : running
	OpenNMS.Eventd                          : running
	OpenNMS.OutageManager                   : running
	OpenNMS.Discovery                       : running
	OpenNMS.Actiond                         : running
	OpenNMS.Capsd                           : running
	OpenNMS.Dhcpd                           : running
	OpenNMS.Notifd                          : running
	OpenNMS.RTCViewCategoryManager          : running
	OpenNMS.Trapd                           : running
			

如果有任何問題或服務沒有正確地啟動, 您可以檢查紀錄檔來獲得更多資訊。記錄檔在/var/log/opennms/

注意: 如果您需要停止目前的OpenNMS 程序, 您可使用以下命令的其中一個。

	/opt/OpenNMS/bin/opennms.sh stop
	/opt/OpenNMS/bin/opennms.sh kill
			

5.2 監看網路

當一切開始運作, 您可在您的瀏覽器輸入以下網址。

	http://127.0.0.1:8080/opennms/
		

login: admin/admin

在登入以後您將被帶到OpenNMS監看您的網路的主畫面。多數瀏覽器均可正常執行, 但是只有下列是正式地受到支援... for Linux: Netscape 4.7+, Netscape 6+, Mozilla 0.8+ and for Windows: Netscape 4.7+, Netscape 6+, IE 5.5+

Posted by ystuan at November 24, 2003 05:15 PM