[OpenNMS Note] 加我加我加我~ OpenNMS新增Service的方法

作者： -
這時候開頭不免要誇一下OpenNMS，因為它的模組化架構，讓我們可以輕易的抽取、更換或者新增某一個模組，當然最大的影響還是在於各模組間的Dependency，如果A模組必須依賴B模組，但你抽掉B模組，勢必A就往生了。這在OpenNMS算是滿重要的概念了。

先不介紹OpenNMS用到的那些技術，像spring、Jmx、Dao..等等，因為我敢說我做完整個架構移植，我也只是略懂Orz......。

↓這就是OpenNMS程式碼的目錄。


首先，第一步，我們先將Log4j的log4j.properties設定好。
↓檔案就在這個位置。
\\192.168.10.69\opennms_workspace\opennms-1.8.16-1\source\opennms-base-assembly\src\main\filtered\etc\log4j.properties

設定內容如下，設定的細節可以參考Log4j的教學網站。

  # BrianSys
  log4j.category.OpenNMS. BrianSys =DEBUG, BRIANSYS
  log4j.additivity.OpenNMS. BrianSys =false
  log4j.category.org.opennms.netmgt.briansys=DEBUG, BRIANSYS
  log4j.additivity.org.opennms.netmgt.briansys =false
  log4j.appender. BRIANSYS =org.apache.log4j.RollingFileAppender
  log4j.appender. BRIANSYS.MaxFileSize=100MB
  log4j.appender. BRIANSYS.MaxBackupIndex=4
  log4j.appender. BRIANSYS.File=/home/ianathome/opennms_workspace/opennms-1.8.16-1/source/target/opennms-1.8.16/logs/daemon/briansys.log
  log4j.appender. BRIANSYS.layout=org.apache.log4j.PatternLayout
  log4j.appender. BRIANSYS.layout.ConversionPattern=%d %-5p [%t] %c{1}: %m%n

其中  log4j.additivity.org.opennms.netmgt.briansys就是你的Service的位置，相對性也就是class的位置。


第二步，參考一下Opennms-daemon，他其實會到ConfigFileConstants.java中，將設定好的一堆Spring File抓出來，所以我們先在這邊把我們預設要撈的Spring File填入程式中。
↓檔案位置。
\\192.168.10.69\opennms_workspace\opennms-1.8.16-1\source\opennms-config-utils\src\main\java\org\opennms\netmgt\ConfigFileConstants.java

在class中增加下面這個。
   public static final int  BRIANSYS_CONFIG_FILE_NAME;
然後設定一個ID
   BRIANSYS_CONFIG_FILE_NAME = 81; //Brian
將ID指向的陣列指向一個檔名，也就是未來我們要新增configuration用的檔案。
   FILE_ID_TO_NAME[ BRIANSYS_CONFIG_FILE_NAME] = "briansys-configuration.xml";

這時候來把剛剛宣示的檔案建立起來，我不清楚你想用它來幹麻，總之先建起來當備用。
↓位置。
   \\192.168.10.69\opennms_workspace\opennms-1.8.16-1\source\opennms-base-assembly\src\main\filtered\etc\  briansys-configuration.xml
我建的大概先長這樣，以後要修改再增加就好，基本上這是放一些固定的參數了。
   <BrianSysConfiguration
ConnectLimit="5">
   </ BrianSysConfiguration>

重頭戲來了，要將Service的init()、stop()、start()這類流程控制函式放至Spring中，所在這個service-configuration.xml中要仔細設定好。
↓檔案位置。
\\192.168.10.69\opennms_workspace\opennms-1.8.16-1\source\opennms-base-assembly\src\main\filtered\etc\service-configuration.xml

↓設定內容如下，可以參考這裡面其他Service的設定。

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

接下來將剛剛設定的configuration的參數導入xsd中，讓castor可以將來生成標準化的程式。
↓檔案位置。
\\192.168.10.69\opennms_workspace\opennms-1.8.16-1\source\opennms-config\src\main\castor\briansys-configuration.xsd

內容大概像下面這樣。


<?xml version="1.0" encoding="UTF-8"?>
<schema targetNamespace="http://xmlns.opennms.org/xsd/config/briansys"
        xmlns="http://www.w3.org/2001/XMLSchema"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xmlns:this="http://xmlns.opennms.org/xsd/config/briansys"
        xmlns:ns2="http://www.w3.org/1999/xhtml"
        xmlns:ns="http://www.w3.org/2001/XMLSchema"
        xmlns:hfp="http://www.w3.org/2001/XMLSchema-hasFacetAndProperty">
  <annotation>
    <documentation>XML Schema for the briansys-configuration.xml configuration
    file. Version: $Id$. </documentation>
  </annotation>

  <element name="BrianSysConfiguration">
    <annotation>
      <documentation>Top-level element for the briansys-configuration.xml
      configuration file. </documentation>
    </annotation>

    <complexType>
      <attribute name="ConnectLimit" use="required">
        <annotation>
          <documentation>The maximum number of threads used for reading and
          processing of incoming events.</documentation>
        </annotation>
     
        <simpleType>
          <restriction base="int">
            <minInclusive value="1"/>
          </restriction>
        </simpleType>
      </attribute>
    </complexType>
  </element>
</schema>

再到castor的設定檔將你的service的xsd檔案加入。
↓檔案位置。
    \\192.168.10.69\opennms_workspace\opennms-1.8.16-1\source\opennms-config\src\main\castor\castorbuilder.properties
加入下面這筆設定。
   http://xmlns.opennms.org/xsd/config/briansys=org.opennms.netmgt.config.briansys,\

接下來再設定一個ConfigFileConstants，跟剛剛的那個不太一樣。
↓檔案位置。
\\192.168.10.69\opennms_workspace\opennms-1.8.16-1\source\opennms-util\src\main\java\org\opennms\core\utils\ConfigFileConstants.java
一樣增加下面這三行程式，加的方法可以參考檔案中其他程式的作法。
   public static final int BRIANSYS_CONFIG_FILE_NAME;
   BRIANSYS_CONFIG_FILE_NAME = 79; //Brian
   FILE_ID_TO_NAME[BRIANSYS_CONFIG_FILE_NAME] = "briansys-configuration.xml";//Brian

然後我們就要進入opennms-services中，增加我們需要的Service了！

↓請先找到這個檔案。
    \\192.168.10.69\opennms_workspace\opennms-1.8.16-1\source\opennms-services\.springBeans
然後將你的applicationContext加入其中。
   <config>src/main/resources/META-INF/opennms/applicationContext-briansys.xml</config>

接下來，去建立起你放置你Service的資料夾。
↓在這個資料夾下建立。[briansys] ->是我的servcie名字
    \\192.168.10.69\opennms_workspace\opennms-1.8.16-1\source\opennms-services\src\main\java\org\opennms\netmgt\[briansys]

基本上整個程式的架構會是這樣
    opennms-services\src\main\java\org\opennms\netmgt\[briansys]\BrianSys.java
    opennms-services\src\main\java\org\opennms\netmgt\[briansys]\jmx\BrianSys.java
    opennms-services\src\main\java\org\opennms\netmgt\[briansys]\jmx\BrianSysMBean.java

真正程式的進入點是在 jmx\BrianSys.java、jmx\BrianSysMBean.java，這是因為他去繼承了AbstractSpringContextJmxServiceDaemon跟BaseOnmsMBean，架構部分我就不在這邊講了。

↓然後再按照其他程式的ConfigManager跟ConfigFactory依樣畫葫蘆，就可以將當初我們設定好的固定參數載入進來。
    \\192.168.10.69\opennms_workspace\opennms-1.8.16-1\source\opennms-services\src\main\java\org\opennms\netmgt\config\BrianSysConfigManager.java
    \\192.168.10.69\opennms_workspace\opennms-1.8.16-1\source\opennms-services\src\main\java\org\opennms\netmgt\config\BrianSysConfigFactory.java

接下來就是將applicationContext跟applicationContext的注入跟設定完成。
↓先將下面要建立的applicationContext注入，檔案位置如下。
    \\192.168.10.69\opennms_workspace\opennms-1.8.16-1\source\opennms-services\src\main\resources\beanRefContext.xml
↓設定如下
     <bean id="briansysContext"     class="org.springframework.context.support.ClassPathXmlApplicationContext">
        <constructor-arg>
          <list>
            <value>META-INF/opennms/applicationContext-briansys.xml</value>
          </list>
        </constructor-arg>
        <constructor-arg ref="daemonContext" />
    </bean>

↓再到下面這個位置，建立applicationContext-briansys.xml。
     \\192.168.10.69\opennms_workspace\opennms-1.8.16-1\source\opennms-services\src\main\resources\META-INF\opennms\

建立方式可以參考其他的applicationContext，或者去認識一下Spring/Jmx。

以上，草率的介紹完畢。

留言

張貼留言

這個網誌中的熱門文章

[Security] wpa_supplicant setup

作者： -
20111115 - wpa_supplicant conf的範例 現在我還在測試中，後續慢慢補上。 20111121 - 後來證實，我之前使用的wpa-supplicant v0.5.10有問題，導致在Enterprise模式時，SSL認證一直不正常，一下子是password不見，一下子是group key有問題。所以我就把atheros-carrier搭配的wpa_supplicant v0.5.10換成v0.6.9，果然一測就ok了，只改了driver_wext.c，順便加了一個檔案是driver_atheros11n.c，用來搭配atheros-carrier driver的Ioctl。 wpa_supplicant的設定檔案說明。 位置大都是在/etc/下。 ctrl_interface=/var/run/wpa_supplicant     #//無更動 ctrl_interface_group=0                            #//無更動 ap_scan=1                                              #//如是在wireless Station狀態務必要使用。 network={ scan_ssid=1                                     #//務必要填為1 ssid="BrianTEST-62bg"                   #//AP的SSID key_mgmt=WPA-PSK                    #//加密方式 WPA-PSK, WPA-EAP.. pairwise=TKIP CCMP                    #//pairwise有下面幾種TKIP CCMP WEP104 WEP40 保守                                                                 一點的話都打也可以。等於是auto mode。 psk="0123456789"                          #//PSK的key或被稱作password    
閱讀完整內容

[Wordpress] 登出時出現 404 Error

作者： -
前幾個月開始自己架設購物車網站，但是安裝了 woocommerce的套件後，在帳號管理時，按下登出的連結，結果出現了404 Error，細追之下，才發現應該是php在轉換過程中，多打了個 \" ，導致登出的連結無法導向正確的位置。 雖說台灣的wordpress社群中，有熱心的大大在幫忙更新woocommerce的語言套件，但我實在不了解這塊的流程，有人維護，想必有人制定規範跟更新流程。 所以我暫時弄了一包臨時解決方案，順便自己也做個記錄。 1. 下載這個  https://dl.dropboxusercontent.com/u/22863940/woocommerce-zh_TW.mo      這是po檔編輯過後，而產生的.mo檔案。 2. 把它放在wp-content/languages/plugins/ 下，記得先備份你自己的woocommerce-zh_TW.mo，否則出問題時，就回不去了。 重申一次，我的狀況如下，橘色的“登出”連結按下後，會出現404 Error，至於錯誤頁面只會出現在子頁面中。如果你的狀況跟我不一樣，你可能要檢查一下了。 我的帳號 brianshihtest001   您好~ (不是 brianshihtest001?   登出 )。 從你的管理面板，您可以查詢近期的訂單、 收貨及帳單地址以及   修改帳戶資料及密碼 。 當然啦，你也可以選擇自己去產生.mo檔案，只要用poedit去開啟wp-content/languages/plugins/woocommerce-zh_TW.po後， 把 “Hello <strong>%1$s</strong> (not %1$s? <a href=\"%2$s\">Sign out</a>).” 的翻譯更正為 “<strong>%1$s</strong> 您好~ (不是 %1$s? <a href=\"%2$s\">登出</a>)。” 。 接著，把產生的.mo檔案丟到你的server上即可。
閱讀完整內容

[OpenNMS Note] OpenNMS SNMP的誕生

作者： -
圖片
這陣子實在是懶到翻掉，一點都不想上班，這幾張圖片還是被我老闆逼出來的。 我承認我真的很懶，懶得囉嗦，我就直接就說明一下。 看圖說故事 ↓這是OpenNMS的架構，基本上OpenNMS的發展一直都是依這樣的架構發展，增加的只是一些模組跟功能，可見這用Maven搭建的架構還算穩定。 我拿到手的版本是1.8.x版，這時候已經是改用Jetty當作Web Server。整個SNMP的功能主要是藏在Dependencies中「snmp*」的module中，opennms/dependencies下的東西大都是用來作Library用，所以很多都是只有pom.xml的檔案，再透過Maven的repository到指定的Server download。當然你也可以自己手動增加一個module，按照其他的pom.xml的架構去搭建就ok了。 接下來OpenNMS的真正核心是在core/snmp/*下面，他會呼叫到Dependencies中的snmp*.tar，所以大家就清楚當初弄Dependencies/snmp*的目的了。當然在core/snmp中只提供大部分的snmp api，而後再依照各個功能需求去初始化Daemon/Service，由此取得SNMP的服務/功能。 ↓剛剛提到的SNMP程式架構的大概。最下面的那幾個是我目前查到有用到SNMP api的幾隻模組。 ↓這其實是整個OpenNMS的Boot up 流程。很多東西都被我省略了，但是剛開始Study OpenNMS的人應該還是有點幫助。 最初的程式其實是「target/openms-1.8x/bin/opennms」這是隻可執行的pl。它平常就被藏在「opennms-base-assembly\src\main\filtered\bin」下。 從中可以看到它會去呼叫opennms-bootstrap.tar，程式就是這樣開始的。 緊接著bootstrap會用classloader的方式去喚起opennms-daemon中的程式，然後就是一連串的初始化，像Spring, JMX, Dao...之類的東西都是在這階段初始化，你也可以從每個module中看到有onInit()或Init的function，這個Function就是在各個資源初始完之後，切入每個Service/mod
閱讀完整內容