Errore di upgrade PostgreSQL

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Sintomo

Si verifica un errore durante l'aggiornamento del database PostgreSQL.

Messaggio di errore

ERROR: PostgreSQL Upgrade FAILED 

Possibili cause

Passaggi comuni per la diagnostica

Se ricevi un errore durante l'upgrade del database PostgreSQL, esegui prima i seguenti passaggi di diagnostica:

1. Rinomina la cartella dei dati PostgreSQL:

   mv /opt/apigee/data/apigee-postgresql/pgdata /opt/apigee/data/apigee-postgresql/pgdata-bkp
   

2. Assicurati che i dati di backup originali si trovino in una cartella denominata /opt/apigee/data/apigee-postgresql/pgdata-version.old/.

   Ad esempio:

   /opt/apigee/data/apigee-postgresql/pgdata-9.6.old/
   

3. Ripristina i dati di backup in /opt/apigee/data/apigee-postgresql/pgdata-version.old/ in /opt/apigee/data/apigee-postgresql/pgdata utilizzando il seguente comando:

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

   Ad esempio:

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

4. Esegui di nuovo il comando db_upgrade:

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

5. Se ricevi il seguente errore…

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

   ...quindi rinomina il file pg_control.old in pg_control utilizzando il seguente comando:

   mv /apigee/apigeeinst/data/apigee-postgresql/pgdata/global/pg_control.old /apigee/apigeeinst/data/apigee-postgresql/pgdata/global/pg_control 
   

6. Esegui di nuovo il comando db_upgrade:

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

   Se il problema persiste, vai a Causa: impostazioni di replica errate nel file di configurazione PostgreSQL.

Causa: impostazioni di replica errate nel file di configurazione PostgreSQL

Diagnosi

1. Controlla se il file di configurazione PostgreSQL /opt/apigee/apigee-postgresql/conf/pg_hba.conf contiene le impostazioni di replica che ti interessano.
2. Se questo file ha le impostazioni di replica previste, vai a Installazione di PostgreSQL eseguita da un altro utente di installazione diverso dall'utente "apigee".
3. In caso contrario, vai a Risoluzione.

Risoluzione

1. Rinomina la cartella dei dati PostgreSQL utilizzando il seguente comando:

   mv /opt/apigee/data/apigee-postgresql/pgdata /opt/apigee/data/apigee-postgresql/pgdata-bkp
   

2. Assicurati che i dati di backup originali si trovino in una cartella denominata: /opt/apigee/data/apigee-postgresql/pgdata-version.old/

   Ad esempio:

   /opt/apigee/data/apigee-postgresql/pgdata-9.6.old/
   

3. Ripristina i dati di backup da /opt/apigee/data/apigee-postgresql/pgdata-version.old/ a /opt/apigee/data/apigee-postgresql/pgdata utilizzando il seguente comando:

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

   Ad esempio:

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

4. Se hai mai modificato l'host slave, devi aggiornare la seguente proprietà in /opt/apigee/customer/application/postgresql.properties per aggiornare il file di configurazione 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. Riavvia il servizio apigee-postgresql per assicurarti che la proprietà impostata nel passaggio 4 sopra venga aggiornata nel file di configurazione pg_hba.conf:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
   

6. Rendi il file di configurazione pg_hba.conf immutabile utilizzando il seguente comando per assicurarti che non venga aggiornato con impostazioni errate durante l'upgrade di PostgreSQL:

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

7. Esegui di nuovo il comando db_upgrade:

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

8. Rimuovi l'impostazione immutabile nel file di configurazione pg_hba.conf:

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

Causa: installazione di PostgreSQL eseguita da un altro utente di installazione diverso dall'utente apigee

Diagnosi

1. Controlla se un altro utente ha rolesuper impostato su true seguendo questi passaggi:

   1. Sul nodo PostgreSQL, accedi a PostgreSQL utilizzando il comando seguente:

      psql -h $(hostname -i)  -U apigee
      

   2. Esegui la seguente query SQL:

      select * from pg_authid;
      

   3. Controlla se più utenti hanno rolesuper impostato su true. In questo caso, l'upgrade di PostgreSQL non riesce perché un altro utente è stato impostato come utente di installazione anziché come utente apigee. Qualsiasi utente con il ruolo rolesuper e un OID inferiore viene considerato un utente di installazione.

      Per verificare questo tipo di problema relativo ai ruoli, esegui le seguenti query SQL:

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

Risoluzione

1. Accedi a PostgreSQL utilizzando il seguente comando:

   psql -h $(hostname -i)  -U apigee
   

2. Rinomina il ruolo apigee esistente nel vecchio database in un utente temporaneo (ad esempio: apigee2):

   update pg_authid set rolname ='apigee2' where rolname = 'apigee'; 
   

3. Supponiamo che ci sia un altro utente di installazione srcapige. Rinomina il ruolo srcapige in apigee:

   update pg_authid set rolname ='apigee' where rolname = 'srcapigee';
   

4. Rinomina apigee2 con l'utente srcapige:

   update pg_authid set rolname ='secapigee' where rolname = 'apigee2'; 
   

5. Aggiorna la password per tutti gli utenti rinominati:

   ALTER ROLE apigee WITH PASSWORD '<secret>'; 
   ALTER ROLE srcapige WITH PASSWORD '<secret>'; 
   

6. Rinomina la cartella dei dati PostgreSQL utilizzando il seguente comando:

   mv /opt/apigee/data/apigee-postgresql/pgdata /opt/apigee/data/apigee-postgresql/pgdata-bkp
   

7. Assicurati che all'interno di una cartella denominata /opt/apigee/data/apigee-postgresql/pgdata-version.old/ siano presenti dati di backup originali.

   Ad esempio:

   /opt/apigee/data/apigee-postgresql/pgdata-9.6.old/
   

8. Ripristina i dati nella cartella /opt/apigee/data/apigee-postgresql/pgdata-version.old/ in /opt/apigee/data/apigee-postgresql/pgdata utilizzando il seguente comando:

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

   Ad esempio:

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

9. Esegui di nuovo il comando db_upgrade:

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

10. Riavvia tutti i servizi apigee-qpidd e edge-qpid-server:

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

Se il problema persiste, vai a Informazioni diagnostiche da raccogliere.

Deve raccogliere informazioni diagnostiche

Se il problema persiste dopo aver seguito le istruzioni per la risoluzione dei problemi riportate sopra, raccogli le seguenti informazioni diagnostiche. Contatta l'assistenza Apigee e condividi queste informazioni con il team di assistenza:

1. Aggiungi set -x alla seconda riga del file /opt/apigee/apigee-postgresql/lib/actions/db_upgrade.

2. Segui i passaggi di diagnosi comuni e fornisci l'output della console del comando db_upgrade al team di assistenza:

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

3. Fornisci i seguenti file di log al team di assistenza:

   /opt/apigee/var/log/apigee-postgresql/apigee-postgresql.log
   /opt/apigee/var/log/apigee-postgresql/update.log
   

4. Fornisci l'output dei seguenti comandi del sistema operativo per verificare se le alternative sono impostate su auto.

   update-alternatives --display psql 
   

   OPPURE

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

   Se le alternative sono impostate su manual, puoi impostarle su auto utilizzando il seguente comando:

   update-alternatives --auto psql
   

   Se imposti le alternative su auto, i file binari psql e postgres vengono indirizzati alle versioni aggiornate. In caso contrario, i file binari punteranno alla versione precedente, il che può causare problemi.