VietNetwork.Vn

XWiki là một phần mềm wiki cho phép mọi người tạo, sắp xếp và chia sẻ thông tin từ bất kỳ thiết bị nào có truy cập internet bằng trình duyệt web, máy tính để bàn hoặc điện thoại di động của họ.

Đó là một dịch vụ lưu trữ wiki cộng đồng chính thức với các quyền, vai trò và nhóm của người dùng. Nó có cả wiki công khai và riêng tư. Một cơ sở dữ liệu như MySQL được sử dụng để lưu trữ thông tin. Các thùng chứa Servlet (ví dụ: Tomcat, Jetty) được sử dụng để chạy nó; nó hỗ trợ XHTML, WYSIWYM, XSL-FO, MathML, SVG và RSS.

XWiki là thế hệ tiếp theo của Wiki, wiki duy nhất trên thị trường cung cấp nhiều tính năng như vậy trong một gói duy nhất.

XWiki cung cấp một chế độ Nâng cao có thể được kích hoạt trên bất kỳ wiki nào, cho phép kiểm soát chi tiết hơn đối với việc hiển thị nội dung bằng cách sử dụng các quy tắc chuyển đổi dựa trên XSLT. Nó đi kèm với một tập hợp các biểu định kiểu mặc định được định cấu hình sẵn để hoạt động ngay lập tức. Tuy nhiên, hành vi này có thể dễ dàng được tùy chỉnh thông qua việc sử dụng các tệp XSLT tùy chỉnh cho phép hoàn toàn tự do thiết kế giao diện wiki của bạn mà không cần phải viết bất kỳ mã nào.

Trong hướng dẫn này, bạn sẽ tìm hiểu cách cài đặt XWiki trên Ubuntu 20.04 và thiết lập và chạy người dùng, quyền cũng như các chức năng thiết yếu của bạn. Mặc dù hướng dẫn này sẽ dựa trên Ubuntu 20.04, hướng dẫn này có thể được áp dụng cho bất kỳ bản phân phối dựa trên Debian nào.

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

• Máy chủ chạy Ubuntu 20.04 với RAM tối thiểu 1024 MB và ổ cứng tối thiểu 20 GB.
• Một tên miền để truy cập wiki từ internet (tùy chọn).
• Kiến thức cơ bản về Linux và máy chủ web nói chung.
• Quyền truy cập root vào máy chủ hoặc đặc quyền người dùng sudo để cài đặt ứng dụng và quản lý tệp & thư mục trên máy chủ của bạn.

2. Cập nhật hệ thống

Để đảm bảo rằng các yêu cầu hệ thống được đáp ứng, trước tiên bạn sẽ phải cập nhật nó. Cập nhật danh sách gói phân phối của bạn bằng cách chạy:

sudo apt-get update
Bạn sẽ nhận được đầu ra sau:


Sau khi cập nhật danh sách các gói có sẵn, hãy chạy lệnh bên dưới để cài đặt tất cả các bản cập nhật trên Ubuntu 20.04:

sudo apt-get upgrade -y
Hoặc

sudo apt-get dist-upgrade -y
Bạn sẽ nhận được đầu ra sau:


Bạn nên khởi động lại máy chủ của mình để áp dụng bất kỳ bản nâng cấp kernel nào để chúng có hiệu lực đúng cách và tránh các sự cố sau này khi sử dụng một số mô-đun nhất định của XWiki, chẳng hạn như các dịch vụ chuyển đổi tài liệu phụ thuộc nhiều vào phiên bản Linux Kernel đang hoạt động.

sudo reboot now
Sau đó, đăng nhập lại bằng cùng một người dùng sudo và chuyển sang bước tiếp theo.

3. Cài đặt Java

XWiki được viết bằng Java, vì vậy bạn sẽ phải cài đặt Java trên Ubuntu 20.04 trước khi tiếp tục.

Để cài đặt Java trên Ubuntu 20.04, hãy chạy lệnh bên dưới:

sudo apt install default-jdk -y
Bạn sẽ nhận được đầu ra sau:


Bạn có thể kiểm tra phiên bản Java bằng lệnh sau sau khi đã cài đặt:

java --version
Bạn sẽ nhận được đầu ra sau:


Bây giờ Java đã được cài đặt đúng cách, bạn có thể tiến hành bước tiếp theo.

4. Cài đặt XWiki trên Ubuntu 20.04

Theo mặc định, XWiki không có sẵn trong kho của Ubuntu 20.04, vì vậy bạn sẽ phải tải xuống gói này từ trang web riêng của XWiki và cài đặt thủ công trên máy chủ của mình.

Trước hết, hãy đảm bảo rằng cả wget và curl đều được cài đặt với:

sudo apt-get -y install wget curl
Thêm khóa GPG vào apt bằng lệnh sau:

wget -q "https://maven.xwiki.org/public.gpg" -O- | apt-key add -
Bạn sẽ thấy đầu ra OK xác nhận rằng khóa đã được thêm đúng cách.


Thêm kho lưu trữ XWiki vào hệ thống của bạn bằng lệnh sau:

sudo wget "https://maven.xwiki.org/stable/xwiki-stable.list" -P /etc/apt/sources.list.d/
Lệnh trên sẽ thêm kho lưu trữ ổn định XWiki vào máy chủ của bạn.

Bạn sẽ nhận được đầu ra sau:


Để apt sử dụng các kho lưu trữ mới được thêm vào, cần phải cập nhật bộ đệm của nó bằng:

sudo apt-get update -y
Ở giai đoạn này, Xwiki có sẵn trong kho Ubuntu 20.04 của bạn, bạn có thể tìm các gói có sẵn bằng lệnh sau:

sudo apt-cache search xwiki
Một danh sách các gói sẽ xuất hiện, cho phép bạn chọn gói nào bạn muốn cài đặt.


XWiki yêu cầu một bộ chứa servlet bên ngoài như Apache Tomcat để chạy trên Ubuntu 20.04. Trong hướng dẫn này, chúng tôi sẽ cài đặt gói nền tảng xwiki với Tomcat 9 và MariaDB làm máy chủ cơ sở dữ liệu:

sudo apt install xwiki-tomcat9-common xwiki-tomcat9-mariadb -y
Là một phần của quá trình cài đặt, bạn sẽ được yêu cầu thiết lập cơ sở dữ liệu XWiki, như minh họa bên dưới. Chọn có và nhấn Enter để bắt đầu quá trình tạo cơ sở dữ liệu.


Đặt mật khẩu mong muốn của bạn, chọn Ok và nhấn Enter khi được nhắc để hoàn tất việc đặt mật khẩu cho cơ sở dữ liệu XWiki như hình bên dưới. Hãy chắc chắn để xác nhận nó sau đó.


Khi quá trình cài đặt hoàn tất, bạn có thể xác minh dịch vụ Tomcat bằng cách sử dụng lệnh sau:

sudo systemctl status tomcat9.service
Bạn sẽ thấy đầu ra sau:


Như bạn có thể thấy, dịch vụ tomcat đang hoạt động và đang chạy.

Thông thường, Tomcat lắng nghe trên cổng 8080. Bạn có thể kiểm tra xem nó có đang lắng nghe trên cổng 8080 hay không bằng cách sử dụng lệnh sau:

ss -antpl | grep 8080
Bạn sẽ thấy đầu ra sau:


5. Cấu hình Nginx cho XWiki

Phần này sẽ chỉ cho bạn cách định cấu hình Nginx cho XWiki. Nginx là một máy chủ web rất phổ biến và mạnh mẽ. Nó có thể được sử dụng để phục vụ nội dung tĩnh, yêu cầu proxy và xử lý xác thực dễ dàng, trong số những thứ khác.

Để Nginx có thể giao tiếp với ứng dụng tomcat XWiki, bạn sẽ cần định cấu hình nó cho phù hợp.

Để cài đặt máy chủ web Nginx, hãy nhập lệnh sau tại dấu nhắc đầu cuối:

sudo apt-get install nginx -y

Sau khi cài đặt máy chủ web, hãy tạo tệp cấu hình Nginx mới bằng lệnh sau có tên xwiki.conf. xwiki.conf là một tệp cấu hình phải được cập nhật với cài đặt của riêng bạn và nó sẽ được lưu trong thư mục vv.

sudo nano /etc/nginx/sites-available/xwiki.conf
Bạn sẽ thấy một tệp trống mở ra trước màn hình, sẵn sàng để chỉnh sửa.

Điền vào tệp với nội dung sau:

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 tệp sau khi bạn hoàn tất, sau đó kích hoạt cấu hình Nginx mới bằng cách sử dụng lệnh sau:

sudo ln -s /etc/nginx/sites-available/xwiki.conf /etc/nginx/sites-enabled/
Khởi động lại Nginx để các thay đổi của bạn có hiệu lực bằng lệnh sau: \

sudo systemctl restart nginx
6. Truy cập giao diện người dùng web XWiki

Bây giờ bạn đã cài đặt và định cấu hình XWiki, đã đến lúc truy cập vào giao diện web. Để làm như vậy, hãy nhập địa chỉ IP máy chủ của bạn hoặc tên miền, sau đó là /xwiki. Ví dụ:

•   Đăng nhập để xem liên kết
• http://server-ip-address/xwiki

Bạn sẽ thấy một màn hình chào mừng như được hiển thị.


Nhấp vào nút Tiếp tục. Bạn sẽ thấy trang tạo người dùng quản trị.

Bây giờ bạn sẽ cần tạo tài khoản người dùng XWiki đầu tiên của mình bằng cách điền vào tất cả các thông tin liên quan như hình bên dưới:


Cung cấp tên người dùng và mật khẩu và email của bạn sau đó nhấp vào nút Đăng ký và Đăng nhập. Bạn sẽ được đưa đến trang dưới đây:


Nhấp vào nút Tiếp tục. Bạn sẽ thấy trang sau. Chọn hương vị bạn muốn sử dụng và nhấp vào nút Cài đặt hương vị này như được hiển thị.


Sau khi cài đặt hoàn tất, bạn sẽ thấy trang sau:


Để áp dụng các cài đặt, nhấp vào nút Tiếp tục. Sau khi hoàn tất cài đặt, bạn sẽ thấy trang sau hiển thị các thư mục XWiki mặc định. Tiếp tục hoàn tất cài đặt bằng cách nhấn Continue.


Cuối cùng, bạn sẽ thấy bảng điều khiển mặc định của XWiki như được hiển thị:


Trong hướng dẫn này, bạn đã học cách cài đặt Xwiki trên Ubuntu 20.04 và định cấu hình Nginx cho nó. Chúng tôi hy vọng rằng hướng dẫn này hữu ích cho bạn.

Để biết thêm thông tin về XWiki, vui lòng truy cập trang web chính thức   Đăng nhập để xem liên kết