您正在查看 Apigee Edge 說明文件。
前往
Apigee X說明文件。 資訊
問題
更新 PostgreSQL 資料庫時發生錯誤。
錯誤訊息
ERROR: PostgreSQL Upgrade FAILED
可能的原因
| 原因 | 說明 | 疑難排解操作說明適用於 |
|---|---|---|
| PostgreSQL 設定檔中的複製設定有誤 | 由於 PostgreSQL 升級期間的複製設定不正確，導致升級失敗。 | Edge Private Cloud 使用者 |
| 由 apigee 使用者以外的其他安裝使用者執行 PostgreSQL 安裝作業 | PostgreSQL 最初安裝時，使用者為其他使用者，導致升級失敗。 | Edge Private Cloud 使用者 |
常見的診斷步驟
如果在升級 PostgreSQL 資料庫時收到錯誤訊息，請先執行下列診斷步驟：
重新命名 PostgreSQL 資料資料夾：
mv /opt/apigee/data/apigee-postgresql/pgdata /opt/apigee/data/apigee-postgresql/pgdata-bkp
確認原始備份資料位於名為「
/opt/apigee/data/apigee-postgresql/pgdata-version.old/」的資料夾中例如：
/opt/apigee/data/apigee-postgresql/pgdata-9.6.old/使用下列指令將
/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
重新執行
db_upgrade指令：/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
如果收到以下錯誤訊息...
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
重新執行
db_upgrade指令：/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
如果問題持續發生，請參閱「原因：PostgreSQL 設定檔的複製作業設定不正確」。
原因：PostgreSQL 設定檔的複製功能設定不正確
診斷
- 檢查 PostgreSQL 設定檔「
/opt/apigee/apigee-postgresql/conf/pg_hba.conf」 以及您想要的複製設定 - 如果這個檔案含有預期的複製設定，請前往由「apigee」使用者以外的其他安裝使用者執行的 PostgreSQL 安裝作業。
- 如未連線，請前往「解析度」。
解析度
使用下列指令重新命名 PostgreSQL 資料夾：
mv /opt/apigee/data/apigee-postgresql/pgdata /opt/apigee/data/apigee-postgresql/pgdata-bkp
確認原始備份資料位於名為「
/opt/apigee/data/apigee-postgresql/pgdata-version.old/」的資料夾中例如：
/opt/apigee/data/apigee-postgresql/pgdata-9.6.old/使用下列指令，將備份資料從
/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
如果您變更了從屬主機，則必須在
/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重新啟動
apigee-postgresql服務，確保在其中設定的屬性 上述步驟 4 會更新為設定檔pg_hba.conf：/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
使用下列指令，將設定檔
pg_hba.conf設為不可變更， 確保在 PostgreSQL 升級期間，不會因設定不正確而進行更新：chattr +i /opt/apigee/apigee-postgresql/conf/pg_hba.conf
重新執行
db_upgrade指令：/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
移除設定檔
pg_hba.conf的不可變動設定：chattr -i /opt/apigee/apigee-postgresql/conf/pg_hba.conf
原因：由 apigee 使用者以外的其他安裝使用者執行 PostgreSQL 安裝作業
診斷
請按照下列步驟確認是否有其他使用者將 rolesuper 設為 true：
在 PostgreSQL 節點上，使用下列指令登入 PostgreSQL：
psql -h $(hostname -i) -U apigee
執行下列 SQL 查詢：
select * from pg_authid;
檢查是否有多位使用者的 rolesuper 設為 true。如果有，表示 PostgreSQL 升級失敗，因為其他使用者 已設為安裝使用者，而非 apigee 使用者。具有 rolesuper 角色和較低的 OID 都會視為安裝使用者。
如要檢查這類角色問題，請執行下列 SQL 查詢：
select oid,rolname,rolsuper from pg_roles; select * from pg_user;
解決方法
使用下列指令登入 PostgreSQL：
psql -h $(hostname -i) -U apigee
將舊資料庫中現有的
apigee角色重新命名為臨時使用者 (例如apigee2)：update pg_authid set rolname ='apigee2' where rolname = 'apigee';
假設有另一位安裝使用者
srcapige。將srcapige角色重新命名為apigee：update pg_authid set rolname ='apigee' where rolname = 'srcapigee';
將
apigee2重新命名為srcapige使用者：update pg_authid set rolname ='secapigee' where rolname = 'apigee2';
為所有重新命名的使用者更新密碼：
ALTER ROLE apigee WITH PASSWORD '<secret>'; ALTER ROLE srcapige WITH PASSWORD '<secret>';使用下列指令重新命名 PostgreSQL 資料夾：
mv /opt/apigee/data/apigee-postgresql/pgdata /opt/apigee/data/apigee-postgresql/pgdata-bkp
確認有相同名稱的資料夾中有原始備份資料
/opt/apigee/data/apigee-postgresql/pgdata-version.old/例如：
/opt/apigee/data/apigee-postgresql/pgdata-9.6.old/使用下列指令，將
/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
重新執行
db_upgrade指令：/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
重新啟動所有
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 支援團隊聯絡，並將下列資訊提供給支援團隊：
- 在
/opt/apigee/apigee-postgresql/lib/actions/db_upgrade檔案的第二行新增set -x。 請按照常見的診斷步驟操作，並將
db_upgrade指令的資訊主機輸出內容提供給支援團隊：opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
將下列記錄檔提供給支援團隊：
/opt/apigee/var/log/apigee-postgresql/apigee-postgresql.log /opt/apigee/var/log/apigee-postgresql/update.log提供下列作業系統指令的輸出內容，檢查是否 替代版本設為
auto。update-alternatives --display psql
或
update-alternatives --display pgsqlupdate-alternatives --list psql或
update-alternatives --list pgsql
如果將替代值設為
manual，您可以使用下列指令將其設為auto指令：update-alternatives --auto psql
將替代方案設為
auto會將psql和postgres二進位檔指向升級版本。否則二進位檔會指向舊版，可能會導致問題。