Nie udało się uaktualnić PostgreSQL

Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X.
info

Krótki opis problemu

Podczas aktualizowania bazy danych PostgreSQL występuje błąd.

Komunikat o błędzie

ERROR: PostgreSQL Upgrade FAILED 

Możliwe przyczyny

Przyczyna Opis Instrukcje rozwiązywania problemów dotyczą
Nieprawidłowe ustawienia replikacji w pliku konfiguracyjnym PostgreSQL Uaktualnienie PostgreSQL nie powiodło się z powodu nieprawidłowych ustawień replikacji podczas uaktualniania. Użytkownicy Edge Private Cloud
Instalacja PostgreSQL została przeprowadzona przez innego użytkownika niż apigee PostgreSQL został początkowo zainstalowany przez innego użytkownika, co powoduje niepowodzenie uaktualnienia. Użytkownicy Edge Private Cloud

Typowe etapy diagnostyki

Jeśli podczas uaktualniania bazy danych PostgreSQL pojawi się błąd, wykonaj najpierw te czynności diagnostyczne:

  1. Zmień nazwę folderu danych PostgreSQL:

    mv /opt/apigee/data/apigee-postgresql/pgdata /opt/apigee/data/apigee-postgresql/pgdata-bkp
    
  2. Upewnij się, że oryginalne dane kopii zapasowej znajdują się w folderze o nazwie /opt/apigee/data/apigee-postgresql/pgdata-version.old/.

    Na przykład:

    /opt/apigee/data/apigee-postgresql/pgdata-9.6.old/
    
  3. Przywróć dane kopii zapasowej z /opt/apigee/data/apigee-postgresql/pgdata-version.old/ do /opt/apigee/data/apigee-postgresql/pgdata za pomocą tego polecenia:

    mv /opt/apigee/data/apigee-postgresql/pgdata-version.old/ /opt/apigee/data/apigee-postgresql/pgdata 
    

    Na przykład:

    mv /opt/apigee/data/apigee-postgresql/pgdata-9.6.old/ /opt/apigee/data/apigee-postgresql/pgdata
  4. Ponownie uruchom polecenie db_upgrade:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    
  5. Jeśli pojawi się ten błąd...

    pg_resetxlog: could not open file "global/pg_control" for reading:
    No such file or directory
    

    …a następnie zmień nazwę pliku pg_control.old na pg_control za pomocą tego polecenia:

    mv /apigee/apigeeinst/data/apigee-postgresql/pgdata/global/pg_control.old /apigee/apigeeinst/data/apigee-postgresql/pgdata/global/pg_control 
    
  6. Ponownie uruchom polecenie db_upgrade:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    

    Jeśli problem nie ustąpi, przejdź do sekcji Przyczyna: nieprawidłowe ustawienia replikacji w pliku konfiguracyjnym PostgreSQL.

Przyczyna: nieprawidłowe ustawienia replikacji w pliku konfiguracyjnym PostgreSQL

Diagnoza

  1. Sprawdź, czy plik konfiguracyjny PostgreSQL /opt/apigee/apigee-postgresql/conf/pg_hba.conf zawiera odpowiednie ustawienia replikacji.
  2. Jeśli ten plik zawiera oczekiwane ustawienia replikacji, przejdź do sekcji Instalacja PostgreSQL przeprowadzona przez innego użytkownika niż „apigee”.
  3. Jeśli nie, przejdź do sekcji Rozdzielczość.

Rozdzielczość

  1. Zmień nazwę folderu danych PostgreSQL za pomocą tego polecenia:

    mv /opt/apigee/data/apigee-postgresql/pgdata /opt/apigee/data/apigee-postgresql/pgdata-bkp
    
  2. Upewnij się, że oryginalne dane kopii zapasowej znajdują się w folderze o nazwie: /opt/apigee/data/apigee-postgresql/pgdata-version.old/

    Na przykład:

    /opt/apigee/data/apigee-postgresql/pgdata-9.6.old/
    
  3. Przywróć dane kopii zapasowej z /opt/apigee/data/apigee-postgresql/pgdata-version.old/ do /opt/apigee/data/apigee-postgresql/pgdata za pomocą tego polecenia:

    mv /opt/apigee/data/apigee-postgresql/pgdata-version.old/ /opt/apigee/data/apigee-postgresql/pgdata 
    

    Na przykład:

    mv /opt/apigee/data/apigee-postgresql/pgdata-9.6.old/ /opt/apigee/data/apigee-postgresql/pgdata 
    
  4. Jeśli kiedykolwiek zmienisz hosta podrzędnego, musisz zaktualizować tę właściwość w pliku /opt/apigee/customer/application/postgresql.properties, aby zaktualizować plik konfiguracyjny:pg_hba.conf

    conf_pg_hba_replication.connection=host replication apigee
    existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust 
    
  5. Uruchom ponownie usługę apigee-postgresql, aby upewnić się, że właściwość ustawiona w kroku 4 powyżej została zaktualizowana w pliku konfiguracyjnym pg_hba.conf:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
    
  6. Ustaw plik konfiguracji pg_hba.conf jako niezmienny, używając tego polecenia, aby mieć pewność, że podczas uaktualniania PostgreSQL nie zostanie on zaktualizowany o nieprawidłowe ustawienia:

    chattr +i /opt/apigee/apigee-postgresql/conf/pg_hba.conf 
    
  7. Ponownie uruchom polecenie db_upgrade:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    
  8. Usuń ustawienie niezmienne w pliku konfiguracyjnym pg_hba.conf:

    chattr -i /opt/apigee/apigee-postgresql/conf/pg_hba.conf
    

Przyczyna: instalacja PostgreSQL została przeprowadzona przez innego użytkownika niż apigee.

Diagnoza

  1. Sprawdź, czy inny użytkownik ma ustawioną wartość rolesuper na true. W tym celu wykonaj te czynności:

    1. Na węźle PostgreSQL zaloguj się w PostgreSQL za pomocą tego polecenia:

      psql -h $(hostname -i)  -U apigee
      
    2. Uruchom to zapytanie SQL:

      select * from pg_authid;
      
    3. Sprawdź, czy wielu użytkowników ma ustawioną wartość rolesuper na true. Jeśli tak jest, uaktualnienie PostgreSQL nie powiodło się, ponieważ jako użytkownik instalacji został ustawiony inny użytkownik zamiast użytkownika apigee. Każdy użytkownik z rolą rolesuper i niższym identyfikatorem OID jest uznawany za użytkownika instalacji.

      Aby sprawdzić, czy występuje ten rodzaj problemu z rolą, uruchom te zapytania SQL:

      select oid,rolname,rolsuper from pg_roles;
      select * from pg_user;
      

Rozdzielczość

  1. Zaloguj się w PostgreSQL za pomocą tego polecenia:

    psql -h $(hostname -i)  -U apigee
    
  2. Zmień nazwę dotychczasowej roli apigee w starej bazie danych na tymczasową (np. apigee2):

    update pg_authid set rolname ='apigee2' where rolname = 'apigee'; 
    
  3. Załóżmy, że był jeszcze jeden użytkownik, który zainstalował aplikację srcapige. Zmień nazwę roli srcapige na apigee:

    update pg_authid set rolname ='apigee' where rolname = 'srcapigee';
    
  4. Zmień nazwę użytkownika apigee2 na srcapige:

    update pg_authid set rolname ='secapigee' where rolname = 'apigee2'; 
    
  5. Zaktualizuj hasła wszystkich użytkowników, których nazwy zostały zmienione:

    ALTER ROLE apigee WITH PASSWORD '<secret>'; 
    ALTER ROLE srcapige WITH PASSWORD '<secret>'; 
    
  6. Zmień nazwę folderu danych PostgreSQL za pomocą tego polecenia:

    mv /opt/apigee/data/apigee-postgresql/pgdata /opt/apigee/data/apigee-postgresql/pgdata-bkp
    
  7. Sprawdź, czy w folderze o nazwie /opt/apigee/data/apigee-postgresql/pgdata-version.old/ znajdują się oryginalne dane kopii zapasowej.

    Na przykład:

    /opt/apigee/data/apigee-postgresql/pgdata-9.6.old/
    
  8. Przywróć dane w folderze /opt/apigee/data/apigee-postgresql/pgdata-version.old/ do /opt/apigee/data/apigee-postgresql/pgdata za pomocą tego polecenia:

    mv /opt/apigee/data/apigee-postgresql/pgdata-version.old/ /opt/apigee/data/apigee-postgresql/pgdata 
    

    Na przykład:

    mv /opt/apigee/data/apigee-postgresql/pgdata-9.6.old/ /opt/apigee/data/apigee-postgresql/pgdata 
    
  9. Ponownie uruchom polecenie db_upgrade:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade 
    
  10. Uruchom ponownie wszystkie usługi apigee-qpidd i edge-qpid-server:

    /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restart
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
    

Jeśli problem nadal występuje, przejdź do sekcji Informacje diagnostyczne, które musisz zebrać.

Musi zbierać informacje diagnostyczne

Jeśli po wykonaniu powyższych instrukcji problem nadal występuje, zbierz te informacje diagnostyczne: Skontaktuj się z zespołem pomocy Apigee i przekaż mu te informacje:

  1. W drugim wierszu pliku /opt/apigee/apigee-postgresql/lib/actions/db_upgrade dodaj set -x.
  2. Wykonaj typowe czynności diagnostyczne i prześlij zespołowi pomocy dane wyjściowe konsoli polecenia db_upgrade:

    opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    
  3. Prześlij zespołowi pomocy te pliki dziennika:

    /opt/apigee/var/log/apigee-postgresql/apigee-postgresql.log
    /opt/apigee/var/log/apigee-postgresql/update.log
    
  4. Podaj dane wyjściowe tych poleceń systemu operacyjnego, aby sprawdzić, czy alternatywne ustawienia są ustawione na auto.

    update-alternatives --display psql 
    

    LUB

    update-alternatives --display pgsql
    update-alternatives --list 
    

    Jeśli alternatywne ustawienia są ustawione na manual, możesz je zmienić na auto za pomocą tego polecenia:

    update-alternatives --auto psql
    

    Ustawienie alternatyw na auto powoduje, że pliki binarne psql i postgres wskazują uaktualnione wersje. W przeciwnym razie pliki binarne będą wskazywać starszą wersję, co może powodować problemy.