Zadania konserwacji OpenLDAP

Edge dla chmury prywatnej w wersji 4.17.05

Lokalizacja pliku dziennika

Pliki dziennika OpenLDAP znajdują się w katalogu /opt/apigee/var/log. Te pliki można okresowo archiwizować i usuwać, aby nie zajmowały zbyt dużo miejsca na dysku. Informacje o utrzymywaniu, archiwizowaniu i usuwaniu dzienników OpenLDAP znajdziesz w sekcji 19.2 instrukcji OpenLDAP na stronie http://www.openldap.org/doc/admin24/maintenance.html.

Ręczne ustawianie hasła użytkownika

Użytkownicy mogą poprosić o nowe hasło do Edge w interfejsie Edge. Użytkownik otrzyma e-maila z informacjami o ustawianiu hasła. Jeśli jednak serwer SMTP nie działa lub użytkownik z jakiegoś powodu nie może odebrać e-maila, możesz ręcznie ustawić hasło użytkownika za pomocą poleceń OpenLDAP.

Aby ustawić hasło użytkownika:

  1. Użyj ldapsearch, aby pobrać informacje o użytkownikach:
    > ldapsearch -w ldapAdminPWord -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389 > ldap.txt
  2. Wyszukaj adres e-mail użytkownika w pliku ldap.txt. Powinien pojawić się blok w tym formacie:
    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. Użyj ldappasswd, aby ustawić hasło użytkownika na podstawie jego identyfikatora uid:
    > 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"

    Pojawi się prośba o podanie hasła administratora OpenLDAP.

Użytkownik może teraz zalogować się za pomocą hasła newPassWord.

Ręczne ustawianie hasła systemowego OpenLDAP

W artykule Resetowanie haseł Edge opisano, jak zmienić hasło systemowe OpenLDAP, ale wymaga to znajomości dotychczasowego hasła. Jeśli nie pamiętasz hasła, możesz je zresetować, wykonując poniższe czynności.

  1. Użyj slappasswd, aby utworzyć zaszyfrowane hasło SSHA dla nowego hasła:
    > slappasswd -h {SSHA} -s newPassWord

    To polecenie zwraca ciąg znaków w postaci:
    {SSHA}+DOup9d6l+czfWzkIvajwYPArjPurhS6
  2. Otwórz plik /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif w edytorze:
    > vi /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif
  3. Znajdź wiersz w postaci:
    olcRootPW:: OldPasswordString
  4. Zastąp OldPasswordString ciągiem znaków zwróconym przez slappasswd. Jeśli po olcRootPw są 2 dwukropki, usuń jeden i upewnij się, że po dwukropku jest spacja:
    olcRootPW: {SSHA}RGon+bLCe+Sk+HyHholFBj8ONQfabrhw
  5. Uruchom ponownie OpenLDAP:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restart
  6. Sprawdź za pomocą ldapsearch, czy nowe hasło działa.
    > ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389

    Pojawi się prośba o podanie hasła administratora OpenLDAP.
  7. Powtórz te czynności na wszystkich innych serwerach OpenLDAP używanych do replikacji.
  8. Zaktualizuj serwer zarządzania, aby używał nowego hasła:
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-server store_ldap_credentials -p newPassWord

Ręczne ustawianie hasła administratora Edge

Resetowanie haseł Edge opisuje, jak zmienić hasło systemowe Edge, ale wymaga znajomości dotychczasowego hasła. Jeśli utracisz hasło systemowe Edge, możesz je zresetować, wykonując poniższe czynności.

  1. Na węźle UI zatrzymaj interfejs Edge:
    > /opt/apigee/apigee-service/bin/apigee-service edge-ui stop
  2. Użyj ldappasswd, aby ustawić hasło administratora systemu Edge:
    > 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"

    Pojawi się prośba o podanie hasła administratora OpenLDAP.
  3. Zaktualizuj plik konfiguracji użyty do zainstalowania interfejsu Edge, podając nowe hasło systemowe Edge:
    APIGEE_ADMINPW=newPassWord
  4. Skonfiguruj i uruchom ponownie interfejs Edge:
    > /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
  5. thought (Tylko jeśli protokół TLS jest włączony w interfejsie użytkownika) Ponownie włącz protokół TLS w interfejsie Edge zgodnie z opisem w artykule Konfigurowanie protokołu TLS dla interfejsu zarządzania.

Usuwanie pliku blokady SLAPD

Jeśli podczas próby uruchomienia OpenLDAP pojawi się błąd informujący, że plik blokady slapd.pid istnieje, możesz go usunąć.

Plik znajduje się w /opt/apigee/apigee-openldap/var/run/slapd.pid. Usuń plik i spróbuj ponownie uruchomić OpenLDAP:

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

Jeśli OpenLDAP nie uruchomi się, spróbuj uruchomić go w trybie debugowania i sprawdź, czy nie ma błędów:

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

Błędy mogą wskazywać na problemy z zasobami, pamięcią lub wykorzystaniem procesora.

Rozwiązywanie problemów z replikacją OpenLDAP

Jeśli Twoja instalacja korzysta z wielu serwerów OpenLDAP, możesz sprawdzić ustawienia replikacji, aby upewnić się, że serwery działają prawidłowo.

  1. Sprawdź, czy ldapsearch zwraca dane z każdego serwera OpenLDAP:
    > ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -h LDAP_IP -p 10389

    Pojawi się prośba o podanie hasła administratora OpenLDAP.
  2. Sprawdź konfigurację replikacji, analizując plik /opt/apigee/conf/openldap/slapd.d/cn=config/olcDatabase={2}bdb.ldif.
  3. Upewnij się, że hasło systemowe jest takie samo na każdym serwerze OpenLDAP.
  4. Sprawdź ustawienia iptables i tcp wrapper.