ارتقا PostgreSQL ناموفق بود

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

نشانه

هنگام به‌روزرسانی پایگاه داده 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 را بازراه‌اندازی کنید تا مطمئن شوید دارایی تنظیم‌شده در مرحله ۴ بالا در فایل پیکربندی 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
    

علت: نصب 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. ‫set -x را در خط دوم فایل /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 به نسخه‌های ارتقایافته هدایت شوند. درغیراین‌صورت، فایل‌های باینری به نسخه قدیمی‌تر اشاره خواهند کرد که می‌تواند باعث بروز مشکل شود.