手把手搭建 Oracle SOA Suite 完整開發部署環境 (含圖解)

Oracle SOA Suite 是企業級整合中介軟體棧。本文記錄從零搭建「開發-測試-部署」一體化環境的完整實戰筆記，涵蓋資料庫、JDeveloper、SOA Suite 三大組件安裝、網路前置配置、記憶體規劃、常見坑點與驗證步驟。

架構總覽

核心組件部署於 **OC4J** (Oracle Containers for J2EE) 容器：

• BPEL Process Manager：業務流程編排引擎。
• ESB / Mediator：訊息路由、轉換、中介。
• Business Rules：決策服務外部化。
• Enterprise Manager (EM)：統一監控管理主控台。

特性：**Hot-pluggable (熱插拔)** —— 各組件獨立部署為 OC4J 應用，可單獨 Start/Stop/Deploy/Undeploy，互不影響。

硬體與軟體需求

Phase 0: 網路前置配置 (DHCP 環境必做)

SOA Suite 安裝程式檢測主機名/IP，DHCP 環境會導致安裝失敗或運行異常。需安裝 **Microsoft Loopback Adapter** 綁定固定 IP。

Windows 10/11 安裝 Loopback Adapter 步驟

1. 右鍵「開始」 → **裝置管理員** → **動作** → **新增舊版硬體**。
2. 選「手動從清單選擇」 → **網路介面卡** → **Microsoft** → **Microsoft KM-TEST Loopback Adapter** (或 Microsoft Loopback Adapter)。
3. 完成後，「網路連線」出現新介面 (如「乙太網路 2」)。
4. 設定 IPv4：
   IP: 192.168.100.10 (私有網段任意)
   子網遮罩: 255.255.255.0
   預設閘道: **留空**
   DNS: 留空或指向本地 DNS。
5. 編輯 C:\Windows\System32\drivers\etc\hosts：
   192.168.100.10 soahost.mydomain soahost
   (主機名/網域從「系統屬性 → 電腦名稱」取得)。
6. 重開機 生效。

Phase 1: 安裝 Oracle Database (建議 19c/21c EE)

1. 下載 Oracle Database 19c/21c Linux/Windows 版。
2. 解壓縮，執行 setup.exe / runInstaller。
3. 選「建立與設定資料庫」 → 桌面類 → 企業版。
4. 字元集選 AL32UTF8 (超集，支援多語言，避免亂碼)。
5. 啟用 EM Database Express (HTTPS 5500 埠)。
6. 記錄：Global Database Name (如 orcl.mydomain)、SID (orcl)、SYS/SYSTEM 密碼。
7. 建立 SOA 專用 Schema 使用者 (後續 RCU 會用到)：
   CREATE USER soainfra IDENTIFIED BY "SoaPass#2024" DEFAULT TABLESPACE soadata TEMPORARY TABLESPACE temp;
GRANT CONNECT, RESOURCE, UNLIMITED TABLESPACE TO soainfra;

Phase 2: 安裝 JDeveloper (含 SOA 擴充)

1. 下載 jdev_suite_122140.jar (Generic/Platform-specific)。
2. 執行：java -jar jdev_suite_122140.jar (需 JDK 8u201+)。
3. 安裝類型選 **Complete** (含 SOA、BPM、MFT 擴充)。
4. 設定 IDE 用戶目錄 (如 D:\JDevHome\mywork)，避免 C 槽空間不足。
5. 啟動 JDeveloper → **Help → Check for Updates** → 安裝最新 SOA/BPM 擴充包 (若非完整安裝)。
6. 配置資料庫連線：新增連線至 Phase 1 建立的資料庫，測試成功。

Phase 3: 安裝 SOA Suite (WebLogic + RCU + Domain 配置)

3.1 安裝 WebLogic Server (FMW 基礎)

# Linux 範例
java -jar fmw_12.2.1.4.0_wls_generic.jar
# 選擇安裝目錄 (Middleware Home) 如 /u01/oracle/middleware
# 僅安裝 WebLogic Server (不含 Coherence 可減省空間)

3.2 執行 RCU (Repository Creation Utility) 建立 SOA Schema

1. $MW_HOME/oracle_common/bin/rcu (Linux) 或 rcu.bat (Windows)。
2. 建立元件：選 **SOA Infrastructure**、**User Messaging Service**、**Metadata Services (MDS)**、**Audit Services**、**OPSS**、**Audit Appendix**。
3. 資料庫連線：Phase 1 的連線資訊，DBA 帳號 (SYS AS SYSDBA)。
4. Schema 密碼：統一或分別設定，記錄備查。
5. 表空間：接受預設或自訂 (建議獨立表空間 soadata, soaindex)。

3.3 建立 WebLogic Domain (Configuration Wizard)

1. $MW_HOME/oracle_common/common/bin/config.sh (或 config.cmd)。
2. 建立新域域：域名 soa_domain。
3. 範本選擇：
   ☑ Basic WebLogic Server Domain
   ☑ Oracle SOA Suite
   ☑ Oracle Enterprise Manager
   ☑ Oracle WSM Policy Manager
   ☑ Oracle JRF
4. 管理伺服器：Port 7001 (AdminServer)。
5. Managed Servers：
   soa_server1 (Port 8001) - SOA/BPEL/ESB
   bam_server1 (Port 9001) - BAM (可選)
   osb_server1 (Port 8011) - OSB (可選)
6. 叢集：生產環境建議配置 SOA Cluster (高可用)。
7. 機器/Node Manager：配置 Node Manager (Port 5556) 啟用機器級管理。
8. RCU Schema：填入 Phase 3.2 建立的 Schema Owner/Password。

Phase 4: 啟動驗證與開發環境整合

啟動順序

1. Node Manager：$DOMAIN_HOME/bin/startNodeManager.sh (背景執行)。
2. AdminServer：$DOMAIN_HOME/bin/startWebLogic.sh。
3. Managed Servers：AdminServer 啟動完成 (Health: RUNNING) 後，透過 EM Console 或命令啟動 soa_server1 等。

驗證入口

• WebLogic Admin Console：https://host:7001/console
• Enterprise Manager Fusion Middleware Control：https://host:7001/em
• SOA Composer / BPM Workspace：https://host:8001/soa/composer, https://host:8001/bpm/workspace

JDeveloper 整合部署

1. JDeveloper → **Application Server Navigator** → 新增連線 → **Standalone Server** → 填入 AdminServer Host/Port、WebLogic 認證。
2. 建立 SOA Application → 開發 Composite → 右鍵專案 → **Deploy** → 選擇建立的 Application Server 連線 → 部署至 soa_server1。

常見坑點與解決方案

記憶體規劃速查 (單機全套 8GB RAM 範例)

OS + 基礎服務          : 1.5 GB
Oracle Database SGA/PGA : 2.5 GB (SGA_TARGET=2G, PGA_AGGREGATE_TARGET=512M)
WebLogic AdminServer    : 1 GB  (Xms1024m Xmx1024m)
SOA Managed Server      : 2 GB  (Xms2048m Xmx2048m)
JDeveloper IDE          : 1 GB  (視專案大小)
------------------------------------------------
總計                    : 8 GB  (建議實體 16GB 留裕度)