在接下來的各節中,WBI_folder 是指包含您現行 WebSphere ICS
安裝主體的資料夾。 所有環境變數及檔案分隔字元,都是以 Windows NT/2000
的格式來指定。 若要在 AIX 或 Solaris
上執行,請做適當的變更。(例如,WBI_folder\connectors 要改成
WBI_folder/connectors)。
- 從捷徑來啟動 WebSphere InterChange Server (ICS)。
- 啟動 WebSphere Business Integration System
Manager,並開啟「元件導覽器視景」。
- 將您的伺服器登錄為 InterChange Server
檢視畫面中的「伺服器實例」,並連接該伺服器。
從「元件導覽器視景」:
- 建立新的「整合元件程式庫」。
- 匯入 repos 檔案,檔名為
WebServicesSample.jar,位於:WBI_folder\connectors\WebServices\samples\WebSphereICS\
使用 WebSphere Business Integration System Manager:
- 將從 WebServicesSample.jar repos
檔案匯入的「協同作業範本」全部編譯。
- 若您尚未這麼做,請依照本手冊中的說明,並根據您的系統來配置連接器。
- 使用 WebSphere Business Integration System
Manager,開啟「連接器配置程式」中的 WebServicesConnector。
- 您必須針對您要用於範例的通訊協定,來配置 WebServicesConnector。
本節說明如何配置針對 SOAP/HTTP 範例情況來配置連接器。
如本文件中的主文所述,連接器包含 SOAP/HTTP 通訊協定接聽器及 SOAP/HTTP-HTTPS
通訊協定處理常式。 範例情況將 SERVICE_ASYNCH_Order_Collab 及
SERVICE_SYNCH_OrderStatus_Collab 協同作業顯現成 SOAP/HTTP Web
服務。 若要將協同作業顯現成 SOAP/HTTP Web 服務,連接器會使用 SOAP/HTTP
通訊協定接聽器。 CLIENT_ASYNCH_Order_Collab 及
CLIENT_SYNCH_OrderStatus_Collab 協同作業是 SOAP/HTTP Web 服務的
SOAP/HTTP 用戶端,附有範例情況。 若要呼叫 SOAP/HTTP Web
服務,連接器會使用「SOAP/HTTP-HTTPS 通訊協定處理常式」。
在接下來的步驟和說明中,會以 』 符號來表示階層式連接器配置內容。
例如,A』 B 表示 A 是階層式內容,B 是 A 的子項內容。
若要為此範例來配置 SOAP/HTTP 通訊協定接聽器,請:
- 在「連接器配置程式」中,按一下 WebServicesConnector
的連接器特有內容。
- 展開 ProtocolListenerFramework 內容,以顯示 ProtocolListeners
子項內容。
- 展開 ProtocolListeners 子項內容,以顯示
SOAPHTTPListener1 子項內容。
- 檢查 SOAPHTTPListener1』Host 及
SOAPHTTPListener1』Port 內容的值。
請確定您的主機上沒有其他處理程序在進行,或是正在接聽此 TCP/IP 埠。 您可選擇將
SOAHTTPListener1』Host 的值設定成要用來執行連接器的機器名稱。
您不需要為此範例配置 SOAP/HTTP-HTTPS 通訊協定處理常式。
本節說明如何配置針對 SOAP/HTTPS 範例情況來配置連接器。 連接器包含
SOAP/HTTPS 通訊協定接聽器及 SOAP/HTTP-HTTPS 通訊協定處理常式。 範例情況將
SERVICE_ASYNCH_Order_Collab 及
SERVICE_SYNCH_OrderStatus_Collab 協同作業顯現成 SOAP/HTTPS Web
服務。 若要將協同作業顯現成 SOAP/HTTPS Web 服務,連接器會使用 SOAP/HTTPS
通訊協定接聽器。 CLIENT_ASYNCH_Order_Collab 及
CLIENT_SYNCH_OrderStatus_Collab 協同作業是 SOAP/HTTPS Web 服務的
SOAP/HTTPS 用戶端,附有範例情況。 若要呼叫 SOAP/HTTPS Web 服務,連接器會使用
SOAP/HTTPHTTPS 通訊協定處理常式。
在接下來的步驟和說明中,會以 』 符號來表示階層式連接器配置內容。
例如,A』 B 表示 A 是階層式內容,B 是 A 的子項內容。
- 註:
- 除了開始之前中所列的預先安裝項目之外,
您應該也已經使用您的「金鑰」和「憑證」管理軟體來建立並測試您的金鑰儲存庫及信任儲存庫。
若為 SOAP/HTTPS,則連接器需要您配置 SSL 連接器特有的階層式內容。
- 在「連接器配置程式」中,按一下 WebServicesConnector
的連接器特有內容標籤。
- 展開 SSL 階層式內容,以檢視其所有的子項內容。
另外,請檢查或變更階層式 SSL 連接器特有內容的下列子項內容。
- SSL』 KeyStore 設定為金鑰儲存庫檔的完整路徑
(您必須用您的「金鑰」和「憑證」管理軟體來建立金鑰儲存庫檔)。
- SSL』KeyStorePassword 設定為存取 KeyStore 所必需的密碼。
- SSL』KeyStoreAlias 設定為 KeyStore 中之私密金鑰的別名。
- SSL』TrustStore 設定為信任儲存庫檔的完整路徑
(您用「金鑰」和「憑證」管理軟體來建立的信任儲存庫檔)。
- SSL』TrustStorePassword 設定為存取 TrustStore 所必需的密碼。
- 註:
- 請不要忘記在「連接器配置程式」中儲存變更。
- 在「連接器配置程式」中,按一下 WebServicesConnector
的連接器特有內容。
- 展開 ProtocolListenerFramework 內容,以顯示
ProtocolListeners 子項內容。
- 展開 ProtocolListeners 子項內容,以顯示
SOAPHTTPSListener1 子項內容。 檢查
SOAPHTTPSListener1』Host 及
SOAPHTTPSListener1』Port 內容的值。
請確定您的主機上沒有其他處理程序在進行,或是正在接聽此 TCP/IP 埠。
您可以選擇將 SOAHTTPSListener1』Host
的值設定成用來執行連接器的機器名稱。
您不需要為此範例配置 SOAP/HTTP-HTTPS 通訊協定處理常式。
您可以快速地設定 KeyStore 及 TrustStore,以用於範例情況。
若是正式作業系統,則必須使用協力廠商的軟體來設定及管理金鑰儲存庫,及憑證和金鑰的產生作業。
「Web 服務配接器」並未提供任何工具來設定及管理這些資源。
本節假設「Java 虛擬機器」已安裝在您的系統上,且您已熟悉您的 JVM (Java
虛擬機器) 所附的 Keytool。 如需詳細資訊,或是有關於 Keytool
的疑難排解問題,請參閱您的 JVM 所附的文件。
設定 KeyStore:
- 使用 Keytool 來建立 KeyStore。您必須在 KeyStore 中建立一對金鑰組。
若要這麼做,請在指令行中輸入下列指令:
keytool -genkey -alias wsadapter -keystore c:\security\keystore
- Keytool 會立即提示您輸入密碼。 請指定您在 SSL』KeyStorePassword
連接器內容中輸入的密碼。
請注意,在上述範例中,若您在指令行中指定了 -keystore
c:\security\keystore, 就要輸入
c:\security\keystore,以作為 SSL』KeyStore 內容的值。
此外,若您在指令行中指定了 -alias wsadapter, 就要輸入
wsadapter,以作為 SSL』KeyStoreAlias 連接器內容的值。 然後
Keytool 會提示您輸入憑證的詳細資料。
下面說明您可以在各個提示中輸入的內容,但這只是範例,請務必參照並遵循 Keytool
文件的指示。
您的姓名為何?
[不明]: HostName
您組織單位的名稱為何?
[不明]: myunit
您組織的名稱為何?
[不明]: myorganization
您的城市或地區名稱為何?
[不明]: mycity
您的省名或市名為何?
[不明]: mystate
此單位的二字母國碼為何?
[不明]: mycountryIs <CN=HostName, OU=myunit, O=myorganization,
L=mycity, ST=mystate, C=mycountry> 正確嗎?
[no]: 是
- 請注意您的姓名為何?這個問題,您應輸入您執行連接器所在之機器的名稱。然後
Keytool 會提示您:
請輸入 <wsadapter> 的金鑰密碼 (如果和金鑰儲存庫密碼相同,則按 RETURN):
- 若要使用相同的密碼,請按 Return 鍵。
如果您要使用自行簽章的憑證,您也許會想要匯出上面所建立的憑證。
若要這麼做,請在指令行中輸入下列指令:
C:\security>keytool -export -alias wsadapter -keystore c:\security\keystore
-file c:\security\wsadapter.cer
- 現在 Keytool 會提示您輸入金鑰儲存庫密碼。請輸入您在上面輸入的密碼。
設定 TrustStore:
- 若要將受信任的憑證匯入 TrustStore,請輸入下列指令:
keytool -import -alias trusted1 -keystore c:\security\truststore
-file c:\security\wsadapter.cer
- 現在 Keytool 會提示您輸入金鑰儲存庫密碼。如果您輸入 -keystore
c:\security\truststore,請確定 SSL』TrustStore 內容的設定為
c:\security\truststore。 此外,也請將 SSL 』
TrustStorePassword 內容的值設定為您在上面輸入的密碼。
本節說明如何配置針對 SOAP/JMS 範例情況來配置連接器。 範例情況將
SERVICE_ASYNCH_Order_Collab 及
SERVICE_SYNCH_OrderStatus_Collab 協同作業顯現成 SOAP/JMS Web 服務。
若要將協同作業顯現成 SOAP/JMS Web 服務,連接器會使用 SOAP/JMS 通訊協定接聽器。
CLIENT_ASYNCH_Order_Collab 及
CLIENT_SYNCH_OrderStatus_Collab 協同作業是 SOAP/JMS Web 服務的
SOAP/JMS 用戶端,附有範例情況。 若要呼叫 SOAP/JMS Web 服務,連接器會使用
SOAP/JMS 通訊協定處理常式。
在接下來的步驟和說明中,會以 』 符號來表示階層式連接器配置內容。
例如,A』 B 表示 A 是階層式內容,B 是 A 的子項內容。
- 註:
- 除了開始之前中所列的預先安裝項目之外, 您應該也已經安裝 JMS
服務提供者,並已安裝及配置您的 JNDI。
若為 SOAP/JMS,則您必須配置 JNDI 連接器配置內容:
- 在「連接器配置程式」中,按一下 WebServicesConnector
的連接器特有內容。
- 展開 JNDI 階層式內容,以顯示其子項內容。
然後檢查或變更子項內容,以符合下面所列的值。
- JNDI』JNDIProviderURL 將這個內容設定為「JNDI 服務」提供者的
URL。 請參閱您的 JNDI 提供者文件。
- JNDI』InitialContextFactory 將這個內容設定為要用來建立 JNDI
起始環境定義之 Factory 類別的完整類別名稱。 請參閱您的 JNDI 提供者文件。
- JNDI』JNDIConnectionFactoryName 將這個內容設定為所要查閱之
Connection Factory 的 JNDI 名稱 (使用 JNDI 環境定義)。 請確定可使用 JNDI
來查閱此名稱。
- 請參閱您的 JNDI 文件,以查看您的 JNDI 提供者是否需要下列任何內容:
- JNDI』CTX_ObjectFactories
- JNDI』CTX_ObjectFactories
- JNDI』CTX_StateFactories
- JNDI』CTX_URLPackagePrefixes
- JNDI』CTX_DNS_URL
- JNDI』CTX_Authoritative
- JND』CTX_Batchsize
- JNDI』CTX_Referral
- JNDI』CTX_SecurityProtocol
- JND』CTX_SecurityAuthentication
- JNDI』CTX_SecurityPrincipal
- JNDI』CTX_SecurityCredentials
- JNDI』CTX_Language
- 在「連接器配置程式」中儲存變更。
此範例情況需要向您的 JMS 服務提供者定義 6 個佇列。 在執行之前,請先檢查您的
JMS 提供者文件;定義佇列的方式會因提供者而有所不同。
- 定義下列佇列 (或透過 JNDI 查閱功能來啟用):
- ORDER_INPUT
- ORDER_INPROGRESS
- ORDER_ERROR
- ORDER_ARCHIVE
- ORDER_UNSUBSCRIBED
- ORDER_REPLYTO
- 從 CSM 來開啟「連接器配置程式」中的 WebServicesConnector。
若您尚未這麼做,請依照您系統所適用之安裝手冊的說明來配置連接器。
- 按一下「連接器配置程式」中的應用程式配置內容。
- 展開 ProtocolListenerFramework 內容,以顯示 ProtocolListeners
子項內容。
- 展開 ProtocolListeners 內容,以顯示 SOAPJMSListener1 子項內容。
- 檢查或變更 SOAPJMSListner1 子項內容的值,以符合下列各項:
- SOAPJMSListener』Protocol 設定為 soap/jms
- SOAPJMSListener1』Protocol 設定為 soap/jms
- SOAPJMSListener1』InputQueue 設定為 ORDER_INPUT
- SOAPJMSListener1』InProgressQueue 設定為
ORDER_INPROGRESS
- SOAPJMSListener1』ArchiveQueue 設定為
ORDER_ARCHIVE
- SOAPJMSListener1』UnsubscribedQueue 設定為
ORDER_UNSUBSCRIBED
- SOAPJMSListener1』ErrorQueue 設定為 ORDER_ERROR
- SOAPJMSListener1』ReplyToQueue 設定為
ORDER_REPLYTO
- 在「連接器配置程式」中儲存變更。
- 從「系統管理程式」來開啟「連接器配置程式」中的
WebServicesConnector。
若您尚未這麼做,請依照您系統所適用之安裝手冊的說明來配置連接器。
- 按一下「連接器配置程式」中的連接器配置內容。
- 展開 ProtocolHandlerFramework 內容,以顯示 ProtocolHandlers
子項內容。
- 展開 ProtocolHandlers 子項內容,以顯示 SOAPJMSHandler
子項內容。 檢查或變更 SOAPJMSHandler 子項內容的值,以符合下列各項:
- SOAPJMSHandler』Protocol 設定為 soap/jms
- SOAPJMSHandler』ReplyToQueue 設定為 ORDER_REPLYTO
值
- 在「連接器配置程式」中儲存變更。
- 使用 WebSphere Business Integration System
Manager,建立新的使用者專案。 選取在載入範例內容中建立之「整合元件程式庫」中的所有元件。
- 在「伺服器實例」檢視畫面中,將在建立使用者專案中 建立的使用者專案新增至 WebSphere ICS。
- 將此「使用者專案」中的所有元件部署至 ICS。
- 重新啟動 ICS,以確定所有變更皆生效。
- 使用「系統監督」工具來確定所有協同作業物件、連接器控制程式和對映都在綠色狀態。
