GALAXY TECH
Chuyên gia Công nghệ
Thứ tư, 19/11/2014 | 00:00 GMT+7

Cách cài đặt MoinMoin với Nginx trên Ubuntu 14.04

MoinMoin là một Wiki Engine open-souce hiệu suất cao được viết bằng Python. Nó cung cấp một wiki giàu tính năng có một cộng đồng lớn user , rất dễ tùy chỉnh và dễ sử dụng. MoinMoin được một số tổ chức sử dụng cho wiki công cộng của họ, chẳng hạn như Ubuntu, Apache, FreeBSD, v.v.

Trong hướng dẫn này, ta sẽ chỉ cho bạn cách cài đặt wiki MoinMoin của bạn trên server Ubuntu 14.04 mới, sử dụng Nginx làm web server và uWSGI làm công cụ ứng dụng. Cài đặt cụ thể này dành cho một wiki duy nhất, nó rất nhanh và tiết kiệm bộ nhớ.

Yêu cầu

Trước khi bắt đầu với hướng dẫn này, bạn nên cài đặt một account user riêng, không phải root trên server của bạn . Bạn có thể xem cách thực hiện việc này bằng cách hoàn thành các bước 1-4 trong cài đặt server ban đầu cho Ubuntu 14.04 .

Hướng dẫn này giả định bạn có một server Ubuntu 14.04 mới.

Hướng dẫn này sử dụng vi để mở và chỉnh sửa file . Nếu bạn thích một trình soạn thảo khác, hãy sử dụng nó thay cho vi nếu có.

Bắt đầu nào!

Cài đặt uWSGI

Để bắt đầu, hãy cài đặt uWSGI, mà ta sẽ sử dụng làm server ứng dụng.

Đầu tiên, hãy cập nhật database Apt của bạn bằng lệnh này:

sudo apt-get update

Một cách dễ dàng để cài đặt uWSGI là sử dụng trình quản lý gói Python, pip . Cài đặt Python-pip và các thư viện Python ngay bây giờ:

sudo apt-get install python-pip python-dev

Với pip đã được cài đặt, ta có thể sử dụng nó để cài đặt bản phát hành ổn định mới nhất của uWSGI bằng lệnh sau:

sudo pip install http://projects.unbit.it/downloads/uwsgi-lts.tar.gz

Nếu uWSGI được cài đặt thành công, bạn sẽ thấy một thông báo như sau:

    ############## end of uWSGI configuration #############     total build time: 36 seconds     *** uWSGI is ready, launch it with /usr/local/bin/uwsgi ***  Successfully installed uWSGI Cleaning up...

Bây giờ server ứng dụng uWSGI đã được cài đặt, ta đã sẵn sàng download và cài đặt MoinMoin.

Cài đặt Moinmoin

Trước khi cài đặt MoinMoin, hãy tra cứu version bạn muốn cài đặt tại đây: MoinMoin Releases . Bạn có thể sẽ muốn sử dụng bản phát hành chung mới nhất.

Tìm bản phát hành chung mới nhất của MoinMoin và sao chép URL của nó vào clipboard của bạn:

Download MoinMoin

Bản phát hành chung mới nhất có sẵn khi hướng dẫn này được viết là 1.9.8, vì vậy URL ví dụ đề cập đến version 1.9.8. Sử dụng lệnh wget này để tải repository MoinMoin về folder chính của bạn (thay thế URL download mà bạn đã sao chép):

cd ~ wget http://static.moinmo.in/files/moin-1.9.8.tar.gz

Bây giờ extract repository bằng tar:

tar zxvf moin-1.9.8.tar.gz

Thay đổi folder đã được tạo bằng cách extract repository MoinMoin:

cd moin-*

Để xây dựng ứng dụng MoinMoin Python và sao chép nó vào /usr/local , hãy chạy lệnh sau:

sudo python setup.py install --prefix=/usr/local

Giả sử bạn đang sử dụng Python 2.7, tập lệnh Python sẽ cài đặt gói mã MoinMoin thành /usr/local/lib/ python2.7 /dist-packages/ và phần còn lại của dữ liệu MoinMoin thành /usr/local/share/moin .

Bây giờ Ứng dụng MoinMoin Python đã được cài đặt nhưng nó chưa được cấu hình . Hãy cấu hình nó ngay bây giờ.

Cấu hình ứng dụng MoinMoin

Trước khi thực sự khởi động ứng dụng MoinMoin, ta cần chuẩn bị các file cấu hình của nó.

Thay đổi folder cài đặt:

cd /usr/local/share/moin

Sau đó, sao chép file cấu hình server mẫu, moin.wsgi , vào folder hiện tại:

sudo cp server/moin.wsgi .

Mở file cấu hình server để chỉnh sửa:

sudo vi moin.wsgi

Bên dưới dòng import sys, os hãy chèn các dòng sau:

sys.path.insert(0, '/usr/local/lib/python2.7/dist-packages/') sys.path.insert(0, '/usr/local/share/moin/')

Lưu và thoát. Thao tác này cấu hình ứng dụng với vị trí của mã MoinMoin và vị trí của các file cấu hình wiki sẽ được đặt.

Tiếp theo, tạo và mở uwsgi.ini :

sudo vi uwsgi.ini

Chèn các dòng sau vào file :

[uwsgi] uid = www-data gid = www-data socket = /usr/local/share/moin/moin.sock chmod-socket = 660 logto = /var/log/uwsgi/uwsgi.log  chdir = /usr/local/share/moin/ wsgi-file = moin.wsgi  master workers = 3 max-requests = 200 harakiri = 30 die-on-term

Lưu và thoát. Tệp uwsgi.ini sẽ được sử dụng để tải ứng dụng MoinMoin bằng server ứng dụng uWSGI. Ở đây, ta đang chỉ cấu hình user , socket và server và các file log mà ứng dụng sẽ sử dụng, trong số những thứ khác. Hãy thoải mái điều chỉnh số lượng công nhân, yêu cầu tối đa hoặc thời lượng phiên được chấp nhận (harakiri).

Bây giờ, hãy tạo folder /var/log/uwsgi , đây là nơi ta đã cấu hình ứng dụng uWSGI để ghi log của nó vào:

sudo mkdir -p /var/log/uwsgi sudo chown www-data /var/log/uwsgi

Tiếp theo, hãy tạo một tập lệnh initctl sẽ được sử dụng để khởi động ứng dụng MoinMoin của ta . Tập lệnh này sẽ kích hoạt MoinMoin khi khởi động server và cho phép bạn điều khiển ứng dụng uWSGI với start moin và stop moin .

Tạo và mở moin.conf bằng lệnh sau:

sudo vi /etc/init/moin.conf

Chèn các dòng cấu hình sau:

description "moin uwsgi service"  start on runlevel [2345] stop on runlevel [!2345]  chdir /usr/local/share/moin exec /usr/local/bin/uwsgi /usr/local/share/moin/uwsgi.ini respawn

Lưu và thoát. Điều quan trọng là các đường dẫn trong chdir và exec dòng phản ánh chính xác nơi MoinMoin đã được cài đặt, và nơi uwsgi binary và uwsgi.ini file tồn tại.

Bạn có thể khởi động server ứng dụng ngay bây giờ ( sudo start moin ) nhưng ta sẽ thực hiện một vài thay đổi đối với cấu hình Wiki trước.

Cấu hình Wiki

Bây giờ server ứng dụng uWSGI đã sẵn sàng, ta sẽ muốn cấu hình Wiki thực tế.

Thay đổi sang folder cài đặt MoinMoin và sao chép file wikiconfig.py mẫu:

cd /usr/local/share/moin sudo cp config/wikiconfig.py .

Bây giờ hãy mở file để chỉnh sửa:

sudo vi wikiconfig.py

Tại đây ta có thể cấu hình các khía cạnh khác nhau của Wiki. Ở mức tối thiểu, ta muốn cấu hình các mục sau:

  • sitename : Tiêu đề Wiki của bạn
  • page_front_page : Bỏ comment này để kích hoạt một trang chủ bình thường
  • superuser : Tên của user mà bạn muốn sử dụng làm administrator của Wiki. Mục này cũng phải được bỏ chú thích

Tìm các dòng sau (và bỏ ghi chú nếu cần, bằng cách xóa dấu # ) và thay đổi các giá trị được đánh dấu theo ý bạn:

    sitename = u'My First Wiki'      page_front_page = u"FrontPage"      superuser = [u"WikiAdmin", ]

Lưu và thoát. Đây là một file Python, vì vậy hãy đảm bảo duy trì bất kỳ thụt lề nào đã tồn tại.

Trước khi bắt đầu ứng dụng, hãy thay đổi quyền sở hữu và quyền của các folder MoinMoin:

sudo chown -R www-data: /usr/local/share/moin sudo chmod -R o-rwx /usr/local/share/moin

Khởi động server ứng dụng uWSGI bằng lệnh sau:

sudo start moin

MoinMoin hiện đang chạy nhưng ta cần cài đặt cấu hình web server Nginx trước khi bạn có thể sử dụng.

Cài đặt và cấu hình Nginx

Ta sẽ sử dụng Nginx làm web server của bạn , vì vậy hãy cài đặt và cấu hình nó ngay bây giờ.

Cài đặt Nginx với apt:

sudo apt-get install nginx

Bây giờ, hãy thay đổi folder sites-available của sites-available và tạo file cấu hình khối server mới cho Wiki. Ta sẽ gọi moin ta :

cd /etc/nginx/sites-available sudo vi moin

Trong file , hãy chèn các dòng sau (thay thế các phần được đánh dấu bằng thông tin của bạn ):

server {     server_name wiki.example.com;      access_log /var/log/nginx/access.log;     error_log /var/log/nginx/error.log;      location / {         include uwsgi_params;         uwsgi_pass unix:///usr/local/share/moin/moin.sock;         uwsgi_modifier1 30;     } }

Đây là một cấu hình Nginx xương trần. Hãy thoải mái thực hiện bất kỳ thay đổi nào mà bạn cảm thấy phù hợp với server của bạn .

Bây giờ, hãy tạo một softlink đến file cấu hình khối server mới của ta trong folder sites-enabled :

cd /etc/nginx/sites-enabled sudo ln -s ../sites-available/moin .

Và xóa softlink đến khối server default :

sudo rm default

Bây giờ khối server moin sẽ là mặc định.

Khởi động lại Nginx để tải cài đặt mới:

sudo service nginx restart

Wiki mới của bạn đang hoạt động! Nó có sẵn tại địa chỉ IP hoặc tên server của server của bạn.

Tạo Wiki Superuser

Điều cuối cùng bạn cần làm trước khi sử dụng Wiki là tạo account Superuser. Tài khoản này có quyền quản trị blog. Ta đã cấu hình tên của user này trong trường superuser của trong file wikiconfig.py , trong phần Định cấu hình Wiki của hướng dẫn này, vì vậy hãy đảm bảo bạn sử dụng cùng một tên tại đây.

Kết nối với server của bạn trong trình duyệt web, qua địa chỉ IP hoặc tên server : http:// wiki.example.com

Bạn sẽ được chào đón bởi trang đầu sau:

Trang chủ

Nhấp vào liên kết Đăng nhập ở đầu trang.

Đăng nhập

Tại trang Đăng nhập, nhấp vào liên kết bạn có thể tạo ngay bây giờ .

Tạo nên

Tại trang Tạo account , nhập tên phù hợp với cấu hình siêu user của bạn (ví dụ được sử dụng là “WikiAdmin”), cùng với password và địa chỉ email của bạn, sau đó nhấp vào nút Tạo profile .

Nếu mọi việc suôn sẻ, bạn sẽ thấy thông báo thành công sau:

User đã tạo

Đó là nó! Wiki của bạn hiện đã sẵn sàng để sử dụng.

Kết luận

Đến đây bạn đã cài đặt và chạy wiki MoinMoin, bạn đã sẵn sàng sử dụng nó để cộng tác! Hãy thoải mái thêm nội dung và user hoặc thay đổi cấu hình và chủ đề của nó.

Tags:

Các tin liên quan

Hiểu cấu trúc tệp cấu hình và khung cấu hình Nginx
2014-11-19
Hiểu server Nginx và các thuật toán lựa chọn khối vị trí
2014-11-17
Cách thiết lập server block Nginx trên CentOS 7
2014-11-05
Cách sử dụng tệp bản đồ Salt Cloud để triển khai server ứng dụng và reverse-proxy Nginx
2014-10-27
Cách triển khai ứng dụng Rails với Passenger và Nginx trên Ubuntu 14.04
2014-10-09
Cách tạo profile AppArmor cho Nginx trên Ubuntu 14.04
2014-10-06
Cách cấu hình Nginx với SSL làm Reverse Proxy cho Jenkins
2014-09-23
Cách thiết lập nhiều trang web WordPress với Nginx trên Ubuntu 14.04
2014-08-21
Cách cài đặt và bảo mật phpMyAdmin với Nginx trên server Ubuntu 14.04
2014-08-06
Cách cài đặt và bảo mật phpMyAdmin với Nginx trên server CentOS 7
2014-08-06