توثيق وحدة Simple SaaS لأودو

قبل البدء يرجى تجهيز هذه المتطلبات

• تأكد من امتلاكك صلاحيات root على خوادمك
• ثبّت إصدار أودو المطلوب على الخادم الرئيسي (Master) وخوادم العملاء (Slave)
• حمّل الوحدتين dx_saas_dbfilter وdx_users_modules_control

ينقسم هذا الدليل إلى جزأين

1. تثبيت الوحدة وإعدادها على خادم العملاء (Slave)
2. Install and configure module on master server
   

خادم العملاء (Slave)

حمّل الوحدة dx_users_modules_control واختر النسخة المناسبة لإصدار أودو لديك

1. فك ضغط الملف
2. Open extracted directory and open file  "config.json" with your favorite text editor
3. غيّر قيمة enabled إلى "True"، ويفضل نسخها كما هي لأنها حساسة لحالة الأحرف
4. غيّر قيمة backend إلى رابط أودو على الخادم الرئيسي
5. احفظ الملف وأعد ضغط المجلد

تجهيز المتطلبات

1. ثبّت nginx (apt/yum install nginx)
2. ارفع الوحدة المعدّلة "dx_users_modules_control" إلى مجلد الإضافات (addons) في تثبيت أودو الخاص بك
3. أضف هذا المعامل إلى ملف إعدادات أودو (dbfilter = ^%h)
4. أعد تشغيل خدمة أودو

خطوة اختيارية

إذا كنت تخطط لاستخدام شهادات Let's Encrypt فثبّت هذه الحزمة

wget -O - https://get.acme.sh | sh

بعد ذلك

 

/root/.acme.sh/acme.sh --set-default-ca --server letsencrypt

الخادم الرئيسي (Master)

تجهيز المتطلبات

1. ثبّت حزمة Python المسماة paramiko (pip install paramiko)
2. ثبّت curl (apt/yum install curl)
3. ارفع الوحدة (dx_saas_dbfilter) إلى مجلد الإضافات (addons) في تثبيت أودو الخاص بك
4. أعد تشغيل خدمة أودو

تثبيت الوحدة

1. فعّل وضع المطوّر: اذهب إلى الإعدادات وانزل لأسفل ثم اضغط تفعيل وضع المطوّر
2. Go to Apps menu and press Update Apps List Then press Update
3.  ابحث عن "dx_saas_dbfilter" ثم اضغط تفعيل/تثبيت
4. بعد تثبيت الوحدة، امنح المستخدم الصلاحيات اللازمة لإدارة وحدة SaaS

إعداد الوحدة

بعد تثبيت الوحدة بنجاح والحصول على الصلاحيات اللازمة، حدّث الصفحة لتظهر الوحدة الجديدة

 1- افتح قائمة الوحدة

2- إعداد خيارات الوحدة

اذهب إلى >> الإعدادات/الخيارات

1. قائمة الإعدادات
2. فترة السماح بعد انتهاء الاشتراك 
3. تفعيل إنشاء شهادة SSL تلقائيًا لخدمات SaaS التي تُشترى من الموقع
4. بداية النطاق للاشتراكات الجديدة المشتراة من الموقع، إذا كان اسم الشركة أو المستخدم المسجل بغير الحروف اللاتينية

3- إعداد الإصدارات

اذهب إلى >> الإعدادات/إصدارات أودو

أنشئ سجلًا جديدًا لكل إصدار

1. قائمة إصدارات أودو
2. رقم الإصدار

4- إعداد الوحدات

أضف أسماء الوحدات لتجمعها في باقات بعد ذلك

اذهب إلى >> الإعدادات/الوحدات

أنشئ سجلًا جديدًا لكل وحدة

1. قائمة الوحدات
2. الاسم التقني للوحدة التي تريد تثبيتها على قواعد بيانات عملائك
3. وصف الوحدة

5- إعداد الباقات

This helps you organize your modules in packages to sell it easily

اذهب إلى >> الإعدادات/الباقات

أنشئ سجلًا جديدًا لكل باقة

1.  قائمة الباقات
2. اسم الباقة
3. الوحدات المشمولة في هذه الباقة

أضف أول خادم

اذهب إلى >> قائمة الخوادم واضغط زر جديد لإنشاء خادم

1. قائمة الخوادم
2. زر التأكيد
3. اسم الخادم
4. بروتوكول الرابط
5. رابط الخادم بدون البروتوكول
   
6. كلمة مرور قاعدة البيانات الرئيسية (Master password) لهذا الخادم
7. منفذ HTTP العام
8. المنفذ المحلي لتثبيت أودو إذا كان يعمل خلف بروكسي مثل Nginx
9. منفذ Longpolling كما هو محدد في ملف إعدادات أودو
10. النطاق المستخدم للاشتراكات الجديدة على هذا الخادم
11. إصدار أودو
12. نوع أودو (Community أو Enterprise)
13. اسم مستخدم SSH
14. كلمة مرور SSH
15. منفذ SSH
16. دولة الخادم
17. منطقة الخادم
18. مسارات قواعد البيانات المخصصة إذا كنت تستخدم مسارات غير قياسية
19. مجلدات nginx المخصصة إذا كنت تستخدم مجلدات غير قياسية

أضف أول اشتراك لعميل

 اذهب إلى >> قائمة الاشتراكات واضغط زر جديد لإنشاء اشتراك

1. قائمة الاشتراكات
2. زر التأكيد
3. العميل
4. إنشاء الاشتراك على هذا الخادم
5. نطاق الاشتراك
6. الباقة
7. عدد المستخدمين
8. اسم الدخول: يُنشأ من بريد العميل، وإذا لم يوجد بريد يكون admin
9. كلمة المرور: كلمة مرور عشوائية
10. تاريخ البدء
11. تاريخ الانتهاء
12. إنشاء شهادة SSL
13. حالة الاشتراك

إنشاء قاعدة بيانات الاشتراك

بعد تأكيد الاشتراك تظهر أزرار جديدة

1. إنشاء قاعدة البيانات
2. إلغاء الاشتراك
3. حالة الاشتراك

تثبيت وحدات الاشتراك

بعد الضغط على إنشاء قاعدة البيانات، تُرسل عملية الإنشاء إلى خادم العملاء (Slave)

 وبعد إنشاء قاعدة البيانات تُثبّت الوحدات المحددة في الباقة تلقائيًا

وإذا فشلت أي خطوة يظهر زر لإعادة تنفيذ الخطوة التي فشلت

1. إيقاف قاعدة البيانات
2. تثبيت الوحدات على قاعدة بيانات العميل: يظهر هذا الزر إذا فشل التثبيت أثناء إنشاء قاعدة البيانات 
3. إلغاء الاشتراك: انتبه، هذا الإجراء لا يمكن التراجع عنه ويحذف قاعدة بيانات العميل
4. تنزيل نسخة احتياطية من قاعدة البيانات 
5. إرسال تفاصيل الاشتراك إلى العميل عبر البريد
6. حالة الاشتراك
7. سجل بالإجراء الذي فشل

إعادة تثبيت وحدات الاشتراك

بعد الضغط على تثبيت الوحدات تُسجّل رسالة نجاح ويختفي زر تثبيت الوحدات

إرسال التفاصيل إلى العميل

معالج لإرسال التفاصيل إلى بريد العميل