Cách cài đặt XWiki trên Ubuntu 22.04

[theanh]

XWiki là phần mềm wiki miễn phí và mã nguồn mở được viết bằng Java và chạy trên Tomcat. Nó giúp người dùng cộng tác hiệu quả hơn. Nó cung cấp nhiều tính năng hữu ích như chỉnh sửa WYSIWYG, nhập/xuất tài liệu dựa trên OpenOffice, chú thích ngữ nghĩa và gắn thẻ, và quản lý quyền nâng cao. Nó sử dụng cơ sở dữ liệu như MySQL hoặc PostgreSQL để lưu trữ thông tin của nó.

Hướng dẫn này sẽ chỉ cho bạn cách cài đặt phần mềm XWiki trên máy chủ Ubuntu 22.04.

Điều kiện tiên quyết​

• Máy chủ chạy Ubuntu 22.04.
• Tên miền hợp lệ được trỏ đến IP máy chủ của bạn.
• Mật khẩu gốc được cấu hình trên máy chủ.

Bắt đầu​

Trước khi bắt đầu, hãy cập nhật và nâng cấp tất cả các gói hệ thống lên phiên bản mới nhất bằng lệnh sau:

apt update -y
apt upgrade -y

Sau khi tất cả các gói được cập nhật, bạn có thể cài đặt các các phụ thuộc bắt buộc bằng lệnh sau:

apt-get install wget curl unzip git name gnupg2 -y

Sau khi hoàn tất, bạn có thể tiến hành bước tiếp theo.

Cài đặt Java JDK​

XWiki là một ứng dụng dựa trên Java nên bạn sẽ cần cài đặt Java trên máy chủ của mình. Bạn có thể cài đặt bằng lệnh sau:

apt-get install default-jdk -y

Sau khi Java được cài đặt, bạn có thể xác minh phiên bản Java bằng lệnh sau:

java --version

Bạn sẽ nhận được thông báo sau đầu ra:

openjdk 11.0.17 2022-10-18
OpenJDK Runtime Environment (build 11.0.17+8-post-Ubuntu-1ubuntu222.04)
OpenJDK 64-Bit Server VM (build 11.0.17+8-post-Ubuntu-1ubuntu222.04, mixed mode, sharing)

Thêm kho lưu trữ XWiki​

Theo mặc định, gói XWiki không được bao gồm trong kho lưu trữ mặc định của Ubuntu. Vì vậy, bạn sẽ cần thêm kho lưu trữ chính thức của XWiki vào máy chủ của mình.

Đầu tiên, hãy tải xuống và thêm khóa GPG bằng lệnh sau:

wget https://maven.xwiki.org/xwiki-keyring.gpg -O /usr/share/keyrings/xwiki-keyring.gpg

Tiếp theo, hãy thêm kho lưu trữ XWiki vào APT bằng lệnh sau:

wget "https://maven.xwiki.org/stable/xwiki-stable.list" -O /etc/apt/sources.list.d/xwiki-stable.list

Sau khi kho lưu trữ được thêm vào APT, bạn có thể cập nhật bộ đệm kho lưu trữ bằng lệnh sau lệnh:

apt-get update -y

Tiếp theo, tìm kiếm gói XWiki bằng lệnh sau:

apt-cache search xwiki

Bạn sẽ thấy tất cả các gói XWiki trong đầu ra:

xwiki-solr-all - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-solr-core - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-solr-data - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-solr-events - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-solr-extension_index - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-solr-like - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-solr-ratings - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat7-common - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat7-mysql - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat7-pgsql - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat8-common - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat8-mariadb - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat8-mysql - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat8-pgsql - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat9-common - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat9-mariadb - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat9-mysql - XWiki is a free wiki software platform written in Java with a design emphasis
xwiki-tomcat9-pgsql - XWiki is a free wiki software platform written in Java with a design emphasis

Cài đặt XWiki trên Ubuntu 22.04​

Bây giờ, hãy chọn phiên bản mới nhất của XWiki và cài đặt bằng lệnh sau:

apt-get install xwiki-tomcat9-common xwiki-tomcat9-mariadb -y

Trong quá trình cài đặt, bạn sẽ được yêu cầu cấu hình cơ sở dữ liệu như hiển thị bên dưới:


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22220%22%3E%3C/svg%3E


Chọn Có và nhấn phím Enter. Bạn sẽ được yêu cầu đặt mật khẩu MySQL cho XWiki:


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22229%22%3E%3C/svg%3E


Xác định mật khẩu của bạn và nhấp vào OK để hoàn tất quá trình cài đặt.

Sau khi XWiki được cài đặt, bạn có thể xác minh dịch vụ Tomcat bằng cách sử dụng lệnh sau lệnh:

systemctl status tomcat9.service

Bạn sẽ nhận được kết quả sau:

? tomcat9.service - Apache Tomcat 9 Web Application Server Loaded: loaded (/lib/systemd/system/tomcat9.service; enabled; vendor preset: enabled) Drop-In: /etc/systemd/system/tomcat9.service.d ??xwiki-tomcat9-systemd.conf Active: active (running) since Mon 2022-11-28 16:49:48 UTC; 6s ago Docs: https://tomcat.apache.org/tomcat-9.0-doc/index.html Process: 27582 ExecStartPre=/usr/libexec/tomcat9/tomcat-update-policy.sh (code=exited, status=0/SUCCESS) Main PID: 27586 (java) Tasks: 20 (limit: 464122) Memory: 272.6M CGroup: /system.slice/tomcat9.service ??27586 /usr/lib/jvm/default-java/bin/java -Djava.util.logging.config.file=/var/lib/tomcat9/conf/logging.properties -Djava.util.>
Nov 28 16:49:49 ubuntu22041 tomcat9[27586]: Loaded Apache Tomcat Native library [1.2.31] using APR version [1.7.0].
Nov 28 16:49:49 ubuntu22041 tomcat9[27586]: APR capabilities: IPv6 [true], sendfile [true], accept filters [false], random [true], UDS [true].
Nov 28 16:49:49 ubuntu22041 tomcat9[27586]: APR/OpenSSL configuration: useAprConnector [false], useOpenSSL [true]
Nov 28 16:49:49 ubuntu22041 tomcat9[27586]: OpenSSL successfully initialized [OpenSSL 3.0.2 15 Mar 2022]
Nov 28 16:49:50 ubuntu22041 tomcat9[27586]: Initializing ProtocolHandler ["http-nio-8080"]
Nov 28 16:49:50 ubuntu22041 tomcat9[27586]: Server initialization in [1204] milliseconds
Nov 28 16:49:50 ubuntu22041 tomcat9[27586]: Starting service [Catalina]
Nov 28 16:49:50 ubuntu22041 tomcat9[27586]: Starting Servlet engine: [Apache Tomcat/9.0.58 (Ubuntu)]
Nov 28 16:49:50 ubuntu22041 tomcat9[27586]: Deploying deployment descriptor [/etc/tomcat9/Catalina/localhost/xwiki.xml]

Tomcat không chạy và lắng nghe trên cổng 8080. Bạn có thể xác minh bằng lệnh sau lệnh:

ss -antpl | grep 8080

Bạn sẽ thấy kết quả sau:

LISTEN 1 100 *:8080 *:* users:(("java",pid=27586,fd=39))

Cấu hình Nginx làm Proxy ngược​

Tiếp theo, bạn sẽ cần cấu hình Nginx làm proxy ngược để truy cập XWiki qua cổng 80. Đầu tiên, hãy cài đặt gói Nginx bằng lệnh sau:

apt-get install nginx -y

Sau khi cài đặt Nginx, hãy tạo tệp cấu hình Nginx:

nano /etc/nginx/conf.d/xwiki.conf

Thêm nội dung sau cấu hình:

server {
listen 80;
server_name xwiki.example.com;
access_log /var/log/nginx/xwiki-access.log;
error_log /var/log/nginx/xwiki-error.log;
location / {
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Host $host;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_cache_bypass $http_upgrade;
proxy_pass http://127.0.0.1:8080;
}
}

Lưu và đóng tệp sau đó khởi động lại dịch vụ Nginx để áp dụng các thay đổi:

systemctl restart nginx

Bạn cũng có thể xác minh trạng thái Nginx bằng cách sử dụng lệnh sau lệnh:

systemctl status nginx

Bạn sẽ nhận được kết quả sau:

? nginx.service - A high performance web server and a reverse proxy server Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled) Active: active (running) since Mon 2022-11-28 16:51:25 UTC; 5s ago Docs: man:nginx(8) Process: 27892 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS) Process: 27894 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS) Main PID: 27895 (nginx) Tasks: 3 (limit: 464122) Memory: 3.4M CGroup: /system.slice/nginx.service ??27895 "nginx: master process /usr/sbin/nginx -g daemon on; master_process on;" ??27896 "nginx: worker process" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" ??27897 "nginx: worker process" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" ""
Nov 28 16:51:25 ubuntu22041 systemd[1]: Starting A high performance web server and a reverse proxy server...
Nov 28 16:51:25 ubuntu22041 systemd[1]: Started A high performance web server and a reverse proxy server.

Lúc này, XWiki đã được cài đặt với Nginx như một proxy ngược. Bây giờ bạn có thể tiến hành bước tiếp theo.

Thực hiện cài đặt XWiki Web​

Bây giờ, hãy mở trình duyệt web của bạn và truy cập trình hướng dẫn cài đặt web XWiki bằng URL

http://xwiki.example.com/xwiki/bin/view/Main/.

Bạn sẽ thấy màn hình sau:


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22492%22%3E%3C/svg%3E


Nhấp vào nút Tiếp tục. Bạn sẽ thấy màn hình đăng ký:


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22458%22%3E%3C/svg%3E


Nhập tên, tên người dùng quản trị, mật khẩu, email và nhấp vào nút Đăng ký và đăng nhập. Bạn sẽ thấy màn hình sau:


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22312%22%3E%3C/svg%3E


Nhấp vào nút Tiếp tục. Bạn sẽ thấy màn hình lựa chọn Hương vị:


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22496%22%3E%3C/svg%3E


Chọn hương vị XWiki của bạn và nhấp vào nút Cài đặt hương vị này. Bạn sẽ thấy màn hình sau:


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22368%22%3E%3C/svg%3E


Nhấp vào nút Cài đặt. Bạn sẽ thấy màn hình sau:


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22497%22%3E%3C/svg%3E


Nhấp vào nút Tiếp tục. Bạn sẽ thấy màn hình sau:


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22492%22%3E%3C/svg%3E


Nhấp vào nút Tiếp tục. Bạn sẽ thấy bảng điều khiển XWiki trên màn hình sau:


data:image/svg+xml,%3Csvg%20xmlns=%22http://www.w3.org/2000/svg%22%20width=%22750%22%20height=%22352%22%3E%3C/svg%3E

Kết luận​

Xin chúc mừng! bạn đã cài đặt thành công XWiki với Nginx trên máy chủ Ubuntu 22.04. Bây giờ bạn có thể triển khai ứng dụng wiki của riêng mình bằng XWiki. Hãy thoải mái hỏi tôi nếu bạn có bất kỳ câu hỏi nào.