OpenNMS是世界上第一個用開放原始碼模式開發的企業級網路管理系 統。和其他複 雜、功能強大的系統一樣，需要費一點心力來安裝和設定。這份文件就是用來說明安裝OpenNMS所需的步驟。

那麼，妳該如何運用這份文件呢？它包含了下列章節：

這份安裝指南非常倚賴「套件」這個概念。現今大部分的作業系統和發行版 本都擁有套件管 理系統。一個套件會將屬於同一個應用程式的檔案都彙整進來（並且包含檔案變動，移除，更新等等的管理）。我們可藉此系統安裝和管理各種軟體。

請參閱最新的發行摘要以 確認是否有支援妳的作業系統。目前OpenNMS支援Linux（的很多不同發行版本）， Solaris和Mac OS X。

這份指南假定如果妳使用套件管理系統，妳就會一直使用它。這是因為 OpenNMS會試著用作業系統內建的套件管理系統來確認那些必須先安裝的套件是否裝好了。例如妳裝了Java，但不是用套件裝的，OpenNMS將無法 確認妳的系統有裝Java，因此整個安裝會失敗。

讓我們再回到最初的問題「妳該如何運用這份文件」，請先瀏覽第二章， 確定妳已經把必須的、作為先決條件的套件都適當地安裝、設定完畢了。用第三章來協助妳將那些套件裝進妳的作業系統，以及安裝OpenNMS。最後，用最後 一章來協助妳修正各種可能遇到的錯誤。

雖然我們不可能針對特定的環境來精確地估量OpenNMS之系統需求， 底下列出安裝在 200個設備的網路中之最低需求。當然，只要有更好的硬體，OpenNMS可監控的設備數量百倍於此。

OpenNMS主要是用Java開發的，雖然為了實作例如ICMP這類 東西而用到一些 JNI來呼叫C語言程式 碼。理所當然，妳需要安裝Java。

由於目前的程式碼有小部分倚賴一個Sun-only的函式庫 (HTTPS Monitor裡面的"com.sun.net.ssl.internal.www.protocol")，我們推薦妳使用Sun的SDK。使用IBM的 SDK應該也可以，只不過在輪詢器(poller)啟動的時候會在記錄檔產生一個錯誤訊息。

底下的說明是使用Sun所散佈的Java，不過有一些使用者採用Blackdown網 站編譯的Sun Java，也獲得成功。

XXX Add something about 32-bit vs 64-bit for libjicmp and librrd.

deb http://debian.opennms.org/ debian/opennms stable

deb http://debian.opennms.org/ debian/opennms unstable

Tomcat是Apache 基金會之Jakarta專案的一部份，是一個Java servlet引擎。也就是說Tomcat是一個網頁伺服器，它用"servlets"（小的 Java程式）來產生HTML頁面。注意這和Java "applets"很不一樣--servlets在伺服器端執行，而不是下載到瀏覽器執行。只要servlet被編譯後，Tomcat就會暫存它，意味著 首次次讀取一個特定頁面也許慢，但是接下來的存取就蠻快的。

Tomcat最新的版本是Tomcat5，不過OpenNMS因為使 用Tomcat4的認證功能，不能使用Tomcat5。以後的版本會修正這個現 況，不過現在妳必須使用Tomcat4。

# tomcat /etc/rc.d script example configuration file
# Use with version 1.07 of the scripts or later

# Use Jpackage utils if present
if [ -x /usr/bin/java-functions ]; then
. /usr/bin/java-functions
set_jvm
fi

# Source Java system configuration if exist
if [ -r /etc/java/java.conf ]; then
. /etc/java/java.conf
fi

# you could also override JAVA_HOME here
# Where your java installation lives
# JAVA_HOME="/usr/java/jdk"
# JAVA_HOME="/opt/IBMJava2-131"

# You can pass some parameters to java
# here if you wish to
#JAVACMD="$JAVA_HOME/bin/java -Xminf0.1 -Xmaxf0.3"

# Where your tomcat installation lives
# That change from previous RPM where TOMCAT_HOME 
# used to be /var/tomcat.
# Now /var/tomcat will be the base for webapps only
CATALINA_HOME="/var/tomcat4"
JASPER_HOME="/var/tomcat4"
CATALINA_TMPDIR="/var/tomcat4/temp"

# What user should run tomcat
TOMCAT_USER="tomcat"

# You can change your tomcat locale here
#LANG=en_US

# If you wish to further customize your tomcat environment,
# put your own definitions here
# (i.e. LD_LIBRARY_PATH for some jdbc drivers)
# Just do not forget to export them 

JAVA_HOME="/usr/java/j2sdk1.4.2_04/"

TOMCAT_USER="root"

MRTG， 這個可能是第一個被廣泛使用的開放原始碼網管工具，它的起源就是RRDtool。

RRDtool提供"round robin"資料庫，用來快速、節省空間地儲存時間序列(time-series)量測數據。OpenNMS將效能相關的數據儲存在用RRDtool產生 的RRD檔案。

我們不需要對RRDtool做特別的設定。只要它是以套件安裝， OpenNMS套件應該可以找到它，並且用適當的指令完成設定。目前已知可以使用RRDtool 1.0.33以上任何的"1.0"系列版本。

XXX add a comment about 32-bit vs. 64-bit stuff for the iplike.so module

OpenNMS使用PostgreSQL（又 稱"Postgres"）這個關聯式資料庫來儲存各種資訊，例如網路設備、事件、告警和故障。

在安裝OpenNMS之前，要先準備兩件跟資料庫有關的事項。首先， OpenNMS必須能夠以TCP/IP方式連結到資料庫（即使兩者都在同一台機 器）；其次，在安裝過程中要能夠新增資料庫。

OpenNMS需要PostgreSQL版本7.2以上。如果你使用 PostgreSQL 7.4之前的版本，伺服器的錯誤訊息必須是英文（'C' locale）。尤其參數lc_messages 必須是'C'。 相關設定在PostgreSQL data目錄的postgresql.conf檔 案裡， 如果有修改的話，請重新啟動資料庫。data目 錄的所在位置，請參閱底下關於pg_hba.conf的 小節。

妳至少應該安裝這個套件：

請注意，Red Hat Enterprise Linux和CentOS把PostgreSQL套件稱為"rhdb"，意思是"Red Hat DataBase"；而舊版的SuSE則稱做"postgres"。

如果妳使用最近版本的Mandrake（版本9以上），妳還需要：

一旦妳安裝了Postgres，妳需要修改兩個Postgres設定 檔：postgresql.conf和pg_hba.conf。Postgres 首次啟動會產生這些檔案，因此如果妳剛才安裝的時候沒有啟 動它，請現在啟動它。通常，啟動指令稿會放在/etc/init.d。

找出Postgres的"data"目錄。通常應該是 /var/lib/pgsql/data。我們要修改的兩個檔案應該就在那個目錄下。

# TYPE DATABASE USER IP-ADDRESS IP-MASK METHOD
local all all trust
host all all 127.0.0.1 255.255.255.255 trust
host all all ::1 ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff trust

# ./initdb -D /usr/local/pgsql/data -E ""

# ./pg_ctl -D /usr/local/pgsql/data start

啟動指令稿使用curl去 連接OpenNMS daemon來檢查各個部分均順利啟動和運行("opennms status")。

由於OpenNMS使用Perl來寄送可用性報告，對於某些郵件程式而 言，妳必須加裝metamail套 件才能讓OpenNMS產生的PDF檔案被順利寄出。

比照前面章節所提到的Perl相關模組，如果妳的發行版本沒有提供 metamail， 妳可以在OpenNMS的 FTP站台找到metamail（也 提供SRPM檔）。

如果妳是首次安裝，請遵循本節中有關妳的作業系統的部分。如果妳要替一 套已經裝好的 OpenNMS升級，請看下 一節。

# apt-get install opennms

# apt-get install opennms-doc opennms-contrib

# rpm -i opennms-1.2.0-1_<distribution>.<platform>.rpm
# rpm -i opennms-webapp-1.2.0-1_<distribution>.<platform>.rpm

# rpm -i opennms-docs-1.2.0-1_<distribution>.<platform>.rpm

# cd /usr/local
# gzip -d opennms-1.2.0-1-sol<version>-sparc-local.gz

# pkgadd -d `pwd`/opennms-1.2.0-1-sol<version>-sparc-local

# sh build.sh install

XXX this section could use some more love, too.

幫舊版的OpenNMS升級至目前的版本，通常只要安裝適合妳的（作業 系統）發行版本 之套件即可。

如果是RPM為基礎的發行版本，只要輸入指令"rpm -Uvh [套件名稱]"即可。

此外，OpenNMS的安裝程式(installer)可能會試著去修 改資料庫。請記 得依照本章後面的指示以 執行安裝程式(installer)。這些變動應 該會順利完成，但是，就算是最周全的計畫都有可能出錯。為了以防萬一，在升級之前請依照下面的細項指示來備份妳的PostgreSQL資料庫。

不管前面妳選了什麼安裝方法，也不管妳是升級或執行首次安裝，妳仍然需 要運行安裝程式 (installer)。 這個工具會在PostgreSQL中設定opennms資 料庫，並且將OpenNMS 網頁應用程式(常簡稱"webapp"或"webUI")裝進Tomcat。

# $OPENNMS_HOME/bin/runjava -s

# $OPENNMS_HOME/bin/runjava -S <JRE的位置>

# $OPENNMS_HOME/bin/install -disU

# $OPENNMS_HOME/bin/install -y -w $CATALINA_HOME/webapps -W $CATALINA_HOME/server/lib

OpenNMS預設的網路主機發掘(host discovery)設定可能不符合妳的需求。請編輯$OPENNMS_HOME/etc/discovery-configuration.xml。 看起來應該像這樣：

<discovery-configuration threads="1" packets-per-second="1"
 initial-sleep-time="300000" restart-sleep-time="86400000"
 retries="3" timeout="800">

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

 <include-url>file:/opt/OpenNMS/etc/include</include-url>

</discovery-configuration>

妳最可能想要更動的，應該是起迄的範圍（分別以<begin>和<end>標 籤設定。）另外妳可以視需要增加幾組<include-range>。 如果妳寧可逐一列出想要發掘的網路主機，妳可以將<specific>標 籤插入<include-range>標 籤之前，或者放在<include-url>所 指的檔案中，一行一個網路位址。 最後，如果妳想要用網頁介面來增加讓OpenNMS監控的主機，妳可以將整個檔案內容變成註解（把"<!--" 放在第一行的前面，然後放"-->" 在最後一行的後面就可以了）。

底下是個範例，在妳的作業系統上也許不太一樣：

# /etc/init.d/postgres start

# /etc/init.d/tomcat4 start
# $OPENNMS_HOME/bin/opennms start

如果妳的作業系統沒有PostgreSQL或Tomcat4的啟動指令 稿，妳可以執行 類似底下的指令：

# sudo -u postgres /usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start
# /usr/local/tomcat/bin/startup.sh

在妳的瀏覽器輸入網址http://<host>:8080/opennms/（在 Debian Linux上請用Port 8180）。一開始可以用帳號"admin"， 密碼"admin" 來登入。

如果到這裡一切順利，妳可以將OpenNMS設為開機自動執行。大部分 的作業系統並沒 有預設OpenNMS為開 機自動執行，妳要自己更改設定。

# chkconfig --add opennms

# ln -s $OPENNMS_HOME/bin/opennms /etc/init.d/opennms

# ln -s ../init.d/opennms /etc/rc3.d/S99opennms
# ln -s ../init.d/opennms /etc/rc3.d/K01opennms

OpenNMS是個複雜的軟體產品，截至目前為止，它（還）不像很多工 具程式，可以簡 單地用"./configure && make && make install" 來編譯。如果已經有包裝好的，適合妳的作業系統的OpenNMS套件，我們強烈建議妳採 用。如果採用包裝好的套件遇到問題，請參閱故障排除章節來尋求協助。

參閱有關安裝必須套件的章節，並且在安裝OpenNMS前先將它們安裝 完畢。

妳可以下載某個釋出版本的程式碼，或者妳可以直接從source code respository (CVS)下載。除非妳想要參與開發，或者需要還沒釋出的特定功能、bug修正，否則下載已釋出的程式碼應該夠了。

$ cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/opennms login

$ cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/opennms co opennms

有幾樣細節是關於RRDtool和PostgreSQL安裝在哪裡，目 前編譯的過程 （還）不能可靠地自動找到這 些答案。如果妳的RRDtool不是裝在/usr目 錄，或者PostgreSQL server include目錄不是/usr/include/pgsql/server， 妳就需要建立一個build.properties檔 案。

妳可以偷懶跳過這一步驟，如果編譯過程找不到這些元件，再讓它通知妳。

這樣安裝的話，OpenNMS預設會裝在檔案build.xml所 在目錄下的dist目 錄。用作測試很好（可能正是妳想要的），不過如果為了正式使用(production use)想要安裝在其他目錄，妳必須設定install.dir。 妳可能想要加一行類似這樣的內容在build.properties：

install.dir=/opt/OpenNMS

這部分很簡單。執行這個指令：

$ sh build.sh compile

細節請參閱「安裝OpenNMS」的章節。

底下的章節是一些建議，用於排除常見的安裝問題。如果妳的問題不在其 中，請參閱「到哪 裡找救兵」的章節。

 <!-- Commented out since we have a DHCP client on this server
 <service>

 <name>OpenNMS:Name=Dhcpd</name>
 <class-name>org.opennms.netmgt.dhcpd.jmx.Dhcpd</class-name>
 <invoke pass="1" method="start"/>
 <invoke at="status" pass="0" method="status"/>
 <invoke at="stop" pass="0" method="stop"/>

 </service>
 -->

<!-- Example Server Configuration File -->

<Server ...
...
 ...
 <Host ... >
 ....
 <Context path="/opennms" docBase="opennms" debug="0" reloadable="true">
 <Logger classname="org.opennms.web.log.Log4JLogger" homeDir="/opt/OpenNMS"/>
 <Realm className="org.opennms.web.authenticate.OpenNMSTomcatRealm" homeDir="/opt/OpenNMS"/>
 </Context >
 </Host >

 ...
</Server >

# psql -h localhost -U opennms opennms
Welcome to psql 7.4.6, the PostgreSQL interactive terminal.

Type: \copyright for distribution terms
 \h for help with SQL commands
 \? for help on internal slash commands
 \g or terminate with semicolon to execute query
 \q to quit

opennms=# ALTER TABLE node_old_11033991291234 RENAME TO node;

PostgreSQL伺服器無法存取檔案iplike.so。這有可能是檔案本身的權限問題，執行PostgreSQL的使用者無法存 取它，也可能是iplike.so上層目錄（們）的權限問題。

就算用root身份來執行安裝程式(installer)也可能遇到這個問題；因為無法存取iplike.so的不是OpenNMS也 不是安裝程式 (installer)，而是PostgreSQL資料庫。安裝程式(installer)要求 PostgreSQL資料庫載入iplike.so，而PostgreSQL資料庫伺服器通常不是以root的權限執行，因此跟其他一般使用者一樣，要遵 照檔案系統的存取控制。這問題通常發生在把OpenNMS安裝到root或其他使用者的家目錄，而這個家目錄的權限設定成不開放給其他使用者，只能讓使用 者本身存取。

這個錯誤顯示資料庫沒有正確地建立。由於安裝程式(installer)指令稿負責建立資料庫，妳可能會認為這是OpenNMS出了問 題，其實這是 Red Hat 4（以及CentOS 4）之中的SELinux 功能的問題。基本上來說，指令postgres init_db無法寫入/dev/null，而當它執行失敗的時候沒有顯示一個比較有意義的錯誤訊息。

要避免這個問題，請執行底下的指令：

注意，步驟二會刪除之前任何妳對postgresql設定檔的修改，妳必須重做那些修改。