PostgreSQL 升級失敗

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

問題

更新 PostgreSQL 資料庫時發生錯誤。

錯誤訊息

ERROR: PostgreSQL Upgrade FAILED

可能原因

原因 說明 疑難排解操作說明適用於：
PostgreSQL 設定檔中的複製設定有誤 升級期間，由於複寫設定有誤，PostgreSQL 升級失敗。 Edge Private Cloud 使用者
由 apigee 使用者以外的其他安裝使用者執行 PostgreSQL 安裝作業 PostgreSQL 最初是由其他使用者安裝，導致升級失敗。 Edge Private Cloud 使用者

常見的診斷步驟

如果升級 PostgreSQL 資料庫時發生錯誤，請先執行下列診斷步驟：

  1. 重新命名 PostgreSQL 資料夾：

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

  2. 確認原始備份資料位於名為 /opt/apigee/data/apigee-postgresql/pgdata-version.old/ 的資料夾中

    例如：

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

  3. 使用下列指令，將 /opt/apigee/data/apigee-postgresql/pgdata-version.old/ 中的備份資料還原至 /opt/apigee/data/apigee-postgresql/pgdata：

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

    例如：

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

  4. 重新執行 db_upgrade 指令：

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

  5. 如果收到下列錯誤訊息...

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

    ...然後使用下列指令將 pg_control.old 檔案重新命名為 pg_control：

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

  6. 重新執行 db_upgrade 指令：

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

    如果問題持續發生，請參閱「原因：PostgreSQL 設定檔中的複製設定不正確」。

原因：PostgreSQL 設定檔中的複製設定不正確

診斷

  1. 檢查 PostgreSQL 設定檔 /opt/apigee/apigee-postgresql/conf/pg_hba.conf 是否包含您想要的複寫設定。
  2. 如果這個檔案包含預期的複製設定，請前往「由『apigee』使用者以外的其他安裝使用者執行的 PostgreSQL 安裝作業」。
  3. 如果沒有，請前往「解決方法」。

解決方法

  1. 使用下列指令重新命名 PostgreSQL 資料夾：

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

  2. 確認原始備份資料位於名為 /opt/apigee/data/apigee-postgresql/pgdata-version.old/ 的資料夾中。

    例如：

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

  3. 使用下列指令，將備份資料從 /opt/apigee/data/apigee-postgresql/pgdata-version.old/ 還原至 /opt/apigee/data/apigee-postgresql/pgdata：

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

    例如：

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

  4. 如果您曾變更從屬主機，就必須在 /opt/apigee/customer/application/postgresql.properties 中更新下列屬性，才能更新設定檔 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. 重新啟動 apigee-postgresql 服務，確保上述步驟 4 中設定的屬性已更新至設定檔 pg_hba.conf：

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

  6. 使用下列指令將設定檔設為不可變更，確保 PostgreSQL 升級期間不會以錯誤設定更新設定檔：pg_hba.conf

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

  7. 重新執行 db_upgrade 指令：

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

  8. 從設定檔 pg_hba.conf 中移除不可變更的設定：

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

原因：PostgreSQL 安裝作業是由 apigee 使用者以外的其他安裝使用者執行

診斷

  1. 按照下列步驟操作，檢查是否有其他使用者將 rolesuper 設為 true：

    1. 在 PostgreSQL 節點上，使用下列指令登入 PostgreSQL：

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

    2. 執行下列 SQL 查詢：

      select * from pg_authid;

    3. 檢查是否有 rolesuper 設為 true 的多位使用者。 如果有的話，PostgreSQL 升級作業就會失敗，因為系統已將其他使用者設為「安裝使用者」，而非「apigee」使用者。凡是具有 rolesuper 角色且 OID 較低的使用者，都會視為安裝使用者。

      如要檢查這類角色問題，請執行下列 SQL 查詢：

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

解決方法

  1. 使用下列指令登入 PostgreSQL：

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

  2. 將舊資料庫中現有的 apigee 角色重新命名為臨時使用者 (例如：apigee2)：

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

  3. 假設還有其他安裝使用者 srcapige，將「srcapige」角色重新命名為「apigee」：

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

  4. 將 apigee2 重新命名為 srcapige 使用者：

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

  5. 更新所有已重新命名的使用者密碼：

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

  6. 使用下列指令重新命名 PostgreSQL 資料夾：

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

  7. 確認名為「/opt/apigee/data/apigee-postgresql/pgdata-version.old/」的資料夾內有原始備份資料

    例如：

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

  8. 使用下列指令，將 /opt/apigee/data/apigee-postgresql/pgdata-version.old/ 資料夾中的資料還原至 /opt/apigee/data/apigee-postgresql/pgdata：

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

    例如：

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

  9. 重新執行 db_upgrade 指令：

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

  10. 重新啟動所有 apigee-qpidd 和 edge-qpid-server 服務：

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

如果問題仍未解決，請參閱「必須收集診斷資訊」。

必須收集診斷資訊

如果按照上述疑難排解說明操作後，問題仍未解決，請收集下列診斷資訊。請與 Apigee 支援團隊聯絡，並提供下列資訊：

  1. 在 /opt/apigee/apigee-postgresql/lib/actions/db_upgrade 檔案的第二行新增 set -x。

  2. 請按照常見診斷步驟操作，並將 db_upgrade 指令的控制台輸出內容提供給支援團隊：

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

  3. 請將下列記錄檔提供給支援團隊：

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

  4. 請提供下列作業系統指令的輸出內容，檢查替代項目是否設為 auto。

    update-alternatives --display psql

    或

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

    如果替代項目設為 manual，可以使用下列指令將其設為 auto：

    update-alternatives --auto psql

    將替代方案設為 auto，即可將 psql 和 postgres 二進位檔指向升級版本。否則，二進位檔會指向舊版，這可能會導致問題。