مهام صيانة OpenLDAP

الإصدار 4.17.01 من Edge for Private Cloud

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

تتوفّر ملفات سجلّ 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. عدِّل Management Server لاستخدام كلمة المرور الجديدة:
    > /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 -F /opt/apigee/apigee-openldap/var/run -d 255

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

تحديد مشاكل النسخ المتماثل في 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.