درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
نشانه
هنگام بهروزرسانی پایگاه داده PostgreSQL، خطا دریافت میکنید.
پیام خطا
ERROR: PostgreSQL Upgrade FAILED
علل احتمالی
| علت | شرح | دستورالعملهای عیبیابی برای موارد زیر اعمال میشود |
|---|---|---|
| تنظیمات تکرار نادرست در فایل پیکربندی PostgreSQL | ارتقای PostgreSQL بهدلیل تنظیمات نادرست تکثیر درطول ارتقا ناموفق است. | کاربران Edge Private Cloud |
| نصب PostgreSQL توسط کاربر نصب دیگری غیراز کاربر apigee انجام شده است | 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تنظیمات تکثیر موردنظر شما را داشته باشد. - اگر این فایل تنظیمات تکثیر موردانتظار را دارد، به نصب PostgreSQL که توسط کاربر نصب دیگری غیراز کاربر «apigee» انجام شده است بروید.
- اگر اینطور نیست، به وضوح بروید.
وضوح
پوشه داده 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را بازراهاندازی کنید تا مطمئن شوید دارایی تنظیمشده در مرحله ۴ بالا در فایل پیکربندی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
علت: نصب PostgreSQL توسط کاربر نصب دیگری غیر از کاربر apigee انجام شده است
تشخیص
با دنبال کردن این مراحل، بررسی کنید که آیا کاربر دیگری وجود دارد که 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 تماس بگیرید و این اطلاعات را با تیم پشتیبانی همرسانی کنید:
-
set -xرا در خط دوم فایل/opt/apigee/apigee-postgresql/lib/actions/db_upgradeاضافه کنید. مراحل تشخیص خرابی رایج را دنبال کنید و برونداد کنسول فرمان
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اگر جایگزینها روی
manualتنظیم شدهاند، میتوانید آنها را بااستفاده از دستور زیر رویautoتنظیم کنید:update-alternatives --auto psql
تنظیم جایگزینها روی
autoباعث میشود فایلهای باینریpsqlوpostgresبه نسخههای ارتقایافته هدایت شوند. درغیراینصورت، فایلهای باینری به نسخه قدیمیتر اشاره خواهند کرد که میتواند باعث بروز مشکل شود.