تکالیف نگهداری OpenLDAP

مکان فایل گزارش

فایل‌های گزارش OpenLDAP در فهرست راهنمای /opt/apigee/var/log قرار دارند. این فایل‌ها را می‌توان به‌طور دوره‌ای بایگانی و حذف کرد تا مطمئن شد که فضای دیسک زیادی را اشغال نمی‌کنند. اطلاعات مربوط به نگهداری، بایگانی، و حذف گزارش‌های OpenLDAP را می‌توانید در بخش ۱۹.۲ راهنمای 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. بازراه‌اندازی ال‌دپ باز:

   /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 UI را متوقف کنید:

   /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 UI استفاده کردید با گذرواژه جدید سیستم Edge به‌روز کنید:

   APIGEE_ADMINPW=newPassWord

4. پیکربندی و بازراه‌اندازی Edge UI:

   /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 تکرار می‌کند. برای مثال، اگر درحال تنظیم تکرار از 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}: میزبان جدید ال‌دپ باز که قصد دارید به آن تکرار کنید.
   • ‫{PORT}: درگاه ال‌دپ باز. درگاه پیش‌فرض 10389 است.
   • ‫{PASSWORD}: گذرواژه ال‌دپ باز.
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 را بررسی کنید.