使用 Script 配置 EIF WebSphere JMS Provider
可以使用提供的配置 Script 來重新配置 EIF WebSphere JMS Provider。此 Script 位於 <was_profile_path>/eventext/bin/eifjms.jacl。請使用 wsadmin 工具來執行 eifjms.jacl Script。此 Script 可以執行下列各項作業:
- 為 EIF WebSphere JMS Provider 建立一組新配置。
- 移除 EIF WebSphere JMS Provider 的配置。
- 配置 EIF WebSphere JMS Provider,將事件轉遞給其他的 Enterprise Console 伺服器。
- 移除將事件轉遞給其他 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