عقب‌گرد کردن Apigee Edge 4.52.02

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

می‌توانید Edge 4.52.02 را به هریک از نسخه‌های اصلی زیر برگردانید:

  • نسخه ۴.۵۲.۰۱
  • نسخه 4.52.00
  • نسخه 4.51.00

برگرداندن نسخه شامل برگرداندن هر مؤلفه‌ای است که ممکن است ارتقا داده باشید. علاوه‌براین، براساس نسخه‌ای که از آن شروع کرده‌اید، ممکن است لازم باشد قبل‌از برگرداندن برخی‌از عناصر نرم‌افزار، مراحل ویژه‌ای را درنظر بگیرید. جدول زیر فهرست اجزای مختلف نرم‌افزاری را ارائه می‌دهد که ممکن است درطول برگرداندن به مراحل ویژه‌ای نیاز داشته باشند:

برگشتن به نسخه ملاحظات ویژه برای نرم‌افزار
4.52.01 Cassandra
4.52.00 Zookeeper، Cassandra، Qpid
4.51.00 Zookeeper، Postgres، Cassandra، Qpid

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

  1. برگشتن به نسخه قبلی اصلی یا فرعی. برای مثال، از ۴.۵۲.۰۲ به ۴.۵۲.۰۰.
  2. برگشتن به نسخه وصله قبلی در همان نسخه پخش. برای مثال، از 4.52.00.02 به 4.52.00.01.

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

ترتیب عقب‌گرد

برگرداندن مؤلفه‌ها باید به ترتیب معکوس ارتقا آن‌ها انجام شود، با این تفاوت که «سرورهای مدیریت» باید پس‌از Cassandra برگردانده شوند. ‫Cassandra، اجزای زمان اجرا، و «سرور مدیریت» باید بااستفاده از رویکرد مرکز داده به مرکز داده (DC-by-DC) به عقب برگردانده شوند و موقتاً ترافیک به مراکز داده کارا هدایت شود.

ترتیب معمول کلی برای برگرداندن Private Cloud 4.52.02 به این شکل است:

مرکز داده تکی

برای راه‌اندازی مرکز داده تکی، فرایند برگرداندن با تأثیر قابل‌توجهی بر ترافیک زمان اجرا و برخی‌از میاناهای برنامه‌سازی کاربردی مدیریت مواجه خواهد شد.

  1. برگرداندن Qpid و دیگر عناصر مرتبط با تجزیه‌وتحلیل
  2. برگرداندن رهیاب‌ها و پردازنده‌های پیام
  3. برگرداندن Cassandra
  4. سرور مدیریت عقب‌گرد
  5. برگرداندن Postgres و Zookeeper

چندین مرکز داده

در تنظیمات چندمرکز داده، بازگرداندن باید از رویکرد مرکز داده به مرکز داده (DC-by-DC) پیروی کند و ترافیک را به‌طور موقت به مراکز داده کارا هدایت کند. این کار باعث تداوم ترافیک می‌شود، از زمان توقف جلوگیری می‌کند، و فرایند بازگرداندن کنترل‌شده‌ای را برای Cassandra، سرور مدیریت، و گره‌های زمان اجرا امکان‌پذیر می‌کند.

  1. برگرداندن Qpid و دیگر عناصر مرتبط با تجزیه‌وتحلیل در همه مراکز داده.
  2. ترافیک را در مرکز داده اول مسدود کنید و ترافیک را به مراکز داده دیگر هدایت کنید.
  3. «مسیرگزین‌ها» و «پردازشگرهای پیام» را در مرکز داده اول برگردانید.
  4. ‫Cassandra را در مرکز داده اول برگردانید.
  5. سرور «مدیریت برگرداندن» در مرکز داده اول.
  6. ترافیک را در اولین مرکز داده رفع انسداد کنید و مراحل ۲ تا ۶ را دنبال کنید تا آخرین مرکز داده به عقب برگردد و گره‌های زمان اجرا، کاساندرا، و سرور مدیریت را دریافت کند.
  7. ‫Postgres،‏ Zookeeper، و LDAP را در همه مراکز داده برگردانید.

برای اینکه بهتر متوجه شوید، فرض کنید کل خوشه Cassandra، همه «سرورهای مدیریت»، و چند «پردازشگر پیام زمان اجرا» (RMP) را از نسخه ۴.۵۲.۰۱ به ۴.۵۲.۰۲ ارتقا داده‌اید و باید یک بازگردانی انجام دهید. در این مورد، بازگرداندن باید به این صورت انجام شود:

  1. برای اطمینان از تداوم سرویس، ترافیک را به اولین مرکز داده (مرکز داده) مسدود کنید و ترافیک را به دیگر مراکز داده فعال هدایت کنید.
  2. برگرداندن «مسیریاب‌ها» و «پردازشگرهای پیام» در مرکز داده اول.
  3. با بازیابی از نسخه پشتیبان یا تصویر فوری ماشین مجازی، ‫Cassandra را در اولین مرکز داده برگردانید.
  4. در مرکز داده اول، «سرور مدیریت» را برگردانید.
  5. ترافیک را رفع انسداد کنید به مرکز داده اول.
  6. برای هر مرکز داده باقی‌مانده، مراحل ۱ تا ۵ را تکرار کنید تا زمانی که همه گره‌های «زمان اجرا»، Cassandra، و «سرورهای مدیریت» به نسخه قبلی برگردانده شوند.

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

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

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

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

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

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

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

برگرداندن Cassandra

وقتی ارتقای عمده‌ای در گره Cassandra خاصی انجام می‌شود، Cassandra طرحواره داده‌های ذخیره‌شده در گره را تغییر می‌دهد و واگرد مستقیم را غیرممکن می‌کند. دو روش برای برگرداندن وجود دارد. شما از یکی از این روش‌ها براساس وضعیت ارتقایی که از آن برمی‌گردید استفاده خواهید کرد.

روش‌های عقب‌گرد

سناریوهای عقب‌گرد

‫Edge for Private Cloud نسخه ۴.۵۲.۰۲ شامل ارتقا در Cassandra و درایور مورداستفاده پردازشگر پیام و سرور مدیریت برای اتصال به Cassandra است. درنتیجه، ارتقا و برگرداندن این ۳ عنصر به‌هم مرتبط است. جدول زیر نمونه‌های کلی از سناریوهای برگرداندن برای این سه عنصر خاص را فهرست می‌کند. برگرداندن دیگر عناصر باید طبق بخش ترتیب برگرداندن انجام شود.

این بخش سناریوهای مختلف بازگرداندن را به‌همراه روش‌شناسی توصیه‌شده برای دنبال کردن، براساس رویکردهای شرح‌داده‌شده در بالا، بیان می‌کند.

سناریو استراتژی عقب‌گرد
مرکز داده تکی، برخی‌از گره‌های Cassandra ارتقا داده شد بازیابی پشتیبان‌گیری
مرکز داده تکی، همه گره‌های Cassandra ارتقا یافتند بازیابی پشتیبان‌گیری
مرکز داده تکی، همه گره‌ها (Cassandra، سرور مدیریت، و گره‌های زمان اجرا) ارتقا یافتند
چندین مرکز داده، برخی/همه گره‌های Cassandra در مرکز داده اول ارتقا یافته است بازسازی از مرکز داده موجود
چندین مرکز داده، همه گره‌های Cassandra، سرور «مدیریت»، و گره‌های «زمان اجرا» در اولین مرکز داده ارتقا یافتند

این کار باید در هر زمان روی یک مرکز داده انجام شود.
چندین مرکز داده، برخی/همه گره‌های Cassandra آخرین مرکز داده ارتقا یافته‌اند
چندین مرکز داده، همه گره‌های Cassandra، سرور «مدیریت»، و گره‌های «زمان اجرا» در همه مراکز داده ارتقا یافتند

این کار باید در هر زمان در یک مرکز داده انجام شود.

به‌طورکلی، هنگام برگرداندن Cassandra باید موارد زیر را درنظر بگیرید:

  1. برگرداندن مؤلفه‌های زمان اجرا یا مدیریت

    اگر لازم است مؤلفه‌هایی مثل «کارساز مدیریت Edge» یا «پردازشگر پیام Edge» را در هر مرکز داده‌ای (DC) به نسخه قبلی «ابر خصوصی Edge» برگردانید، مطمئن شوید که Cassandra نیز در همان مرکز داده خاص و در همان زمان به نسخه قبلی برگردانده شود. این کار برای جلوگیری از خطاهای ترافیک مدیریت و زمان اجرا ضروری است.

  2. برگرداندن بااستفاده از نسخه‌های پشتیبان

    نسخه‌های پشتیبان گرفته‌شده از Cassandra 3.11.x با نسخه‌های پشتیبان Cassandra 2.1.x سازگار نیست. برای فعال کردن برگرداندن بااستفاده از بازیابی پشتیبان، مطمئن شوید که قبل‌از انجام ارتقا، از Cassandra 2.1.x پشتیبان‌گیری شده باشد.

  3. جداسازی مرکز داده برای برگرداندن

    برای جلوگیری از زمان توقف، مطمئن شوید که ترافیک به مراکز داده کاملاً کاربردی هدایت می‌شود و از مرکز داده‌ای که درحال بازگرداندن است مسدود می‌شود.

برگرداندن Cassandra بااستفاده از بازسازی

پیش‌نیازها

  1. درحال کار با خوشه Edge for Private Cloud 4.51.00 / 4.52.00 / 4.52.01 در چندین مرکز داده هستید
  2. درحال ارتقا دادن Cassandra از نسخه 2.1.X به 3.11.X هستید و درطول ارتقا با مشکلاتی مواجه شده‌اید
  3. حداقل ۱ مرکز داده کاملاً کارآمد در خوشه‌ای دارید که هنوز از نسخه قدیمی‌تر Cassandra (Cassandra 2.1.X) استفاده می‌کند

گام‌های سطح بالا

  1. یکی از مراکز داده (که به‌صورت جزئی یا کامل ارتقا یافته است) را که می‌خواهید به عقب برگردانید انتخاب کنید. همه ترافیک برنامه را از این مرکز داده به مرکز داده کاملاً کارآمد دیگری هدایت کنید.
  2. اگر «پردازشگر پیام» و «مسیریاب» ارتقا یافته است، همه گره‌های «پردازشگر پیام» و «مسیریاب» را در مرکز داده، یکی‌یکی، به نسخه قبلی برگردانید.
  3. ‫Cassandra را در یک گره متوقف کنید، آن را حذف نصب کنید، و همه داده‌های منسوب را پاک‌سازی کنید.
  4. نسخه قبلی bootstrap را نصب کنید و Cassandra نسخه 2.1.x را در گره پاک‌شده راه‌اندازی کنید.
  5. گره را از مرکز داده کارکردی موجود که هنوز Cassandra 2.1.x را اجرا می‌کند بازسازی کنید.
  6. مراحل ۳ تا ۵ را روی هر گره Cassandra باقی‌مانده در مرکز داده، یک گره در هر زمان، انجام دهید.
  7. راه‌اندازی «سرور مدیریت» را در مرکز داده مجدداً اجرا کنید.
  8. برای اعتبارسنجی کردن برگرداندن، آزمایش انجام دهید. پس‌از درستی‌سنجی، ترافیک برنامه را به مرکز داده بازگردانده‌شده هدایت کنید.
  9. مراحل بالا را برای سایر مراکز داده‌ای که نیاز به بازگرداندن دارند، یکی‌یکی تکرار کنید.

مراحل دقیق پاک‌سازی و استفاده از گره‌های موجود در خوشه برای بازسازی گره:

با گرهی که می‌خواهید به عقب برگردانید شروع کنید

  1. قبل‌از ادامه دادن مراحل بعدی، مطمئن شوید که ترافیک به مراکز داده کاملاً فعال هدایت شده است.
  2. اگر «رهیاب» و «پردازشگر پیام» ارتقا یافته است، همه گره‌های «رهیاب» و «پردازشگر پیام» را در مرکز داده، یکی‌یکی، به نسخه قبلی برگردانید.
  3. ‫Cassandra را در گره متوقف کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  4. نرم‌افزار Cassandra را از گره حذف نصب کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
  5. برداشتن فهرست داده از گره: 
    rm -rf /opt/apigee/data/apigee-cassandra

  6. راه‌اندازی نسخه قدیمی‌تر Edge for Private Cloud را که می‌خواهید به آن برگردید بارگیری و اجرا کنید:

    مثال: برای برگرداندن به نسخه ۴.۵۲.۰۱

  7. بارگیری خودراه‌انداز نسخه ۴.۵۲.۰۱: 
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
  8. اجرای خودراه‌انداز نسخه ۴.۵۲.۰۱: 
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
  9. «نرم‌افزار Cassandra» را در گره نصب کنید: 
    apigee-service apigee-cassandra install
  10. دارایی زیر را به فایل /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh اضافه کنید. 
    JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=<cass_ip-address>"

    مثال: 

    JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=10.0.0.1"

  11. راه‌اندازی Cassandra در گره: 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
  12. پس‌از اینکه Cassandra UP و RUNNING شد، CWC بالا را از فایل زیر بردارید:فایل /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh.
  13. بازراه‌اندازی گره Cassandra 
    apigee-service apigee-cassandra restart
  14. با ارائه نام مرکز داده عملکردی، بازسازی را در گره اجرا کنید: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h <node-IP> <functional-dc>

    مثال: 

    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h 10.0.0.1 dc-2

  15. مراحل بالا را برای هر گره‌ای که می‌خواهید در مرکز داده برگردانید، یکی‌یکی تکرار کنید.

وقتی همه گره‌های Cassandra در مرکز داده به عقب برگردانده و بازسازی شدند

  1. راه‌اندازی هریک از گره‌های سرور مدیریت را در مرکز داده‌ای که درحال برگرداندن است اجرا کنید. مطمئن شوید که سرور مدیریت از نسخه برگردانده‌شده باشد. اگر این‌طور نیست، سرور مدیریت را نیز برگردانید.

    2. برگرداندن سرور مدیریت به نسخه قدیمی‌تر

  2. سرور مدیریت را متوقف کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
  3. اگر از درآمدزایی استفاده می‌کنید، درآمدزایی را نیز حذف نصب کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. حذف نصب edge-gateway و apigee-cassandra-client: 
    /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
     
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall
  5. بارگیری و اجرای راه‌اندازی نسخه قدیمی‌تر. برای مثال، مراحل زیر را برای بارگیری و اجرای bootstrap نسخه 4.52.01 اجرا کنید 
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
     
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    6. راه‌اندازی سرور مدیریت

  6. راه‌اندازی یک گره سرور مدیریت: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f configFile
  7. پس‌از تکمیل مراحل بالا، ترافیک را به مرکز داده برگشت‌خورده هدایت کنید.

بهینه‌سازی پس‌از بازسازی

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

مثال: فرض کنید شش گره Cassandra در مرکز داده محلی دارید. به‌طور پیش‌فرض، عامل تکثیر Apigee سه است، بنابراین هر گره ۵۰٪ از داده‌ها را دراختیار دارد. در این مورد، می‌توانید با دنبال کردن رویه بالا، گره‌های ۱ و ۴ را بازسازی کنید. برای گره‌های شماره ۲، ۳، ۵، و ۶، مراحل زیر را برای بازیابی نسخه پشتیبان و اجرای تعمیر دنبال کنید.

  1. برای بازسازی رونوشت‌ها در مرکز داده محلی، روش مستندشده تا مراحل بالا را دنبال کنید.
  2. برای گره‌های باقی‌مانده، مراحل زیر را در هر گره باقی‌مانده به‌صورت جداگانه دنبال کنید.
  3. پشتیبان‌گیری‌ای را که در این گره ضبط کرده‌اید بازیابی کنید (توجه: این پشتیبان‌گیری احتمالاً داده‌های قدیمی دارد زیرا این پشتیبان‌گیری قبل‌از شروع ارتقای Cassandra گرفته شده است): 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file

    اگر عکس آنی ماشین مجازی گره را دارید، می‌توانید به‌جای بازیابی پشتیبان‌گیری Cassandra، عکس آنی را بازیابی کنید.

  4. پس‌از بازیابی پشتیبان، سرویس Cassandra را در گره شروع کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
  5. تعمیر را در گره اجرا کنید تا جدیدترین داده‌ها بتوانند از مرکز داده موجود جاری‌سازی شوند: 
    /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -dc <local-dc-name>

    مثال: 

    /opt/apigee/apigee-cassandra/bin/nodetool -h 10.0.0.1 repair -dc dc-1

  6. همه مراحل بالا را که در «مرحله ۲» ذکر شده است در هر گره‌ای که می‌خواهید تعمیر کنید تکرار کنید

عقب‌گرد Cassandra بااستفاده از پشتیبان‌گیری / تصویر فوری ماشین مجازی

اگر کل خوشه Cassandra را ارتقا داده‌اید و می‌خواهید به نسخه قبلی برگردید، این روش تنها روش دردسترس است. علاوه‌براین، پشتیبان‌گیری‌های Apigee مختص گره است. امکان بازیابی نسخه پشتیبان گرفته‌شده از یک گره در گره دیگر وجود ندارد. نسخه‌های پشتیبان Cassandra شامل اطلاعات فراداده گره (مثل نشانی IP، موقعیت حلقه، و غیره) است.

پیش‌نیازها

  1. در فرایند ارتقا دادن Cassandra از نسخه 2.1.X به 3.11.X در آخرین مرکز داده هستید و درطول ارتقا با مشکلاتی مواجه شده‌اید.
  2. قبل‌از ارتقایی که درحال برگرداندن آن هستید، پشتیبان‌هایی برای گره دارید. نسخه پشتیبان قبل‌از تلاش برای ارتقا از نسخه ۲.۱.X به ۳.۱۱.X گرفته شده است.

گام‌های سطح بالا

  1. مرکز داده‌ای را (که به‌صورت جزئی یا کامل ارتقا یافته است) برای برگرداندن انتخاب کنید. همه ترافیک زمان اجرا را از این مرکز داده به مرکز داده کاملاً کارآمد دیگری هدایت کنید.
  2. اگر رهیاب و پردازشگر پیام ارتقا یافته است، همه گره‌های رهیاب و پردازشگر پیام را در مرکز داده، یکی‌یکی، به نسخه قبلی برگردانید
  3. ‫Cassandra را در یک گره متوقف کنید، آن را حذف نصب کنید، و همه داده‌های منسوب را پاک‌سازی کنید.
  4. نسخه قبلی bootstrap را نصب کنید و Cassandra نسخه 2.1.x را در گره پاک‌شده راه‌اندازی کنید.
  5. گره Cassandra را متوقف کنید و همه داده‌های منسوب را پاک کنید.
  6. گره Cassandra را از نسخه پشتیبان گرفته‌شده قبل‌از ارتقا بازیابی کنید.
  7. مراحل ۳ تا ۶ را برای هریک از گره‌های Cassandra باقی‌مانده در مرکز داده، یک گره در هر زمان، تکرار کنید.
  8. راه‌اندازی «سرور مدیریت» را در مرکز داده مجدداً اجرا کنید.
  9. برای اعتبارسنجی کردن برگرداندن، آزمایش انجام دهید. پس‌از درستی‌سنجی، ترافیک زمان اجرای هدایت را به مرکز داده بازیابی‌شده برگردانید.
  10. مراحل بالا را برای سایر مراکز داده‌ای که نیاز به بازگرداندن دارند، یکی‌یکی تکرار کنید.
  11. (اختیاری) اگر بین همه گره‌های Cassandra در همه مراکز داده ناسازگاری داده وجود دارد، فرمان تعمیر را در همه آن‌ها اجرا کنید.

مراحل دقیق برای برگرداندن Cassandra بااستفاده از پشتیبان‌گیری‌ها/تصویر فوری ماشین مجازی

با ۱ گره cassandra در خوشه شروع کنید

  1. قبل‌از ادامه دادن مراحل بعدی، مطمئن شوید که ترافیک به مراکز داده کاملاً فعال هدایت شده است.
  2. اگر رهیاب و پردازشگر پیام ارتقا یافته است، همه گره‌های رهیاب و پردازشگر پیام را در مرکز داده، یکی‌یکی، به نسخه قبلی برگردانید.
  3. ‫Cassandra را در گره متوقف کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  4. نرم‌افزار Cassandra را از گره حذف نصب کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
  5. برداشتن فهرست داده از گره: 
    rm -rf /opt/apigee/data/apigee-cassandra

  6. راه‌اندازی نسخه قدیمی‌تر Edge for Private Cloud را که می‌خواهید به آن برگردید بارگیری و اجرا کنید:

    مثال: برای برگرداندن به نسخه ۴.۵۲.۰۱

  7. بارگیری خودراه‌انداز نسخه ۴.۵۲.۰۱: 
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
  8. اجرای خودراه‌انداز نسخه ۴.۵۲.۰۱: 
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
  9. راه‌اندازی Cassandra در گره: 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
  10. ‫Cassandra را در گره متوقف کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  11. حذف کردن فهرست داده‌ها در گره: 
    rm -rf /opt/apigee/data/apigee-cassandra/data
  12. بازیابی نسخه پشتیبان: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
  13. شروع سرویس Cassandra در گره 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
  14. مراحل را روی هر گره Cassandra یکی‌یکی تکرار کنید.
  15. راه‌اندازی هریک از گره‌های سرور مدیریت را در مرکز داده‌ای که درحال برگرداندن است اجرا کنید. مطمئن شوید که سرور مدیریت از نسخه برگردانده‌شده باشد. اگر این‌طور نیست، سرور مدیریت را نیز برگردانید.
  16. پس‌از تکمیل مراحل بالا، ترافیک را به مرکز داده برگشت‌خورده هدایت کنید.
  17. (اختیاری) اگر بین همه گره‌های Cassandra در همه مراکز داده ناسازگاری داده وجود دارد، فرمان تعمیر را در همه آن‌ها اجرا کنید. 
    /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr

برگرداندن به‌روزرسانی Zookeeper 3.8.3

اگر به نسخه‌های ۴.۵۲.۰۰ یا ۴.۵۱.۰۰ برمی‌گردید، قبل‌از برگشتن به Zookeeper، باید به برخی مراحل ویژه مراجعه کنید. این مراحل در برگرداندن فهرست شده‌اند.

اگر به نسخه ۴.۵۲.۰۱ برمی‌گردید، Zookeeper را نیز مانند هر نرم‌افزار دیگری، همان‌طور که در بخش برگشتن به نسخه اصلی یا فرعی قبلی در زیر فهرست شده است، برگردانید.

برگرداندن Qpid

اگر به نسخه‌های ۴.۵۲.۰۰ یا ۴.۵۱.۰۰ برمی‌گردید، قبل‌از برگرداندن Qpid باید به برخی مراحل ویژه مراجعه کنید. این مراحل در برگرداندن فهرست شده‌اند.

اگر به نسخه ۴.۵۲.۰۱ برمی‌گردید، Qpid را مانند هر نرم‌افزار دیگری که در برگشتن به نسخه اصلی یا فرعی قبلی فهرست شده است برگردانید.

برگرداندن به‌روزرسانی Postgres 10.17

اگر به نسخه ۴.۵۱.۰۰ برمی‌گردید، قبل‌از برگشتن به Postgres باید به چند مرحله ویژه مراجعه کنید. این مراحل در برگرداندن فهرست شده‌اند.

اگر به نسخه ۴.۵۲.۰۱ یا ۴.۵۲.۰۰ برمی‌گردید، Postgres را همان‌طور که هر نرم‌افزاری را برمی‌گردانید، برگردانید، همان‌طور که در بخش برگشتن به نسخه اصلی یا فرعی قبلی در زیر فهرست شده است.

برگشتن به نسخه اصلی یا فرعی قبلی

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

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

    • برای بازگرداندن به نسخه ۴.۵۱.۰۰، bootstrap_4.51.00.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 و apigee-cassandra-client بردارید، همان‌طور که در مثال زیر نشان داده شده است: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
       
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall
    2. برای برگرداندن هر عنصر دیگری در گره، فقط آن عنصر را حذف نصب کنید، همان‌طور که مثال زیر نشان می‌دهد: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      که در آن component نام عنصر است.

    3. برای برگرداندن «مسیریاب لبه»، باید محتوای فایل /opt/nginx/conf.d را علاوه‌بر حذف نصب گروه مؤلفه edge-gateway حذف کنید: 
      cd /opt/nginx/conf.d
rm -rf *
  5. نسخه ۴.۵۲.۰۲ از apigee-setup را حذف نصب کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. نسخه 4.51.00 ابزار apigee-service و وابستگی‌های آن را نصب کنید. مثال زیر نسخه ۴.۵۱.۰۰ از apigee-service را نصب می‌کند: 
    sudo bash /tmp/bootstrap_4.51.00.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.51.05-0.0.3749 install

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

    yum --showduplicates list component

    برای مثال:

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

    برای مثال:

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

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

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

عقب‌گرد mTLS

برای برگرداندن به‌روزرسانی mTLS، مراحل زیر را در همه میزبان‌ها انجام دهید:

  1. توقف Apigee: 
    apigee-all stop
  2. توقف mTLS: 
    apigee-service apigee-mtls uninstall
  3. بازنصب mTLS: 
    apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf