November 24, 2003

[繁體中譯]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 源碼或文獻是相關的:

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
Pings
Comments

請問
我在安裝好OpenNMS 後再進入http://127.0.0.1:8080/opennms/打入
帳號:admin
密碼:admin
but 不能進入

不知為什麼

方順展

Posted by: 方順展 at May 3, 2004 08:13 PM

我想是postgresql 的問題
請先確定postgresql 有無啟動?
(檢查:#ps -ef | grep postmaster)
如果確實啟動,試試下列指令建立opennms 的資料庫
#/opt/OpenNMS/bin/install.pl -q /opt/OpenNMS/etc/create.sql

檢查設定
/var/lib/pgsql/data/postgresql.conf
/var/lib/pgsql/data/pg_hba.conf
是否同官網所述,應該就可以了

Posted by: weber at May 5, 2004 01:24 PM

#/opt/OpenNMS/bin/install.pl -q /opt/OpenNMS/etc/create.sql

OpenNMS/bin的目录里怎么没有install.pl 文件。 怎么处理?

Posted by: withoutastop at October 15, 2004 12:45 PM

你可以使用官方文件的方法
java -jar /usr/local/opennms/lib/opennms_install.jar -disU

Posted by: Crab at October 16, 2004 12:19 PM

[root@localhost root]# service opennms status
OpenNMS.Eventd : starting
OpenNMS.Trapd : starting
OpenNMS.Dhcpd : running
OpenNMS.Actiond : running
OpenNMS.Capsd : starting
OpenNMS.Notifd : running
OpenNMS.Scriptd : running
OpenNMS.Outaged : starting
OpenNMS.Rtcd : starting
OpenNMS.Pollerd : starting
OpenNMS.Collectd : starting
OpenNMS.Threshd : starting
OpenNMS.Discovery : starting

opennms安装后, 不能完全运行起来, 一般会是什么问题? 请高手指点一下, 谢谢!

Posted by: withoutastop at October 19, 2004 12:08 PM

withoutastop:
你的情形我也遇過,不曉得底下這個鏈結的討論有沒有幫助:
https://sourceforge.net/mailarchive/message.php?msg_id=9393659

它其實指向一篇有關PostgreSQL權限設定的FAQ:
http://faq.opennms.org/faq/fom-serve/cache/106.html
參考看看。

Posted by: PowerOp at October 29, 2004 04:42 PM