安裝和配置「IBM WebSphere SNMP 功能」

您必須先在 IBM® WebSphere® Application Server 上安裝及配置「IBM WebSphere 簡易網路管理通訊協定 (SNMP) 功能」,以便收集效能度量。

開始之前

註: 如需「IBM WebSphere SNMP 功能」(也稱為「IBM WebSphere Snmp 代理程式」)的相關資訊,請閱讀「基於 SNMP 的 WebSphere Application Server 效能監視」主題。

安裝「IBM WebSphere SNMP 功能」之前,請先確認是否已隨獨立式小型用戶端安裝 WebSphere Application Server 8.5 版或更新版本。

關於這項作業

「IBM WebSphere SNMP 代理程式」檔案位於 <WAS_HOME>/optionalLibraries/IBM/SNMPAgent 目錄中:

「IBM WebSphere SNMP 代理程式」必須利用隨附的範本配置保存檔 (<WAS_HOME>/optionalLibraries/IBM/SNMPAgent/templateSnmpAgentServer.car),建立為通用伺服器。

如果要安裝「IBM WebSphere SNMP 代理程式」,請執行下列步驟:

程序

  1. 啟動部署管理程式伺服器。
  2. 利用 -lang jacl 來啟動 wsadmin,以連接至部署管理程式伺服器。
  3. 在節點範圍建立 WebSphere WAS_NODE_NAME 變數,以節點名稱作為值:
    $AdminTask setVariable {-scope Cell=<cell name>,Node=<node name> -variableName WAS_NODE_NAME -variableValue <node name> }
    其中 <nodename> 是要在其中建立「IBM WebSphere SNMP 代理程式」通用伺服器的節點名稱。
  4. 利用隨附的範本配置保存檔,將「IBM WebSphere SNMP 代理程式」建立為通用伺服器:
    $AdminTask importServer {-archive <washome>/optionalLibraries/IBM/SNMPAgent/config/templates
    /templateSnmpAgentServer.car -nodeName <node name> -serverName SnmpAgent }
    其中 <washome> 是 WebSphere Application Server 的完整安裝路徑,<nodename> 是要在其中建立「IBM WebSphere SNMP 代理程式」的節點名稱。
  5. 儲存配置。
    $AdminConfig save

下一步

您可以建立一或多個「IBM WebSphere SNMP 代理程式」來作為連接至不同應用程式伺服器和管理伺服器(例如,部署管理程式、NodeAgent 和 AdminAgent)的通用伺服器。

請修改下列三個 XML 檔來配置「IBM WebSphere SNMP 代理程式」:agentConfig.xmljmxConfig.xmltrapConfig.xml。 這些 XML 檔是在 WebSphere 配置儲存庫中,在 cells/<tcell name>;/nodes/<tnode name>/servers/<server name> 目錄之下。

在配置這三個 XML 檔之前,您必須先從所需伺服器上的管理主控台中,啟用「效能監視基礎架構 (PMI)」監視。

註: 在「網路部署」環境中,應該在部署管理程式的配置儲存庫中,配置「IBM WebSphere SNMP 功能」。
如果要配置「IBM WebSphere SNMP 代理程式」的這三個 XML 檔,請執行下列步驟:
  1. 開啟 agentConfig.xml 檔。 這個檔案會配置「IBM WebSphere SNMP 代理程式」執行所在的主機名稱、埠和社群。 編輯之前,請先備份檔案,以保留原始副本。
    <!--sample agentConfig.xml -->
    <agentConfig name="WsSNMPAgent" logFile="log/WsSNMP.log"
        registryPort = "1107" agents = "WsSNMP">
      <metadata
        mibsFolder = "mibs"
        mibs="nh-smi.smi,rfc1213-mib.mib,rmon-mib.mib,snmpv2-tc.mib,websphere-mib.mib”   />ok
    <WsSNMP ipAddress = "localhost" snmpPort = "161"
      views="V1"
      Behaviors="getScalars,getCollection" jmxConfigFile="jmxConfig.xml"  user="nick2" authMode="MD5" password="password">
      			
      <V1
      jmacfgFiles = "oid.out"
     trapConfig = "config/trapConfig.xml"/>
      			
      <getScalars
      oid = "1.3.6.1.4.1.1977.22.10.1.0"
      class = "com.ibm. ws.pmi.snmp.behaviors.GetScalarsBehavior"/>  			
    			
      <getCollection
      oid = "1.3.6.1.4.1.1977.22.10.10.1.2"
      class = "com.ibm. ws.pmi.snmp.behaviors.GetCollectionBehavior"/>	
    <…..>		
     </WsTSNMP>
      
    </agentConfig>
    註: 您應該只編輯 registryPort、ipAddress 和 authMode 屬性。 修改任何其他屬性都可能導致未定義的行為。
    .
    表 1. agentConfig.xml 檔中的屬性
    屬性名稱 說明
    registryPort 用來在 Java™ RMI 服務登錄中登錄引導代理程式的埠號。 這個屬性是在 <agentConfig> 標籤中。
    註: 請指定大於 1024 的埠號,以避免使用保留埠。
    ipAddress 「IBM WebSphere SNMP 代理程式」執行所在的主機位址。 在 SNMP 監視軟體中,應該設定相同的值,以便與「IBM WebSphere SNMP 代理程式」通訊。 這個屬性是在 <agent> 標籤中。
    註: 請指定標準的主機名稱/IP 位址,而不是預設值:localhost
    snmpPort 「WebSphere SNMP 代理程式」用來接聽 SNMP 封包的埠號。 在 SNMP 監視軟體中,應該設定相同的值,以便與「IBM WebSphere SNMP 代理程式」通訊。 這個屬性是在 <agentConfig> 標籤中。
    user 獲授權連接至「IBM WebSphere SNMP 代理程式」的使用者名稱。 在 SNMP 監視軟體中,應該設定相同的值,以便與「IBM WebSphere SNMP 代理程式」通訊。 這個屬性出現在 <agent> 標籤中。
    註: "user" 和 "password" 是用於即將連接 SNMP 代理程式之 SNMP 監視器的使用者/密碼認證。 這些認證不是用來登入管理主控台的 WebSphere Application Server 認證。
    authMode 用來與「IBM WebSphere SNMP 代理程式」通訊的鑑別模式。 在 SNMP 監視軟體中,應該設定相同的值,以便與「IBM WebSphere SNMP 代理程式」通訊。 這個屬性出現在 <agent> 標籤中。
    password ‘user’ 屬性中定義的授權使用者的密碼。 在 SNMP 監視軟體中,應該設定相同的值,以便與「IBM WebSphere SNMP 代理程式」通訊。 這個屬性出現在 <agent> 標籤中。
    註: 「IBM WebSphere SNMP 代理程式」的現行版本不支援 SNMP 第 3 版的隱私模式。
  2. 開啟 jmxConfig.xml 檔。編輯之前,請先備份檔案,以保留原始副本。

    這個配置檔包含必須從中收集 PMI 資料之 MBean 伺服器的相關資訊。 您必須設定在這個檔案中所指定的所有屬性。

    所有節點和屬性都是靜態的,在 <Mbean> 下的除外(換言之,它們只能在啟動「IBM WebSphere SNMP 代理程式」之前進行配置)。 不過,即使「IBM WebSphere SNMP 代理程式」在執行中,也可以修改 <Mbean> 下的節點和屬性。

    當啟用安全時,只能配置下表中的以下屬性:Security、User、Password、connectorSOAPconfig/connectorRMIconfig、sslRMIConfig、trustStore、tsPassword、keyStore 和 ksPassword。

    表 2. jmxConfig.xml 檔中的屬性
    屬性名稱 說明
    connectorType 您只能將下列值指定為連接器類型:
    • SOAP
    • RMI
    如果您使用連接器類型 SOAP,請指定 SOAPmbeanServer 屬性;如果使用連接器類型 RMI,請指定 RMIm-beanServer 屬性。
    註: 依預設,如果指定任何其他值,「IBM WebSphere SNMP 代理程式」會使用 SOAP。
    安全 指定是否啟用 WebSphere Application Server 安全。 您只能指定下列值:
    • 如果要啟用安全,請將值設為 yesy
    • 如果要停用安全,請將值設為 non
    註: 依預設,如果指定任何其他值,「IBM WebSphere SNMP 代理程式」會使用 no
    Address 指定 WebSphere Application Server 的 Hostname 或 IPAddress。
    對 SOAP 連線指定 SOAP_CONNECTOR 埠;對 RMI 連線指定 BOOTSTRAP。
    sampleInterval 指定「WebSphere SNMP 代理程式」應該擷取 PMI 資料的間隔(秒數)。 這個值應該至少是 60。
    使用者 如果您已啟用安全屬性,請設定登入管理主控台所需的使用者名稱。
    密碼 如果您已啟用安全屬性,請設定登入管理主控台所需的密碼。
    connectorSOAPconfig/connectorRMIconfig 如果已啟用安全,但未指定使用者名稱或密碼(或兩者),「WebSphere SNMP 代理程式」會在這個屬性所指向的檔案中尋找使用者名稱和密碼。
    註: soap.client.propssas.client.props 檔分別隨附於所安裝的 WebSphere Application Server,位在 </was_profile>/properties 目錄中。 請修改這個值來指向系統上的位置。
    sslRMIConfig 如果您選擇 RMI 連線,當啟用這個安全屬性時,會執行 SSL 信號交換。 您可以利用預設的 ssl.client.props 檔(在 </was_profile>/properties 目錄中),也可以根據這個檔案中包含的指示來修改檔案。
    註: 對於 connectorRMIConfig 和 sslRMIConfig,路徑名稱的開頭應該是 file。 例如:sslRMIConfig="file:/opt/IBM/Websphere/AppServer/profiles/Dmgr01/properties/ssl.client.props"
    trustStore 指定在「WebSphere SNMP 代理程式」執行所在的主機上,信任儲存庫檔案的位置。 您可以使用預設信任儲存庫或建立您自己的信任儲存庫。 如果您使用預設信任儲存庫,請確定這個值反映了您機器上對應的路徑。
    tsPassword 指定存取信任儲存庫所需的密碼。
    keyStore 指定在「WebSphere SNMP 代理程式」執行所在的主機上,金鑰儲存庫檔案的位置。 您可以使用預設信任儲存庫或建立您自己的信任儲存庫。 如果您使用預設信任儲存庫,請確定這個值反映了您機器上對應的路徑。

    當啟用安全時,信任儲存庫和金鑰儲存庫檔案會執行 SOAP 的 SSL 信號交換。

    ksPassword 指定存取金鑰儲存庫所需的密碼。
    Mbean 指定必須監視的 Mbean。這個節點可以有任意數目的集合子節點。 每個集合節點都有三個屬性:
    expression
    Java 支援的任何正規表示式,用來指定必須監視的 Mbean 型樣。
    counterMode
    可以是自動或手動
    counter
    如果 counterMode 是自動,會監視符合 Mbean 的所有計數器。 如果 counterMode 是手動,counter 屬性應該有一份要監視相符的 MBean 的逗點區隔計數器清單。
    註: 在管理主控台中,按一下伺服器 > 伺服器類型 > WebSphere Application Server,可以識別引導位址或 SOAP 連接器。 選取應用程式伺服器的名稱(例如 dmgr)。 顯示「應用程式伺服器」頁面之後,,請選取配置標籤(如果未選取的話)。 向下捲到通訊,然後展開
  3. 開啟 trapconfig.xml 檔。 編輯之前,請先備份檔案,以保留原始副本。
    這個檔案包含設陷接聽器的清單。 SNMP 設陷訊息可能有多個用來接聽的接聽器。 管理者可以在 trapConfig.xml 檔中新增多個設陷目的地,格式如下:
    <?xml version="1.0" encoding="UTF-8"?>
    <tns:TrapDestinations
    xmlns:tns="http://www.ibm.com/schema/WsT/SNMPSchema/TRAPConfig/"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.ibm.com/schema/WsT/SNMPSchema/TRAPConfig/TrapConfig.xsd ">
    
    <TrapDestination community="public" index="2" name="abcdom"
    protocol="2" status="3" version="1">
       <HostName>127.0.0.1</HostName>
       <Port>161</Port>
      </TrapDestination>
    </tns:TrapDestinations>
    其中:
    community
    這個項目所屬的社群名稱
    通訊協定
    要使用的通訊協定:
    • 1 – ip(預設值)
    • 2 – ipx
    版本
    產生設陷時要用的 SNMP 版本
    索引
    唯一的整數索引 ID。 如果多個設陷目的地有相同的索引值,就會予以忽略。
    狀態
    表格項目的狀態。 它包含下列值之一:
    • 1 - active
    • 2 - notInService
    • 3 - notReady
    • 4 - createAndGo
    • 5 – createAndWait
    • 6 – destroy
    <TrapDestinations>
    trapConfig.xml 的主要根元素
    <TrapDestination>
    定義設陷目的地接聽器
    <tHostName>
    接聽器的主機名稱或 IP 位址
    <tPort>
    接聽器執行所在的埠號
    <Status>
    用來啟用或停用特定通知
註: 您必須啟用「IBM WebSphere SNMP 代理程式」的安全,才能連接至已啟用安全的 WebSphere Application Server 環境。 請閱讀「啟用 IBM WebSphere SNMP 功能的安全」主題,以取得相關資訊。

指出主題類型的圖示 作業主題



時間戳記圖示 前次更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tprf_snmp_install
檔名:tprf_snmp_install.html