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

[theanh]

OpenProject là phần mềm quản lý tác vụ nguồn mở được viết bằng Ruby on Rails và Angular JS. Phần mềm này chạy trên nền tảng web và cung cấp khả năng quản lý cổ điển cho toàn bộ vòng đời của dự án. Phần mềm cung cấp ba phiên bản: phiên bản cộng đồng, phiên bản đám mây và phiên bản doanh nghiệp. Phiên bản doanh nghiệp cung cấp một số tính năng cao cấp, hỗ trợ & tiện ích lưu trữ, trong khi phiên bản cộng đồng có thể tải xuống miễn phí và có thể lưu trữ trên bất kỳ máy chủ nào. Nó cung cấp một bộ tính năng phong phú bao gồm quản lý ứng dụng, lập kế hoạch phát hành, quản lý sản phẩm, cộng tác nhóm, quản lý tác vụ, theo dõi lỗi và lập kế hoạch ngân sách.

Hướng dẫn này sẽ chỉ cho bạn cách cài đặt phần mềm quản lý dự án OpenProject trên Ubuntu 22.04.

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

• Máy chủ chạy Ubuntu 22.04.
• Mật khẩu gốc được cấu hình trên máy chủ.

Cài đặt các phụ thuộc bắt buộc​

Trước khi bắt đầu, bạn sẽ cần cài đặt một số phụ thuộc bắt buộc để cài đặt OpenProject.

apt-get install gnupg2 wget apt-transport-https -y

Tiếp theo, bạn cũng sẽ cần cài đặt libssl1.1 trên máy chủ của bạn. Tuy nhiên, nó 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 một kho lưu trữ cho libssl.

echo "deb http://security.ubuntu.com/ubuntu impish-security main" | sudo tee /etc/apt/sources.list.d/impish-security.list

Sau khi kho lưu trữ được thêm vào APT, hãy cập nhật kho lưu trữ và cài đặt libssl1.1 bằng cách sử dụng lệnh sau lệnh:

apt-get update -y
apt-get install libssl1.1 -y

Sau khi libssl được cài đặt, bạn có thể tiến hành bước tiếp theo.

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

OpenProject sử dụng PostgreSQL làm cơ sở dữ liệu phụ trợ. Bạn có thể cài đặt nó bằng lệnh sau:

apt install postgresql -y

Sau khi PostgreSQL được cài đặt, hãy khởi động dịch vụ PostgreSQL bằng lệnh sau:

systemctl start postgresql

Bạn cũng có thể kiểm tra trạng thái của PostgreSQL bằng lệnh sau lệnh:

systemctl status postgresql

Bạn sẽ thấy đầu ra sau:

? postgresql.service - PostgreSQL RDBMS Loaded: loaded (/lib/systemd/system/postgresql.service; enabled; vendor preset: enabled) Active: active (exited) since Sun 2022-05-22 08:37:49 UTC; 25s ago Process: 21934 ExecStart=/bin/true (code=exited, status=0/SUCCESS) Main PID: 21934 (code=exited, status=0/SUCCESS) CPU: 1ms
May 22 08:37:49 ubuntu2204 systemd[1]: Starting PostgreSQL RDBMS...
May 22 08:37:49 ubuntu2204 systemd[1]: Finished PostgreSQL RDBMS.

Tiếp theo, đăng nhập vào shell PostgreSQL bằng lệnh sau lệnh:

su - postgres
psql

Tiếp theo, đặt mật khẩu PostgreSQL và tạo cơ sở dữ liệu bằng lệnh sau:

ALTER USER postgres PASSWORD 'password';
create database openproject

Tiếp theo, thoát khỏi shell PostgreSQL bằng lệnh sau lệnh:

exit
exit

Tiếp theo, chỉnh sửa tệp cấu hình PostgreSQL và thay đổi phương thức xác thực thành md5:

nano /etc/postgresql/14/main/pg_hba.conf

Thay đổi các mục sau dòng:

# Database administrative login by Unix domain socket
local all postgres md5
# TYPE DATABASE USER ADDRESS METHOD
# "local" is for Unix domain socket connections only
local all all md5
# IPv4 local connections:
host all all 127.0.0.1/32 md5
# IPv6 local connections:
host all all ::1/128 md5

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

systemctl restart postgresql

Cài đặt OpenProject​

Theo mặc định, OpenProject không được bao gồm trong kho lưu trữ mặc định của Ubuntu 22.04. Vì vậy, bạn sẽ cần thêm kho lưu trữ OpenProject vào APT. Bạn có thể thêm nó bằng lệnh sau:

wget -qO- https://dl.packager.io/srv/opf/openproject/key | apt-key add -
wget -O /etc/apt/sources.list.d/openproject.list https://dl.packager.io/srv/opf/openproject/stable/12/installer/ubuntu/20.04.repo

Sau khi kho lưu trữ được thêm vào, hãy cập nhật kho lưu trữ bằng lệnh sau:

apt-get update -y

Tiếp theo, cài đặt OpenProject bằng lệnh sau lệnh:

apt-get install openproject -y

Sau khi OpenProject được cài đặt, bạn sẽ nhận được kết quả sau:

Setting up libpangoft2-1.0-0:amd64 (1.50.6+ds-2) ...
Setting up libpangocairo-1.0-0:amd64 (1.50.6+ds-2) ...
Setting up libgs9:amd64 (9.55.0~dfsg1-0ubuntu5) ...
Setting up libmagickcore-6.q16-6-extra:amd64 (8:6.9.11.60+dfsg-1.3build2) ...
Setting up ghostscript (9.55.0~dfsg1-0ubuntu5) ...
Setting up tesseract-ocr (4.1.1-2.1build1) ...
Setting up imagemagick (8:6.9.11.60+dfsg-1.3build2) ...
Setting up openproject (12.1.4-1652787939.a0fe11cd.focal) ...
==============
The openproject package provides an installer. Please run the following command to finish the installation:
sudo openproject configure
==============
Processing triggers for libc-bin (2.35-0ubuntu3) ...
Processing triggers for man-db (2.10.2-1) ...
Processing triggers for mailcap (3.70+nmu1ubuntu1) ...

Cấu hình OpenProject​

Sau khi cài đặt OpenProject, bạn sẽ cần cấu hình OpenProject. Bạn có thể thực hiện bằng lệnh sau:

openproject configure

Bạn sẽ được yêu cầu xác định cơ sở dữ liệu PostgreSQL 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=%22365%22%3E%3C/svg%3E


Nhấp vào Sử dụng cơ sở dữ liệu PostgreSQL hiện có và nhấn phím Enter. Bạn sẽ được yêu cầu cung cấp máy chủ PostgreSQL:


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


Cung cấp địa chỉ localhost và nhấn phím Enter. Bạn sẽ được yêu cầu cung cấp một cổng PostgreSQL:


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


Cung cấp một cổng lắng nghe PostgreSQL và nhấn phím Enter. Bạn sẽ được yêu cầu cung cấp tên người dùng PostgreSQL:


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


Cung cấp tên người dùng của bạn và nhấn phím Enter. Bạn sẽ được yêu cầu cung cấp mật khẩu PostgreSQL:


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


Cung cấp mật khẩu của bạn và nhấn phím Enter. Bạn sẽ được yêu cầu cung cấp cơ sở dữ liệu PostgreSQL:


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


Cung cấp cơ sở dữ liệu PostgreSQL của bạn và nhấn phím Enter. Bạn sẽ được yêu cầu thiết lập máy chủ web:


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


ChọnCài đặt máy chủ Apache và nhấn phím Enter. Bạn sẽ được yêu cầu cung cấp tên miền đủ điều kiện:


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


Cung cấp tên miền của bạn và nhấn phím Enter. Bạn sẽ được yêu cầu cung cấp đường dẫn máy chủ:


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


Cung cấp đường dẫn máy chủ của bạn và nhấn phím Enter. Bạn sẽ được yêu cầu bật SSL:


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


Chọn Không và nhấn phím Enter. Bạn sẽ được yêu cầu cài đặt Subversion:


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


ChọnCài đặt hỗ trợ kho lưu trữ Subversion và nhấn phím Enter. Bạn sẽ được yêu cầu xác định đường dẫn kho lưu trữ:


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


Cung cấp đường dẫn kho lưu trữ của bạn hoặc giữ nguyên mặc định rồi nhấn phím Enter. Bạn sẽ được yêu cầu cài đặt kho lưu trữ Git:


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


Chọn bỏ qua và nhấn phím Enter. Bạn sẽ được yêu cầu sử dụng email:


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


Chọn SMTP và nhấn phím Enter. Bạn sẽ được yêu cầu chọn loại xác thực:


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


Chọn Không có và nhấn phím Enter. Bạn sẽ được yêu cầu xác định máy chủ SMTP:


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


Cung cấp máy chủ SMTP của bạn và nhấn phím Enter. Bạn sẽ được yêu cầu cung cấp cổng SMTP:


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


Cung cấp cổng SMTP của bạn và nhấn phím Enter. Bạn sẽ được yêu cầu cung cấp tên miền SMTP của mình:


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


Cung cấp tên miền SMTP của bạn và nhấn phím Enter. Bạn sẽ được yêu cầu cung cấp email của mình:


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


Cung cấp email của bạn và nhấn phím Enter. Bạn sẽ được yêu cầu cài đặt máy chủ Memcached:


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


Chọn bỏ qua và nhấn phím Enter để bắt đầu cấu hình. Sau khi OpenProject được cấu hình, hãy xác minh dịch vụ Apache bằng lệnh sau:

systemctl status apache2

Bạn sẽ thấy đầu ra sau:

? apache2.service - The Apache HTTP Server Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled) Active: active (running) since Sun 2022-05-22 09:13:26 UTC; 51s ago Docs: https://httpd.apache.org/docs/2.4/ Main PID: 38894 (/usr/sbin/apach) Tasks: 7 (limit: 2292) Memory: 28.2M CPU: 345ms CGroup: /system.slice/apache2.service ??38894 /usr/sbin/apache2 -k start ??38988 /usr/sbin/apache2 -k start ??39022 /usr/sbin/apache2 -k start ??39023 /usr/sbin/apache2 -k start ??39024 /usr/sbin/apache2 -k start ??39031 /usr/sbin/apache2 -k start ??39032 /usr/sbin/apache2 -k start
May 22 09:13:26 ubuntu2204 systemd[1]: Starting The Apache HTTP Server...
May 22 09:13:26 ubuntu2204 apachectl[38893]: AH00558: apache2: Could not reliably determine the server's fully qualified domain name, using 2>
May 22 09:13:26 ubuntu2204 systemd[1]: Started The Apache HTTP Server.

Bạn cũng có thể kiểm tra trạng thái OpenProject bằng lệnh sau lệnh:

systemctl status openproject-web-1.service

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

? openproject-web-1.service Loaded: loaded (/etc/systemd/system/openproject-web-1.service; enabled; vendor preset: enabled) Active: active (running) since Sun 2022-05-22 09:14:06 UTC; 47s ago Main PID: 40653 (web) Tasks: 25 (limit: 2292) Memory: 364.8M CPU: 18.618s CGroup: /system.slice/openproject-web-1.service ??40653 /bin/bash -e ./packaging/scripts/web ??40713 "puma 5.6.4 (tcp://127.0.0.1:6000) [openproject]" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "> ??40743 "puma: cluster worker 0: 40713 [openproject]" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" ""> ??40744 "puma: cluster worker 1: 40713 [openproject]" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "">
May 22 09:14:43 ubuntu2204 openproject-web-1.service[40713]: [40713] * Max threads: 16
May 22 09:14:43 ubuntu2204 openproject-web-1.service[40713]: [40713] * Environment: production
May 22 09:14:43 ubuntu2204 openproject-web-1.service[40713]: [40713] * Master PID: 40713
May 22 09:14:43 ubuntu2204 openproject-web-1.service[40713]: [40713] * Workers: 2
May 22 09:14:43 ubuntu2204 openproject-web-1.service[40713]: [40713] * Restarts: (?) hot (?) phased
May 22 09:14:43 ubuntu2204 openproject-web-1.service[40713]: [40713] * Preloading application
May 22 09:14:43 ubuntu2204 openproject-web-1.service[40713]: [40713] * Listening on http://127.0.0.1:6000
May 22 09:14:43 ubuntu2204 openproject-web-1.service[40713]: [40713] Use Ctrl-C to stop
May 22 09:14:43 ubuntu2204 openproject-web-1.service[40713]: [40713] - Worker 0 (PID: 40743) booted in 0.02s, phase: 0
May 22 09:14:43 ubuntu2204 openproject-web-1.service[40713]: [40713] - Worker 1 (PID: 40744) booted in 0.02s, phase: 0

Truy cập Giao diện Web OpenProject​

Bây giờ, hãy mở trình duyệt web của bạn và truy cập OpenProject bằng URL http://openproject.example.com/login. Bạn sẽ được chuyển hướng đến trang đăng nhập OpenProject:


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


Cung cấp tên người dùng và mật khẩu mặc định là admin / admin và nhấp vào nút Đăng nhập. Bạn sẽ thấy màn hình đặt lại mật khẩu:


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


Đặt mật khẩu quản trị viên mới và nhấp vào nút Lưu để áp dụng các thay đổi. Bạn sẽ thấy bảng điều khiển OpenProject trên màn hình sau:


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

Kết luận​

Xin chúc mừng! Bạn đã cài đặt thành công OpenProject trên máy chủ Ubuntu 22.04. Bây giờ bạn có thể triển khai OpenProject trong tổ chức của mình và bắt đầu quản lý dự án từ vị trí trung tâm.