Zadania konserwacyjne SymasLDAP

Lokalizacja pliku dziennika

Pliki dziennika SymasLDAP 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 SymasLDAP znajdziesz w sekcji 19.2 podręcznika SymasLDAP na stronie https://kb.symas.com/configuration/logging-configuration.

Ręczne ustawianie hasła użytkownika

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

Aby ustawić hasło użytkownika:

  1. Użyj ldapsearch, aby pobrać informacje o użytkowniku:
    /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. W pliku ldap.txt wyszukaj adres e-mail użytkownika. Powinien się wyświetlić blok w postaci:
    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:
    /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"

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

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

Ręczne ustawianie hasła systemowego SymasLDAP

W artykule Resetowanie haseł Edge opisano, jak zmienić hasło systemowe SymasLDAP, ale wymaga to znajomości dotychczasowego hasła. Jeśli je utracisz, możesz je zresetować, wykonując te czynności.

  1. Użyj slappasswd, aby utworzyć zaszyfrowane hasło SSHA dla nowego hasła:
    /opt/symas/sbin/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}mdb.ldif w edytorze:
    vi /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase={2}mdb.ldif
  3. Znajdź wiersz w postaci:
    olcRootPW:: OldPasswordString
  4. Zastąp OldPasswordString ciągiem znaków zwróconym przez slappasswd. Jeśli po olcRootPw występują 2 dwukropki, usuń jeden z nich i upewnij się, że po dwukropku jest spacja:
    olcRootPW: {SSHA}RGon+bLCe+Sk+HyHholFBj8ONQfabrhw
  5. Uruchom ponownie SymasLDAP:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restart
  6. Sprawdź za pomocą ldapsearch, czy nowe hasło działa:
    /opt/symas/bin/ldapsearch -W -D "cn=manager,dc=apigee,dc=com" -b "dc=apigee,dc=com" -LLL -x -H ldap://LDAP_IP:10389

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

  7. Powtórz te czynności na wszystkich innych serwerach SymasLDAP 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

W artykule Resetowanie haseł Edge opisano, jak zmienić hasło systemowe Edge, ale wymaga to znajomości dotychczasowego hasła. Jeśli utracisz hasło systemowe Edge , możesz je zresetować, wykonując te czynności.

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

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

  3. Zaktualizuj plik konfiguracyjny, którego używasz do instalowania nowego interfejsu Edge, o nowe hasło systemowe Edge:
    APIGEE_ADMINPW=newPassWord
  4. Skonfiguruj i uruchom ponownie nowy interfejs Edge:
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile
  5. (Tylko jeśli w nowym interfejsie Edge jest włączony protokół TLS) Ponownie włącz protokół TLS w nowym interfejsie Edge zgodnie z opisem w artykule Konfigurowanie protokołu TLS w nowym interfejsie Edge.

Usuwanie pliku blokady SLAPD

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

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

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

Jeśli SymasLDAP się nie uruchomi, spróbuj uruchomić go w trybie debugowania i sprawdź, czy nie występują błędy:

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

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

Modyfikowanie replikacji SymasLDAP

W tej sekcji dowiesz się, jak zmodyfikować replikację SymasLDAP.

Wykonaj czynności opisane w tej procedurze na węźle replikatora SymasLDAP, który replikuje swoje dane do innego węzła SymasLDAP. Jeśli na przykład konfigurujesz replikację z węzła 1 do węzła 2, uruchom polecenia w węźle 1.

  1. Sprawdź bieżący stan:
    /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

    Dane wyjściowe powinny być podobne do tych:

    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. Utwórz plik repl.ldif i wklej do niego te polecenia do pliku:
    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

    Upewnij się, że zastępujesz odpowiednią wartością te symbole zastępcze:

    • NEW_HOST: nowy host SymasLDAP, do którego planujesz replikować.
    • PORT: port SymasLDAP. Domyślny port to 10389.
    • PASSWORD: hasło SymasLDAP.
  3. Uruchom polecenie ldapmodify:
    /opt/symas/bin/ldapmodify -x -w PASSWORD -D "cn=admin,cn=config" -H "ldap://HOST:PORT/" -f repl.ldif

    Dane wyjściowe powinny być podobne do tych:

    modifying entry "olcDatabase={2}mdb,cn=config"
  4. Zweryfikuj replikację:
    /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

    Dane wyjściowe powinny być podobne do tych:

    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

    Aby sprawdzić, czy replikacja działa prawidłowo, odczytaj i porównaj wartość contextCSN z każdego serwera i upewnij się, że są one zgodne.

    /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

Rozwiązywanie problemów z replikacją SymasLDAP problemów

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

  1. Upewnij się, że ldapsearch zwraca dane z każdego serwera 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

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

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