تثبيت المصدر¶

لا يتعلق "تثبيت" المصدر بتثبيت أودو، بل بتشغيله مباشرةً من المصدر عوضاً عن ذلك.

يمكن أن يكون استخدام مصدر أودو أكثر ملاءمة لمطوري التطبيقات حيث يسهل الوصول إليه أكثر من استخدام أدوات التثبيت المجمعة.

إنه يجعل من عمليتَي تشغيل وإيقاف أودو أكثر مرونة ووضوحاً من الخدمات التي تم إعدادها بواسطة أدوات التثبيت المجمعة. كما أنه يسمح بتجاوز الإعدادات باستخدام معايير بند الأمر دون الحاجة إلى تحرير ملف التهيئة.

وأخيراً، إنه يوفر تحكماً أكبر في إعداد النظام ويسمح بالاحتفاظ (وتشغيل) إصدارات متعددة من أودو جنباً إلى جنب بسهولة أكبر.

إحضار الموارد¶

هناك طريقتان للحصول على الكود المصدري لأودو: كملف ZIP أرشيف أو من خلال Git.

الأرشيف¶

إصدار أودو المجتمعي:

صفحة تنزيل أودو
` مستودع GitHub لأودو المجتمعي <https://github.com/odoo/odoo>`_
الخادم الليلي

إصدار أودو للمؤسسات

صفحة تنزيل أودو
` مستودع GitHub لإصدار أودو للمؤسسات <https://github.com/odoo/enterprise>`_

Git¶

ملاحظة

من الضروري تثبيت Git، ومن المستحسن أن تكون لديك معرفة أساسية بأوامر Git للمتابعة.

لاستنساخ مستودع Git، اختر بين الاستنساخ باستخدام HTTPS أو SSH. في معظم الحالات، الخيار الأفضل هو HTTPS. ومع ذلك، اختر 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 لإصدار أودو للمؤسسات على كود أودو المصدري الكامل. إنها مجرد مجموعة من المكونات الإضافية. كود الخادم الرئيسي موجود في إصدار أودو المجتمعي. إن تشغيل إصدار أودو للمؤسسات يعني تشغيل الخادم من إصدار أودو المجتمعي مع تعيين خيار "addons-path" على المجلد الذي يحتوي على إصدار أودو للمؤسسات. يلزم استنساخ مستودعات كلا الإصدارين أودو المجتمعي وأودو للمؤسسات حتى تتم عملية تثبيت إصدار أودو للمؤسسات بشكل فعال.

تجهيز¶

Python¶

يتطلب أودو إصدار Python 3.10 أو إصدار أحدث للتشغيل.

Changed in version 17: تم تحديث الحد الأدنى من المتطلبات من Python 3.7 إلى Python 3.10.

استخدم مدير الحزم لتنزيل وتثبيت Python 3 إذا لزم الأمر.

ملاحظة

إذا كان Python 3 مثبتاً بالفعل، فتأكد من أن الإصدار هو 3.10 أو أحدث، لأن الإصدارات السابقة غير متوافقة مع أودو.

$ python3 --version

C:\> python --version

$ python3 --version

تأكد من أن pip مثبت أيضاً لهذا الإصدار.

$ pip3 --version

C:\> pip --version

$ pip3 --version

PostgreSQL¶

يستخدم أودو PostgreSQL كنظام لإدارة قواعد البيانات.

Changed in version 19: تم تحديث الحد الأدنى من المتطلبات من PostgreSQL 12 إلى PostgreSQL 13.

استخدم مدير حزم لتنزيل وتثبيت PostgreSQL (الإصدارات المدعومة: 13.0 أو أعلى). يمكن تحقيق ذلك من خلال تنفيذ ما يلي:

$ sudo apt install postgresql postgresql-client

استخدم Postgres.app لتنزيل وتثبيت PostgreSQL (الإصدار المدعوم: 13.0 أو أعلى).

نصيحة

لجعل أدوات بند الأمر متاحة مع Postgres.app، تأكد من إعداد متغير $PATH عن طريق اتباع تعليمات أدوات Postgres.app CLI <https://postgresapp.com/documentation/cli-tools.html >`_.

افتراضياً، يكون المستخدم الوحيد هو postgres. نظراً لأن أودو يحظر الاتصال كـ "postgres"، قم بإنشاء مستخدم PostgreSQL جديد.

$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER

ملاحظة

نظراً لأن مستخدم PostgreSQL له نفس اسم تسجيل الدخول إلى Unix، فمن الممكن الاتصال بقاعدة البيانات دون كلمة مرور.

أضف دليل "bin" الخاص بـ PostgreSQL (افتراضياً C:\Program Files\PostgreSQL\<version>\bin) إلى PATH.
قم بإنشاء مستخدم postgres مع كلمة مرور باستخدام pg admin gui:
1. قم بفتح pgAdmin.
2. قم بالضغط مرتين على الخادم لإنشاء اتصال.
3. قم بتحديد كائن ‣ إنشاء ‣ تسجيل الدخول/دور المجموعة.
4. أدخل اسم المستخدم في الحقل اسم الدور (على سبيل المثال، odoo).
5. قم بفتح علامة تبويب التعريف، وأدخل كلمة المرور (على سبيل المثال، odoo)، واضغط على حفظ.
6. قم بفتح علامة تبويب الامتيازات وقم بتبديل هل يمكن تسجيل الدخول؟ إلى نعم و إنشاء قاعدة بيانات؟ إلى نعم.

$ sudo -u postgres createuser -d -R -S $USER
$ createdb $USER

ملاحظة

نظراً لأن مستخدم PostgreSQL له نفس اسم تسجيل الدخول إلى Unix، فمن الممكن الاتصال بقاعدة البيانات دون كلمة مرور.

ملاحظة

إذا كنت تريد استخدام ميزات الذكاء الاصطناعي من Odoo، فإن امتداد pg-vector لـ PostgreSQL مطلوب.

لاحظ أن pg-vector متاح فقط لإصدار PostgreSQL 15 وما فوق.

انتقل إلى مجلد الملفات المؤقتة
```
$ cd /tmp
```
استنسخ مستودع GitHub الخاص بـ `pg-vector:
```
$ git clone https://github.com/pgvector/pgvector.git
```
انتقل إلى الدليل:
```
$ cd pgvector
```
قم بتجميع الامتداد:
```
$ make
```
قم بتثبيت الامتداد:
```
$ sudo make install
```

إذا واجهت أي مشاكل أثناء التثبيت، تأكد من مراجعة ملاحظات التثبيت الرسمية.

انتقل إلى مجلد الملفات المؤقتة
```
$ cd /tmp
```
استنسخ مستودع GitHub الخاص بـ `pg-vector:
```
$ git clone https://github.com/pgvector/pgvector.git
```
انتقل إلى الدليل:
```
$ cd pgvector
```
قم بتجميع الامتداد:
```
$ make
```
قم بتثبيت الامتداد:
```
$ sudo make install
```

إذا واجهت أي مشاكل أثناء التثبيت، تأكد من مراجعة ملاحظات التثبيت الرسمية.

انتقل إلى مجلد الملفات المؤقتة
```
$ cd %TEMP%
```
استنسخ مستودع GitHub الخاص بـ `pg-vector:
```
$ git clone https://github.com/pgvector/pgvector.git
```
انتقل إلى الدليل:
```
$ cd pgvector
```
تأكد من تثبيت دعم C++ في Visual Studio وقم بتشغيل x64 Native Tools Command Prompt for VS [version] كمسؤول.

قم بتعيين متغير البيئة PGROOT الخاص بك:

$ set "PGROOT=C:\Program Files\PostgreSQL\[Your PostgreSQL Version]"

قم بتجميع الامتداد:
```
$ nmake /F Makefile.win
```
قم بتثبيت الامتداد:
```
$ nmake /F Makefile.win install
```

إذا واجهت أي مشاكل أثناء التثبيت، تأكد من التحقق من ملاحظات التثبيت الرسمية.

التبعيات¶

يعد استخدام حزم التوزيع الطريقة المفضلة لتثبيت التبعيات. عوضاً عن ذلك، قم بتثبيت تبعيات Python باستخدام pip.

في نظام Debian/Ubuntu، يجب أن تقوم الأوامر التالية بتثبيت الحزم المطلوبة:

$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh

سيقوم السكريبت setup/debinstall.sh بتحليل ملف debian/control وتثبيت الحزم الموجودة.

تحذير

Using pip may lead to security issues and broken dependencies; only do this if you know what you are doing.

نظراً لأن بعض حزم Python تحتاج إلى خطوة تجميع، فإنها تتطلب تثبيت مكتبات النظام.

في نظام Debian/Ubuntu، يجب أن يقوم الأمر التالي بتثبيت هذه المكتبات المطلوبة:

$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev

تم إدراج تبعيات أودو في ملف requirements.txt الموجود في جذر دليل مجتمع أودو.

ملاحظة

تعتمد حزم Python الموجودة في requirements.txt على الإصدار المستقر/LTS Debian/Ubuntu المقابل لها في وقت إصدار أودو. على سبيل المثال، بالنسبة لأودو 15.0، إصدار حزمة python3-babel هو 2.8.0 في Debian Bullseye و2.6.0 في Ubuntu Focal. يتم بعد ذلك اختيار الإصدار الأدنى في requirements.txt.

نصيحة

قد يكون من الأفضل عدم خلط حزم وحدات Python بين مثيلات مختلفة من أودو أو مع النظام. ومع ذلك، من الممكن استخدام virtualenv لإنشاء بيئات Python معزولة.

انتقل إلى مسار تثبيت مجتمع أودو (CommunityPath) وقم بتشغيل pip في ملف المتطلبات لتثبيت المتطلبات للمستخدم الحالي.

$ cd /CommunityPath
$ pip install -r requirements.txt

قبل تثبيت التبعيات، قم بتنزيل وتثبيت Build Tools for Visual Studio. قم بتحديد أدوات بناء C++ في علامة تبويب ضغط العمل وقم بتثبيتها عند المطالبة بذلك.

يتم إدراج تبعيات أودو في ملف "requirements.txt" الموجود في جذر دليل مجتمع أودو.

نصيحة
قد يكون من الأفضل عدم خلط حزم وحدات Python بين مثيلات مختلفة من أودو أو مع النظام. ومع ذلك، من الممكن استخدام virtualenv لإنشاء بيئات Python معزولة.

انتقل إلى مسار تثبيت مجتمع أودو (CommunityPath) وقم بتشغيل pip على ملف المتطلبات في الوحدة الطرفية مع امتيازات المسؤول:

C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt

يتم إدراج تبعيات أودو في ملف "requirements.txt" الموجود في جذر دليل مجتمع أودو.

نصيحة
قد يكون من الأفضل عدم خلط حزم وحدات Python بين مثيلات مختلفة من أودو أو مع النظام. ومع ذلك، من الممكن استخدام virtualenv لإنشاء بيئات Python معزولة.

انتقل إلى مسار تثبيت مجتمع أودو (CommunityPath) وقم بتشغيل pip في ملف المتطلبات:

$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt

تحذير

يجب تثبيت التبعيات لغير Python باستخدام مدير الحزم (Homebrew، MacPorts).

قم بتنزيل وتثبيت أدوات بند الأمر:
```
$ xcode-select --install
```
استخدم مدير الحزم لتثبيت التبعيات لغير Python.

ملاحظة

بالنسبة للغات التي تستخدم واجهة من اليمين إلى اليسار (مثل العربية أو العبرية)، تكون الحزمة 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\).

قم بتنزيل nodejs وتثبيته باستخدام مدير الحزم (Homebrew، MacPorts).
قم بتثبيت rtlcss:
```
$ sudo npm install -g rtlcss
```

تحذير

لم يتم تثبيت wkhtmltopdf من خلال pip ويجب تثبيته يدوياً في الإصدار 0.12.6 لذلك لدعم الترويسات والتذييلات. ألقِ نظرة على wkhtmltopdf wiki للمزيد من التفاصيل حول الإصدارات المختلفة.

تشغيل أودو¶

بمجرد أن قد تم إعداد كافة التبعيات، يمكن تشغيل أودو عن طريق تشغيل "odoo-bin"، وهي واجهة بند الأوامر للخادم. وهو موجود في جذر دليل مجتمع أودو.

لتهيئة الخادم، حدد إما وسائط بند الأوامر أو ملف التهيئة.

نصيحة

بالنسبة لإصدار أودو للمؤسسات، أضف المسار إلى الوظائف الإضافية أودو للمؤسسات إلى الوسيطة addons-path. لاحظ أنه يجب أن يأتي قبل المسارات الأخرى في "addons-path" حتى يتم تحميل الوظائف الإضافية بشكل صحيح.

من التهيئات الضرورية الشائعة:

اسم المستخدم وكلمة المرور لـ PostgreSQL
مسارات إضافية مخصصة تتجاوز الإعدادات الافتراضية لتحميل الوحدات المخصصة.

الطريقة النموذجية لتشغيل الخادم هي:

$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb

حيث CommunityPath هو مسار تثبيت مجتمع أودو، و`mydb` هو اسم قاعدة بيانات PostgreSQL.

C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb

حيث CommunityPath هو مسار تثبيت مجتمع أودو، و`dbuser` هو تسجيل دخول PostgreSQL، و`dbpassword` هو كلمة مرور PostgreSQL، و`mydb` هو اسم قاعدة بيانات PostgreSQL.

$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb

حيث CommunityPath هو مسار تثبيت مجتمع أودو، و`mydb` هو اسم قاعدة بيانات PostgreSQL.

بعد بدء تشغيل الخادم (تتم طباعة سجل المعلومات odoo.modules.loading: التطبيقات المحملة.)، قم بفتح http://localhost:8069 في متصفح الويب وسجل الدخول إلى قاعدة بيانات أودو باستخدام حساب المدير الأساسي: استخدم كلمة admin كالبريد الإلكتروني، ونفس كلمة admin ككلمة المرور.

نصيحة

من هناك، قم بإنشاء وإدارة المستخدمين الجدد.
يختلف حساب المستخدِم المستخدَم لتسجيل الدخول إلى واجهة الويب الخاصة بأودو عن وسيطة CLI --db_user.

انظر أيضًا

قائمة وسيطات CLI لـ odoo-bin

التحرير على GitHub