مهام صيانة SymasLDAP

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

يتم تضمين ملفات سجلّ SymasLDAP في الدليل /opt/apigee/var/log. يمكن أرشفة هذه الملفات وإزالتها بشكل دوري لضمان عدم شغلها مساحة كبيرة على القرص. يمكنك الاطّلاع على معلومات حول الاحتفاظ بسجلّات SymasLDAP وأرشفتها وإزالتها في القسم 19.2 من دليل SymasLDAP على الرابط https://kb.symas.com/configuration/logging-configuration.

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

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

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

  1. استخدِم ldapsearch لتنزيل معلومات المستخدم: 
    /opt/symas/bin/ldapsearch -w ldapAdminPWord -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -x -H ldap://LDAP_IP: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 لضبط كلمة مرور المستخدم استنادًا إلى رقم تعريف المستخدم (uid): 
    /opt/symas/bin/ldappasswd -x -H ldap://LDAP_IP: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"

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

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

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

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

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

    يعرض هذا الأمر سلسلة بالصيغة التالية: 

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

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

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

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

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

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

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

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

حذف ملف قفل SLAPD

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

يقع الملف في /opt/apigee/apigee-openldap/var/run/slapd.pid. احذف الـ ملف وحاول إعادة تشغيل SymasLDAP:

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

إذا لم يبدأ SymasLDAP، حاوِل بدءه في وضع تصحيح الأخطاء وابحث عن الأخطاء:

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

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

تعديل عملية تكرار SymasLDAP

يوضِّح هذا القسم كيفية تعديل عملية تكرار SymasLDAP.

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

  1. تحقَّق من الحالة الحالية: 
    /opt/symas/bin/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.ldif والصِق الأوامر التالية في الملف: 
    dn: olcDatabase={2}mdb,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: مضيف SymasLDAP الجديد الذي تخطط لتكرار البيانات إليه
    • PORT: منفذ SymasLDAP المنفذ التلقائي هو 10389.
    • PASSWORD: كلمة مرور SymasLDAP
  3. نفِّذ الأمر ldapmodify: 
    /opt/symas/bin/ldapmodify -x -w PASSWORD -D "cn=admin,cn=config" -H "ldap://HOST:PORT/" -f repl.ldif

    يجب أن تكون النتيجة مشابهة لما يلي:

    modifying entry "olcDatabase={2}mdb,cn=config"
  4. تحقَّق من عملية التكرار: 
    /opt/symas/bin/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 من كل خادم والتأكّد من تطابقها.

    /opt/symas/bin/ldapsearch -w PASSWORD -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -x -H ldap://localhost:10389 contextCSN | grep contextCSN

تحديد مشاكل تكرار SymasLDAP وحلّها

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

  1. تأكَّد من أنّ ldapsearch يعرض بيانات من كل خادم SymasLDAP: 
    /opt/symas/bin/ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -x -H ldap://LDAP_IP:10389

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

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