a. Cài đặt eXist
Tải gói cài đặt tại địa chỉ http://exist-db.org, phiên bản 1.4.2 (tên file eXist-setup-1.4.2-rev16251.jar)
Dành cho ngƣời mới bắt đầu, gói .jar (java archive) hỗ trợ giao diện đồ họa lúc cài đặt; tự động xác định đƣợc các thông số hệ thống (các biến môi trƣờng và biến đƣờng dẫn) cho eXist. Nó cũng tự động tạo ra các lối tắt trên màn hình sau khi cài đặt (cho hệ điều hành Windows hoặc Linux).
Sau khi tải về, để cài đặt thực hiện 1 trong 2 cách dƣới đây: 1. Kích đúp vào gói cài đặt:
eXist-setup-1.4.2-rev16251.jar (Windows và Mac)
2. Trong cửa sổ dòng lệnh của Windows hoặc cửa sổ shell của Unix, gõ câu lệnh java:
java -jar eXist-setup-1.4.2-rev16251.jar
Cài đặt eXist như một dịch vụ
Install eXist as Service: Sau khi cài đặt eXist thành công, có thể cài đặt eXist nhƣ một dịch vụ bằng cách chọn Install eXist as Service để eXist tự động chạy khi bật máy nhƣ một dịch vụ nền (background service). Sau đó, kích hoạt bằng công cụ “Service manager”.
b. Sử dụng eXist
Khởi động eXist Database
Sau khi cài đặt thành công, nếu không thay đổi gì trong quá trình cài đặt thì trên màn hình sẽ xuất hiện 3 lối tắt sau:
Hình 3.10: Các biểu tượng của eXist
Để khởi động CSDL eXist, kích đúp chuột vào biểu tƣợng eXist Database Startup, xuất hiện cửa sổ với các thông điệp:
Hình 3.11: Cửa sổ eXist Database Startup
Nếu muốn khởi động bằng dòng lệnh, thực hiện theo các bƣớc sau: 1. Mở cửa sổ dòng lệnh DOS hoặc cửa sổ Unix shell
2. Chuyển đến thƣ mục mà chúng ta đã cài eXist
3. Gõ lệnh: bin/startup.sh trong cửa sổ Unix shell, hoặc gõ câu lệnh bin\startup.bat trong cửa sổ DOS
Nếu các scripts không khởi động eXist, có thể tải trực tiếp bằng bootstrap loader sử dụng câu lệnh sau trong cửa sổ dòng lệnh:
java -Xmx128M -Djava.endorsed.dirs=lib/endorsed -jar start.jar jetty
Truy cập tới máy chủ CSDL eXist
Theo mặc định, eXist chạy bên trong một ứng dụng web, do máy chủ web tên là Jetty phục vụ. Để kiểm tra máy chủ có đang hoạt động không, gõ vào thanh địa chỉ của trình duyệt địa chỉ sau:
http://localhost:8080/exist/index.xml. Bản sao tại máy cục bộ của trang chủ eXist sẽ xuất hiện. Trang này đƣợc gộp cả trong gói cài đặt.
Hình 3.12: Trang web eXist
Từ trang này, có thể tham khảo các tài liệu hƣớng dẫn sử dụng, thƣ viện hàm, và các ví dụ XQuery của eXist. Từ trang này cũng có thể tham chiếu đến các bài báo và các tài liệu từ cơ bản đến nâng cao về các công nghệ đƣợc sử dụng hoặc có liên quan đến eXist.
Nếu khởi động CSDL không thành công, cần kiểm tra các biến môi trƣờng EXIST_HOME và JAVA_HOME. Hai biến này đƣợc thiết đặt trong các tệp startup.bat và startup.sh.
EXIST_HOME phải trỏ đến thƣ mục chứa tệp cấu hình conf.xml, vì máy chủ sử dụng đƣờng dẫn EXIST_HOME/conf.xml.
JAVA_HOME phải trỏ đến thƣ mục nơi cài đặt Java JDK (chứ không
phải JRE).
Cũng phải có quyền "write" đối với thƣ mục dữ liệu trong webapp/WEB-INF/.
Quản trị CSDL
Để sử dụng CSDL, đầu tiên ta phải tạo ra các sƣu tập tài liệu và import các tệp vào eXist. Ta có thể thực hiện việc này thông qua giao diện web hoặc sử dụng trình eXist Client Shell.
+ Quản trị CSDL qua giao diện web
Từ trang eXist, ta bấm vào liên kết Admin trong vùng Administration hoặc có thể gõ trực tiếp địa chỉ http://localhost:8080/exist/admin/admin.xql trong thanh địa chỉ của trình duyệt, sau đó đăng nhập vào với tài khoản “admin” và mật khẩu để trống (trong trƣờng hợp chƣa đổi mật khẩu của tài khoản admin từ sau khi cài đặt).
Hình 3.13: Màn hình quản trị CSDL dùng giao diện Web
Trong trang quản trị này ta có thể tạo ra các sƣu tập tài liệu hoặc có thể sử dụng các chức năng dành cho quản trị theo hƣớng dẫn.
- Chọn Examples Setup và nhấn nút "Import Example Data" để cài đặt các ví dụ tải về từ Internet.
- Thử các vấn tin trên sƣu tập mẫu trên trang "Examples Page". Ở đây có một số ứng dụng web dùng eXist và XQuery. Đơn giản nhất là "XQuery Sandbox" (http://localhost:8080/exist/sandbox/) cho phép gửi lên các vấn tin ví dụ.
Hình 3.14: Màn hình sưu tập mẫu XQuery Sandbox
+ Quản trị CSDL sử dụng công cụ eXist Client Shell
Khởi động
- Kích đúp chuột vào biểu tƣợng eXist Client Shell để khởi động hoặc nhập câu lệnh sau trực tiếp vào cửa sổ dòng lệnh shell của Unix hay DOS/Windows:
bin\client.bat (DOS/Windows) bin\client.sh (Unix)
hoặc dùng lệnh java:
java -jar start.jar client
- Sau khi khởi động công cụ eXist Client Shell ta phải đăng nhập vào bằng một tài khoản đƣợc gán quyền quản trị.
Hình 3.1 : Cửa sổ điền thông số kết nối đến CSDL
Ở cửa sổ này, nhập Username và Password còn các thông số khác để theo thông số mặc định. Sau khi cài đặt eXist với tên ngƣời dùng và mật khẩu cho lần đầu tiên đăng nhập ta sử dụng tài khoản quản trị có sẵn là “admin” và mật khẩu để trống.
Sau khi đăng nhập vào CSDL cửa sổ làm việc có dạng sau:
Để xem hƣớng dẫn sử dụng eXist đầy đủ ta có thể truy cập vào địa chỉ http://exist-db.org/quickstart.html.
Đóng CSDL eXist
Để tránh hỏng dữ liệu, nên đóng (shut down) CSDL trƣớc khi kết thúc phiên. Chọn một trong các cách sau đây:
1.Trong cửa sổ eXist Admin Client: Chọn thực đơn Connection >> Shutdown.
2. Giao diện Web: chọn liên kết Shutdown
http://localhost:8080/exist/admin/admin.xql
3. Chạy bin/shutdown.sh (Unix) hoặc shutdown.bat (DOS/Windows). 4. Dùng dòng lệnh:
java -jar start.jar shutdown
Chú ý: Dùng tham số dòng lệnh -u và -p để nhập tên ngƣời dùng và mật khẩu. Theo mặc định lệnh trên sẽ đóng CSDL đang chạy ở URI: xmldb:exist://localhost:8080/exist/xmlrpc/db. Nếu đƣờng dẫn thay đổi, cần thêm tham số dòng lệnh -l và URI thích hợp, ví dụ:
java -jar start.jar shutdown -u admin -p adminpass -l xmldb:exist://localhost:8080/exist/xmlrpc/db