Échec de la mise à niveau de PostgreSQL

Vous consultez la documentation Apigee Edge.
Accédez à la documentation Apigee X.

Problème constaté

Une erreur s'affiche lorsque vous mettez à jour la base de données PostgreSQL.

Message d'erreur

ERROR: PostgreSQL Upgrade FAILED 

Causes possibles :

Étapes de diagnostic courantes

Si vous rencontrez une erreur lors de la mise à niveau de la base de données PostgreSQL, effectuez d'abord les étapes de diagnostic suivantes :

1. Renommez le dossier de données PostgreSQL :

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

2. Assurez-vous que vos données de sauvegarde d'origine se trouvent dans un dossier nommé /opt/apigee/data/apigee-postgresql/pgdata-version.old/.

   Exemple :

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

3. Restaurez les données de sauvegarde dans /opt/apigee/data/apigee-postgresql/pgdata-version.old/ vers /opt/apigee/data/apigee-postgresql/pgdata à l'aide de la commande suivante :

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

   Exemple :

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

4. Exécutez à nouveau la commande db_upgrade :

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

5. Si vous obtenez l'erreur suivante :

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

   … puis renommez le fichier pg_control.old en pg_control à l'aide de la commande suivante :

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

6. Exécutez à nouveau la commande db_upgrade :

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

   Si le problème persiste, consultez Cause : paramètres de réplication incorrects dans le fichier de configuration PostgreSQL.

Cause : Paramètres de réplication incorrects dans le fichier de configuration PostgreSQL

Diagnostic

1. Vérifiez si le fichier de configuration PostgreSQL /opt/apigee/apigee-postgresql/conf/pg_hba.conf contient les paramètres de réplication souhaités.
2. Si ce fichier contient les paramètres de réplication attendus, accédez à Installation de PostgreSQL effectuée par un autre utilisateur d'installation que l'utilisateur "apigee".
3. Sinon, accédez à la section Résolution.

Solution

1. Renommez le dossier de données PostgreSQL à l'aide de la commande suivante :

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

2. Assurez-vous que les données de sauvegarde d'origine se trouvent dans un dossier nommé /opt/apigee/data/apigee-postgresql/pgdata-version.old/.

   Exemple :

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

3. Restaurez les données de sauvegarde de /opt/apigee/data/apigee-postgresql/pgdata-version.old/ vers /opt/apigee/data/apigee-postgresql/pgdata à l'aide de la commande suivante :

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

   Exemple :

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

4. Si vous avez déjà modifié l'hôte esclave, vous devez mettre à jour la propriété suivante dans /opt/apigee/customer/application/postgresql.properties pour mettre à jour le fichier de configuration 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. Redémarrez le service apigee-postgresql pour vous assurer que la propriété définie à l'étape 4 ci-dessus est mise à jour dans le fichier de configuration pg_hba.conf :

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

6. Rendez le fichier de configuration pg_hba.conf immuable à l'aide de la commande suivante pour vous assurer qu'il n'est pas mis à jour avec des paramètres incorrects lors de la mise à niveau de PostgreSQL :

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

7. Exécutez à nouveau la commande db_upgrade :

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

8. Supprimez le paramètre immuable du fichier de configuration pg_hba.conf :

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

Cause : Installation de PostgreSQL effectuée par un autre utilisateur d'installation que l'utilisateur apigee

Diagnostic

1. Vérifiez si un autre utilisateur a défini rolesuper sur true en procédant comme suit :

   1. Sur le nœud PostgreSQL, connectez-vous à PostgreSQL à l'aide de la commande suivante :

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

   2. Exécutez la requête SQL suivante :

      select * from pg_authid;
      

   3. Vérifiez si plusieurs utilisateurs ont la valeur true pour rolesuper. Si c'est le cas, la mise à niveau de PostgreSQL échoue, car un autre utilisateur a été défini comme utilisateur d'installation au lieu de l'utilisateur apigee. Tout utilisateur disposant du rôle rolesuper et d'un OID inférieur est considéré comme un utilisateur d'installation.

      Pour vérifier ce type de problème lié aux rôles, exécutez les requêtes SQL suivantes :

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

Solution

1. Connectez-vous à PostgreSQL à l'aide de la commande suivante :

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

2. Renommez le rôle apigee existant dans l'ancienne base de données en un utilisateur temporaire (par exemple, apigee2) :

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

3. Supposons qu'il existe un autre utilisateur d'installation srcapige. Renommez le rôle srcapige en apigee :

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

4. Renommez apigee2 en srcapige :

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

5. Mettez à jour le mot de passe de tous les utilisateurs renommés :

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

6. Renommez le dossier de données PostgreSQL à l'aide de la commande suivante :

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

7. Assurez-vous qu'il existe des données de sauvegarde d'origine dans un dossier nommé /opt/apigee/data/apigee-postgresql/pgdata-version.old/.

   Exemple :

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

8. Restaurez les données du dossier /opt/apigee/data/apigee-postgresql/pgdata-version.old/ dans /opt/apigee/data/apigee-postgresql/pgdata à l'aide de la commande suivante :

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

   Exemple :

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

9. Exécutez à nouveau la commande db_upgrade :

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

10. Redémarrez tous les services apigee-qpidd et edge-qpid-server :

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

Si le problème persiste, consultez la page Vous devez collecter des informations de diagnostic.

Vous devez collecter des informations de diagnostic

Si le problème persiste après avoir suivi les instructions de dépannage ci-dessus, rassemblez les informations de diagnostic suivantes. Contactez l'assistance Apigee et partagez les informations suivantes avec l'équipe d'assistance :

1. Ajoutez set -x sur la deuxième ligne du fichier /opt/apigee/apigee-postgresql/lib/actions/db_upgrade.

2. Suivez les étapes de diagnostic courantes et fournissez à l'équipe d'assistance la sortie de la console de la commande db_upgrade :

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

3. Fournissez les fichiers journaux suivants à l'équipe d'assistance :

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

4. Fournissez la sortie des commandes de système d'exploitation suivantes pour vérifier si les alternatives sont définies sur auto.

   update-alternatives --display psql 
   

   OU

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

   Si les alternatives sont définies sur manual, vous pouvez les définir sur auto à l'aide de la commande suivante :

   update-alternatives --auto psql
   

   Si vous définissez les alternatives sur auto, les binaires psql et postgres sont redirigés vers les versions mises à niveau. Sinon, les binaires pointeront vers l'ancienne version, ce qui peut entraîner des problèmes.