تثبيت المصدر¶
لا يتعلق "تثبيت" المصدر بتثبيت أودو، بل بتشغيله مباشرةً من المصدر عوضاً عن ذلك.
يمكن أن يكون استخدام مصدر أودو أكثر ملاءمة لمطوري التطبيقات حيث يسهل الوصول إليه أكثر من استخدام أدوات التثبيت المجمعة.
إنه يجعل من عمليتَي تشغيل وإيقاف أودو أكثر مرونة ووضوحاً من الخدمات التي تم إعدادها بواسطة أدوات التثبيت المجمعة. كما أنه يسمح بتجاوز الإعدادات باستخدام معايير بند الأمر دون الحاجة إلى تحرير ملف التهيئة.
وأخيراً، إنه يوفر تحكماً أكبر في إعداد النظام ويسمح بالاحتفاظ (وتشغيل) إصدارات متعددة من أودو جنباً إلى جنب بسهولة أكبر.
إحضار الموارد¶
هناك طريقتان للحصول على الكود المصدري لأودو: كملف 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 18.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 18.0 --single-branch https://github.com/odoo/enterprise.git
$ git clone --branch 18.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 18.0 --single-branch git@github.com:odoo/enterprise.git
C:\> git clone --branch 18.0 --single-branch https://github.com/odoo/odoo.git
C:\> git clone --branch 18.0 --single-branch https://github.com/odoo/enterprise.git
C:\> git clone --branch 18.0 --single-branch git@github.com:odoo/odoo.git
C:\> git clone --branch 18.0 --single-branch git@github.com:odoo/enterprise.git
$ git clone --branch 18.0 --single-branch https://github.com/odoo/odoo.git
$ git clone --branch 18.0 --single-branch https://github.com/odoo/enterprise.git
$ git clone --branch 18.0 --single-branch git@github.com:odoo/odoo.git
$ git clone --branch 18.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 وتثبيته.
أثناء عملية التثبيت، قم بتحديد خيار إضافة Python 3 إلى PATH، ثم اضغط على تخصيص عملية التثبيت وتأكد من أن خيار pip محدد.
ملاحظة
إذا كان Python 3 مثبتاً بالفعل، فتأكد من أن الإصدار هو 3.10 أو أحدث، لأن الإصدارات السابقة غير متوافقة مع أودو.
$ python3 --version
C:\> python --version
$ python3 --version
تأكد من أن pip مثبت أيضاً لهذا الإصدار.
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
يستخدم أودو PostgreSQL كنظام لإدارة قواعد البيانات.
استخدم مدير الحزم لتنزيل PostgreSQL وتثبيته (الإصدارات المدعومة: 12.0 أو أحدث). يمكن تحقيق ذلك عن طريق تنفيذ ما يلي:
$ sudo apt install postgresql postgresql-client
قم بتنزيل PostgreSQL (الإصدارات المدعومة: 12.0 أو أحدث) وقم بتثبيته.
استخدم Postgres.app لتنزيل PostgreSQL وتثبيته (الإصدار المدعوم: 12.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:
قم بفتح pgAdmin.
قم بالضغط مرتين على الخادم لإنشاء اتصال.
قم بتحديد .
أدخل اسم المستخدم في الحقل اسم الدور (على سبيل المثال،
odoo).قم بفتح علامة تبويب التعريف، وأدخل كلمة المرور (على سبيل المثال،
odoo)، واضغط على حفظ.قم بفتح علامة تبويب الامتيازات وقم بتبديل هل يمكن تسجيل الدخول؟ إلى
نعمو إنشاء قاعدة بيانات؟ إلىنعم.
$ 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 وتثبيت الباقات التي تم العثور عليها.
تحذير
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
ملاحظة
بالنسبة للغات التي تستخدم واجهة من اليمين إلى اليسار (مثل العربية أو العبرية)، تكون الحزمة 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"، وهي واجهة بند الأوامر للخادم. وهو موجود في جذر دليل مجتمع أودو.
لتهيئة الخادم، حدد إما وسائط بند الأوامر أو ملف التهيئة.
نصيحة
بالنسبة لإصدار أودو للمؤسسات، أضف المسار إلى الوظائف الإضافية أودو للمؤسسات إلى الوسيطة 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.
انظر أيضًا