J2EE 環境配置完整指南：從 JDBC 驅動到安全設定

前言

本指南詳細說明 J2EE 環境的核心配置項目。所有配置檔案均位於 J2EE 安裝目錄下的 config 目錄中，皆為純文字格式，可使用任意文字編輯器修改。一般而言，預設配置已足夠應付大多數情況；僅當您使用非 Cloudscape 資料庫驅動時，才需依照本文進行調整。

JDBC 驅動程式部署

驅動檔案放置位置

將 JDBC 驅動的 .jar 檔案複製到 $J2EE_HOME/lib/system 目錄下，並確保該路徑已包含在 J2EE_CLASSPATH 環境變數中。

設定 J2EE_CLASSPATH 環境變數

J2EE Server 透過此變數定位驅動檔案。雖可在啟動前於命令列暫時設定，但建議寫入啟動腳本中：

• Unix/Linux：/bin/userconfig.sh
• Windows NT：bin/userconfig.bat

注意： 請同時從系統 CLASSPATH 中移除該驅動檔，避免衝突。

JDBC 1.0 驅動配置

編輯 config/default.properties，設定兩個關鍵屬性：

jdbc.drivers 屬性

指定一組以冒號分隔的驅動類別名稱：

jdbc.drivers=oracle.jdbc.driver.OracleDriver:testutil.MyDriver

jdbc.datasources 屬性

定義 JNDI 名稱與資料庫 URL 的對應關係，語法為：

jdbc.datasources=jdbc/Oracle|jdbc:oracle:thin@rtc:1521:acct|jdbc/MyDB|jdbc:test

每組以 | 分隔，前為 JNDI 名稱（以 jdbc/ 開頭），後為資料庫連線 URL。

支援 JTA 的 JDBC 2.0 驅動配置

需設定下列屬性（n 為索引，從 0 開始）：

• jdbc20.datasources
• xadatasource.n.jndiname
• xadatasource.n.classname
• xadatasource.n.dbuser / dbpassword
• xadatasource.n.prop.url 等驅動專屬屬性

範例：

jdbc20.datasources=jdbc/Merant|jdbc/XAMerant|jdbc/Finch|jdbc/XAFinch
xadatasource.0.jndiname=jdbc/XAMerant
xadatasource.0.classname=com.merant.sequelink.jdbcx.datasource.SequeLinkDataSource
xadatasource.0.prop.url=jdbc:sequelink://mypc:5000/[Oracle]

交易管理設定

分散式交易恢復

屬性 distributed.transaction.recovery 控制是否啟用分散式交易恢復（預設 false）。啟用條件包括：跨資料庫操作、使用 JDBC 2.0 JTA 驅動、符合兩階段提交協定、Server 重啟後仍能完成提交或回滾。

交易逾時

屬性 transaction.timeout 以秒為單位設定 Container-managed 交易的逾時時間（預設 0 代表無限制）。Bean-managed 交易請使用 UserTransaction.setTransactionTimeout()。

通訊埠配置

修改 config 目錄下對應檔案即可變更預設埠號：

日誌檔案管理

預設日誌目錄為 logs，可透過 log.directory 屬性變更。單一 VM 模式下，日誌檔案置於 $J2EE_HOME/logs/<host>/ejb，包含 system.out、system.err、event.log、output.log、error.log。Multi-VM 模式則分別存放於 EJB、HTTP、各部署應用程式的獨立目錄。

安全性設定

未授權使用者

預設帳號 guest/guest123，可在 auth.properties 中修改：

default.principal.name=guest
default.principal.password=guest123

Keystore 密碼

HTTPS 憑證儲存於 ~/.keystore，預設密碼 changeit，可在 web.properties 中透過 keystore.password 變更。

ANYONE 角色

預設所有方法指派給 ANYONE 角色，可在 auth.properties 中以 anyone.role.name 自訂。

鈍化門檻

當記憶體使用超過 passivation.threshold.memory（預設 128MB）時觸發 EJB 鈍化，值需為正整數。

其他常用設定

• JNDI Name Server Host： 若非同機器，修改 orb.properties 的 host 屬性（預設 localhost）。
• HTTP 文件根目錄： 預設 public_html/，可在 web.properties 中以 documentroot 變更。