Hướng dẫn cài đặt Jboss Server

Tên dự án
Ngày 04/11/2007
Phiên bản 0.5
Trạng thái Tạo bản nháp
Bản quyền công ty iNet Solutions. Trang 1/7
Hướng dẫn cài đặt Jboss Server
Phiên bản 0.5 - Ngày 04/11/2007
Phiên bản
Ngày Phiên bản Giải thích Tác giả
04/11/2007 0.5 Tạo bản nháp Dũng Nguyễn
Bản quyền công ty iNet Solutions. Trang 2/7
Hướng dẫn cài đặt Jboss Server
Phiên bản 0.5 - Ngày 04/11/2007
1 TỔNG QUAN
Các ứng dụng hiện nay chủ yếu làm việc trên diện rộng và không giới hạn không gian làm việc của
mình, các ứng dụng Web hoặc các ứng dụng làm việc trên LAN, MAN, WAN lần lượt ra đời. Những ứng
dụng đó thường yêu cầu một máy chủ chứa trình điều khiển như: Web Server, Application Server,
Jboss là một trong những ứng dụng thuộc loại này.
Tuy nhiên, Jboss là một Web Server và Application Server, đồng thời nó cũng là một ứng dụng nguồn
mở hoàn thiện và rất được cộng đồng nguồn mở lưu tâm.
Tài liệu này hướng dẫn việc cài đặt và cấu hình Jboss nhằm giúp cho người dùng có thể điều khiển
được Jboss.
2 MỤC TIÊU
Tài liệu này được cung cấp nhằm giúp cho người sử dụng hoặc quản trị có thể cài đặt và cấu hình
Jboss. Đồng thời qua tài liệu này các bạn có thể làm quen thêm một số tiện ích khác được nhà phát
triển Jboss cung cấp.
3 GIỚI THIỆU JBOSS
Jboss là một Web Server và Application Server. Do là Web Server nên Jboss có thể hỗ trợ triển khai
những web site viết bằng Java. Ngoài ra Jboss cũng là một Application Server có thể triển khai EJB,
JMX, JMS,
Đến thời điểm hiện nay Jboss đã cho ra đời bản Jboss 4.2.2 rất ổn định và hoạt động hiệu quả. Jboss

4.2.2 hỗ trợ những ứng dụng viết bằng Java 1.5 trở lên và đồng thời hỗ trợ triển khai các ứng dụng
EJB3 suôn sẻ, gọn nhẹ.
EJB3 của nhà cung cấp Jboss tuân theo JSR 220 và dựa trên Framework Hibernate nên cũng kế thừa
những đặt điểm nổi bật của Hibernate. Đồng thời EJB3 trong Jboss lại cải thiện và bổ sung những tính
năng vào Framework này làm cho nó ngày càng hoàn thiện hơn.
Một trong những đặc điểm không kém phần quan trọng là Jboss là một hệ nguồn mở, do đó bạn có thể
dễ dàng thay đổi và cải tiến Jboss nhằm mang lại hiệu quả cao khi sử dụng mà chi phí là 0.
Bản quyền công ty iNet Solutions. Trang 3/7
Hướng dẫn cài đặt Jboss Server
Phiên bản 0.5 - Ngày 04/11/2007
4 HƯỚNG DẪN CÀI ĐẶT JBOSS
Trong phần này tôi trình bày cho các bạn về những bước cài đặt và cấu hình Jboss. Việc cài đặt và cấu
hình Jboss trên Windows cũng như Linux có thể xem gần như tương đương với nhau. Do Jboss được
phát triển bằng Java nên bạn phải cài đặt Java trước khi cài Jboss [Tham khảo thêm tài liệu cài đặt
Java].
4.1 Cài đặt Jboss
✔ Bước 1 : Tải phiên bản Jboss 4.2.1 từ web site
✔ Bước 2 : Giải nén phiên bản mới tải về vào thư mục bạn chọn. Thường thì khi giải nén Jboss tạo
ra một kho chứa và chép thông tin vào trong đó. Đường dẫn từ thư mục gốc đến kho chứa này
là thư mục nhà của Jboss.
✔ Bước 3 : Thêm vào biến môi trường biến JBOSS_HOME trỏ đến thư mục nhà vừa được xác
định ở bước 2. [Tham khảo thêm tài liệu cài đặt Java để biết thêm cách tạo biến môi trường].
✔ Bước 4 : Mở một terminal trên Linux hay một cửa sổ lênh trên Windows và vào thư mục nhà của
Jboss (dùng lệnh change dir (cd)). Xem thông tin thư mục thì chúng ta có các thông tin chính
sau:
 Thư mục bin : Đây là thư mục chứa các chương trình dùng để khởi động và tắt Jboss
server.
 Thư mục client : Chứa các tiện ích và thư viện cần thiết cho việc phát triển các chương trình
khai thác tài nguyên từ Jboss
 Thư mục docs : Chứa các thông tin mẫu cho việc cấu hình Jboss.

 Thư mục lib : Chứa các thư viện cần thiết cho việc khởi động Jboss.
 Thư mục server : Chứa các thông tin cấu hình cho loại server khi chạy. Có ba loại server cơ
bản là: minimal, default và all.
Để có thể chạy chương trình Jboss, bạn vào thư mục bin và chạy chương trình run.sh (nếu
đang cài trên Linux) hoặc run.bat (nếu đang cài trên Windows). Để có thể tắt chương trình bạn
chạy shutdown.sh (trên môi trường Linux) hoặc là shutdown.bat (trên môi trường Windows)
Các thông số cần thiết khi chạy và tắt chương trình:
Bản quyền công ty iNet Solutions. Trang 4/7
Hướng dẫn cài đặt Jboss Server
Phiên bản 0.5 - Ngày 04/11/2007
 Chạy chương trình :
✗ Thông số -b : Mặc định khi chạy chương trình Jboss server sẽ ràng buộc với địa chỉ
localhost (127.0.0.1), nên ở bên ngoài không thể thấy được thể hiện của Server Jboss.
Để có thể thấy được thể hiện của Server bạn phải lệnh cho Jboss ràng buộc với địa chỉ
thực của máy trong mạng thông qua đối số này.
✗ Thông số -c : Mặc định khi chạy Jboss, Jboss sẽ dùng mặc định loại server default trong
mục server. Muốn thay đổi loại server khi chạy bạn dùng thông số -c.
Ví dụ: $./run.sh
1
-b jboss-server -c all  Ràng buộc vào địa chỉ của jboss-server
2
và
chạy loại all.
 Tắt chương trình .
✗ Thông số -s : Đây là thông số chỉ server Jboss đang chạy mà bạn muốn tắt nó.
✗ Thông số -S : Đây là thông số buộc tắt server jboss. Nếu không có thông số này thì trình
tắt sẽ không tắt Jboss. Trong trường hợp này có thể hiểu thông số -S có nghĩa là
shutdown.
Ví dụ: Muốn tắt jboss server có tên gọi jboss-server và đang chạy jboss. Ta dùng lệnh
sau: $./shutdown.sh -S -s jboss-server

4.2 Cấu hình Jboss
✔ Cấu hình các thông số cổng :
 Thông thường khi chạy Jboss sẽ chọn các cổng được cấu hình trong các tệp cấu hình của
Jboss, thường thì tệp này được đặt với tên gọi jboss-service.xml.
 Để cấu hình thông tin các cổng mặc định này chúng ta lần lượt thay đổi các giá trị cổng
trong tệp jboss-service.xml đặt trong thư mụ conf và chứa trong thư mục loại server. Ví dụ
như ta đang chạy loại server là default và muốn thay đổi thông tin về cổng chúng ta vào thư
mục server/default/conf và thay đổi giá trị cổng trong tệp jboss-service.xml
✔ Cấu hình thông số liên quan đến database :
 Thông thường Jboss sẽ cung cấp cho bạn một loạt các tệp cấu hình mẫu về thông tin
1 Trong trường hợp này là đang chạy jboss server trên hệ điều hành Linux. Nếu dùng HĐH Windows thì chỉ cần thay run.sh bằng run.bat
2 jboss-server là tên của server bạn đang cài đặt Jboss và đang gắn cho một địa chỉ thự ở trong mạng.
Bản quyền công ty iNet Solutions. Trang 5/7
Hướng dẫn cài đặt Jboss Server
Phiên bản 0.5 - Ngày 04/11/2007
database được đặt trong thư mục docs/examples/jca. Bạn vào đây lấy tệp cấu hình tương
ứng với database mình đang dùng (ví dụ: mysql-ds.xml là cấu hình database MySQL,
mssql-ds.xml là cấu hình cho database SQL Server, ), và thay đổi thông tin sau đó chép
vào thư mục deploy trong loại server mà bạn chọn (ví dụ: server/default/deploy).
 Các giá trị trong tệp -ds.xml thường là thông số liên quan đến việc kết nối database. Bạn
phải điền đủ thông tin yêu cầu.
 Ngoài những database theo truyền thống, có loại database hỗ trợ cách thức “Two Phase
Committed”. Với những loại database này bạn sử dụng những tệp có từ xa, ví dụ như db2-
xa-ds.xml. Tuy nhiên, với loại cấu hình này (sử dụng xa) bạn phải thay đổi lại tệp cấu hình
nằm trong thư mục deploy/jms và bạn phải có kiến thức về cấu hình các loại database này.
Phạm vi của phương pháp cấu hình này vượt ra ngoài phạm vi của tài liệu này, nếu bạn
thực sự cần thiết đến cấu hình loại này xin liên lạc với chúng tôi.
 Một trong những chú ý là khi bạn cấu hình database thì bạn phải chép thêm những thư viện
hỗ trợ cho việc kết nối đến loại database bạn muốn cấu hình. Những thư viện này thường
được cung cấp bởi nhà phát triển ra loại database đó. Sau khi có thư viện bạn chỉ cần chép

nó và mục lib nằm trong thư mục loại server mà bạn chọn. Ví dụ, bạn chọn chạy loại server
default, bạn chép vào thư mục server/default/lib.
✔ Cấu hình thông số liên quan đến EJB .
 Các thông số liên quan đến cấu hình EJB thường nằm trong tệp persistence.properties đặt
trong thư mục ejb3.deployer/META-INF. Thư mục này chứa trong thư mục deploy của loại
server mà bạn chọn để chạy. Ví dụ, khi bạn chọn loại server default thì bạn vào trong thư
mục server/default/deploy/ejb3.deployer/META-INF để có thể thay đổi một số thông số
liên quan đến EJB nếu cần thiết.
 Đối với ứng dụng iDesk bạn cần thay đổi thông số hibernate.bytecode.provider để cho nó
mang giá trị cglib thay vì giá trị mặc định javaassist.

hibernate.bytecode.provider=cglib

Bản quyền công ty iNet Solutions. Trang 6/7
Hướng dẫn cài đặt Jboss Server
Phiên bản 0.5 - Ngày 04/11/2007
5 TỔNG KẾT
Qua tài liệu này mong rằng có thể giúp các bạn cài đặt và cấu hình được Jboss server trên môi trường
Linux hoặc Windows. Nếu có thông tin gì thắc mắc cần trao đổi mong các bạn liên hệ với chúng tôi qua
địa chỉ.
Công ty Cổ Phần Tin Học Giải Pháp Tích Hợp Mở
115/100 Lê Văn Sỹ, Phường 13, Quận Phú Nhuận, HCMC.
Điện thoại: +848 991 9150
Fax: +848 991 9152
Email:
Web site:
Bản quyền công ty iNet Solutions. Trang 7/7
Hướng dẫn cài đặt Jboss Server
Phiên bản 0.5 - Ngày 04/11/2007