برگرداندن Apigee Edge 4.50.00

اگر درطول به‌روزرسانی به Edge 4.50.00 با خطایی مواجه شدید، می‌توانید مؤلفه‌ای را که باعث خطا شده است برگردانید و سپس به‌روزرسانی را دوباره امتحان کنید.

می‌توانید Edge 4.50.00 را به نسخه‌های «انتشار ویژگی» زیر عقب‌گرد کنید:

  • نسخه ۴.۱۹.۰۶
  • نسخه 4.19.01
  • نسخه ۴.۱۸.۰۵

دو سناریو وجود دارد که ممکن است بخواهید بازگرداندن را انجام دهید:

  1. به «نسخه ویژه» قبلی برگردید. برای مثال از ‫۴.۵۰.۰۰ به ۴.۱۸.۰۵.
  2. به نسخه به‌روزرسانی قبلی در همان نسخه پخش برگردید. برای مثال، از 4.19.01.02 به 4.19.01.01.

برای اطلاعات بیشتر، به فرایند انتشار Apigee Edge مراجعه کنید.

چه کسی می‌تواند بازگرداندن را انجام دهد

کاربری که بازگشت به نسخه قبلی را انجام می‌دهد باید همان کاربری باشد که در ابتدا Edge را به‌روزرسانی کرده است، یا کاربری که به‌عنوان root اجرا می‌شود.

به‌طور پیش‌فرض، مؤلفه‌های Edge به‌عنوان کاربر «apigee» اجرا می‌شوند. در برخی موارد، ممکن است مؤلفه‌های Edge را به‌عنوان کاربران مختلف اجرا کنید. برای مثال، اگر «مسیریاب» باید به درگاه‌های ممتاز دسترسی داشته باشد، مثل درگاه‌های زیر ۱۰۰۰، باید «مسیریاب» را به‌عنوان ریشه یا به‌عنوان کاربری که به آن درگاه‌ها دسترسی دارد اجرا کنید. یا ممکن است یک مؤلفه را به‌عنوان یک کاربر و مؤلفه دیگر را به‌عنوان کاربر دیگری اجرا کنید.

عنصرهایی با کد مشترک

مؤلفه‌های Edge زیر کد مشترک دارند. بنابراین، برای عقب‌گرد کردن هریک از این مؤلفه‌ها در یک گره، باید همه این مؤلفه‌های موجود در آن گره را عقب‌گرد کنید.

  • edge-management-server (سرور مدیریت)
  • edge-message-processor (پردازشگر پیام)
  • ‫edge-router (رهیاب)
  • edge-postgres-server (سرور Postgres)
  • edge-qpid-server (Qpid Server)

برای مثال، اگر «سرور مدیریت»، «رهیاب»، و «پردازشگر پیام» را در گره نصب کرده باشید، برای بازگرداندن هرکدام از آن‌ها باید هر سه را بازگردانید.

برگشتن به «نسخه ویژگی» قبلی

برای عقب‌گرد به «انتشار ویژگی» قبلی، در هر گره‌ای که میزبان مؤلفه است، کارهای زیر را انجام دهید:

  1. فایل bootstrap.sh را برای نسخه‌ای که می‌خواهید به آن برگردید بارگیری کنید:

    • برای بازگشت به نسخه ۴.۱۹.۰۶، bootstrap_4.19.06.sh را بارگیری کنید: 
      curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
    • برای بازگشت به نسخه ۴.۱۹.۰۱، bootstrap_4.19.01.sh را بارگیری کنید: 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    • برای بازگشت به نسخه 4.18.05، bootstrap_4.18.05.sh را بارگیری کنید: 
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  2. عنصری را که می‌خواهید عقب‌گرد شود متوقف کنید:
    1. برای بازگرداندن هریک از مؤلفه‌های دارای کد مشترک در گره، باید همه آن‌ها را متوقف کنید، همان‌طور که در مثال زیر نشان داده شده است: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. برای عقب‌گرد کردن هر مؤلفه دیگری در گره، فقط همان مؤلفه را متوقف کنید: 
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. اگر «درآمدزایی» را برمی‌گردانید، آن را از همه گره‌های «سرور مدیریت» و «پردازشگر پیام» حذف نصب کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. برای بازگشت به نسخه قبلی در گره، مؤلفه را حذف نصب کنید:
    1. برای بازگرداندن هریک از مؤلفه‌های دارای کد مشترک در گره، باید همه آن‌ها را با حذف نصب گروه مؤلفه edge-gateway حذف نصب کنید، همان‌طور که در مثال زیر نشان داده شده است: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. برای بازگرداندن هر مؤلفه دیگری در گره، فقط آن مؤلفه را حذف نصب کنید، همان‌طور که مثال زیر نشان می‌دهد: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      که component نام مؤلفه است.

    3. برای بازگرداندن Edge Router، باید علاوه‌بر حذف نصب گروه مؤلفه edge-gateway، محتوای فایل /opt/nginx/conf.d را نیز حذف کنید: 
      cd /opt/nginx/conf.d
rm -rf *
  5. نسخه 4.50.00 apigee-setup را حذف نصب کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. نسخه ۴.۱۹.۰۱ یا ۴.۱۸.۰۵ از ابزار apigee-service و وابستگی‌های آن را نصب کنید. مثال زیر نسخه ۴.۱۸.۰۵ apigee-service را نصب می‌کند: 
    sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

    که uName و pWord نام کاربری و گذرواژه‌ای است که از Apigee دریافت کرده‌اید. اگر pWord را حذف کنید، از شما خواسته می‌شود آن را وارد کنید.

    اگر خطایی دریافت کردید، مطمئن شوید فایل bootstrap.sh را در مرحله ۱ بارگیری کرده باشید.

  7. نصب apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. نسخه قدیمی‌تر مؤلفه را نصب کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    که component مؤلفه موردنظر برای نصب و configFile فایل پیکربندی شما برای نسخه قدیمی‌تر است.

  9. اگر Qpid را برمی‌گردانید، iptables را پاک کنید: 
    sudo iptables -F
  10. این فرایند را برای هر گره‌ای که میزبان مؤلفه‌ای است که می‌خواهید برگردانید تکرار کنید.

برگشتن به نسخه به‌روزرسانی قبلی

برای بازگرداندن مؤلفه به نسخه خاصی از انتشار، در هر گره‌ای که مؤلفه را میزبانی می‌کند، کارهای زیر را انجام دهید:

  1. نسخه عنصر خاص را بارگیری کنید: 
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    که component_version مؤلفه و نسخه به‌روزرسانی برای نصب است. برای مثال:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.05-0.0.3749 install

    اگر از مخزن آنلاین Apigee استفاده می‌کنید، می‌توانید نسخه‌های مؤلفه دردسترس را بااستفاده از فرمان زیر تعیین کنید: 

    yum --showduplicates list comp

    برای مثال:

    yum --showduplicates list edge-ui
  2. از apigee-setup برای نصب مؤلفه استفاده کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

    برای مثال:

    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

    توجه داشته باشید که هنگام نصب مؤلفه، فقط نام آن را مشخص می‌کنید، نه نسخه آن را.

  3. این فرایند را برای هر گره‌ای که میزبان مؤلفه‌ای است که می‌خواهید برگردانید تکرار کنید.