OpenLDAP-Wartungsaufgaben

Edge for Private Cloud v4.18.05

Speicherort der Protokolldatei

OpenLDAP-Protokolldateien sind im Verzeichnis /opt/apigee/var/log enthalten. Diese Dateien können regelmäßig archiviert und entfernt werden, damit sie keinen übermäßigen Speicherplatz belegen. Informationen zum Verwalten, Archivieren und Entfernen von OpenLDAP-Protokollen finden Sie in Abschnitt 19.2 des OpenLDAP-Handbuchs unter http://www.openldap.org/doc/admin24/maintenance.html.

Nutzerpasswort manuell festlegen

Benutzer können in der Edge-Benutzeroberfläche ein neues Edge-Passwort anfordern. Der Nutzer erhält dann eine E-Mail mit Informationen zum Festlegen eines Passworts. Wenn Ihr SMTP-Server jedoch ausgefallen ist oder der Nutzer aus irgendeinem Grund keine E-Mail empfangen kann, können Sie das Passwort des Nutzers mithilfe von OpenLDAP-Befehlen manuell festlegen.

So legen Sie ein Nutzerpasswort fest:

  1. Verwende ldapsearch, um Nutzerinformationen herunterzuladen:
    ldapsearch -w ldapAdminPWord -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389 > ldap.txt
  2. Suchen Sie in der Datei „ldap.txt“ nach der E-Mail-Adresse des Nutzers. Sie sollten einen Block in folgendem Format sehen:
    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. Verwenden Sie ldappasswd, um das Passwort des Nutzers anhand der UID des Nutzers festzulegen:
    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"

    Sie werden aufgefordert, das OpenLDAP-Administratorpasswort einzugeben.

Der Nutzer kann sich jetzt mit newPassWord anmelden.

OpenLDAP-Systempasswort manuell festlegen

Unter Edge-Passwörter zurücksetzen wird beschrieben, wie Sie das OpenLDAP-Systempasswort ändern. Hierfür müssen Sie jedoch das bestehende Passwort kennen. Wenn Sie dieses Passwort vergessen haben, können Sie es mit den folgenden Schritten zurücksetzen.

  1. Erstellen Sie mit slappasswd das SSHA-verschlüsselte Passwort für ein neues Passwort:
    slappasswd -h {SSHA} -s newPassWord

    Dieser Befehl gibt einen String in der Form

    {SSHA}+DOup9d6l+czfWzkIvajwYPArjPurhS6
    zurück.

  2. Öffnen Sie die Datei /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif in einem Editor:
    vi /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif
  3. Suchen Sie die Zeile im Format
    olcRootPW:: OldPasswordString
    .
  4. Ersetzen Sie OldPasswordString durch den von slappasswd zurückgegebenen String. Wenn nach olcRootPw zwei Doppelpunkte stehen, entferne einen und achte darauf, dass nach dem Doppelpunkt ein Leerzeichen steht:
    olcRootPW: {SSHA}RGon+bLCe+Sk+HyHholFBj8ONQfabrhw
  5. Starten Sie OpenLDAP neu:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restart
  6. Prüfe mit ldapsearch, ob dein neues Passwort funktioniert:
    ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389

    Sie werden aufgefordert, das OpenLDAP-Administratorpasswort einzugeben.

  7. Wiederholen Sie diese Schritte auf allen anderen OpenLDAP-Servern, die für die Replikation verwendet werden.
  8. Aktualisieren Sie den Verwaltungsserver, um das neue Passwort zu verwenden:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p newPassWord

Edge-Administratorpasswort manuell festlegen

Unter Edge-Passwörter zurücksetzen wird beschrieben, wie Sie das Edge-Systempasswort ändern. Hierfür müssen Sie jedoch das vorhandene Passwort kennen. Wenn Sie das Edge-Systempasswort verloren haben, können Sie es mit dem folgenden Verfahren zurücksetzen.

  1. Beenden Sie im UI-Knoten die Edge-UI:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui stop
  2. Verwenden Sie ldappasswd, um das Edge-Sys-Administratorpasswort festzulegen:
    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"

    Sie werden aufgefordert, das OpenLDAP-Administratorpasswort einzugeben.

  3. Aktualisieren Sie die Konfigurationsdatei, mit der Sie die Edge-Benutzeroberfläche installiert haben, mit dem neuen Edge-Systempasswort:
    APIGEE_ADMINPW=newPassWord
  4. Konfigurieren Sie die Edge-UI und starten Sie sie neu:
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
  5. (Nur wenn TLS in der Benutzeroberfläche aktiviert ist) Aktivieren Sie TLS in der Edge-Benutzeroberfläche wieder, wie unter TLS für die Verwaltungs-UI konfigurieren beschrieben.

SLAPD-Sperrdatei löschen

Wenn Sie beim Starten von OpenLDAP die Fehlermeldung erhalten, dass die Sperrdatei slapd.pid vorhanden ist, können Sie die Datei löschen.

Die Datei befindet sich in /opt/apigee/apigee-openldap/var/run/slapd.pid. Löschen Sie die Datei und versuchen Sie, OpenLDAP neu zu starten:

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

Wenn OpenLDAP nicht gestartet wird, starten Sie es im Debug-Modus und suchen Sie nach Fehlern:

slapd -h ldap://:10389/ -u apigee -F /opt/apigee/apigee-openldap/var/run -d 255

Fehler können auf Ressourcenprobleme, Arbeitsspeicher- oder CPU-Auslastungsprobleme hinweisen.

Fehlerbehebung bei Problemen mit der OpenLDAP-Replikation

Wenn Ihre Installation mehrere OpenLDAP-Server verwendet, können Sie die Replikationseinstellungen überprüfen, um sicherzustellen, dass diese Server ordnungsgemäß funktionieren.

  1. Achten Sie darauf, dass ldapsearch Daten von jedem OpenLDAP-Server zurückgibt:
    ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389

    Sie werden aufgefordert, das OpenLDAP-Administratorpasswort einzugeben.

  2. Prüfen Sie die Replikationskonfiguration mithilfe der Datei /opt/apigee/conf/openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif.
  3. Das Systempasswort muss auf jedem OpenLDAP-Server identisch sein.
  4. Prüfen Sie die Einstellungen für iptables und den TCP-Wrapper.