Error de actualización de PostgreSQL

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X. info

Síntoma

Recibirás un error cuando actualices la base de datos de PostgreSQL.

Mensaje de error

ERROR: PostgreSQL Upgrade FAILED

Causas posibles

Causa Descripción Las instrucciones de solución de problemas se aplican a
Configuración de replicación incorrecta en el archivo de configuración de PostgreSQL La actualización de PostgreSQL falla debido a una configuración de replicación incorrecta durante la actualización. Usuarios de Edge Private Cloud
Instalación de PostgreSQL realizada por otro usuario de instalación que no sea el usuario de Apigee PostgreSQL se instaló inicialmente con otro usuario como usuario de instalación, lo que provoca un error en la actualización. Usuarios de Edge Private Cloud

Pasos comunes de diagnóstico

Si recibes un error cuando actualizas la base de datos de PostgreSQL, primero realiza los siguientes pasos de diagnóstico:

  1. Cambia el nombre de la carpeta de datos de PostgreSQL:

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

  2. Asegúrate de que los datos de la copia de seguridad original estén en una carpeta llamada /opt/apigee/data/apigee-postgresql/pgdata-version.old/.

    Por ejemplo:

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

  3. Restablece los datos de la copia de seguridad en /opt/apigee/data/apigee-postgresql/pgdata-version.old/ a /opt/apigee/data/apigee-postgresql/pgdata con el siguiente comando:

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

    Por ejemplo:

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

  4. Vuelve a ejecutar el comando db_upgrade: 

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

  5. Si recibes el siguiente error, haz lo siguiente:

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

    …luego, cambia el nombre del archivo pg_control.old a pg_control con el siguiente comando:

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

  6. Vuelve a ejecutar el comando db_upgrade: 

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

    Si el problema persiste, consulta Causa: Configuración de replicación incorrecta en el archivo de configuración de PostgreSQL.

Causa: Configuración de replicación incorrecta en el archivo de configuración de PostgreSQL

Diagnóstico

  1. Verifica si el archivo de configuración de PostgreSQL /opt/apigee/apigee-postgresql/conf/pg_hba.conf tiene la configuración de replicación que deseas.
  2. Si este archivo tiene la configuración de replicación esperada, ve a Instalación de PostgreSQL realizada por otro usuario de instalación que no sea el usuario "apigee".
  3. De lo contrario, ve a Resolución.

Solución

  1. Cambia el nombre de la carpeta de datos de PostgreSQL con el siguiente comando:

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

  2. Asegúrate de que los datos de la copia de seguridad original estén en una carpeta llamada /opt/apigee/data/apigee-postgresql/pgdata-version.old/.

    Por ejemplo:

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

  3. Restablece los datos de la copia de seguridad de /opt/apigee/data/apigee-postgresql/pgdata-version.old/ a /opt/apigee/data/apigee-postgresql/pgdata con el siguiente comando:

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

    Por ejemplo:

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

  4. Si alguna vez cambiaste el host secundario, debes actualizar la siguiente propiedad en /opt/apigee/customer/application/postgresql.properties para actualizar el archivo de configuración 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. Reinicia el servicio apigee-postgresql para asegurarte de que la propiedad establecida en el paso 4 anterior se actualice en el archivo de configuración pg_hba.conf:

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

  6. Haz que el archivo de configuración pg_hba.conf sea inmutable con el siguiente comando para asegurarte de que no se actualice con parámetros de configuración incorrectos durante la actualización de PostgreSQL:

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

  7. Vuelve a ejecutar el comando db_upgrade:

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

  8. Quita el parámetro de configuración inmutable en el archivo de configuración pg_hba.conf:

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

Causa: La instalación de PostgreSQL se realizó con otro usuario de instalación que no es el usuario apigee.

Diagnóstico

  1. Sigue estos pasos para verificar si hay algún otro usuario que tenga rolesuper establecido en true:

    1. En el nodo de PostgreSQL, accede a PostgreSQL con el siguiente comando:

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

    2. Ejecuta la siguiente consulta en SQL:

      select * from pg_authid;

    3. Comprueba si hay varios usuarios con rolesuper establecido en true. Si es así, la actualización de PostgreSQL falla porque otro usuario se configuró como usuario de instalación en lugar del usuario apigee. Cualquier usuario con el rol rolesuper y un OID inferior se considera un usuario de instalación.

      Para verificar este tipo de problema de rol, ejecuta las siguientes consultas en SQL:

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

Solución

  1. Accede a PostgreSQL con el siguiente comando:

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

  2. Cambia el nombre del rol apigee existente en la base de datos anterior a un usuario temporal (por ejemplo, apigee2):

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

  3. Supongamos que había otro usuario de instalación srcapige. Cambia el nombre del rol srcapige a apigee:

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

  4. Cambia el nombre de apigee2 a srcapige:

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

  5. Actualiza la contraseña de todos los usuarios cuyo nombre se cambió:

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

  6. Cambia el nombre de la carpeta de datos de PostgreSQL con el siguiente comando:

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

  7. Asegúrate de que haya datos de copia de seguridad originales dentro de una carpeta llamada /opt/apigee/data/apigee-postgresql/pgdata-version.old/.

    Por ejemplo:

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

  8. Restablece los datos de la carpeta /opt/apigee/data/apigee-postgresql/pgdata-version.old/ a /opt/apigee/data/apigee-postgresql/pgdata con el siguiente comando:

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

    Por ejemplo:

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

  9. Vuelve a ejecutar el comando db_upgrade:

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

  10. Reinicia todos los servicios de apigee-qpidd y 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 el problema persiste, consulta Recopila información de diagnóstico.

Se debe recopilar información de diagnóstico

Si el problema persiste después de seguir las instrucciones de solución de problemas anteriores, recopila la siguiente información de diagnóstico. Comunícate con el equipo de asistencia de Apigee y comparte esta información con él:

  1. Agrega set -x en la segunda línea del archivo /opt/apigee/apigee-postgresql/lib/actions/db_upgrade.

  2. Sigue los pasos comunes de diagnóstico y proporciona el resultado de la consola del comando db_upgrade al equipo de asistencia al cliente:

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

  3. Proporciona los siguientes archivos de registro al equipo de asistencia al cliente:

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

  4. Proporciona el resultado de los siguientes comandos del sistema operativo para verificar si las alternativas están configuradas en auto.

    update-alternatives --display psql

    O 

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

    Si las alternativas están configuradas como manual, puedes establecerlas como auto con el siguiente comando:

    update-alternatives --auto psql

    Si configuras las alternativas en auto, los archivos binarios psql y postgres apuntarán a las versiones actualizadas. De lo contrario, los archivos binarios apuntarán a la versión anterior, lo que puede causar problemas.