June 16, 2004

[繁體中譯]OpenNMS Administrator Reference Guide

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

原始網址http://www.opennms.org/users/docs/docs/html/adminref.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

序言
誌謝和版權

Copyrights

以下版權與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的設定. 下面的章節我們將談到每個設定檔和它的作用. 其中一部份有提供範例, 不過其實大部分設定檔的內容都是不解自明的.

2 第二章
各個設定檔

2.1 actiond-configuration.xml

在事件(events)產生時所呼叫的外部程式稱為(actions). 這個設定檔控制最多可以同時 執行的action數量, 以及等待action執行完畢回傳結果的逾時值。

2.2 AvailabilityReports.xsl SVGAvailReport.xsl PDFAvailReport.xsl

這三個檔案的資訊是關於如何將可用性報表轉換成PDF格式.

2.3 viewsdisplay.xml

這個檔案定義在web UI中顯示時, 各個類別的呈現方式. 這些類別則是 定義在views.xmlcategories.xml.

2.4 views.xmlcategories.xml

(譯註:views.xml這個設定檔拿掉了,categories.xml還在。省略這一段的翻譯)

2.5 capsd-configuration.xml

這個檔案定義, 對於已經發現的節點(包含由discovery daemon或SNMP所發現的), 我們能夠偵測出哪些服務. 它還可定義,若發掘了某些網路位址/網路位址區段,則應該受控或排除在外. 對於沒有定義到的其他網路位址,它可用一個預設的狀態(管理政策)來規範.

		<capsd-configuration rescan-frequency="86400000"
			management-policy="unmanaged">

		

最後,這個檔案可以讓你設定"rescan-frequency"(重新掃描網路的頻率).這個設定決定了時間間隔多久需重新掃描網路上的設備, 並且重新確認其上有哪些服務. 這個數字的單位是毫秒,預設值是86400000,也就是24小時.

2.6 controller-configuration.xml

(譯註:這個設定檔拿掉了,省略這一段的翻譯)

2.7 service-configuration.xml

這個檔案定義opennms本身要啟動的服務. 它和VM有關,並且控制哪個服務在哪個VM中開啟.

2.8 create.sql database-schema.xml

一般來說, 在安裝過程中, 指令稿install.pl會去呼叫create.sql, 來建立OpenNMS資料庫. create.sql中的註解很易懂. OpenNMS資料庫的schema定義在database-schema.xml; 執行篩選時, 系統會參照它來執行資料庫查詢.

2.9 datacollection-config.xml

這個檔案包含給RRDTool的資料收集資訊.

2.10 notifications.xml

這個檔案定義哪個事件或UEI發出告警, 以及發出告警的途徑.

		<notification name="nodeAdded">
			<uei><![CDATA[http://uei.opennms.org/products/bluebird/nodes/nodeAdded]]></uei>
			<rule><![CDATA[IPADDR IPLIKE *.*.*.*]]></rule>

			<destinationPath>Email-Network/Systems</destinationPath>
			<text-message>OpenNMS has discovered a new node named %parm[nodelabel]%.    Please be advised.</text-message>
			<subject>%parm[nodelabel]% discovered.</subject>
		</notification>

		

2.11 destinationPaths.xml

這個檔案用來定義告警的目標路徑(destination path), 例如告警應該送給誰, 傳送方式用傳呼, 電郵, 或者電郵-傳呼.

2.12 notificationCommands.xml

這個檔案定義如何達成在destinationPaths.xml中所使用的各種聯絡方式. 這包括了可執行檔的所在位置, 各種聯絡方式的別名(aliases), 以及特定傳送方式尚需的其他資訊.

		<command type="email">
			<name>/bin/mail</name>
			<lookup>email</lookup>
			<lookup>mail</lookup>

			<comment>for sending email notifications</comment>
			<argument streamed="false">
				<substitution>-s</substitution>
				<switch>-subject</switch>

			</argument>
			<argument streamed="false">
				<switch>-email</switch>
			</argument>
			<argument streamed="true">

				<switch>-tm</switch>
			</argument>
		</command>
		

2.13 discovery-configuration.xml

這個檔案定義要發掘的網路位址範圍,(ping sweep)以及逾時,重試次數,以及用來做發掘的執行緒(thread)數目。這個檔案也提供 初次發掘間隔時間(initial-sleep-time)和重新發掘間隔時間(restart-sleep-time)。這些數值以毫秒(miliseconds)為單位,用來決定 OpenNMS執行後,間隔多久要開始針對網路位址清單作發掘;以及每次發掘之間的間隔時間。

2.14 eventconf.xml

這個檔案定義通用事件識別碼(Universal Event Identifiers或UEIs)以及它們的事件遮罩(masks), 描述,記錄檔訊息,和嚴重程度。

2.15 eventd-configuration.xml

這個檔案定義eventd的運作參數,例如逾時值以及監聽器執行緒(listener threads)的數量。

2.16 users.xml / groups.xml

這些檔案存放使用者的資訊,例如他們的聯絡方式,所屬群組和會員資格。這些檔案的資訊是用來做web UI的身份認證 及告警所需的聯絡方式。

2.17 log4j.properties

這個檔案定義log4j的屬性。它包括記錄檔大小,更迭(rotation),以及各類別記錄檔的記錄層級。

2.18 magic-users.properties

這個檔案的優先權高於users.xml,它包含了一些特殊使用者的資訊。這是刻意用來控制和web UI互動的某些功能之權限。

2.19 opennms-database.xml

這個檔案定義了供OpenNMS使用的資料庫型態,名稱,認證,以及套用的模板。

2.20 opennms-mapping.xml

這個檔案是空的,但是因為opennms-database.xml的DTD需要而存在。

2.21 opennms-jms.xml

(譯註:這個設定檔拿掉了,省略這一段的翻譯)

2.22 outage-configuration.xml

這個檔案只是用來定義(服務)中斷管理(outage manager)可以有多少個寫入執行緒(writer threads)。

2.23 poller-configuration.xml

這個檔案用來定義輪詢組合(packages)以及設定各種服務的輪詢器(pollers)。一個輪詢組合內含數種項目,例如網路位址範圍, ,服務,排修時段(outage calendars),和故障時段模式(down time models).

2.24 rrdtool-graph.properties

(譯註:這個設定檔拿掉了,省略這一段的翻譯)

2.25 rtc-configuration.xml

這個檔案定義RTC (Real Time Console)的屬性,例如用來計算故障時段百分比的週期(rolling window),web UI刷新週期,以及多久 RTC將更新送至web介面。

2.26 snmp-config.xml

這個檔案用來定義網路位址或位址範圍的community strings,一個community一筆設定。

2.27 trapd-configuration.xml

這個檔案定義SNMP trap的埠口(port)。

Posted by ystuan at June 16, 2004 12:55 PM
Pings
Comments

測試一下自己的blog,為什麼主頁面出不來?

Posted by: PowerOp at June 25, 2004 12:40 AM