อัปเกรด PostgreSQL ไม่สำเร็จ

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info

ลักษณะปัญหา

คุณได้รับข้อผิดพลาดเมื่ออัปเดตฐานข้อมูล PostgreSQL

ข้อความแสดงข้อผิดพลาด

ERROR: PostgreSQL Upgrade FAILED

สาเหตุที่เป็นไปได้

สาเหตุ คำอธิบาย วิธีการแก้ปัญหาใช้ได้กับ
การตั้งค่าการจำลองที่ไม่ถูกต้องในไฟล์การกำหนดค่า PostgreSQL การอัปเกรด PostgreSQL ไม่สำเร็จเนื่องจากการตั้งค่าการจำลองที่ไม่ถูกต้องในระหว่างการอัปเกรด ผู้ใช้ Edge Private Cloud
การติดตั้ง PostgreSQL ดำเนินการโดยผู้ใช้ที่ติดตั้งรายอื่นที่ไม่ใช่ผู้ใช้ Apigee ตอนแรกมีการติดตั้ง 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. หากไฟล์นี้มีการตั้งค่าการจำลองที่คาดไว้ ให้ไปที่การติดตั้ง PostgreSQL ที่ดำเนินการโดยผู้ใช้การติดตั้งอื่นที่ไม่ใช่ผู้ใช้ "apigee"
  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. ทำให้ไฟล์การกำหนดค่า pg_hba.conf เปลี่ยนแปลงไม่ได้โดยใช้คำสั่งต่อไปนี้เพื่อ ตรวจสอบว่าไฟล์จะไม่ได้รับการอัปเดตด้วยการตั้งค่าที่ไม่ถูกต้องในระหว่างการอัปเกรด PostgreSQL

    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

สาเหตุ: ผู้ใช้ติดตั้งรายอื่นที่ไม่ใช่ผู้ใช้ apigee เป็นผู้ติดตั้ง PostgreSQL

การวินิจฉัย

  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. เพิ่ม set -x ในบรรทัดที่ 2 ของไฟล์ /opt/apigee/apigee-postgresql/lib/actions/db_upgrade

  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 ไปยัง เวอร์ชันที่อัปเกรดแล้ว ไม่เช่นนั้น ไบนารีจะชี้ไปยังเวอร์ชันเก่ากว่า ซึ่งอาจทำให้เกิดปัญหาได้