Java 開源實戰（一）：Windows/Linux 環境下 JBoss + MySQL + Ant 完整部署指南

專案技術棧與版本

Windows 環境安裝步驟

1. 安裝 JDK 1.5
2. 解壓 JBoss 4.0.1 至目錄（如 D:\jboss-4.0.1sp1）
3. 安裝 MySQL 4.1，建立資料庫：

   mysql> create database ppp character set utf8;

4. 解壓 Ant 至目錄（如 D:\apache-ant-1.6.2）
5. 設定系統環境變數（我的電腦 → 內容 → 進階 → 環境變數 → 系統變數）：
   • 新增 ANT_HOME=D:\apache-ant-1.6.2
   • 新增 JAVA_HOME=JDK安裝路徑
   • 新增 CLASS_PATH=%JAVA_HOME%\lib
   • 修改 PATH 追加 %ANT_HOME%\bin;%JAVA_HOME%\bin;[MySQL安裝路徑]\bin
6. 將 mysql-connector-java-3.1.7-bin.jar 複製至 [JBoss目錄]\server\default\lib
7. 修改 jboss-service.xml 部署掃描路徑：

   <attribute name="URLs">
   deploy/,file:/e:/dep/web/,file:/e:/dep/ejb/
   </attribute>

   e:/dep/web、e:/dep/ejb 為自訂部署目錄。

8. 配置 MySQL 資料源：複製 [JBoss目錄]\docs\examples\jca\mysql-ds.xml 至 \server\default\deploy，修改內容：

   <jndi-name>MySQLDS</jndi-name>
   <connection-url>jdbc:mysql://localhost:3306/ppp</connection-url>
   <driver-class>com.mysql.jdbc.Driver</driver-class>
   <user-name>root</user-name>
   <password>你的密碼</password>
   <config-property name="useUnicode">true</config-property>
   <config-property name="characterEncoding">utf8</config-property>

9. 專案目錄下執行 ant 建置，輸出 yyweb.war、yyejb.jar 至 target 目錄
10. 將 war/jar 複製至對應部署目錄（E:\dep\web、E:\dep\ejb）
11. 啟動 MySQL（mysqld）與 JBoss（run.bat），驗證 https://localhost:8080/wap/faces/admin/co/listAll.do

Linux (Red Hat 9.0) 環境安裝步驟

1. 安裝 JDK：./jdk-1_5_0_01-linux-i586.bin，安裝至 /usr/java/jdk1.5.0_01
2. 安裝 MySQL：

   groupadd mysql
   useradd -g mysql mysql
   cd /usr/local
   tar -xzf /path/to/mysql-standard-4.1.10-pc-linux-gnu-i686.tar.gz
   ln -s mysql-standard-4.1.10-pc-linux-gnu-i686 mysql
   cd mysql
   scripts/mysql_install_db --user=mysql
   chown -R root .
   chown -R mysql data
   chgrp -R mysql .
   bin/mysqld_safe --user=mysql &
   mysqladmin -u root password '新密碼'
   mysql> create database ppp character set utf8;

3. 解壓 JBoss、Ant 至自訂目錄
4. 編輯 ~/.bash_profile 設定環境變數（注意路徑分隔符為 :）：

   JAVA_HOME=/usr/java/jdk1.5.0_01
   ANT_HOME=/home/wubing/ev/apache-ant-1.6.2
   MYSQL_HOME=/usr/local/mysql
   PATH=$PATH:$HOME/bin:$JAVA_HOME/bin:$ANT_HOME/bin:$MYSQL_HOME/bin
   CLASSPATH=$JAVA_HOME/lib/tools.jar:$JAVA_HOME/lib/dt.jar
   export JAVA_HOME ANT_HOME MYSQL_HOME PATH CLASSPATH

   執行 source ~/.bash_profile 生效，echo $PATH 驗證。

5. 後續步驟（JDBC 驅動部署、mysql-ds.xml 配置、Ant 建置、部署 war/jar、啟動服務）邏輯同 Windows，指令調整為 .sh 腳本（run.sh、shutdown.sh -S）。
6. 驗證：https://localhost:8080/listAll.do（Mozilla 瀏覽器）

常見錯誤排查

• MySQL 資料源設定錯誤（密碼、URL、驅動類別）
• JDBC 驅動未放入 server/default/lib
• 資料庫 ppp 未建立
• JBoss 啟動日誌檢查 MySQLDS 是否成功綁定 JNDI