OpenLDAP-Wartungsaufgaben

Edge for Private Cloud v. 4.17.01

Speicherort der Logdatei

OpenLDAP-Logdateien sind im Verzeichnis /opt/apigee/var/log enthalten. Diese Dateien können regelmäßig archiviert und entfernt werden, damit sie nicht zu viel Speicherplatz belegen. Informationen zum Verwalten, Archivieren und Entfernen von OpenLDAP-Protokollen finden Sie im OpenLDAP-Handbuch unter http://www.openldap.org/doc/admin24/maintenance.html im Abschnitt 19.2.

Nutzerpasswort manuell festlegen

Nutzer 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 nicht verfügbar ist oder der Nutzer aus irgendeinem Grund keine E-Mail empfangen kann, können Sie das Passwort des Nutzers manuell mit OpenLDAP-Befehlen festlegen.

So legen Sie das Passwort eines Nutzers fest:

  1. Verwenden Sie 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 im folgenden 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 zur Eingabe des OpenLDAP-Administratorpassworts aufgefordert.

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. Dazu müssen Sie jedoch das vorhandene Passwort kennen. Wenn Sie dieses Passwort vergessen haben, können Sie es mit dem folgenden Verfahren zurücksetzen.

  1. Verwenden Sie slappasswd, um das SSHA-verschlüsselte Passwort für ein neues Passwort zu erstellen:
    > slappasswd -h {SSHA} -s newPassWord

    Dieser Befehl gibt einen String im folgenden Format zurück:
    {SSHA}+DOup9d6l+czfWzkIvajwYPArjPurhS6
  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 folgenden Format:
    olcRootPW:: OldPasswordString
  4. Ersetzen Sie OldPasswordString durch den von slappasswd zurückgegebenen String. Wenn nach olcRootPw zwei Doppelpunkte stehen, entfernen Sie einen und achten Sie 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üfen Sie mit ldapsearch, ob das neue Passwort funktioniert.
    > ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389

    Sie werden zur Eingabe des OpenLDAP-Administratorpassworts aufgefordert.
  7. Wiederholen Sie diese Schritte auf allen anderen OpenLDAP-Servern, die für die Replikation verwendet werden.
  8. Aktualisieren Sie den Management Server, 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. Dazu 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 auf dem UI-Knoten die Edge-UI:
    > /opt/apigee/apigee-service/bin/apigee-service edge-ui stop
  2. Verwenden Sie ldappasswd, um das Edge-Systemadministratorpasswort 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, die Sie für die Installation der Edge-Benutzeroberfläche verwendet haben, mit dem neuen Edge-Systempasswort:
    APIGEE_ADMINPW=newPassWord
  4. Konfigurieren Sie die Edge-Benutzeroberfläche und starten Sie sie neu:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
  5. (Nur wenn TLS auf der Benutzeroberfläche aktiviert ist) Aktivieren Sie TLS auf 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 unter /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 startet, versuchen Sie, es im Debug-Modus zu starten, 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 OpenLDAP-Replikationsproblemen

Wenn in Ihrer Installation mehrere OpenLDAP-Server verwendet werden, können Sie die Replikationseinstellungen prüfen, um sicherzustellen, dass die Server ordnungsgemäß funktionieren.

  1. Prüfen Sie, ob 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 zur Eingabe des OpenLDAP-Administratorpassworts aufgefordert.
  2. Prüfen Sie die Replikationskonfiguration, indem Sie die Datei /opt/apigee/conf/openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif untersuchen.
  3. Achten Sie darauf, dass das Systempasswort auf allen OpenLDAP-Servern identisch ist.
  4. Prüfen Sie die iptables- und TCP-Wrapper-Einstellungen.