SymasLDAP-Wartungsaufgaben

Speicherort der Logdatei

SymasLDAP-Logdateien befinden sich im Verzeichnis /opt/apigee/var/log. Diese Dateien können regelmäßig archiviert und entfernt werden, damit sie nicht zu viel Speicherplatz belegen. Informationen zum Verwalten, Archivieren und Entfernen von SymasLDAP-Logs finden Sie im Abschnitt 19.2 des SymasLDAP-Handbuchs unter https://kb.symas.com/configuration/logging-configuration.

Passwort eines Nutzers manuell festlegen

Nutzer können in der neuen 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 funktioniert oder der Nutzer aus irgendeinem Grund keine E-Mail empfangen kann, können Sie das Passwort des Nutzers manuell mit SymasLDAP Befehlen festlegen.

So legen Sie das Passwort eines Nutzers fest:

  1. Laden Sie mit ldapsearch Nutzerinformationen herunter: 
    /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. 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. Legen Sie mit ldappasswd das Passwort des Nutzers basierend auf der Nutzer-ID fest: 
    /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"

    Sie werden zur Eingabe des SymasLDAP-Administratorpassworts aufgefordert.

Der Nutzer kann sich jetzt mit newPassWord anmelden.

SymasLDAP-Systempasswort manuell festlegen

Unter Edge-Passwörter zurücksetzen wird beschrieben, wie Sie das SymasLDAP-Systempasswort ändern. Dazu müssen Sie jedoch das vorhandene Passwort kennen. Wenn Sie das Passwort vergessen haben, können Sie es mit der folgenden Anleitung zurücksetzen.

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

    Dieser Befehl gibt einen String im folgenden Format zurück: 

    {SSHA}+DOup9d6l+czfWzkIvajwYPArjPurhS6
  2. Öffnen Sie die /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif Datei in einem Editor: 
    vi /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif
  3. Suchen Sie die Zeile im folgenden Format: 
    olcRootPW:: OldPasswordString
  4. Ersetzen Sie OldPasswordString durch den String, der von slappasswd zurückgegeben wurde. Wenn nach olcRootPw zwei Doppelpunkte stehen, entfernen Sie einen und fügen Sie nach dem Doppelpunkt ein Leerzeichen ein: 
    olcRootPW: {SSHA}RGon+bLCe+Sk+HyHholFBj8ONQfabrhw
  5. Starten Sie SymasLDAP neu: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restart
  6. Prüfen Sie mit ldapsearch, ob Ihr neues Passwort funktioniert: 
    /opt/symas/bin/ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -x -H ldap://LDAP_IP:10389

    Sie werden zur Eingabe des SymasLDAP-Administratorpassworts aufgefordert.

  7. Wiederholen Sie diese Schritte auf allen anderen SymasLDAP-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 vergessen haben, können Sie es mit der folgenden Anleitung zurücksetzen.

  1. Beenden Sie die neue Edge-Benutzeroberfläche auf dem entsprechenden Knoten: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
  2. Legen Sie mit ldappasswd das Edge-Systemadministratorpasswort fest: 
    /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"

    Sie werden zur Eingabe des SymasLDAP-Administratorpassworts aufgefordert.

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

SLAPD-Sperrdatei löschen

Wenn beim Starten von SymasLDAP ein Fehler auftritt, weil die slapd.pid Sperrdatei 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, SymasLDAP neu zu starten:

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

Wenn SymasLDAP nicht startet, versuchen Sie, es im Debug-Modus zu starten, und suchen Sie nach Fehlern:

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

Fehler können auf Ressourcenprobleme oder Probleme mit der Arbeitsspeicher- oder CPU-Auslastung hinweisen.

SymasLDAP-Replikation ändern

In diesem Abschnitt wird beschrieben, wie Sie die SymasLDAP-Replikation ändern.

Führen Sie die Schritte in der folgenden Anleitung auf dem SymasLDAP-Replikationsknoten aus, der seine Daten auf den anderen SymasLDAP-Knoten repliziert. Wenn Sie beispielsweise die Replikation von Knoten 1 zu Knoten 2 einrichten, führen Sie die Befehle auf Knoten 1 aus.

  1. Prüfen Sie den aktuellen Status: 
    /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

    Die Ausgabe sollte in etwa so aussehen:

    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. Erstellen Sie eine Datei repl.ldif und fügen Sie die folgenden Befehle in die Datei ein: 
    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

    Ersetzen Sie die folgenden Platzhalter durch die entsprechenden Werte:

    • NEW_HOST: Der neue SymasLDAP-Host, auf den Sie replizieren möchten.
    • PORT: Der SymasLDAP-Port. Der Standardport ist 10389.
    • PASSWORD: Das SymasLDAP-Passwort.
  3. Führen Sie den Befehl ldapmodify aus: 
    /opt/symas/bin/ldapmodify -x -w PASSWORD -D "cn=admin,cn=config" -H "ldap://HOST:PORT/" -f repl.ldif

    Die Ausgabe sollte in etwa so aussehen:

    modifying entry "olcDatabase={2}mdb,cn=config"
  4. Prüfen Sie die Replikation: 
    /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

    Die Ausgabe sollte in etwa so aussehen: 

    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

    Sie können prüfen, ob die Replikation ordnungsgemäß funktioniert, indem Sie den contextCSN Wert von jedem Server lesen und vergleichen und darauf achten, dass sie übereinstimmen.

    /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

Fehlerbehebung bei Problemen mit der SymasLDAP-Replikation

Wenn in Ihrer Installation mehrere SymasLDAP-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 SymasLDAP-Server zurückgibt: 
    /opt/symas/bin/ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -x -H ldap://LDAP_IP:10389

    Sie werden zur Eingabe des SymasLDAP-Administratorpassworts aufgefordert.

  2. Prüfen Sie die Replikationskonfiguration, indem Sie die /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif Datei untersuchen.
  3. Achten Sie darauf, dass das Systempasswort auf jedem OpenLDAP-Server identisch ist.
  4. Prüfen Sie die Einstellungen für iptables und TCP-Wrapper.