งานบำรุงรักษา SymasLDAP

ตำแหน่งไฟล์บันทึก

ไฟล์บันทึกของ SymasLDAP จะอยู่ในไดเรกทอรี /opt/apigee/var/log คุณสามารถเก็บถาวรและนำไฟล์เหล่านี้ออกเป็นระยะๆ เพื่อให้มั่นใจว่าไฟล์จะไม่ใช้พื้นที่ดิสก์ มากเกินไป ดูข้อมูลเกี่ยวกับการดูแลรักษา การเก็บถาวร และการนำบันทึกของ SymasLDAP ออกได้ในส่วนที่ 19.2 ของคู่มือ SymasLDAP ที่ https://kb.symas.com/configuration/logging-configuration

ตั้งรหัสผ่านของผู้ใช้ด้วยตนเอง

ผู้ใช้สามารถขอรหัสผ่าน Edge ใหม่ได้ใน UI ใหม่ของ 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 หากมีโคลอน 2 ตัวหลัง olcRootPw ให้นำออก 1 ตัวและตรวจสอบว่ามีช่องว่าง หลังโคลอน 
    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. หยุด UI ใหม่ของ Edge ในโหนด UI ใหม่ของ 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. อัปเดตไฟล์การกำหนดค่าที่คุณใช้ติดตั้ง UI ใหม่ของ Edge ด้วยรหัสผ่านระบบ Edge ใหม่ 
    APIGEE_ADMINPW=newPassWord
  4. กำหนดค่าและรีสตาร์ท UI ใหม่ของ Edge 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile
  5. (เฉพาะในกรณีที่เปิดใช้ TLS ใน UI ใหม่ของ Edge) เปิดใช้ TLS อีกครั้งใน UI ใหม่ของ Edge ตามที่ อธิบายไว้ในหัวข้อการกำหนดค่า TLS สำหรับ UI ใหม่ของ 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

ข้อผิดพลาดอาจบ่งชี้ถึงปัญหาเกี่ยวกับทรัพยากร หน่วยความจำ หรือการใช้ CPU

การแก้ไขการจำลอง 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