Cài đặt nguồn¶
‘Cài đặt’ nguồn không phải là cài đặt Odoo mà là chạy Odoo trực tiếp từ nguồn.
Việc sử dụng nguồn Odoo có thể thuận tiện hơn cho các lập trình viên phân hệ vì nó dễ truy cập hơn so với việc sử dụng trình cài đặt trọn gói.
It makes starting and stopping Odoo more flexible and explicit than the services set up by the packaged installers. Also, it allows overriding settings using command-line parameters without needing to edit a configuration file.
Cuối cùng là nó nâng cao khả năng kiểm soát đối với thiết lập hệ thống và cho phép dễ dàng duy trì (và chạy) nhiều phiên bản Odoo song song.
Lấy nguồn¶
Có hai cách để lấy mã nguồn của Odoo: dưới dạng lưu trữ ZIP hoặc thông qua Git.
Lưu trữ¶
Phiên bản Community:
Phiên bản Enterprise:
Git¶
Ghi chú
It is required to have Git installed, and it is recommended to have a basic knowledge of Git commands to proceed.
To clone a Git repository, choose between cloning with HTTPS or SSH. In most cases, the best option is HTTPS. However, choose SSH to contribute to Odoo source code or when following the Getting Started developer tutorial.
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
C:\> git clone https://github.com/odoo/odoo.git
C:\> git clone https://github.com/odoo/enterprise.git
C:\> git clone git@github.com:odoo/odoo.git
C:\> git clone git@github.com:odoo/enterprise.git
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
Ghi chú
Kho lưu trữ git Enterprise không chứa mã nguồn Odoo đầy đủ. Nó chỉ là một tập hợp các add-on bổ sung. Mã máy chủ chính nằm trong phiên bản Community. Chạy phiên bản Enterprise có nghĩa là chạy máy chủ từ phiên bản Community với tùy chọn addons-path
được thiết lập cho phiên bản Enterprise trong một thư mục cụ thể. Cần phải sao chép cả kho lưu trữ Community và Enterprise để bản cài đặt Odoo Enterprise hoạt động.
Chuẩn bị¶
Python¶
Odoo yêu cầu Python 3.10 trở lên để có thể hoạt động.
Thay đổi trong phiên bản 17: Yêu cầu tối thiểu được cập nhật từ Python 3.7 lên Python 3.10.
Sử dụng trình quản lý gói để tải xuống và cài đặt Python 3 nếu cần.
Tải xuống phiên bản mới nhất của Python 3 <https://www.python.org/downloads/windows/>
_ và cài đặt.
Trong quá trình cài đặt, hãy kiểm tra Thêm Python 3 vào PATH, sau đó nhấp vào Tùy chỉnh cài đặt và đảm bảo rằng pip đã được chọn.
Sử dụng trình quản lý gói (Homebrew <https://brew.sh/>
, MacPorts <https://www.macports.org>
) để tải xuống và cài đặt Python 3 nếu cần.
Ghi chú
Nếu Python 3 đã được cài đặt, hãy đảm bảo đó là phiên bản 3.10 trở lên vì các phiên bản trước đó không tương thích với Odoo.
$ python3 --version
C:\> python --version
$ python3 --version
Verify that pip is also installed for this version.
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
Odoo sử dụng PostgreSQL làm hệ thống quản lý cơ sở dữ liệu.
Sử dụng trình quản lý gói để tải xuống và cài đặt PostgreSQL (phiên bản được hỗ trợ: 12.0 trở lên). Bạn có thể tiến hành bằng cách thực hiện lệnh sau:
$ sudo apt install postgresql postgresql-client
Tải xuống PostgreSQL <https://www.postgresql.org/download/windows>
_ (phiên bản được hỗ trợ: 12.0 trở lên) và cài đặt.
Sử dụng Postgres.app <https://postgresapp.com>
_ để tải xuống và cài đặt PostgreSQL (phiên bản được hỗ trợ: 12.0 trở lên).
Mẹo
Để sử dụng các công cụ dòng lệnh đi kèm với Postgres.app, hãy đảm bảo thiết lập biến $PATH
bằng cách làm theo hướng dẫn về công cụ CLI của Postgres.app <https://postgresapp.com/documentation/cli-tools.html>
_.
Theo mặc định, người dùng duy nhất là postgres
. Vì Odoo cấm kết nối dưới dạng postgres
, hãy tạo một người dùng PostgreSQL mới.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Ghi chú
Vì người dùng PostgreSQL có cùng tên với tên đăng nhập Unix nên có thể kết nối với cơ sở dữ liệu mà không cần mật khẩu.
Thêm thư mục
bin
của PostgreSQL (theo mặc định: :file:C:\\Program Files\\PostgreSQL\\<version>\\bin
) vàoPATH
.Tạo người dùng postgres có mật khẩu bằng giao diện người dùng đồ hoạ pg admin:
Mở pgAdmin.
Nhấp đúp vào máy chủ để tạo kết nối.
Chọn :menuselection:
Đối tượng --> Tạo --> Đăng nhập/Vai trò nhóm
.Nhập tên người dùng vào trường Tên vai trò (ví dụ:
odoo
).Mở tab Định nghĩa, nhập mật khẩu (ví dụ:
odoo
) và nhấp vào Lưu.Mở tab Quyền hạn và chuyển Có thể đăng nhập không? thành
Có
và Có tạo cơ sở dữ liệu không? thànhCó
.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
Ghi chú
Vì người dùng PostgreSQL có cùng tên với tên đăng nhập Unix nên có thể kết nối với cơ sở dữ liệu mà không cần mật khẩu.
Phụ thuộc¶
Việc sử dụng gói phân phối là cách cài đặt phụ thuộc được ưu tiên. Ngoài ra, hãy cài đặt các phụ thuộc Python bằng pip.
Trên Debian/Ubuntu, các lệnh sau sẽ cài đặt các gói cần thiết:
$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh
Tập lệnh setup/debinstall.sh
sẽ phân tích tệp debian/control <https://github.com/odoo/odoo/blob/18.0/debian/control>
_ và cài đặt các gói được tìm thấy.
Cảnh báo
Việc sử dụng pip có thể dẫn đến các vấn đề bảo mật và làm hỏng phụ thuộc; chỉ thực hiện việc này nếu bạn nắm rõ quy trình.
Vì một số gói Python cần bước biên dịch, nên chúng yêu cầu phải cài đặt thư viện hệ thống.
Trên Debian/Ubuntu, các lệnh sau sẽ cài đặt các thư viện cần thiết:
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
Các phụ thuộc của Odoo được liệt kê trong tệp :file:requirements.txt
nằm ở thư mục gốc của Odoo Community.
Ghi chú
Các gói Python trong :file:requirements.txt
dựa trên phiên bản Ubuntu/LTS Debian/ổn định tương ứng tại thời điểm phát hành Odoo. Ví dụ, đối với Odoo 15.0, phiên bản gói python3-babel
là 2.8.0 trong Debian Bullseye và 2.6.0 trong Ubuntu Focal. Sau đó, phiên bản thấp nhất được chọn trong :file:requirements.txt
.
Mẹo
Tốt hơn hết là không nên trộn các gói phân hệ Python giữa các phiên bản Odoo khác nhau hoặc với hệ thống. Tuy nhiên, có thể sử dụng virtualenv <https://pypi.org/project/virtualenv/>
_ để tạo các môi trường Python cô lập.
Điều hướng đến đường dẫn cài đặt Odoo Communit (:file:CommunityPath
) và chạy pip trên tệp yêu cầu để cài đặt các yêu cầu cho người dùng hiện tại.
$ cd /CommunityPath
$ pip install -r requirements.txt
Trước khi cài đặt các phụ thuộc, hãy tải xuống và cài đặt Công cụ Dựng Dành cho Visual Studio <https://visualstudio.microsoft.com/downloads/>
_. Chọn công cụ dựng C++ trong tab Workload và cài đặt chúng khi được nhắc.
Các phụ thuộc của Odoo được liệt kê trong tệp requirements.txt
nằm ở thư mục gốc của Odoo Community.
Mẹo
Tốt hơn hết là không nên trộn các gói phân hệ Python giữa các phiên bản Odoo khác nhau hoặc với hệ thống. Tuy nhiên, có thể sử dụng
virtualenv <https://pypi.org/project/virtualenv/>
_ để tạo các môi trường Python cô lập.
Điều hướng đến đường dẫn cài đặt Odoo Community (CommunityPath
) và chạy pip trên tệp yêu cầu trong terminal với quyền Quản trị viên:
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
Các phụ thuộc của Odoo được liệt kê trong tệp requirements.txt
nằm ở thư mục gốc của Odoo Community.
Mẹo
Tốt hơn hết là không nên trộn các gói phân hệ Python giữa các phiên bản Odoo khác nhau hoặc với hệ thống. Tuy nhiên, có thể sử dụng
virtualenv <https://pypi.org/project/virtualenv/>
_ để tạo các môi trường Python cô lập.
Điều hướng đến đường dẫn cài đặt Odoo Community (CommunityPath
) và chạy pip trên tệp yêu cầu:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
Cảnh báo
Các phụ thuộc không phải Python phải được cài đặt bằng trình quản lý gói (Homebrew <https://brew.sh/>
, MacPorts <https://www.macports.org>
).
Tải xuống và cài đặt Công cụ Dòng Lệnh:
$ xcode-select --install
Sử dụng trình quản lý gói để cài đặt các phụ thuộc không phải Python.
Ghi chú
Đối với các ngôn ngữ sử dụng giao diện từ phải sang trái (như tiếng Ả Rập hoặc tiếng Do Thái), gói rtlcss
là điều kiện bắt buộc.
Tải xuống và cài đặt nodejs và npm bằng trình quản lý gói.
Cài đặt
rtlcss
:$ sudo npm install -g rtlcss
Tải xuống và cài đặt
nodejs <https://nodejs.org/en/download>
_.Cài đặt
rtlcss
:C:\> npm install -g rtlcss
Chỉnh sửa biến môi trường hệ thống
PATH
để thêm thư mục chứartlcss.cmd
(thường là: :file:C:\\Users\\<user>\\AppData\\Roaming\\npm\\
).
Tải xuống và cài đặt nodejs bằng trình quản lý gói (
Homebrew <https://brew.sh/>
,MacPorts <https://www.macports.org>
).Cài đặt
rtlcss
:$ sudo npm install -g rtlcss
Cảnh báo
wkhtmltopdf
is not installed through pip and must be installed manually in version 0.12.6 for it to support headers
and footers. Check out the wkhtmltopdf wiki
for more details on the various versions.
Chạy Odoo¶
Sau khi tất cả phụ thuộc được thiết lập, bạn có thể khởi chạy Odoo bằng cách chạy odoo-bin
, giao diện dòng lệnh của máy chủ. Giao diện này nằm ở gốc của thư mục Odoo Community.
To configure the server, either specify command-line arguments or a configuration file.
Mẹo
Đối với phiên bản Enterprise, thêm đường dẫn đến add-on enterprise
vào đối số addons-path
. Lưu ý rằng nó phải đứng trước các đường dẫn khác trong addons-path
để add-on được tải chính xác.
Cấu hình cần thiết phổ biến là:
Người dùng và mật khẩu PostgreSQL.
Đường dẫn add-on tùy chỉnh ngoài đường dẫn mặc định để tải các phân hệ tùy chỉnh.
Một cách điển hình để chạy máy chủ là:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Trong đó CommunityPath
là đường dẫn cài đặt Odoo Community và mydb
là tên cơ sở dữ liệu PostgreSQL.
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
Trong đó CommunityPath
là đường dẫn cài đặt Odoo Community, dbuser
là tên đăng nhập PostgreSQL, dbpassword
là mật khẩu PostgreSQL và mydb
là tên cơ sở dữ liệu PostgreSQL.
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Trong đó CommunityPath
là đường dẫn cài đặt Odoo Community và mydb
là tên cơ sở dữ liệu PostgreSQL.
After the server has started (the INFO log odoo.modules.loading: Modules loaded.
is printed), open
http://localhost:8069 in a web browser and log into the Odoo database with the base administrator
account: use admin
as the email and, again, admin
as the password.
Mẹo