نصب از منبع¶
«نصب» از منبع دربارهٔ نصب Odoo نیست، بلکه دربارهٔ اجرای مستقیم آن از کد منبع است.
استفاده از منبع Odoo میتواند برای توسعهدهندگان ماژول راحتتر باشد، زیرا نسبت به استفاده از نصبکنندههای بستهبندیشده، دسترسی آسانتری دارد.
این، شروع و توقف Odoo را انعطافپذیرتر و صریحتر از سرویسهای تنظیمشده توسط نصبکنندههای بستهبندیشده میکند. همچنین اجازهٔ override تنظیمات با استفاده از command-line parameters را میدهد.
در نهایت، کنترل بیشتری بر تنظیمات سیستم فراهم میکند و اجازه میدهد چندین نسخهٔ Odoo را آسانتر در کنار هم نگه دارید (و اجرا کنید).
دریافت منابع¶
دو راه برای بهدست آوردن کد منبع Odoo وجود دارد: بهصورت یک آرشیو ZIP یا از طریق Git.
آرشیو¶
نسخهٔ Community:
نسخهٔ Enterprise:
Git¶
توجه
لازم است Git نصب شده باشد، و توصیه میشود برای ادامه دانش پایهای از دستورات Git داشته باشید.
برای کلون کردن یک مخزن Git، بین کلون با HTTPS یا SSH انتخاب کنید. در بیشتر موارد، بهترین گزینه HTTPS است. با این حال، اگر میخواهید در کد منبع Odoo مشارکت کنید یا آموزش توسعهدهنده Getting Started را دنبال میکنید، SSH را انتخاب کنید.
$ git clone --branch 19.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 19.0 --single-branch https://github.com/odoo/enterprise.git
$ git clone --branch 19.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 19.0 --single-branch git@github.com:odoo/enterprise.git
C:\> git clone --branch 19.0 --single-branch https://github.com/odoo/odoo.git
C:\> git clone --branch 19.0 --single-branch https://github.com/odoo/enterprise.git
C:\> git clone --branch 19.0 --single-branch git@github.com:odoo/odoo.git
C:\> git clone --branch 19.0 --single-branch git@github.com:odoo/enterprise.git
$ git clone --branch 19.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 19.0 --single-branch https://github.com/odoo/enterprise.git
$ git clone --branch 19.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 19.0 --single-branch git@github.com:odoo/enterprise.git
توجه
مخزن git Enterprise شامل کد منبع کامل Odoo نیست. این فقط مجموعهای از add-onهای اضافی است. کد سرور اصلی در ویرایش Community است. اجرای نسخهٔ Enterprise به معنای اجرای سرور از نسخهٔ Community با گزینهٔ addons-path تنظیمشده به پوشهٔ ویرایش Enterprise است. برای داشتن یک نصب کارآمد Odoo Enterprise، کلون کردن هر دو مخزن Community و Enterprise الزامی است.
آمادهسازی¶
Python¶
Odoo برای اجرا به Python 3.10 یا جدیدتر نیاز دارد.
تغییر داده شده در نسخه 17: حداقل نیازمندی از Python 3.7 به Python 3.10 بهروزرسانی شد.
در صورت نیاز، از یک مدیر بسته برای دانلود و نصب Python 3 استفاده کنید.
آخرین نسخهٔ Python 3 را دانلود کنید و نصب کنید.
در حین نصب، گزینهٔ Add Python 3 to PATH را علامت بزنید، سپس روی سفارشیسازی نصب کلیک کنید و مطمئن شوید pip علامت خورده است.
توجه
اگر Python 3 از قبل نصب است، مطمئن شوید که نسخهٔ آن 3.10 یا بالاتر است، زیرا نسخههای قبلی با Odoo سازگار نیستند.
$ python3 --version
C:\> python --version
$ python3 --version
تأیید کنید که pip نیز برای این نسخه نصب شده است.
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
Odoo از PostgreSQL بهعنوان سامانهٔ مدیریت پایگاه دادهٔ خود استفاده میکند.
تغییر داده شده در نسخه 19: حداقل نیازمندی از PostgreSQL 12 به PostgreSQL 13 بهروزرسانی شد.
از یک مدیر بسته برای دانلود و نصب PostgreSQL (نسخههای پشتیبانیشده: 13.0 یا بالاتر) استفاده کنید. این کار با اجرای دستور زیر قابل انجام است:
$ sudo apt install postgresql postgresql-client
PostgreSQL را دانلود کنید (نسخههای پشتیبانیشده: 13.0 یا بالاتر) و نصب کنید.
از Postgres.app برای دانلود و نصب PostgreSQL (نسخهٔ پشتیبانیشده: 13.0 یا بالاتر) استفاده کنید.
نکته
برای در دسترس قرار دادن command line toolهای همراه Postgres.app، حتماً متغیر $PATH را با دنبال کردن دستورالعملهای CLI tools Postgres.app تنظیم کنید.
بهصورت پیشفرض، تنها کاربر postgres است. از آنجا که Odoo اتصال بهعنوان postgres را ممنوع میکند، یک کاربر جدید PostgreSQL ایجاد کنید.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
توجه
از آنجا که کاربر PostgreSQL همان نام ورود Unix را دارد، میتوان بدون رمز عبور به پایگاه داده متصل شد.
دایرکتوری
binمربوط به PostgreSQL (بهصورت پیشفرض:C:\Program Files\PostgreSQL\<version>\bin) را بهPATHاضافه کنید.با استفاده از gui pg admin، یک کاربر postgres با رمز عبور ایجاد کنید:
pgAdmin را باز کنید.
روی سرور دوبار کلیک کنید تا یک اتصال ایجاد شود.
را انتخاب کنید.
نام کاربری را در فیلد Role Name وارد کنید (مثلاً
odoo).تب Definition را باز کنید، یک رمز عبور وارد کنید (مثلاً
odoo) و روی Save کلیک کنید.تب Privileges را باز کنید و Can login? را به
Yesو Create database? را بهYesتغییر دهید.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
توجه
از آنجا که کاربر PostgreSQL همان نام ورود Unix را دارد، میتوان بدون رمز عبور به پایگاه داده متصل شد.
وابستگیها¶
استفاده از بستههای توزیع روش ترجیحی برای نصب وابستگیها است. بهصورت جایگزین، وابستگیهای Python را با pip نصب کنید.
در Debian/Ubuntu، دستورات زیر باید بستههای موردنیاز را نصب کنند:
$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh
اسکریپت setup/debinstall.sh فایل debian/control را parse میکند و بستههای یافتشده را نصب میکند.
هشدار
استفاده از pip ممکن است منجر به مشکلات امنیتی و وابستگیهای شکسته شود؛ تنها در صورتی این کار را انجام دهید که میدانید چه میکنید.
از آنجا که برخی از بستههای Python نیازمند یک مرحلهٔ کامپایل هستند، نصب کتابخانههای سیستم برای آنها لازم است.
در Debian/Ubuntu، دستور زیر باید این کتابخانههای موردنیاز را نصب کند:
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
وابستگیهای Odoo در فایل requirements.txt که در ریشهٔ دایرکتوری Odoo Community قرار دارد فهرست شدهاند.
توجه
بستههای Python در requirements.txt بر اساس نسخهٔ متناظر stable/LTS Debian/Ubuntu آنها در زمان انتشار Odoo هستند. برای مثال، برای Odoo 15.0، بستهٔ python3-babel.
نکته
ممکن است ترجیح دهید بستههای ماژول Python را بین نمونههای مختلف Odoo یا با سیستم mix نکنید. با این حال، میتوان از virtualenv برای ایجاد محیطهای ایزوله استفاده کرد.
به مسیر نصب Odoo Community (CommunityPath) بروید و pip را روی فایل requirements اجرا کنید تا الزامات برای کاربر فعلی نصب شوند.
$ cd /CommunityPath
$ pip install -r requirements.txt
پیش از نصب وابستگیها، Build Tools for Visual Studio را دانلود و نصب کنید. C++ ساخت tools را در تب Workloads انتخاب کنید و نصب کنید.
وابستگیهای Odoo در فایل requirements.txt که در ریشهٔ دایرکتوری Odoo Community قرار دارد فهرست شدهاند.
نکته
ممکن است ترجیح دهید بستههای ماژول Python را بین نمونههای مختلف Odoo یا با سیستم mix نکنید. با این حال، میتوان از virtualenv برای ایجاد محیطهای ایزوله استفاده کرد.
به مسیر نصب Odoo Community (CommunityPath) بروید و pip را روی فایل requirements در یک ترمینال با مجوزهای Administrator اجرا کنید:
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
وابستگیهای Odoo در فایل requirements.txt که در ریشهٔ دایرکتوری Odoo Community قرار دارد فهرست شدهاند.
نکته
ممکن است ترجیح دهید بستههای ماژول Python را بین نمونههای مختلف Odoo یا با سیستم mix نکنید. با این حال، میتوان از virtualenv برای ایجاد محیطهای ایزوله استفاده کرد.
به مسیر نصب Odoo Community (CommunityPath) بروید و pip را روی فایل requirements اجرا کنید:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
توجه
برای زبانهایی که از رابط راستبهچپ استفاده میکنند (مانند عربی یا عبری)، بستهٔ rtlcss لازم است.
nodejs و npm را با یک مدیر بسته دانلود و نصب کنید.
نصب
rtlcss:$ sudo npm install -g rtlcss
nodejs را دانلود و نصب کنید.
نصب
rtlcss:C:\> npm install -g rtlcssمتغیر محیط سیستم
PATHرا ویرایش کنید تا پوشهای کهrtlcss.cmdدر آن قرار دارد را اضافه کنید (معمولاً:C:\Users\<user>\AppData\Roaming\npm\).
هشدار
wkhtmltopdf از طریق pip نصب نمیشود و باید بهصورت دستی در نسخهٔ 0.12.6 نصب شود تا از سرصفحهها و پاصفحهها پشتیبانی کند. برای جزئیات بیشتر دربارهٔ نسخههای مختلف، ویکی wkhtmltopdf را ببینید.
اجرای Odoo¶
پس از تنظیم تمام وابستگیها، میتوان Odoo را با اجرای odoo-bin، رابط command-line سرور، راهاندازی کرد. در ریشهٔ دایرکتوری Odoo Community قرار دارد.
برای پیکربندی سرور، یا command-line arguments یا یک configuration file را مشخص کنید.
نکته
برای ویرایش Enterprise، مسیر add-onهای enterprise را به آرگومان addons-path اضافه کنید. توجه داشته باشید که باید پیش از سایر مسیرها در addons-path بیاید تا add-onها بهدرستی بارگذاری شوند.
پیکربندیهای ضروری رایج عبارتاند از:
کاربر و رمز عبور PostgreSQL.
مسیرهای addon سفارشی فراتر از مقادیر پیشفرض برای بارگذاری ماژولهای سفارشی.
یک روش معمول برای اجرای سرور به این شکل است:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
که CommunityPath مسیر نصب Odoo Community و mydb نام پایگاه دادهٔ PostgreSQL است.
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
که CommunityPath مسیر نصب Odoo Community، dbuser login PostgreSQL، dbpassword رمز عبور PostgreSQL، و mydb نام پایگاه دادهٔ PostgreSQL است.
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
که CommunityPath مسیر نصب Odoo Community و mydb نام پایگاه دادهٔ PostgreSQL است.
پس از راهاندازی سرور (لاگ INFO odoo.modules.loading: Modules loaded. چاپ میشود)، http://localhost:8069 را در یک مرورگر وب باز کنید و با حساب administrator پایه به پایگاه دادهٔ Odoo وارد شوید.
نکته
همچنین ببینید