在設定檔已擴增至使用共用事件基礎架構的每一個 WebSphere 執行時期環境中,
必須部署事件伺服器企業應用程式。
執行這項作業的原因和時機
事件伺服器企業應用程式必須包裝在 event-application.ear
EAR 檔中。event-application.jacl Script 會將這個應用程式安裝在
WebSphere ESB 中。
這項作業的步驟
- 移至設定檔(其中定義應用程式部署所在的 WebSphere Application Server 執行時期環境)的
profile_path/event/application 目錄。 (請將 profile_path
換成內含 WebSphere Application Server 設定檔的目錄路徑。)
- 使用 wsadmin 指令執行 event-application.jacl Script:
- Windows 系統
profile_path\bin\wsadmin [-conntype none] -profile event-profile.jacl
-f event-application.jacl -action action -earfile event-application.ear
-backendid backend_id -node node_name -server server_name
[-cluster cluster_name] [-appname app_name] [-trace]
- Linux 和 UNIX 系統
profile_path/bin/wsadmin.sh [-conntype none] -profile event-profile.jacl
-f event-application.jacl -action action -earfile event-application.ear
-backendid backend_id -node node_name -server server_name
[-cluster cluster_name] [-appname app_name] [-trace]
參數如下:
- action
- 您要執行的動作。如果要安裝企業應用程式,請指定 install。
如果要更新已經安裝的現有事件伺服器應用程式,請指定 update。
在更新期間,Script 會在現行目錄中建立現有應用程式 EAR 檔的備份版本;必要的話,
您可以稍後再利用這個備份來還原舊版的應用程式。
- backend_id
- 企業應用程式所用的資料庫後端類型。它必須是下列一值:
- CLOUDSCAPE_V51_1
- DB2UDBNT_V82_1
- DB2UDBNT_V8_1
- ORACLE_V10_1
- ORACLE_V9_1
- DB2UDBOS390_V8_1
- DB2UDBOS390_V7_1
- node_name
- 事件伺服器部署所在的 WebSphere ESB 節點。若要知道節點名稱,請遵循下列步驟:
- 執行 profile_path/bin/setupCmdLine Script。
- 執行 echo $WAS_NODE(Linux/UNIX 系統)或 echo
%WAS_NODE%(Windows 系統)指令。
此值有區分大小寫。如果您要將企業應用程式部署在叢集中,
請省略此參數。
- server_name
- 事件伺服器企業應用程式部署所在的 WebSphere 伺服器。此值有區分大小寫。如果您要將企業應用程式部署在叢集中,
請省略此參數。
- cluster_name
- 事件伺服器企業應用程式部署所在的 WebSphere 叢集。只有在您要將應用程式部署在叢集中,
且您並未指定節點和伺服器時,才需指定此參數。
- app_name
- 共用事件基礎架構 企業應用程式所用的名稱。這是選用參數;預設值為 CommonEventInfrastructureServer。
-trace 選用參數會使更多的除錯資訊顯示在標準輸出中。
註: - 如果您在 event-application.ear 檔位置方面指定一個完整路徑,
請確定您在路徑中使用的是正斜線 (/)(即使您使用的是 Windows 系統)。
- 如果您將應用程式部署在獨立式節點上,
請指定 -conntype none 選用參數,以便在本端模式下執行 wsadmin。
如需 wsadmin 公用程式的相關資訊,
請參閱 WebSphere Application Server 文件。
結果
當
event-application.jacl Script 完成後,
「共用事件基礎架構」企業應用程式會部署到指定的伺服器或叢集上。在
WebSphere ESB Network Deployment 環境中,
如果已安裝應用程式,Script 只會新增指定節點和伺服器的部署資訊。