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

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

فایل‌های گزارش SymasLDAP در فهرست راهنمای /opt/apigee/var/log قرار دارند. این فایل‌ها می‌توانند به‌صورت دوره‌ای بایگانی و حذف شوند تا مطمئن شویم فضای دیسک بیش‌ازحد اشغال نمی‌کنند. اطلاعات مربوط به نگهداری، بایگانی، و برداشتن گزارش‌های SymasLDAP را می‌توانید در بخش ۱۹.۲ دفترچه راهنمای SymasLDAP در https://kb.symas.com/configuration/logging-configuration پیدا کنید.

گذرواژه کاربر را به‌صورت دستی تنظیم کنید

کاربران می‌توانند در «واسط کاربر Edge جدید» گذرواژه 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 برای تنظیم گذرواژه کاربر براساس شناسه کاربری کاربر استفاده کنید: 
    /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. فایل پیکربندی‌ای را که برای نصب «میانای کاربر 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 را بررسی کنید.