مهام صيانة OpenLDAP

Edge for Private Cloud الإصدار 4.19.01

موقع ملف السجلّ

تتوفّر ملفات سجلّ OpenLDAP في الدليل /opt/apigee/var/log. يمكن أرشفة هذه الملفات وإزالتها بشكل دوري لضمان عدم استهلاكها مساحة كبيرة على القرص. يمكن العثور على معلومات حول صيانة سجلات OpenLDAP وأرشفتها وإزالتها في القسم 19.2 من دليل OpenLDAP على الرابط http://www.openldap.org/doc/admin24/maintenance.html.

ضبط كلمة مرور المستخدم يدويًا

يمكن للمستخدمين طلب كلمة مرور جديدة لـ Edge في واجهة مستخدم Edge. يتلقّى المستخدم بعد ذلك رسالة إلكترونية تتضمّن معلومات حول ضبط كلمة مرور. ومع ذلك، إذا كان خادم SMTP معطّلاً أو لم يتمكّن المستخدم من تلقّي رسالة إلكترونية لأي سبب، يمكنك ضبط كلمة مرور المستخدم يدويًا باستخدام أوامر OpenLDAP.

لضبط كلمة مرور مستخدم:

  1. استخدِم ldapsearch لتنزيل معلومات المستخدم: 
    ldapsearch -w ldapAdminPWord -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389 > ldap.txt
  2. ابحث في ملف ldap.txt عن عنوان البريد الإلكتروني للمستخدم. من المفترض أن يظهر لك قسم بالشكل التالي: 
    dn: uid=29383a67-9279-4aa8-a75b-cfbf901578fc,ou=users,ou=global,dc=apigee,dc=com
mail: foo@bar.com
userPassword:: e1NTSEF9a01UUDdSd01BYXRuUURXdXN5OWNPRzBEWWlYZFBRTm14MHlNVWc9PQ==
uid: 29383a67-9279-4aa8-a75b-cfbf901578fc
  3. استخدِم ldappasswd لضبط كلمة مرور المستخدم استنادًا إلى معرّف المستخدم: 
    ldappasswd -h LDAP_IP -p 10389 -D "cn=manager,dc=apigee,dc=com" -W -s newPassWord \
  "uid=29383a67-9279-4aa8-a75b-cfbf901578fc,ou=users,ou=global,dc=apigee,dc=com"

    سيُطلب منك إدخال كلمة مرور مشرف OpenLDAP.

يمكن للمستخدم الآن تسجيل الدخول باستخدام newPassWord.

ضبط كلمة مرور نظام OpenLDAP يدويًا

إعادة ضبط كلمات مرور Edge توضّح كيفية تغيير كلمة مرور نظام OpenLDAP، ولكنها تتطلّب معرفة كلمة المرور الحالية. إذا فقدت كلمة المرور هذه، يمكنك استخدام الإجراء التالي لإعادة ضبطها.

  1. استخدِم slappasswd لإنشاء كلمة مرور مشفّرة باستخدام SSHA لكلمة مرور جديدة: 
    slappasswd -h {SSHA} -s newPassWord

    يعرض هذا الأمر سلسلة بالشكل التالي: 

    {SSHA}+DOup9d6l+czfWzkIvajwYPArjPurhS6
  2. افتح ملف /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif في محرِّر: 
    vi /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif
  3. ابحث عن السطر في النموذج: 
    olcRootPW:: OldPasswordString
  4. استبدِل OldPasswordString بالسلسلة التي تم عرضها من slappasswd. إذا كانت هناك نقطتان بعد olcRootPw، أزِل واحدة وتأكَّد من وجود مسافة بعد النقطتين: 
    olcRootPW: {SSHA}RGon+bLCe+Sk+HyHholFBj8ONQfabrhw
  5. أعِد تشغيل OpenLDAP: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restart
  6. تحقَّق من عمل كلمة المرور الجديدة باستخدام ldapsearch: 
    ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389

    سيُطلب منك إدخال كلمة مرور مشرف OpenLDAP.

  7. كرِّر هذه الخطوات على أي خوادم OpenLDAP أخرى يتم استخدامها للنسخ المتماثل.
  8. عدِّل خادم الإدارة لاستخدام كلمة المرور الجديدة: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p newPassWord

ضبط كلمة مرور مشرف Edge يدويًا

إعادة ضبط كلمات مرور Edge توضّح كيفية تغيير كلمة مرور نظام Edge، ولكنها تتطلب معرفة كلمة المرور الحالية. إذا فقدت كلمة مرور نظام Edge، يمكنك استخدام الإجراء التالي لإعادة ضبطها.

  1. في عقدة واجهة المستخدم، أوقِف واجهة مستخدم Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui stop
  2. استخدِم ldappasswd لضبط كلمة مرور مشرف نظام Edge: 
    ldappasswd -h localhost -p 10389 -D "cn=manager,dc=apigee,dc=com" -W -s newPassWord \
  "uid=admin,ou=users,ou=global,dc=apigee,dc=com"

    سيُطلب منك إدخال كلمة مرور مشرف OpenLDAP.

  3. عدِّل ملف الإعداد الذي استخدمته لتثبيت واجهة مستخدم Edge باستخدام كلمة مرور نظام Edge الجديدة: 
    APIGEE_ADMINPW=newPassWord
  4. اضبط واجهة مستخدم Edge وأعِد تشغيلها: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
  5. (فقط في حال تفعيل بروتوكول أمان طبقة النقل (TLS) في واجهة المستخدم) أعِد تفعيل بروتوكول أمان طبقة النقل (TLS) في واجهة مستخدم Edge كما هو موضّح في ضبط بروتوكول أمان طبقة النقل (TLS) لواجهة مستخدم الإدارة.

حذف ملف قفل SLAPD

إذا ظهرت لك رسالة خطأ عند محاولة بدء OpenLDAP تفيد بأنّ ملف القفل slapd.pid موجود، يمكنك حذف الملف.

يتوفّر الملف في /opt/apigee/apigee-openldap/var/run/slapd.pid. احذف الملف وحاوِل إعادة تشغيل OpenLDAP:

/opt/apigee/apigee-service/bin/apigee-service apigee-openldap restart

إذا لم يبدأ OpenLDAP، جرِّب بدء تشغيله في وضع تصحيح الأخطاء وابحث عن الأخطاء:

slapd -h ldap://:10389/ -u apigee -d 255 -F /opt/apigee/data/apigee-openldap/slapd.d

قد تشير الأخطاء إلى مشاكل في الموارد أو الذاكرة أو استخدام وحدة المعالجة المركزية.

تحديد مشاكل النسخ المتماثل في OpenLDAP وحلّها

إذا كان التثبيت يستخدم عدة خوادم OpenLDAP، يمكنك التحقّق من إعدادات النسخ المتماثل للتأكّد من أنّ الخوادم تعمل بشكل صحيح.

  1. تأكَّد من أنّ ldapsearch يعرض البيانات من كل خادم OpenLDAP: 
    ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389

    سيُطلب منك إدخال كلمة مرور مشرف OpenLDAP.

  2. تحقَّق من إعدادات النسخ المتماثل من خلال فحص ملف /opt/apigee/conf/openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif.
  3. تأكَّد من أنّ كلمة مرور النظام هي نفسها على كل خادم OpenLDAP.
  4. تحقَّق من إعدادات iptables وtcp wrapper.