نصب از منبع¶
منبع «نصب» مربوط به نصب اودو نیست، بلکه اجرای مستقیم آن از منبع است.
استفاده از منبع Odoo می‌تواند برای توسعه‌دهندگان ماژول راحت‌تر باشد، زیرا دسترسی به آن نسبت به استفاده از نصب‌کننده‌های بسته‌بندی‌شده آسان‌تر است.
این امر شروع و توقف Odoo را انعطاف‌پذیرتر و واضح‌تر از خدمات تنظیم‌شده توسط نصب‌کننده‌های بسته‌بندی شده می‌کند. همچنین، امکان تغییر تنظیمات با استفاده از پارامترهای خط فرمان را بدون نیاز به ویرایش فایل پیکربندی فراهم می‌کند.
در نهایت، کنترل بیشتری بر تنظیمات سیستم فراهم می‌کند و امکان نگهداری (و اجرای) نسخه‌های متعدد از Odoo به‌صورت هم‌زمان را آسان‌تر می‌سازد.
دریافت منابع¶
دو روش برای دریافت کد منبع اودوو وجود دارد: به صورت فایل فشرده ZIP یا از طریق Git.
بایگانی¶
نسخه جامعه:
صفحه دانلود اودو <https://www.odoo.com/page/download>`_
مخزن جامعه گیت‌هاب <https://github.com/odoo/odoo>
سرور شبانه <https://nightly.odoo.com>
نسخه سازمانی:
صفحه دانلود اودو <https://www.odoo.com/page/download>`_
مخزن GitHub Enterprise <https://github.com/odoo/enterprise>`_
گیت¶
توجه
نصب Git ضروری است و توصیه می‌شود که دانش پایه‌ای از دستورات Git داشته باشید تا بتوانید ادامه دهید.
برای کلون کردن یک مخزن Git، بین کلون کردن با HTTPS یا SSH انتخاب کنید. در بیشتر موارد، گزینه بهتر HTTPS است. با این حال، برای مشارکت در کد منبع Odoo یا هنگام دنبال کردن آموزش شروع به کار توسعه‌دهنده، SSH را انتخاب کنید.
$ 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
توجه
مخزن گیت نسخه Enterprise شامل کد منبع کامل Odoo نیست. این مخزن تنها مجموعه‌ای از افزونه‌های اضافی است. کد اصلی سرور در نسخه Community قرار دارد. اجرای نسخه Enterprise به این معناست که سرور نسخه Community با گزینه addons-path تنظیم شده به پوشه‌ای که نسخه Enterprise در آن قرار دارد، اجرا شود. برای داشتن یک نصب کاری از Odoo Enterprise، لازم است که هر دو مخزن Community و Enterprise کلون شوند.
آماده کردن¶
پایتون¶
اودو برای اجرا به پایتون 3.10 یا نسخه‌های جدیدتر نیاز دارد.
تغییر داده شده در نسخه 17: حداقل نیازمندی از Python 3.7 به Python 3.10 به‌روزرسانی شد.
از یک مدیر بسته برای دانلود و نصب پایتون ۳ در صورت نیاز استفاده کنید.
آخرین نسخه Python 3 را از <https://www.python.org/downloads/windows/> دانلود و نصب کنید.
در هنگام نصب، گزینه افزودن Python 3 به PATH را انتخاب کنید، سپس روی نصب سفارشی کلیک کنید و مطمئن شوید که گزینه pip انتخاب شده است.
توجه
اگر Python 3 از قبل نصب شده است، مطمئن شوید که نسخه آن 3.10 یا بالاتر باشد، زیرا نسخه‌های قبلی با Odoo سازگار نیستند.
$ python3 --version
C:\> python --version
$ python3 --version
تأیید کنید که pip نیز برای این نسخه نصب شده است.
$ pip3 --version
C:\> pip --version
$ pip3 --version
پستگرس‌کیوال¶
اودوو از PostgreSQL به عنوان سیستم مدیریت پایگاه داده خود استفاده می‌کند.
از یک مدیر بسته برای دانلود و نصب PostgreSQL (نسخه‌های پشتیبانی‌شده: 12.0 یا بالاتر) استفاده کنید. این کار را می‌توان با اجرای دستور زیر انجام داد:
$ sudo apt install postgresql postgresql-client
PostgreSQL (نسخه‌های پشتیبانی‌شده: 12.0 یا بالاتر) را دانلود و نصب کنید.
از Postgres.app برای دانلود و نصب PostgreSQL (نسخه‌های پشتیبانی‌شده: 12.0 یا بالاتر) استفاده کنید.
نکته
برای در دسترس قرار دادن ابزارهای خط فرمان همراه با Postgres.app، مطمئن شوید که متغیر $PATH را با دنبال کردن دستورالعمل‌های ابزارهای CLI Postgres.app تنظیم کرده‌اید <https://postgresapp.com/documentation/cli-tools.html>.
به صورت پیش‌فرض، تنها کاربر موجود postgres است. از آنجا که Odoo اتصال به عنوان postgres را ممنوع می‌کند، یک کاربر جدید برای PostgreSQL ایجاد کنید.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
توجه
از آنجا که کاربر PostgreSQL همان نام ورود به سیستم یونیکس را دارد، امکان اتصال به پایگاه داده بدون رمز عبور وجود دارد.
دایرکتوری
binمربوط به PostgreSQL (به طور پیش‌فرض:C:\Program Files\PostgreSQL\<version>\bin) را به متغیرPATHاضافه کنید.ایجاد یک کاربر پستگرس با رمز عبور با استفاده از رابط گرافیکی pg admin:
pgAdmin را باز کنید.
برای ایجاد اتصال، روی سرور دوبار کلیک کنید.
انتخاب کنید: .
نام کاربری را در قسمت نام نقش وارد کنید (مثلاً
odoo).زبانه تعریف را باز کنید، یک رمز عبور وارد کنید (مثلاً
odoo) و روی ذخیره کلیک کنید.زبانه امتیازات را باز کنید و گزینه امکان ورود؟ را به
بلهو ایجاد پایگاه داده؟ را بهبلهتغییر دهید.
$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER
توجه
از آنجا که کاربر PostgreSQL همان نام ورود به سیستم یونیکس را دارد، امکان اتصال به پایگاه داده بدون رمز عبور وجود دارد.
وابستگی‌ها¶
استفاده از بسته‌های توزیع روش ترجیحی برای نصب وابستگی‌ها است. به‌طور جایگزین، وابستگی‌های پایتون را با pip نصب کنید.
در Debian/Ubuntu، دستورات زیر باید بسته‌های مورد نیاز را نصب کنند:
$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh
اسکریپت setup/debinstall.sh فایل debian/control را تجزیه کرده و بسته‌های یافت‌شده را نصب می‌کند.
هشدار
استفاده از pip ممکن است منجر به مشکلات امنیتی و وابستگی‌های خراب شود؛ فقط در صورتی این کار را انجام دهید که بدانید چه می‌کنید.
از آنجا که برخی از بسته‌های پایتون نیاز به مرحله کامپایل دارند، به نصب کتابخانه‌های سیستمی نیاز دارند.
در Debian/Ubuntu، دستور زیر باید این کتابخانه‌های مورد نیاز را نصب کند:
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
وابستگی‌های Odoo در فایل requirements.txt که در ریشه‌ی دایرکتوری Odoo Community قرار دارد، فهرست شده‌اند.
توجه
بسته‌های پایتون در فایل requirements.txt بر اساس نسخه پایدار/LTS متناظر با Debian/Ubuntu در زمان انتشار Odoo انتخاب شده‌اند. به عنوان مثال، برای Odoo 15.0، نسخه بسته python3-babel در Debian Bullseye برابر با 2.8.0 و در Ubuntu Focal برابر با 2.6.0 است. سپس پایین‌ترین نسخه در فایل requirements.txt انتخاب می‌شود.
نکته
ممکن است ترجیح داده شود که بسته‌های ماژول پایتون بین نمونه‌های مختلف Odoo یا با سیستم مخلوط نشوند. با این حال، می‌توان از virtualenv برای ایجاد محیط‌های ایزوله پایتون استفاده کرد.
به مسیر نصب Odoo Community (CommunityPath) بروید و با استفاده از دستور pip فایل نیازمندی‌ها را اجرا کنید تا نیازمندی‌ها برای کاربر فعلی نصب شوند.
$ cd /CommunityPath
$ pip install -r requirements.txt
قبل از نصب وابستگی‌ها، ابزارهای ساخت برای ویژوال استودیو را دانلود و نصب کنید. در تب Workloads گزینه ابزارهای ساخت C++ را انتخاب کرده و در صورت درخواست، آنها را نصب کنید.
وابستگی‌های Odoo در فایل requirements.txt که در ریشه دایرکتوری Odoo Community قرار دارد، فهرست شده‌اند.
نکته
ممکن است ترجیح داده شود که بسته‌های ماژول پایتون بین نمونه‌های مختلف Odoo یا با سیستم مخلوط نشوند. با این حال، می‌توان از virtualenv برای ایجاد محیط‌های ایزوله پایتون استفاده کرد.
به مسیر نصب Odoo Community (CommunityPath) بروید و pip را بر روی فایل نیازمندی‌ها در یک ترمینال با دسترسی مدیر اجرا کنید:
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
وابستگی‌های Odoo در فایل requirements.txt که در ریشه دایرکتوری Odoo Community قرار دارد، فهرست شده‌اند.
نکته
ممکن است ترجیح داده شود که بسته‌های ماژول پایتون بین نمونه‌های مختلف Odoo یا با سیستم مخلوط نشوند. با این حال، می‌توان از virtualenv برای ایجاد محیط‌های ایزوله پایتون استفاده کرد.
به مسیر نصب اودو کامیونیتی (CommunityPath) بروید و pip را بر روی فایل نیازمندی‌ها اجرا کنید:
$ 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 wiki مراجعه کنید.
اجرای اودوو¶
پس از تنظیم تمام وابستگی‌ها، اودو را می‌توان با اجرای odoo-bin، رابط خط فرمان سرور، راه‌اندازی کرد. این فایل در ریشه دایرکتوری اودو کامیونیتی قرار دارد.
برای پیکربندی سرور، یا از آرگومان‌های خط فرمان استفاده کنید یا یک فایل پیکربندی مشخص کنید.
نکته
برای نسخه Enterprise، مسیر افزونه‌های enterprise را به آرگومان addons-path اضافه کنید. توجه داشته باشید که این مسیر باید قبل از مسیرهای دیگر در addons-path قرار گیرد تا افزونه‌ها به درستی بارگذاری شوند.
پیکربندی‌های ضروری معمول عبارتند از:
کاربر و رمز عبور PostgreSQL.
مسیرهای افزونه سفارشی فراتر از پیش‌فرض‌ها برای بارگذاری ماژول‌های سفارشی.
یک روش معمول برای اجرای سرور به این صورت خواهد بود:
$ 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 نام کاربری ورود به 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 را در مرورگر وب باز کنید و با حساب کاربری مدیر اصلی وارد پایگاه داده Odoo شوید: از admin به‌عنوان ایمیل و دوباره از admin به‌عنوان رمز عبور استفاده کنید.
نکته
از آنجا، کاربران جدید را ایجاد و مدیریت کنید.
حساب کاربری که برای ورود به رابط وب اودو استفاده می‌شود با آرگومان CLI
--db_userمتفاوت است.
همچنین ببینید