مهام صيانة OpenLDAP

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

تتوفّر ملفات سجلّ 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.

نفِّذ الخطوات الواردة في الإجراء التالي على عقدة النسخ المتماثل في OpenLDAP، والتي تنسخ بياناتها إلى عقدة OpenLDAP الأخرى. على سبيل المثال، إذا كنت بصدد إعداد النسخ المتماثل من node1 إلى node2، شغِّل الأوامر على node1.

1. التحقّق من الحالة الحالية:

   ldapsearch -H ldap://{HOST}:{PORT} -LLL -x -b "cn=config" -D "cn=admin,cn=config" -w {PASSWORD} -o ldif-wrap=no 'olcSyncRepl' | grep olcSyncrepl

   من المفترض أن يكون الناتج مشابهًا لما يلي:

   olcSyncrepl: {0}rid=001 provider=ldap://{HOST}:{PORT}/ binddn="cn=manager,dc=apigee,dc=com" bindmethod=simple credentials={PASSWORD} searchbase="dc=apigee,dc=com" attrs="*,+" type=refreshAndPersist retry="60 1 300 12 7200 +" timeout=1

2. أنشئ ملفًا باسم repl.lidf والصِق الأوامر التالية فيه:

   dn: olcDatabase={2}bdb,cn=config
   changetype: modify
   replace: olcSyncRepl
       olcSyncRepl: rid=001
       provider=ldap://{NEW_HOST}:{PORT}/
       binddn="cn=manager,dc=apigee,dc=com"
       bindmethod=simple
       credentials={PASSWORD}
       searchbase="dc=apigee,dc=com"
       attrs="*,+"
       type=refreshAndPersist
       retry="60 1 300 12 7200 +"
       timeout=1

   تأكَّد من استبدال القيمة المناسبة للعناصر النائبة التالية:

   • ‫{NEW_HOST}: مضيف OpenLDAP الجديد الذي تخطّط للنسخ المتماثل إليه
   • ‫{PORT}: منفذ OpenLDAP المنفذ التلقائي هو 10389.
   • ‫{PASSWORD}: كلمة مرور OpenLDAP
3. نفِّذ الأمر ldapmodify:

   ldapmodify -x -w {PASSWORD} -D "cn=admin,cn=config" -H "ldap://{HOST}:{PORT}/" -f repl.ldif
       
   The output should be similar to the following:
       
   modifying entry "olcDatabase={2}bdb,cn=config"

4. التحقّق من النسخ المتماثل:

   ldapsearch -H ldap://{HOST}:{PORT} -LLL -x -b "cn=config" -D "cn=admin,cn=config" -w {PASSWORD} -o ldif-wrap=no 'olcSyncRepl' | grep olcSyncrepl

   من المفترض أن يكون الناتج مشابهًا لما يلي:

   olcSyncrepl: {0}rid=001 provider=ldap://{NEW_HOST}:{PORT}/ binddn="cn=manager,dc=apigee,dc=com" bindmethod=simple credentials={PASSWORD} searchbase="dc=apigee,dc=com" attrs="*,+" type=refreshAndPersist retry="60 1 300 12 7200 +" timeout=1

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

   ldapsearch -w {PASSWORD} -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h localhost -p 10389 contextCSN | grep contextCSN

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