安裝和配置「IBM WebSphere SNMP 功能」
您必須先在 IBM® WebSphere® Application Server 上安裝及配置「IBM WebSphere 簡易網路管理通訊協定 (SNMP) 功能」,以便收集效能度量。
開始之前
安裝「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 代理程式」,請執行下列步驟:
程序
下一步
您可以建立一或多個「IBM WebSphere SNMP 代理程式」來作為連接至不同應用程式伺服器和管理伺服器(例如,部署管理程式、NodeAgent 和 AdminAgent)的通用伺服器。
請修改下列三個 XML 檔來配置「IBM WebSphere SNMP 代理程式」:agentConfig.xml、jmxConfig.xml 和 trapConfig.xml。 這些 XML 檔是在 WebSphere 配置儲存庫中,在 cells/<tcell name>;/nodes/<tnode name>/servers/<server name> 目錄之下。
在配置這三個 XML 檔之前,您必須先從所需伺服器上的管理主控台中,啟用「效能監視基礎架構 (PMI)」監視。
- 開啟 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 版的隱私模式。 - 開啟 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
註: 依預設,如果指定任何其他值,「IBM WebSphere SNMP 代理程式」會使用 SOAP。安全 指定是否啟用 WebSphere Application Server 安全。 您只能指定下列值: - 如果要啟用安全,請將值設為 yes 或 y。
- 如果要停用安全,請將值設為 no 或 n。
註: 依預設,如果指定任何其他值,「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.props 和 sas.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)。 顯示「應用程式伺服器」頁面之後,,請選取配置標籤(如果未選取的話)。 向下捲到通訊,然後展開埠。 - 開啟 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>
- 用來啟用或停用特定通知