Apache Derby Bài 04: Hướng dẫn cài đặt JDK, Apache Derby và cấu hình biến môi trường DERBY_HOME

1. Yêu cầu hệ thống & Chuẩn bị

Vì Apache Derby được viết 100% bằng Java, điều kiện tiên quyết duy nhất là máy tính phải có môi trường thực thi Java (Java Development Kit - JDK).

• JDK tương thích: Khuyến nghị cài đặt JDK 17 LTS hoặc JDK 21 LTS (hỗ trợ tốt các bản Derby 10.15, 10.16 và 10.17+).

• Phiên bản Apache Derby: Tải bản phân phối nhị phân chính thức (db-derby-X.Y.Z-bin.zip hoặc .tar.gz) từ trang chủ của Apache Software Foundation.

Kiểm tra Java trên máy bằng lệnh:

Bash

java -version
javac -version

Nếu hệ thống trả về thông tin phiên bản (ví dụ: openjdk version "17.0.x" hoặc 21.0.x), môi trường Java đã sẵn sàng.

2. Tải và giải nén Apache Derby

1. Truy cập trang tải xuống chính thức của Apache Derby: [https://db.apache.org/derby/derby_downloads.html](https://db.apache.org/derby/derby_downloads.html).

2. Chọn phiên bản ổn định (Stable Release) mới nhất thuộc nhánh phù hợp với phiên bản Java của bạn:

   • Bản bin chứa đầy đủ file thực thi, tài liệu và các file .jar.

   • Ví dụ file: db-derby-10.17.1.0-bin.zip (hoặc định dạng .tar.gz).

3. Giải nén vào thư mục cố định trên hệ thống:

   • Windows: C:\Java\db-derby-10.17.1.0-bin (đổi tên ngắn gọn thành C:\derby để dễ quản lý).

   • Linux / macOS: /opt/derby hoặc ~/tools/derby.

3. Cấu hình biến môi trường

Để các công cụ dòng lệnh của Derby (như ij, sysinfo, startNetworkServer) có thể gọi từ bất kỳ thư mục nào trong terminal, cần thiết lập hai biến môi trường chính: DERBY_HOME và cập nhật biến PATH.

Cách 1: Thiết lập trên hệ điều hành Windows

1.Mở hộp thoại Environment Variables:

Nhấn tổ hợp phím Win + R, nhập lệnh sysdm.cpl và nhấn Enter. Chuyển sang thẻ Advanced rồi nhấp vào nút Environment Variables....

2.Tạo biến DERBY_HOME:

Tại mục System variables (hoặc User variables), nhấn New...:

• Variable name: DERBY_HOME

• Variable value: C:\derby (đường dẫn thực tế đến thư mục giải nén)

3.Cập nhật biến PATH:

Tìm biến Path trong danh sách, chọn Edit... -> nhấn New và thêm dòng sau:

Plaintext

%DERBY_HOME%\bin

Nhấn OK để lưu lại toàn bộ thay đổi trên tất cả các cửa sổ.

Cách 2: Thiết lập trên Linux / macOS (Bash / Zsh)

Mở tệp cấu hình shell cá nhân (~/.bashrc cho Bash hoặc ~/.zshrc cho Zsh trên macOS):

Bash

nano ~/.bashrc  # hoặc nano ~/.zshrc

Thêm các dòng khai báo sau vào cuối tệp:

Bash

# Cấu hình Apache Derby
export DERBY_HOME=/opt/derby
export PATH=$PATH:$DERBY_HOME/bin
export CLASSPATH=$CLASSPATH:$DERBY_HOME/lib/derby.jar:$DERBY_HOME/lib/derbytools.jar:.

Lưu tệp và tải lại cấu hình vào phiên làm việc hiện tại:

Bash

source ~/.bashrc  # hoặc source ~/.zshrc

4. Kiểm tra cấu hình với tiện ích sysinfo

Sau khi thiết lập xong, mở một cửa sổ Terminal/Command Prompt mới (để nhận biến môi trường vừa tạo) và thực thi lệnh kiểm tra:

Bash

sysinfo

Tiện ích sysinfo tích hợp sẵn trong Derby sẽ phân tích toàn bộ môi trường và in ra báo cáo chi tiết gồm 3 nhóm thông tin quan trọng:

1. Java Information: Hệ điều hành, phiên bản JDK/JRE, đường dẫn java.home.

2. Derby Information: Số hiệu phiên bản engine Derby, build number.

3. Classpath Information: Danh sách các file JAR cần thiết đã được định vị chính xác hay chưa (derby.jar, derbytools.jar, derbynet.jar, derbyclient.jar).

Nếu màn hình hiển thị bảng thông tin dạng văn bản liệt kê đầy đủ các driver mà không báo lỗi command not found hay ClassNotFoundException, hệ thống đã được cài đặt thành công.

5. Tổng kết

• Quá trình thiết lập Apache Derby độc lập và nhẹ hơn các hệ quản trị khác vì không yêu cầu chạy file cài đặt dịch vụ nền (installer wizard).

• Cấu hình cốt lõi nằm ở việc trỏ biến DERBY_HOME đến thư mục giải nén và đưa thư mục %DERBY_HOME%\bin (hoặc $DERBY_HOME/bin) vào PATH.

• Tiện ích sysinfo là công cụ chuẩn để xác minh tính tương thích giữa JVM hiện tại và các thư viện JAR của Derby.

Ở bài tiếp theo, chúng ta sẽ phân tích cấu trúc bên trong thư mục cài đặt: Apache Derby Bài 05: Khám phá thư mục cài đặt Derby và các công cụ dòng lệnh đi kèm.