Apigee Edge 4.19.06 را به عقب برگردانید

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

می‌توانید Edge 4.19.06 را به نسخه‌های Feature Release زیر برگردانید:

  • نسخه 4.19.01
  • نسخه 4.18.05
  • نسخه 4.18.01

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

  1. به نسخه قبلی ویژگی برگردید . به عنوان مثال از 4.19.06 تا 4.18.05.
  2. به نسخه به‌روزرسانی قبلی در همان نسخه برگردید . به عنوان مثال، از 4.19.01.02 تا 4.19.01.01.

برای اطلاعات بیشتر، روند انتشار Apigee Edge را ببینید.

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

کاربری که rollback انجام می دهد باید همان کاربری باشد که Edge را در ابتدا به روز کرده است یا کاربری که به عنوان root اجرا می شود.

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

کامپوننت هایی با کد مشترک

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

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

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

به نسخه قبلی ویژگی برگردید

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

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

    • برای بازگشت به نسخه 4.19.01، 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 
    • برای بازگشت به نسخه 4.18.01، bootstrap_4.18.01.sh دانلود کنید:
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.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، باید محتویات فایل /opt/nginx/conf.d را علاوه بر حذف نصب گروه مؤلفه edge-gateway حذف کنید:
      cd /opt/nginx/conf.d
      rm -rf *
  5. نسخه 4.19.06 apigee-setup :
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
    را حذف نصب کنید
  6. نسخه 4.19.01، 4.18.05 یا 4.18.01 برنامه کاربردی apigee-service و وابستگی های آن را نصب کنید. مثال زیر نسخه 4.18.01 apigee-service نصب می کند:
    sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

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

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

  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.01-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. این فرآیند را برای هر گره ای که میزبان مؤلفه ای است که در حال بازگرداندن آن هستید، تکرار کنید.