「連接器配置程式」工具提供一個圖形式使用者介面來配置連接器。 當您完成連接器配置內容值的指定作業之後,「連接器配置程式」會產生一個連接器 配置檔並將它放置於連接器的本端儲存庫中。
當您執行 IBM WebSphere Business Integration Adapter 安裝程式時, 它就會載入 ProductDir\connectors\repository\ConnName 中連接器的連接器定義檔案。 此連接器定義檔提供一些配置檔內容的起始值。下一步是使用「連接器配置程式」來 建立連接器配置檔。連接器定義檔提供一些配置檔起始值時, 配置檔包含連接器的標準和應用程式特有內容,並指定其支援的商業物件。 附錄 C, 連接器的標準配置內容詳細說明這些內容。
如果您手動安裝了新連接器 (不是由 IBM 預先建置), 就必須使用「連接器配置程式」為該連接器建立新配置檔。
要訣 |
---|
使用與您要配置的連接器之配接器使用手冊一起提供的下面資訊,它包含:
|
以下各節討論套用至每一個使用 WebSphere 訊息分配管理 系統的連接器之「連接器配置程式」設定。
您可以使用標準內容 RepositoryDirectory 來指定您要使用的本端儲存庫位置。 預設位置為 ProductDir\repository。
於配置 WebSphere MQ 佇列中,您定義了一組供連接器與訊息分配管理 系統通訊的佇列。於「連接器配置程式」中,按一下標準內容標籤, 並使用下列標準內容將這些佇列指定給連接器:
預設連線模式為連結模式。如下所示來指定用戶端模式:
例如:
jms.MessageBrokerName = WMQIB.Queue.Manager:CHANNEL1:RemoteMachine:1456
若您的連接器使用同步執行,請按一下「標準內容」標籤並設定下列內容:
記載用來傳遞系統訊息、元件狀態變更、失敗,以及追蹤資訊。產生下列檔案:
預設檔案名稱和路徑 | 說明 |
---|---|
暫時日誌檔: ProductDir\broker_name_connector_name_tmp.log。
|
於啟動期間,連接器會產生一個暫時日誌檔。
此檔案包含啟動期間記載的所有訊息,包括傳遞至連接器組織架構的連接器內容和商業物件定義。
且檔案寫入產品的安裝目錄中。
|
連接器日誌檔: UNIX:依預設,連接器將訊息記載到 STDOUT,然後將那些訊息 重新遞送至 ProductDir/logs/connector_manager_ConnName。log。
WINDOWS:依預設,連接器將訊息記載到 STDOUT,
但可經由配置來傳送到 ProductDir 目錄中的
本端目的地日誌檔。
|
連接器的日誌檔用來儲存連接器所發出的訊息。其亦包含有關 WebSphere MQ
通訊錯誤的訊息。
|
連接器訊息檔案:
ProductDir\connectors\messages\ConnName_LocaleName.txt
|
此檔案包含連接器所發出每一個訊息的完整內容。
您可以使用此檔案來查閱您在日誌檔中所看到的訊息 ID 內容。
若連接器配置檔中指定的語言環境不受支援,則會使用
ConnName.txt 檔。
|
追蹤檔案: 對於 UNIX 和 Windows 而言,預設值為 STDOUT。
|
包含所選取追蹤層次指定的追蹤訊息。
|
記載系統恆為作用中,並且提供連接器的精確監視。
若要進行問題疑難排解,您可以開啟追蹤。追蹤訊息可協助您監視 商業整合系統元件執行的動作。 追蹤層次定義寫入追蹤檔的詳細資料數目。追蹤層次越高,您接收的詳細資料就越多。 於下列情況中,追蹤與記載不同:
依預設,追蹤是關閉的,因為它會產生比您平常所需要更詳細的資訊。
如需使用 LogViewer 來檢視記載與追蹤的相關資訊,請參閱使用「日誌檢視器」來檢視連接器訊息。
若要配置連接器記載選項,請按一下追蹤/日誌檔標籤並指定下列項目:
如需管理日誌檔的詳細資訊,請參閱管理日誌檔和追蹤檔。
若要配置連接器追蹤選項,請:
如需連接器不同追蹤層次所產生資訊的詳細資料,請參閱您要配置之連接器的配接器使用手冊。
您可將連接器追蹤設定為下列其中一個層次:
追蹤層次 | 說明 |
---|---|
1 | 追蹤商業物件的起始設定以及傳送和接收。 |
2 | 列印層次 1 的訊息。另外,在相同類型的事件中,提供的資訊比層次 1 更加詳細。 |
3 | 列印層次 1 和 2 的訊息。另外,追蹤連接器代理程式與 傳訊驅動程式之間的訊息交換。 |
4 | 列印層次 1 到 3 的訊息。另外,追蹤連接器內部層次之間商業物件的傳遞。 |
5 | 列印層次 1 到 4 的訊息。另外,追蹤連接器內部層次之間管理訊息的傳遞。 |
新建或變更的追蹤層次會在您重新啟動連接器後生效。
如需保存追蹤檔的詳細資訊,請參閱管理日誌檔和追蹤檔。
啟動連接器和設定作業所需的程序皆視執行連接器的所在平台而定。
當您在 Windows 上安裝 WebSphere Business Integration Adapters 時, 會在 WebSphere Business Integration Adapters 程式功能表建立所安裝每一個連接器的 捷徑 (開始 > 程式集 > IBM WebSphere Business Integration Adapters > 配接器 > 連接器)。您必須使用附錄 D, 連接器啟動選項中列示的 啟動選項來自訂下列項目:
於 UNIX 環境中,您執行 connector_manager_connName Script 來啟動連接器, 此 Script 是一般連接器管理程式 Script (ProductDir/bin/connector_manager ) 的封套。 此封套包含下列資訊:
若您已建立自訂配接器或已使用 ESD 安裝配接器,則在第一次啟動連接器之前, 您必須執行下列動作:
或者,您可瀏覽至 ProductDir/bin 目錄, 並編輯 connector_manager_connName 檔案, 以指定連接器的配置檔名稱。於此檔案中,尋找 AGENTCONFIG_FILE 變數並將其設為 配置檔的完整路徑名稱,如下所示:
AGENTCONFIG_FILE=ConfigFile
一般連接器管理程式 Script 會呼叫適當的 start_connector.sh Script, 其為管理特定連接器的實際 Script。每個 WebSphere Business Integration 配接器都包括 start_connector.sh Script。您可以修改 start_connector.sh Script, 使其包含附錄 D, 連接器啟動選項中列示的所有受支援啟動選項。