使用 Script 配置 EIF WebSphere JMS Provider

可以使用提供的配置 Script 來重新配置 EIF WebSphere JMS Provider。此 Script 位於 <was_profile_path>/eventext/bin/eifjms.jacl。請使用 wsadmin 工具來執行 eifjms.jacl Script。此 Script 可以執行下列各項作業:

  1. 為 EIF WebSphere JMS Provider 建立一組新配置。
  2. 移除 EIF WebSphere JMS Provider 的配置。
  3. 配置 EIF WebSphere JMS Provider,將事件轉遞給其他的 Enterprise Console 伺服器。
  4. 移除將事件轉遞給其他 Enterprise Console 伺服器的配置。

需要重新啟動 WebSphere Application Server,配置變更才會生效。

用法

呼叫 wsadmin,並在 -f 參數上提供此 Script 的名稱。此 Script 會採用下列參數:
-action
指定其中一個 [install/uninstall/addconnection/removeconnection]
指定 install 會為 EIF WebSphere JMS Provider 建立一組新配置。會安裝「JMS 提供者」,並建立事件群組。
指定 uninstall 會移除 EIF WebSphere JMS Provider 的配置。會解除安裝「JMS 提供者」,並移除事件群組。
指定 addconnection 會配置 EIF WebSphere JMS Provider,以將事件轉遞給其他的 Enterprise Console 伺服器。 會為所安裝的「JMS 提供者」建立 JMS Connection Factory,並建立相對應的事件群組。
指定 removeconnection 會移除將事件轉遞給其他 Enterprise Console 伺服器的配置。會移除 JMS Conection Factory 及相對應的事件群組。
此參數是必要的。
-scope
指定要安裝/解除安裝 JMS 提供者或新增/移除連線的範圍 (cell、node、server 或 cluster)。
此參數是必要的。
-node
指定要安裝/解除安裝「JMS 提供者」或新增/移除連線的節點名稱。
如果 scope 參數設為 node/server,則這是必要參數。
-server
指定要安裝/解除安裝「JMS 提供者」或新增/移除連線的伺服器名稱。
如果 scope 參數設為 server,則這是必要參數。
-cluster
指定要安裝/解除安裝「JMS 提供者」或新增/移除連線的叢集名稱。
如果 scope 參數設為 cluster,則這是必要參數。
-qname
指定要為「JMS 提供者」建立的「佇列」名稱。
如果 action 參數設為 install,則這是必要參數。
-qcfname
指定要為「JMS 提供者」建立的 Queue Connection Factory 名稱。如果 action 參數設為 install/addconnection/removeconnection,則這是必要參數。
-qjndi
指定要為「JMS 提供者」建立之「佇列」的 JNDI 名稱。
此參數是選用的。預設值是 jms/eif/<qname>。
-qcfjndi
指定要為「JMS 提供者」建立之 Queue Connection Factory 的 JNDI 名稱。
此參數是選用的。預設值是 jms/eif/<qcfname>。
-eventselector
指定要轉遞給 Tivoli Enterprise Console 伺服器之事件的選取元字串。這必須是有效的 XPath 表示式。
這是選用參數。預設值是所有事件。
-trace

指定此選項以顯示詳細的處理資訊。

此參數是選用的。依預設不會顯示詳細資訊。

Script 會額外採用「鍵=值」格式的內容清單, 而這些內容會設為安裝期間或新增連線時所建立之 Queue Connection Factory 的「自訂內容」。

容許的內容鍵是:

BarocLocation
指定 baroc 檔案的位置
此內容是選用的。預設值設為 ${USER_INSTALL_ROOT}/eventext/tec_classes
ServerLocation
指定要轉遞事件之 Enterprise Console 伺服器的主機名稱
此內容是選用的。預設值設為 localhost。
ServerPort
指定 Tivoli Enterprise 伺服器的接收埠
此內容是選用的。預設值設為 5529
BufferEvents
指定是否要將轉遞給 Enterprise Console 伺服器的事件置入緩衝區。有效值是 [YES/NO]
此內容是選用的。預設值是 NO
BufEvtPath
指定儲存了置入緩衝區之事件的檔案的位置及名稱
如果 BufferEvents 設為 YES,則這是必要內容。預設值是 /tmp/<qcfname>.cache。
LogLevel
指定要完成的記載層次。
此內容是選用的。預設值是 none。
TraceLevel
指定要完成的追蹤層次。
此內容是選用的。預設值是 none。
LogFileName
指定日誌檔的位置及名稱
如果已指定 LogLevel,則必須指定此內容
預設值是 /tmp/<qcfname>.log
TraceFileName
指定追蹤檔案的位置及名稱
如果已指定 TraceLevel,則需要指定此內容
預設值是 /tmp/<qcfname>.trace

範例

install 動作範例
建立一組新配置的範例。此指令是從 <was_profile_path>/eventext/bin 目錄中執行。
wsadmin
-f eifjms.jacl
-action install
-scope node
-node mynode
-qname TECQueue
-qcfname TECQCF
-trace
ServerLocation=myhost
BufferEvents=yes
BufEvtPath=/tmp/tecevt.buf
uninstall 動作範例
移除配置的範例。此指令是從 <was_profile_path>/eventext/bin 目錄中執行。
wsadmin
-f eifjms.jacl
-action uninstall
-scope node
-node mynode
-trace
addconnection 動作範例
新增連線的範例。此指令是從 <was_profile_path>/eventext/bin 目錄中執行。
wsadmin
-f eifjms.jacl
-action addconnection
-scope node
-node mynode
-qcfname TECQCF
-eventselector "CommonBaseEvent[@extensionName = 'CLASS' and @severity > 40]"
-trace
ServerLocation=myanotherhost
removeconnection 動作範例
移除連線的範例。此指令是從 <profile_home>/eventext/bin 目錄中執行
wsadmin
-f eifjms.jacl
-action removeconnection
-scope node
-node mynode
-qcfname TECQCF
-trace

參照
配置「JMS 提供者」
配置事件群組

相關主題
變更轉遞 Tivoli Enterprise Console 伺服器
選取要轉遞的事件
啟用事件緩衝
將事件轉遞給多個伺服器
修改配置範圍
修改 Enterprise Console 事件類別定義

母主題
管理 EIF WebSphere JMS Provider