Các tác vụ bảo trì SymasLDAP

Vị trí tệp nhật ký

Tệp nhật ký SymasLDAP có trong thư mục /opt/apigee/var/log. Bạn có thể định kỳ lưu trữ và xoá các tệp này để đảm bảo rằng chúng không chiếm quá nhiều dung lượng ổ đĩa. Bạn có thể tìm thấy thông tin về cách duy trì, lưu trữ và xoá nhật ký SymasLDAP trong Phần 19.2 của hướng dẫn sử dụng SymasLDAP tại https://kb.symas.com/configuration/logging-configuration.

Đặt mật khẩu của người dùng theo cách thủ công

Người dùng có thể yêu cầu mật khẩu Edge mới trong Giao diện người dùng Edge mới. Sau đó, người dùng sẽ nhận được một email có thông tin về cách đặt mật khẩu. Tuy nhiên, nếu máy chủ SMTP của bạn ngừng hoạt động hoặc người dùng không thể nhận được email vì bất kỳ lý do nào, bạn có thể đặt mật khẩu của người dùng theo cách thủ công bằng cách sử dụng các lệnh SymasLDAP.

Cách đặt mật khẩu của người dùng:

  1. Sử dụng ldapsearch để tải thông tin người dùng xuống:
    /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. Tìm địa chỉ email của người dùng trong tệp ldap.txt. Bạn sẽ thấy một khối ở dạng:
    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. Sử dụng ldappasswd để đặt mật khẩu của người dùng dựa trên uid của người dùng:
    /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"

    Bạn được nhắc nhập mật khẩu quản trị viên SymasLDAP.

Giờ đây, người dùng có thể đăng nhập bằng newPassWord.

Đặt mật khẩu hệ thống SymasLDAP theo cách thủ công

Đặt lại mật khẩu Edge mô tả cách thay đổi mật khẩu hệ thống SymasLDAP nhưng yêu cầu bạn phải biết mật khẩu hiện có. Nếu quên mật khẩu đó, bạn có thể sử dụng quy trình sau để đặt lại.

  1. Sử dụng slappasswd để tạo mật khẩu được mã hoá SSHA cho mật khẩu mới:
    /opt/symas/sbin/slappasswd -h {SSHA} -s newPassWord

    Lệnh này trả về một chuỗi ở dạng:

    {SSHA}+DOup9d6l+czfWzkIvajwYPArjPurhS6
  2. Mở tệp /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif trong trình chỉnh sửa:
    vi /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif
  3. Tìm dòng ở dạng:
    olcRootPW:: OldPasswordString
  4. Thay thế OldPasswordString bằng chuỗi được trả về từ slappasswd. Nếu có 2 dấu hai chấm sau olcRootPw, hãy xoá một dấu và đảm bảo có khoảng trắng sau dấu hai chấm:
    olcRootPW: {SSHA}RGon+bLCe+Sk+HyHholFBj8ONQfabrhw
  5. Khởi động lại SymasLDAP:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restart
  6. Kiểm tra bằng ldapsearch xem mật khẩu mới của bạn có hoạt động hay không:
    /opt/symas/bin/ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -x -H ldap://LDAP_IP:10389

    Bạn được nhắc nhập mật khẩu quản trị viên SymasLDAP.

  7. Lặp lại các bước này trên mọi máy chủ SymasLDAP khác đang được dùng để sao chép.
  8. Cập nhật Máy chủ quản lý để sử dụng mật khẩu mới:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p newPassWord

Đặt mật khẩu quản trị viên Edge theo cách thủ công

Đặt lại mật khẩu Edge mô tả cách thay đổi mật khẩu hệ thống Edge nhưng yêu cầu bạn phải biết mật khẩu hiện có. Nếu quên mật khẩu hệ thống Edge, bạn có thể sử dụng quy trình sau để đặt lại.

  1. Trên nút Giao diện người dùng Edge mới, hãy dừng Giao diện người dùng Edge mới:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
  2. Sử dụng ldappasswd để đặt mật khẩu quản trị viên hệ thống 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"

    Bạn được nhắc nhập mật khẩu quản trị viên SymasLDAP.

  3. Cập nhật tệp cấu hình mà bạn đã dùng để cài đặt Giao diện người dùng Edge mới bằng mật khẩu hệ thống Edge mới:
    APIGEE_ADMINPW=newPassWord
  4. Định cấu hình và khởi động lại Giao diện người dùng Edge mới:
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile
  5. (Chỉ khi TLS được bật trên Giao diện người dùng Edge mới) Bật lại TLS trên Giao diện người dùng Edge mới như mô tả trong phần Định cấu hình TLS cho Giao diện người dùng Edge mới.

Xoá tệp khoá SLAPD

Nếu gặp lỗi khi cố gắng khởi động SymasLDAP rằng tệp khoá slapd.pid tồn tại, bạn có thể xoá tệp đó.

Tệp này nằm trong /opt/apigee/apigee-openldap/var/run/slapd.pid. Xoá tệp đó rồi thử khởi động lại SymasLDAP:

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

Nếu SymasLDAP không khởi động, hãy thử khởi động ở chế độ gỡ lỗi và kiểm tra lỗi:

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

Lỗi có thể chỉ ra các vấn đề về tài nguyên, bộ nhớ hoặc mức sử dụng CPU.

Sửa đổi quá trình sao chép SymasLDAP

Phần này giải thích cách sửa đổi quá trình sao chép SymasLDAP.

Thực hiện các bước trong quy trình sau trên nút sao chép SymasLDAP, nút này sẽ sao chép dữ liệu của mình sang nút SymasLDAP khác. Ví dụ: nếu bạn đang thiết lập quá trình sao chép từ nút 1 sang nút 2, hãy chạy các lệnh trên nút 1.

  1. Kiểm tra trạng thái hiện tại:
    /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

    Kết quả sẽ tương tự như kết quả sau:

    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. Tạo tệp repl.ldif rồi dán các lệnh sau vào tệp đó:
    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

    Đảm bảo bạn thay thế giá trị thích hợp cho các trình giữ chỗ sau:

    • NEW_HOST: Máy chủ SymasLDAP mới mà bạn dự định sao chép.
    • PORT: Cổng SymasLDAP. Cổng mặc định là 10389.
    • PASSWORD: Mật khẩu SymasLDAP.
  3. Chạy lệnh ldapmodify:
    /opt/symas/bin/ldapmodify -x -w PASSWORD -D "cn=admin,cn=config" -H "ldap://HOST:PORT/" -f repl.ldif

    Kết quả sẽ tương tự như kết quả sau:

    modifying entry "olcDatabase={2}mdb,cn=config"
  4. Xác minh quá trình sao chép:
    /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

    Kết quả sẽ tương tự như kết quả sau:

    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

    Bạn có thể xác minh rằng quá trình sao chép đang hoạt động đúng cách bằng cách đọc và so sánh giá trị contextCSN từ mỗi máy chủ và đảm bảo rằng chúng khớp nhau.

    /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

Khắc phục sự cố về quá trình sao chép SymasLDAP

Nếu bản cài đặt của bạn sử dụng nhiều máy chủ SymasLDAP, bạn có thể kiểm tra chế độ cài đặt sao chép để đảm bảo rằng các máy chủ đang hoạt động đúng cách.

  1. Đảm bảo rằng ldapsearch trả về dữ liệu từ mỗi máy chủ 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

    Bạn được nhắc nhập mật khẩu quản trị viên SymasLDAP.

  2. Kiểm tra cấu hình sao chép bằng cách xem xét tệp /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif.
  3. Đảm bảo mật khẩu hệ thống giống nhau trên mỗi máy chủ OpenLDAP.
  4. Kiểm tra chế độ cài đặt iptables và tcp wrapper.