به‌روزرسانی Apigee Edge 4.52.02 یا 4.53.00 به 4.53.01

‫Apigee از ارتقا دادن Edge for Private Cloud مستقیماً از نسخه 4.52.02 یا 4.53.00 به نسخه 4.53.01 پشتیبانی می‌کند. این صفحه نحوه انجام چنین ارتقاهایی را توضیح می‌دهد.

برای نمای کلی مسیرهای ارتقای سازگار، ماتریس سازگاری ارتقا برای نسخه‌های Edge for Private Cloud را ببینید.

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

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

پس‌از نصب Edge RPM، هر کسی می‌تواند آن‌ها را پیکربندی کند.

کدام عناصر را باید به‌روز کنید

باید همه عناصر Edge را به‌روز کنید. ‫Edge از تنظیماتی که شامل عناصر چند نسخه باشد پشتیبانی نمی‌کند.

به‌روزرسانی پیش‌نیازها

پیش‌از ارتقا دادن Apigee Edge، پیش‌نیازهای زیر را بررسی کنید:

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

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

• مطمئن شوید Edge درحال اجرا است
  بااستفاده از فرمان زیر، مطمئن شوید که Edge درطول فرایند به‌روزرسانی درحال اجرا است:

  /opt/apigee/apigee-service/bin/apigee-all status

• درستی‌سنجی پیش‌نیازهای Cassandra
  

  اگر قبلاً از نسخه قدیمی‌تر Edge for Private Cloud به نسخه ۴.۵۲.۰۲ ارتقا داده‌اید و اکنون قصد دارید به نسخه ۴.۵۳.۰۱ ارتقا دهید، مطمئن شوید مراحل پس‌از ارتقای لازم برای Cassandra را تکمیل کرده‌اید. این مراحل در مستندات ارتقا به نسخه ۴.۵۲.۰۲ شرح داده شده است و همچنین در بخش پیش‌نیازهای ارتقا Cassandra ذکر شده است. اگر مطمئن نیستید که این مراحل درطول ارتقای قبلی تکمیل شده‌اند یا نه، قبل‌از ادامه دادن ارتقا به نسخه ۴.۵۳.۰۱، آن‌ها را دوباره تکمیل کنید.

• پیکربندی کلیدها و گواهینامه‌های IDP در Edge برای «ابر خصوصی» نسخه ۴.۵۳.۰۱
  

  در Edge for Private Cloud نسخه 4.53.01، کلیدها و گواهینامه‌های IDP که در عنصر apigee-sso استفاده می‌شوند اکنون ازطریق محل ذخیره کلید پیکربندی می‌شوند. باید کلید و گواهینامه‌ای را که قبلاً استفاده کرده‌اید به یک انبار کلید صادر کنید. قبل‌از به‌روزرسانی کردن عنصر SSO، مراحل بخش مراحل به‌روزرسانی Apigee SSO از نسخه‌های قدیمی‌تر را برای مراحل دقیق دنبال کنید.

• الزامات Python
  قبل‌از تلاش برای ارتقا، مطمئن شوید که همه گره‌ها، ازجمله گره‌های Cassandra، دارای Python 3 نصب‌شده هستند.

مراحل ویژه‌ای که باید برای ارتقا درنظر بگیرید

برای ارتقا دادن به Edge for Private Cloud 4.53.01، مراحل خاصی را برای ارتقا دادن نرم‌افزارهای خاص اجرا کنید. مراحل لازم به نسخه فعلی شما بستگی دارد. برای اطلاع از نرم‌افزارهای مختلفی که به مراحل تکمیلی نیاز دارند، به جدول زیر مراجعه کنید و دستورالعمل‌های دقیق هرکدام را دنبال کنید. پس‌از تکمیل تکالیف لازم، برای ادامه فرایند ارتقا به رویه اصلی ارتقا برگردید.

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

انتقال خودکار تنظیمات دارایی

اگر با ویرایش کردن فایل‌های .properties در /opt/apigee/customer/application ویژگی‌هایی را تنظیم کرده باشید، این مقادیر با به‌روزرسانی حفظ می‌شوند.

ارتقا به OpenLDAP 2.6 الزامی است

در اینجا روش گام‌به‌گام ارتقا دادن سرویس LDAP زیربنایی Apigee Edge for Private Cloud از OpenLDAP 2.4 قدیمی به OpenLDAP 2.6 ارائه شده است. این ارتقا برای به‌روزرسانی به Apigee Edge for Private Cloud نسخه 4.53.01 و بالاتر الزامی است. این ارتقا برای همه توپولوژی‌های استقرار Apigee LDAP قابل‌اعمال است: تک‌سرور، فعال-غیرفعال، و فعال-فعال (چند سرور اصلی).

پیش‌نیازها و ملاحظات

• توجه داشته باشید که درطول فرایند ارتقای LDAP، «میاناهای برنامه‌سازی کاربردی مدیریت» و درنتیجه، «میانای کاربر Apigee» در همه مناطق کاملاً دردسترس نخواهد بود. همه وظایف سرپرستی - مانند مدیریت کاربران، نقش‌ها، برنامه‌ها، و سازمان‌ها با شکست مواجه خواهد شد و باید متوقف شود. این کار روی پردازش ترافیک پراکسی API شما هیچ تأثیری نمی‌گذارد. لطفاً قبل‌از ادامه دادن به ارتقای LDAP، مطمئن شوید همه edge-management-server و edge-ui خاموش شده باشند.

• پشتیبان‌گیری حیاتی است: پشتیبان‌گیری کامل و اعتبارسنجی‌شده از داده‌های LDAP موجودتان غیرقابل مذاکره است. ادامه دادن بدون پشتیبان معتبر باعث ازدست رفتن غیرقابل‌جبران داده‌ها می‌شود. پشتیبان‌گیری باید درحالی‌که سرویس LDAP هنوز درحال اجرا است آغاز شود تا یک نمای لحظه‌ای سازگار از داده‌های LDAP ثبت شود. برای انجام ارتقای واقعی، پشتیبان‌گیری لازم است. بدون نسخه پشتیبان، نه می‌توانید ارتقا را اجرا کنید و نه می‌توانید به عقب برگردید زیرا مراحل ارتقا شامل پاک کردن داده‌های LDAP است.

آماده‌سازی و نصب (همه سرورهای LDAP)

مراحل این بخش (مرحله ۲ تا مرحله ۵) برای همه توپولوژی‌های استقرار LDAP یکسان است. این کنش‌ها باید در هر سروری که عنصر apigee-openldap در آن نصب شده است انجام شود، صرف‌نظر از نقش آن.

1. لطفاً قبل‌از ادامه دادن به ارتقای LDAP، مطمئن شوید همه edge-management-server و edge-ui را خاموش کرده باشید.

   apigee-service edge-management-server stop
   apigee-service edge-ui stop

2. پشتیبان‌گیری از داده‌های LDAP موجود

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

   • فرمان پشتیبان‌گیری را اجرا کنید. این کنش بایگانی پشتیبان‌گیری با مُهر زمان در دایرکتوری /opt/apigee/backup/openldap ایجاد می‌کند.

     apigee-service apigee-openldap backup

   • دریافت تعداد کل گزارش: تعداد گزارش‌های موجود در دایرکتوری خود را برای اعتبارسنجی پس‌از ارتقا ضبط کنید (تعداد گزارش‌ها باید در همه سرورهای LDAP یکسان باشد). این یک بررسی سلامت است.

     # Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
     ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
     -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l

3. توقف LDAP و پاک‌سازی فهرست‌های راهنمای داده

   این مرحله باید در همه سرورهای LDAP انجام شود. به‌دلیل تغییر نسخه اصلی و تفاوت‌های ساختاری زیربنایی، این کار الزامی است. دایرکتوری تمیز تضمین می‌کند که هیچ تداخلی وجود ندارد. وقتی همه سرورهای LDAP متوقف شوند، اختلال در «واسط برنامه‌سازی کاربردی مدیریت» و «واسط کاربر» شروع خواهد شد.

   • سرویس LDAP را متوقف کنید.

     apigee-service apigee-openldap stop

   • فهرست‌های پیکربندی و داده‌های قدیمی LDAP را برای همیشه بردارید.

     rm -rf /opt/apigee/data/apigee-openldap/*

4. نصب و پیکربندی نسخه جدید LDAP

   در همه سرورهای LDAP، از دستورگان استاندارد Apigee برای بارگیری و نصب نسخه جدید عنصر استفاده کنید.

   • نصب عنصر جدید LDAP: دستورگان به‌روزرسانی فایل پیکربندی شما را می‌خواند و بسته جدید apigee-openldap را نصب می‌کند.

     /opt/apigee/apigee-setup/bin/update.sh -c ldap -f /opt/silent.conf

   • نسخه جدید LDAP را اعتبارسنجی کنید:پس‌از تکمیل نصب، نمایه را مجدد بار کنید و بررسی کنید که نسخه جدید LDAP به‌درستی نصب شده باشد.

     source ~/.bash_profile
     ldapsearch -VV
     Expected output:
     ldapsearch: @(#) $OpenLDAP: ldapsearch 2.6.7

5. پیش‌از بازیابی داده‌ها، LDAP را در همه سرورها متوقف کنید

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

   apigee-service apigee-openldap stop
   rm -rf /opt/apigee/data/apigee-openldap/ldap/*

6. بازیابی داده‌های LDAP

   استراتژی این است که پشتیبان‌گیری را در اولین سرور فعال بازیابی کنید. این سرور سپس به‌عنوان منبع حقیقت عمل می‌کند و داده‌ها را در تنظیمات چندسروری به همتایان خود تکثیر می‌کند.

   1. شناسایی اولین سرور فعال برای بازیابی

      • برای راه‌اندازی تک‌سرور: این تنها سرور LDAP شما است. می‌توانید مستقیماً به مرحله بعدی بروید.
      • برای تنظیمات فعال-غیرفعال و فعال-فعال: فرمان تشخیصی زیر را در هر سرور LDAP اجرا کنید:

        grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*\ldif
        Note:
        -If this command returns output, the server is a passive server.
        -If it returns no output, the server is the active server.

   2. بازیابی داده‌های پشتیبان

      قبل‌از ادامه دادن، دوباره بررسی کنید که «مرحله ۵» در همه سرورهای LDAP باموفقیت تکمیل شده باشد.

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

        cd /opt/apigee/backup/openldap

      • فرمان restore را اجرا کنید. به‌شدت توصیه می‌کنیم برای جلوگیری از بازیابی نسخه ناخواسته یا قدیمی‌تر، مُهر زمان دقیق نسخه پشتیبان را از «مرحله ۲» مشخص کنید.

        # To restore a specific backup (recommended):
        apigee-service apigee-openldap restore 2025.08.11,23.34.00
        
        # To restore the latest available backup by default:
        apigee-service apigee-openldap restore

      • پس‌از تکمیل موفقیت‌آمیز فرایند بازیابی، سرویس LDAP را در اولین سرور فعال شروع کنید.

        apigee-service apigee-openldap start

7. شروع سرورهای ال‌دپ باقی‌مانده

   اگر تنظیمات چند سروری دارید، در هریک از سرورهای LDAP، سرویس را شروع کنید:

   apigee-service apigee-openldap start

8. اعتبارسنجی نهایی

   مرحله آخر این است که تأیید کنید ارتقا باموفقیت انجام شده است و داده‌ها در سراسر خوشه LDAP یکسان است.

   • دستور اعتبارسنجی را در همه سرورهای LDAP اجرا کنید. تعداد گزارش باید در همه سرورها یکسان باشد و با تعداد گزارش‌هایی که در «مرحله ۲» ضبط کردید مطابقت داشته باشد.

   # Note: Replace 'YOUR_PASSWORD' with your LDAP manager password.
   ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
   -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l

   • پس‌از اینکه تأیید کردید داده‌ها درست و یکپارچه است، ارتقا LDAP شما تکمیل می‌شود. اکنون می‌توانید طبق رویه استاندارد ارتقا سازمانتان، سرور مدیریت لبه و واسط کاربر لبه و هریک از عناصر وابسته دیگر را راه‌اندازی کنید.

ارتقا به Cassandra 4.0.18 الزامی است

‫Apigee Edge for Private Cloud 4.53.01 شامل ارتقا Cassandra به نسخه 4.0.18 است.

ارتقا و برگرداندن

• ارتقا از Cassandra 3.11.X به Cassandra 4.0.X فرایندی روان است. ‫Cassandra 4.0.X که با Edge for Private Cloud 4.53.00 منتشر شده است با اجزای زمان اجرا و مدیریت Private Cloud 4.52.02 سازگار است.
• برگرداندن مستقیم درجا از Cassandra 4.0.X به 3.11.X امکان‌پذیر نیست. برگرداندن بااستفاده از رونوشت‌ها یا پشتیبان‌گیری‌ها فرایندی پیچیده است و ممکن است شامل زمان ازکارافتادگی و/یا ازدست رفتن داده‌ها باشد. عیب‌یابی کردن مشکلات و ارتقا به Cassandra 4.0.X بهتر از بازگشت به نسخه قبلی است.
• مهم است که قبل‌از تلاش برای ارتقا، با روش‌های برگرداندن آشنا شوید. توجه به تفاوت‌های ظریف برگرداندن درطول ارتقا برای اطمینان از دردسترس بودن مسیرهای برگرداندن مناسب بسیار مهم است.

مرکز داده تکی

ارتقا دادن Cassandra از نسخه 3.11.X به 4.0.X در یک مرکز داده واحد یکپارچه است، اما برگرداندن پیچیده است و ممکن است منجر به زمان ازکارافتادگی و ازدست رفتن داده‌ها شود. برای حجم‌های کاری تولید، اکیداً توصیه می‌شود که قبل‌از شروع ارتقا، مرکز داده جدیدی اضافه کنید که حداقل گره‌های Cassandra در مرکز داده جدید دردسترس باشد. این کار امکان برگرداندن Cassandra را بدون ازدست رفتن داده‌ها یا اختلال در ترافیک API شما فراهم می‌کند. پس‌از تکمیل ارتقا یا رسیدن به «ایست بازرسی ۲»، این مرکز داده اضافی می‌تواند ازکار انداخته شود.

اگر افزودن مرکز داده جدید امکان‌پذیر نیست اما قابلیت برگرداندن همچنان موردنظر است، برای بازیابی Cassandra 3.11.X، پشتیبان‌گیری ضروری خواهد بود. بااین‌حال، این روش احتمالاً هم شامل زمان توقف و هم ازدست رفتن داده‌ها می‌شود.

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

اجرای چندین مرکز داده با Edge for Private Cloud 4.52.02 انعطاف‌پذیری بیشتری برای بازگرداندن به نسخه قبلی درطول ارتقا به Edge for Private Cloud 4.53.00 ارائه می‌دهد.

• بازگرداندن به نسخه قبلی به داشتن حداقل یک مرکز داده که نسخه قدیمی‌تر Cassandra (3.11.X) را اجرا می‌کند بستگی دارد.
• اگر کل خوشه Cassandra شما به نسخه 4.0.X ارتقا یافته است، نباید به Cassandra 3.11.X برگردید. باید به استفاده از نسخه جدیدتر Cassandra با دیگر عناصر Private Cloud 4.53.00 یا 4.52.02 ادامه دهید.

روش‌شناسی ارتقای توصیه‌شده

1. ارتقا دادن یک مرکز داده Cassandra در هر بار: با ارتقا دادن گره‌های Cassandra به‌صورت جداگانه در یک مرکز داده شروع کنید. پیش‌از رفتن به مرکز داده بعدی، ارتقای همه گره‌های Cassandra را در یک مرکز داده تکمیل کنید.
2. توقف موقت و اعتبارسنجی: پس‌از ارتقا دادن یک مرکز داده، موقتاً متوقف کنید تا مطمئن شوید خوشه «ابر خصوصی» شما، به‌ویژه مرکز داده ارتقایافته، به‌درستی کار می‌کند.
3. به‌یاد داشته باشید: فقط درصورتی می‌توانید به نسخه قبلی Cassandra برگردید که حداقل یک مرکز داده داشته باشید که هنوز نسخه قدیمی‌تر را اجرا می‌کند.
4. حساس به زمان: اگرچه می‌توانید برای مدت کوتاهی (توصیه می‌شود چند ساعت) برای اعتبارسنجی عملکرد موقتاً متوقف کنید، نمی‌توانید برای همیشه در وضعیت نسخه ترکیبی باقی بمانید. دلیل این امر این است که خوشه Cassandra غیریکنواخت (با گره‌هایی در نسخه‌های مختلف) محدودیت‌های عملیاتی دارد.
5. آزمایش کامل: Apigee اکیداً توصیه می‌کند قبل‌از ارتقا دادن مرکز داده بعدی، عملکرد و کارایی را به‌طور جامع آزمایش کنید. پس‌از ارتقا یافتن همه مراکز داده، بازگرداندن به نسخه قبلی غیرممکن است.

برگرداندن به‌عنوان فرایند دو ایست‌بازرسی

1. ایست بازرسی ۱: وضعیت اولیه، با همه عناصر در نسخه ۴.۵۲.۰۲. تا زمانی که حداقل یک مرکز داده Cassandra در نسخه قدیمی‌تر باقی بماند، بازگرداندن کامل امکان‌پذیر است.
2. ایست بازرسی ۲: پس‌از به‌روزرسانی همه گره‌های Cassandra در همه مراکز داده. می‌توانید به این وضعیت عقب‌گرد کنید، اما نمی‌توانید به «ایست بازرسی ۱» برگردید.

مثال

خوشه دو مرکز داده (DC) را درنظر بگیرید:

1. وضعیت شروع: گره‌های Cassandra در هر دو مرکز داده در نسخه 3.11.X هستند. همه گره‌های دیگر در Edge برای نسخه 4.52.02 «ابر خصوصی» هستند. فرض کنید سه گره Cassandra در هر DC وجود دارد.
2. ارتقا DC-1: سه گره Cassandra در DC-1 را یکی‌یکی ارتقا دهید.
3. توقف موقت و اعتبارسنجی: برای اطمینان از اینکه خوشه، به‌ویژه DC-1، به‌درستی کار می‌کند، موقتاً متوقف کنید (عملکرد و کارایی را بررسی کنید). بااستفاده از گره‌های Cassandra در DC-2 می‌توانید به وضعیت اولیه برگردید. به‌خاطر داشته باشید که این توقف موقت باید به‌دلیل محدودیت‌های خوشه Cassandra با نسخه ترکیبی باشد.
4. ارتقا DC-2: سه گره Cassandra باقی‌مانده در DC-2 را ارتقا دهید. این نقطه بازگشت جدید شما می‌شود.
5. ارتقا دادن دیگر عناصر: گره‌های مدیریت، زمان اجرا، و تجزیه‌وتحلیل را طبق معمول در همه مراکز داده، یک گره و یک مرکز داده در هر زمان، ارتقا دهید. اگر مشکلی پیش آمد، می‌توانید به وضعیت مرحله ۴ برگردید.

پیش‌نیازهای ارتقا Cassandra

1. کل خوشه با Cassandra 3.11.16 عملیاتی و کاملاً کارآمد است.
2. استراتژی فشرده‌سازی روی LeveledCompactionStrategy تنظیم شده است (پیش‌نیاز ارتقا به نسخه ۴.۵۲.۰۲).

3. تأیید کنید که هریک از مراحل زیر به‌عنوان بخشی از ارتقای اولیه Cassandra 3.11 در Edge for Private Cloud نسخه 4.52.02 تکمیل شده است.

   • فرمان post_upgrade درطول ارتقای قبلی در هر گره Cassandra اجرا شد
   • فرمان drop_old_tables درطول ارتقای قبلی در کل خوشه Cassandra اجرا شد.

اگر مطمئن نیستید که دستورات post_upgrade و drop_old_tables در Cassandra 3.11 هنگام استفاده از Edge for Private Cloud 4.52.02 اجرا شده است، می‌توانید آن‌ها را قبل‌از تلاش برای ارتقا به 4.53.01 دوباره اجرا کنید.

مرحله ۱: آماده شدن برای ارتقا

مراحل زیر علاوه‌بر فایل‌های استانداردی است که معمولاً ایجاد می‌کنید، مثل فایل پیکربندی استاندارد Apigee برای فعال کردن ارتقاهای مؤلفه.

1. بااستفاده از Apigee از Cassandra پشتیبان‌گیری کنید.
2. از گره‌های Cassandra عکس‌های فوری ماشین مجازی بگیرید (درصورت امکان).
3. اگر قبلاً پیکربندی نشده است، مطمئن شوید که درگاه ۹۰۴۲ از همه عناصر Edge for Private Cloud، ازجمله «سرور مدیریت»، «پردازشگر پیام»، «مسیریاب»، Qpid، و Postgres، به گره‌های Cassandra قابل‌دسترسی باشد. برای اطلاعات بیشتر، به الزامات درگاه مراجعه کنید.

مرحله ۲: ارتقا دادن همه گره‌های Cassandra

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

پس‌از ارتقا دادن همه گره‌های Cassandra در مرکز داده، قبل‌از ادامه دادن با گره‌های مرکز داده بعدی، مدتی (۳۰ دقیقه تا چند ساعت) صبر کنید. در این مدت، مرکز داده‌ای را که به‌روز شده است به‌طور کامل بررسی کنید و مطمئن شوید که سنجه‌های عملکرد و کارکرد خوشه Apigee شما دست‌نخورده است. این مرحله برای اطمینان از پایداری مرکز داده‌ای که در آن Cassandra به نسخه 4.0.X ارتقا یافته است بسیار مهم است، درحالی‌که بقیه عناصر Apigee در نسخه 4.52.02 باقی می‌مانند.

1. برای ارتقا دادن گره Cassandra، فرمان زیر را اجرا کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

2. پس‌از به‌روزرسانی گره، فرمان زیر را در گره اجرا کنید تا قبل‌از ادامه دادن، چند اعتبارسنجی انجام شود:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile

3. مورد بالا چیزی شبیه به این برونداد خواهد داشت:

   Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.18 | CQL spec 3.4.5 | Native protocol v5] 
   Metadata is verified

4. فرمان post_upgrade زیر را در گره Cassandra اجرا کنید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

5. فرمان cleanup_old_index زیر را در گره Cassandra اجرا کنید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra cleanup_old_index

6. فرمان‌های nodetool زیر را اجرا کنید تا شاخص‌ها را بازسازی کنید در گره Cassandra:

   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index

   اگر از درآمدزایی استفاده می‌کنید، فرمان‌های بازسازی نمایه‌های زیر را نیز که مربوط به فضاهای کلید درآمدزایی است اجرا کنید:

   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
   /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx

مرحله ۳: ارتقا دادن همه گره‌های «مدیریت»

همه گره‌های «مدیریت» را در همه مناطق یکی‌یکی ارتقا دهید:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

مرحله ۴: ارتقا دادن همه گره‌های «زمان اجرا»

همه گره‌های «پردازشگر پیام» و «مسیریاب» را در همه مناطق یکی‌یکی ارتقا دهید:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

مرحله ۵: ارتقا دادن همه مؤلفه‌های باقی‌مانده Edge for Private Cloud 4.53.01

همه گره‌های edge-qpid-server و edge-postgres-server باقی‌مانده را در همه مناطق یکی‌یکی ارتقا دهید.

ارتقا به Zookeeper 3.8.4 الزامی است

این نسخه Edge برای «ابر خصوصی» شامل ارتقا به Zookeeper 3.8.4 است. به‌عنوان بخشی از آن ارتقا، همه داده‌های Zookeeper به Zookeeper 3.8.4 انتقال داده خواهد شد.

قبل‌از ارتقا دادن Zookeeper، راهنمای نگهداری Zookeeper را بخوانید. اکثر سیستم‌های تولید Edge از خوشه‌ای از گره‌های Zookeeper استفاده می‌کنند که در چندین مرکز داده پخش شده‌اند. برخی‌از این گره‌ها به‌عنوان رأی‌دهندگانی پیکربندی می‌شوند که در انتخاب رهبر Zookeeper شرکت می‌کنند، و بقیه به‌عنوان ناظر پیکربندی می‌شوند. برای جزئیات بیشتر، درباره رهبران، پیروان، رأی‌دهندگان، و ناظران را ببینید. گره‌های رأی‌دهنده رهبری را انتخاب می‌کنند و پس‌از آن گره‌های رأی‌دهنده خودشان پیرو می‌شوند.

درطول فرایند به‌روزرسانی، ممکن است هنگام خاموش شدن گره رهبر، تأخیر لحظه‌ای یا خطای نوشتن در Zookeeper رخ دهد. این امر می‌تواند بر عملیات «مدیریت» که در Zookeeper می‌نویسند، مانند عملیات استقرار پراکسی، و تغییرات زیرساخت Apigee، مانند افزودن یا برداشتن پردازشگر پیام و غیره، تأثیر بگذارد. درطول ارتقای Zookeeper و درحین پیروی از رویه زیر، نباید هیچ تأثیری بر میاناهای برنامه‌سازی کاربردی زمان اجرا Apigee (مگر اینکه این میاناهای برنامه‌سازی کاربردی زمان اجرا میاناهای برنامه‌سازی کاربردی مدیریت را فراخوانی کنند) داشته باشد.

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

پشتیبان‌گیری

از همه گره‌های Zookeeper پشتیبان‌گیری کنید تا درصورت نیاز به برگرداندن، از آن استفاده کنید. توجه داشته باشید که برگرداندن به نسخه قبلی Zookeeper را به وضعیتی که در زمان پشتیبان‌گیری داشته است برمی‌گرداند. توجه: هرگونه استقرار یا تغییر زیرساخت در Apigee از زمان تهیه نسخه پشتیبان (که اطلاعات آن در Zookeeper ذخیره می‌شود) درطول بازیابی ازدست خواهد رفت.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

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

شناسایی رهبر، پیروان و ناظران

توجه: فرمان‌های نمونه زیر از ابزار nc برای ارسال داده به Zookeeper استفاده می‌کنند. می‌توانید از ابزارهای کمکی جایگزین برای ارسال داده به Zookeeper نیز استفاده کنید.

1. اگر در گره ZooKeeper نصب نشده است، nc را نصب کنید:

     sudo yum install nc

2. فرمان nc زیر را در گره اجرا کنید، که در آن ۲۱۸۱ درگاه ZooKeeper است:

     echo stat | nc localhost 2181

   باید بروندادی مانند زیر ببینید:

     Zookeeper version: 3.8.4-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
     Clients:
      /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
     
     Latency min/avg/max: 0/0.2518/41
     Received: 647228
     Sent: 647339
     Connections: 4
     Outstanding: 0
     Zxid: 0x400018b15
     Mode: follower
     Node count: 100597

   در خط Mode برونداد گره‌ها، بسته به پیکربندی گره باید ناظر، رهبر، یا پیرو (یعنی رأی‌دهنده‌ای که رهبر نیست) را ببینید. توجه: در نصب خوداتکای Edge با یک گره ZooKeeper، Mode روی خوداتکا تنظیم می‌شود.

3. مراحل ۱ و ۲ را در هر گره ZooKeeper تکرار کنید.

ارتقا دادن Zookeeper در گره‌های ناظر و پیرو

‫Zookeeper را در هریک از گره‌های ناظر و پیرو به این ترتیب ارتقا دهید:

1. راه‌اندازی اولیه Edge for Private Cloud نسخه 4.53.01 را همان‌طور که در به‌روزرسانی به نسخه 4.53.01 در گره‌ای با اتصال اینترنت خارجی توضیح داده شده است بارگیری و اجرا کنید. این فرایند احتمالاً بسته به اینکه گره اتصال اینترنت خارجی داشته باشد یا نصب آفلاین انجام دهید، متفاوت خواهد بود.
2. ارتقا دادن مؤلفه Zookeeper:

     /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>

   توجه: اگر این گره‌ها مؤلفه‌های دیگری نصب‌شده داشته باشند (مثل Cassandra)، می‌توانید آن‌ها را هم اکنون (مثل نمایه cs،zk) ارتقا دهید یا می‌توانید مؤلفه‌های دیگر را بعداً ارتقا دهید. ‫Apigee توصیه می‌کند که ابتدا فقط Zookeeper را ارتقا دهید و مطمئن شوید خوشه‌تان به‌درستی کار می‌کند سپس دیگر عناصر را ارتقا دهید.
3. مراحل بالا را در هریک از گره‌های پیرو و ناظر Zookeeper تکرار کنید.

ازکار انداختن رهبر

پس‌از ارتقا یافتن همه گره‌های ناظر و پیرو، رهبر را خاموش کنید. در گره شناسایی‌شده به‌عنوان رهبر، فرمان زیر را اجرا کنید:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

توجه داشته باشید که درطول این رویداد، قبل‌از انتخاب رهبر جدید، ممکن است تأخیرهای لحظه‌ای یا نوشتن ناموفق در Zookeeper رخ دهد. این امر می‌تواند بر عملیاتی که در Zookeeper می‌نویسند تأثیر بگذارد، مثل کنش استقرار کارگزاران یا تغییرات زیرساخت Apigee، مثل افزودن یا برداشتن پردازشگرهای پیام و غیره.

تأیید کنید که رهبر جدید انتخاب شده است

بااستفاده از مراحل بخش شناسایی رهبر، پیروان، و ناظران در بالا، تأیید کنید که پس‌از توقف رهبر فعلی، رهبر جدیدی از میان پیروان انتخاب شده است. توجه داشته باشید که رهبر می‌تواند در مرکز داده‌ای متفاوت از رهبر کنونی انتخاب شده باشد.

ارتقا دادن رهبر

همان مراحل ارتقا دادن Zookeeper در گره‌های ناظر و پیرو در بالا را دنبال کنید.

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

ارتقا Nginx 1.26 در Edge-Router

ارتقا دادن به Edge for Private Cloud 4.53.01 از نسخه‌های قبلی، نرم‌افزار Nginx را به‌طور خودکار به جدیدترین نسخه (1.26.x) ارتقا نمی‌دهد. این کار برای جلوگیری از هرگونه عوارض جانبی زمان اجرا درنتیجه تغییرات مستندشده در تغییرات Nginx 1.26 در Apigee Edge 4.53.01 انجام می‌شود. پس‌از درستی‌سنجی در محیط‌های پایین‌تر، می‌توانید Nginx را به‌صورت دستی از نسخه 1.20.x به 1.26.x ارتقا دهید. برای ارتقا دادن دستی:

1. مطمئن شوید گره روتر لبه جدیدترین نرم‌افزار ۴.۵۳.۰۱ را داشته باشد

   /opt/apigee/apigee-service/bin/apigee-service edge-router version

2. نسخه Nginx را که درحال‌حاضر اجرا می‌کنید بررسی و درستی‌سنجی کنید

   /opt/nginx/sbin/nginx -V

   اگر از نسخه قدیمی‌تری از Nginx استفاده می‌کنید، می‌توانید مراحل زیر را برای ارتقا دادن Nginx به نسخه 1.26.X در گره مسیریاب دنبال کنید.

3. فرایند رهیاب لبه را در گره رهیاب متوقف کنید

   /opt/apigee/apigee-service/bin/apigee-service edge-router stop

4. ارتقا دادن نرم‌افزار nginx در گره مسیریاب

   dnf update apigee-nginx-1.26.3

5. تأیید کنید که نسخه Nginx به‌روز شده است

   /opt/nginx/sbin/nginx -V

6. فرایند رهیاب را در گره شروع کنید

   /opt/apigee/apigee-service/bin/apigee-service edge-router start

7. این فرایند را برای هر گره مسیریاب، یکی‌یکی، تکرار کنید

ارتقا به Postgres 17 الزامی است

این نسخه Edge شامل ارتقا به Postgres 17 است. به‌عنوان بخشی از این ارتقا، همه داده‌های Postgres به Postgres 17 انتقال داده می‌شود.

اکثر سیستم‌های تولید Edge از دو گره Postgres استفاده می‌کنند که برای تکثیر اصلی-آماده‌به‌کار پیکربندی شده‌اند. درطول فرایند به‌روزرسانی، درحالی‌که گره‌های Postgres برای به‌روزرسانی غیرفعال هستند، داده‌های تجزیه‌وتحلیل همچنان در گره‌های Qpid نوشته می‌شود. پس‌از به‌روزرسانی گره‌های Postgres و بازگشت آن‌ها به حالت آنلاین، داده‌های Analytics به گره‌های Postgres ارسال می‌شود.

نحوه انجام به‌روزرسانی Postgres به نحوه پیکربندی فضای ذخیره‌سازی داده برای گره‌های Postgres بستگی دارد:

• اگر از فضای ذخیره‌سازی داده‌های محلی برای گره‌های Postgres خود استفاده می‌کنید، باید گره آماده‌به‌کار Postgres جدیدی را برای مدت زمان ارتقا نصب کنید. پس‌از تکمیل ارتقا، می‌توانید گره آماده به‌کار جدید Postgres را ازکار بیندازید.

  اگر به هر دلیلی مجبور شوید به‌روزرسانی را برگردانید، گره آماده‌به‌کار Postgres اضافی لازم است. اگر مجبور شوید به‌روزرسانی را برگردانید، گره آماده‌به‌کار جدید Postgres پس‌از برگرداندن به گره اصلی Postgres تبدیل می‌شود. بنابراین، وقتی گره آماده‌به‌کار جدید Postgres را نصب می‌کنید، باید در گره‌ای باشد که همه الزامات سخت‌افزاری سرور Postgres را که در الزامات نصب Edge تعریف شده است برآورده کند.

  در پیکربندی ۱ گره و ۲ گره Edge، توپولوژی‌های مورداستفاده برای نمونه‌سازی اولیه و آزمایش، فقط یک گره Postgres دارید. می‌توانید این گره‌های Postgres را مستقیماً به‌روز کنید بدون اینکه نیاز به ایجاد گره Postgres جدیدی داشته باشید.

• اگر برای گره‌های Postgres از فضای ذخیره‌سازی شبکه استفاده می‌کنید، همان‌طور که Apigee توصیه می‌کند، لازم نیست گره Postgres جدیدی نصب کنید. در روال‌های زیر، می‌توانید از مراحلی که نصب و سپس برچیدن گره آماده‌به‌کار جدید Postgres را مشخص می‌کنند رد شوید.

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

درحال نصب گره آماده‌به‌کار Postgres جدید

این رویه سرور آماده‌به‌کار Postgres را در گره جدیدی ایجاد می‌کند. مطمئن شوید که سرور آماده‌به‌کار Postgres جدیدی برای نسخه موجود Edge (نسخه ۴.۵۲.۰۲ یا ۴.۵۳.۰۰) نصب می‌کنید، نه برای نسخه ۴.۵۳.۰۱.

برای انجام نصب، از همان فایل پیکربندی که برای نصب نسخه فعلی Edge استفاده کرده‌اید استفاده کنید.

برای ایجاد گره آماده‌به‌کار جدید Postgres:

1. در Postgres master کنونی، فایل /opt/apigee/customer/application/postgresql.properties را ویرایش کنید تا نشان زیر را تنظیم کنید. اگر آن فایل وجود ندارد، آن را ایجاد کنید:

   conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

   که در آن existing_standby_ip نشانی IP سرور آماده‌به‌کار Postgres کنونی و new_standby_ip نشانی IP گره آماده‌به‌کار جدید است.

2. ‫apigee-postgresql را در سرور اصلی Postgres بازراه‌اندازی کنید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

3. با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf در سرور اصلی، تأیید کنید که گره آماده‌به‌کار جدید اضافه شده است. باید خطوط زیر را در آن فایل ببینید:

   host replication apigee existing_standby_ip/32 trust
   host replication apigee new_standby_ip/32 trust

4. نصب سرور آماده‌به‌کار جدید Postgres:
   1. فایل پیکربندی را که برای نصب نسخه فعلی Edge استفاده کرده‌اید ویرایش کنید تا موارد زیر را مشخص کنید:

      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102

   2. SELinux را طبق روشی که در نصب ابزار کمکی apigee-setup در Edge توضیح داده شده است غیرفعال کنید.

   3. اگر درحال‌حاضر از Edge 4.52.02 استفاده می‌کنید:

      1. فایل Edge bootstrap_4.52.02.sh را در /tmp/bootstrap_4.52.02.sh بارگیری کنید:

         curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.51.00.sh

      2. ابزار Edge apigee-service و وابستگی‌ها را نصب کنید:

         sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      اگر درحال‌حاضر از Edge 4.53.00 استفاده می‌کنید:

      1. فایل Edge bootstrap_4.53.00.sh را در /tmp/bootstrap_4.53.00.sh بارگیری کنید:

         curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh

      2. ابزار Edge apigee-service و وابستگی‌ها را نصب کنید:

         sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

   4. برای نصب ابزار apigee-setup، از apigee-service استفاده کنید:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   5. نصب Postgres:

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

   6. در گره آماده به‌کار جدید، فرمان زیر را اجرا کنید:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      درستی‌سنجی کنید که در حالت آماده‌به‌کار باشد.

درحال انجام ارتقای درجا برای Postgres

مرحله مقدماتی

قبل‌از انجام ارتقای درجا به Postgres، مراحل زیر را در میزبان اصلی و آماده‌به‌کار انجام دهید تا دارایی max_locks_per_transaction را در apigee-postgresql به‌روز کنید:

1. اگر وجود ندارد، فایل /opt/apigee/customer/application/postgresql.properties را ایجاد کنید.
2. مالکیت این فایل را به apigee تغییر دهید:

   sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

3. دارایی زیر را به فایل اضافه کنید:

   conf/postgresql.conf+max_locks_per_transaction=30000

4. پیکربندی apigee-postgresql:

   apigee-service apigee-postgresql configure

5. بازراه‌اندازی apigee-postgresql:

   apigee-service apigee-postgresql restart

انجام ارتقای درجا

برای انجام ارتقای درجا به Postgres 17، مراحل زیر را انجام دهید:

1. ارتقا دادن postgres در میزبان اصلی

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

2. فرمان راه‌اندازی را در میزبان اصلی اجرا کنید:

   apigee-service apigee-postgresql setup -f /opt/silent.conf

3. فرمان پیکربندی را در میزبان اصلی اجرا کنید:

   apigee-service apigee-postgresql configure

4. بازراه‌اندازی میزبان اصلی:

   apigee-service apigee-postgresql restart

5. آن را به‌عنوان اصلی پیکربندی کنید:

   apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf

6. مطمئن شوید که میزبان اصلی شروع کرده است:

   apigee-service apigee-postgresql wait_for_ready

7. توقف آماده‌به‌کار:

   apigee-service apigee-postgresql stop

8. آماده‌به‌کار را ارتقا دهید.

   توجه: اگر این مرحله با خطا مواجه شد/انجام نشد، می‌توانید آن را نادیده بگیرید. ‫update.sh تلاش خواهد کرد سرور آماده‌به‌کار را با پیکربندی نادرست شروع کند. اگر نصب Postgres به نسخه ۱۷ ارتقا یابد، می‌توان این خطا را نادیده گرفت.

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

9. مطمئن شوید آماده‌به‌کار متوقف شده باشد:

   apigee-service apigee-postgresql stop

10. پیکربندی آماده به‌کار قدیمی را بردارید:

    rm -rf /opt/apigee/data/apigee-postgresql/

11. راه‌اندازی تکثیر در سرور آماده‌به‌کار:

    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

12. خط conf/postgresql.conf+max_locks_per_transaction=30000 را از فایل /opt/apigee/customer/application/postgresql.properties در هر دو میزبان اصلی و آماده‌به‌کار بردارید. این خط در مرحله مقدماتی اضافه شده است.

پس‌از تکمیل این روش، آماده‌به‌کار با موفقیت شروع خواهد شد.

ازکار انداختن گره Postgres

پس‌از تکمیل به‌روزرسانی، گره آماده به‌کار جدید را ازکار بیندازید:

1. مطمئن شوید Postgres درحال اجرا است:

   /opt/apigee/apigee-service/bin/apigee-all status

   اگر Postgres اجرا نمی‌شود، آن را شروع کنید:

   /opt/apigee/apigee-service/bin/apigee-all start

2. با اجرای فرمان curl زیر در گره آماده به‌کار جدید، شناسه UUID گره آماده به‌کار جدید را دریافت کنید:

   curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

   باید UUID گره را در انتهای برونداد به‌صورت زیر ببینید:

   "type" : [ "postgres-server" ],
   "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

3. با اجرای فرمان زیر در گره آماده‌به‌کار جدید، گره آماده‌به‌کار جدید را متوقف کنید:

   /opt/apigee/apigee-service/bin/apigee-all stop

4. در گره اصلی Postgres، /opt/apigee/customer/application/postgresql.properties را ویرایش کنید تا گره آماده‌به‌کار جدید را از conf_pg_hba_replication.connection بردارید:

   conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust

5. ‫apigee-postgresql را در Postgres master بازراه‌اندازی کنید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

6. با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf در سرور اصلی، مطمئن شوید که گره آماده‌به‌کار جدید برداشته شده است. باید فقط خط زیر را در آن فایل ببینید:

   host replication apigee existing_standby_ip/32 trust

7. با انجام دادن تماس «میانای برنامه‌سازی کاربردی مدیریت Edge» زیر در گره «سرور مدیریت»، شناسه UUID گره آماده به‌کار را از ZooKeeper حذف کنید:

   curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

مراحل پس‌از ارتقا برای Postgres

پس‌از ارتقای بزرگ Postgres، آمار داخلی Postgres پاک می‌شود. این آمارها به برنامه‌ریز پُرسمان Postgres کمک می‌کند تا از بهینه‌ترین نمایه‌ها و مسیرها برای اجرای پُرسمان‌ها استفاده کند.

‫Postgres می‌تواند به‌تدریج آمار خود را درطول زمان با اجرای پُرسمان‌ها و زمانی که کارگزار autovacuum اجرا می‌شود بازسازی کند. بااین‌حال، تا زمانی که آمار بازسازی شود، پُرسمان‌های شما ممکن است کند باشد.

برای رفع این مشکل، ANALYZE را در همه جدول‌های پایگاه داده در گره اصلی Postgres اجرا کنید. یا اینکه می‌توانید ANALYZE را برای چند جدول به‌طور هم‌زمان اجرا کنید.

مراحل به‌روزرسانی Apigee SSO از نسخه‌های قدیمی‌تر

در Edge for Private Cloud نسخه 4.53.01، کلیدها و گواهینامه‌های IDP که در عنصر apigee-sso استفاده می‌شوند اکنون ازطریق محل ذخیره کلید پیکربندی می‌شوند. باید کلید و گواهی‌ای را که قبلاً استفاده می‌کردید به یک keystore صادر کنید، آن را پیکربندی کنید، و سپس به‌طور معمول به‌روزرسانی SSO را انجام دهید.

1. کلید و گواهینامه موجود مورداستفاده برای پیکربندی IDP را شناسایی کنید:

   1. با جستجوی مقدار SSO_SAML_SERVICE_PROVIDER_CERTIFICATE در فایل پیکربندی نصب «ورود به سیستم با یک حساب کاربری» یا با پُرسمان کردن عنصر apigee-sso برای conf_login_service_provider_certificate، گواهینامه را بازیابی کنید.

      از فرمان زیر در گره SSO برای پُرسمان apigee-sso برای مسیر گواهی IDP استفاده کنید. در برونداد، مقدار را در خط آخر پیدا کنید.

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

   2. با جستجوی مقدار SSO_SAML_SERVICE_PROVIDER_KEY در فایل پیکربندی نصب «شناسایی یگانه» یا با پُرسمان کردن عنصر apigee-sso برای conf_login_service_provider_key، کلید را بازیابی کنید.

      از فرمان زیر در گره SSO برای پُرسمان apigee-sso برای مسیر کلید IDP استفاده کنید. در برونداد، مقدار را در خط آخر پیدا کنید.

      apigee-service apigee-sso configure -search conf_login_service_provider_key

2. کلید و گواهینامه را به یک انبار کلید صادر کنید:
   1. کلید و گواهی را به یک انبار کلید PKCS12 صادر کنید:

      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      پارامترها:

      • certificate_path: مسیر فایل گواهینامه بازیابی‌شده در مرحله ۱.الف.
      • ‫key_path: مسیر فایل کلید خصوصی که در «مرحله ۱.ب» بازیابی شده است.
      • ‫keystore_path: مسیر به انبار کلید جدیداً ایجادشده که حاوی گواهی و کلید خصوصی است.
      • ‫alias: نام مستعار استفاده‌شده برای جفت کلید و گواهی در انبار کلید.

      برای جزئیات بیشتر، به اسناد OpenSSL مراجعه کنید.

   2. (اختیاری) کلید و گواهینامه را از PKCS12 به انبار کلید JKS صادر کنید:

      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      پارامترها:

      • PKCS12_keystore_path: مسیر انبار کلید PKCS12 که در مرحله ۲.الف ایجاد شده است و حاوی گواهی و کلید است.
      • ‫destination_keystore_path: مسیر به انبار کلید JKS جدید که گواهینامه و کلید در آن صادر خواهد شد.
      • ‫alias: نام مستعار استفاده‌شده برای جفت کلید و گواهی در انبار کلید JKS.

   برای جزئیات بیشتر به اسناد keytool مراجعه کنید.

3. مالک فایل keystore برونداد را به کاربر «apigee» تغییر دهید:

   sudo chown apigee:apigee <keystore_file>

4. ویژگی‌های زیر را در فایل پیکربندی Apigee SSO اضافه کنید و آن‌ها را با مسیر فایل انبار کلید، گذرواژه، نوع انبار کلید، و نام مستعار به‌روز کنید:

   # Path to the keystore file
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks
   
   # Keystore password
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore
   
   # Keystore type
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12
   
   # Alias within keystore that stores the key and certificate
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert 

5. نرم‌افزار Apigee SSO را در گره SSO طبق معمول بااستفاده از فرمان زیر به‌روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

واسط کاربر جدید Edge

این بخش ملاحظاتی را درباره «میانای کاربر Edge» فهرست می‌کند. برای اطلاعات بیشتر، میانای کاربری جدید Edge برای «ابر خصوصی» را ببینید.

نصب کردن میانای کاربر Edge

پس‌از تکمیل نصب اولیه، Apigee توصیه می‌کند که «میانای کاربر Edge» را نصب کنید، که میانای کاربری بهبودیافته‌ای برای توسعه‌دهندگان و سرپرستان Apigee Edge for Private Cloud است.

توجه داشته باشید که «میانای کاربری Edge» نیازمند این است که «احراز هویت پایه» را غیرفعال کنید و از IDP مثل SAML یا LDAP استفاده کنید.

برای اطلاعات بیشتر، نصب واسط کاربر جدید Edge را ببینید.

به‌روزرسانی با Apigee mTLS

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

• حذف نصب Apigee mTLS.
• ‫Apigee mTLS را دوباره نصب کنید.

درحال برگرداندن به‌روزرسانی

درصورت ناموفق بودن به‌روزرسانی، می‌توانید مشکل را برطرف کنید و سپس update.sh را دوباره اجرا کنید. می‌توانید به‌روزرسانی را چند بار اجرا کنید و به‌روزرسانی از جایی که آخرین بار متوقف شده است ادامه می‌یابد.

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

درحال ثبت اطلاعات به‌روزرسانی

به‌طور پیش‌فرض، ابزار update.sh اطلاعات گزارش را در اینجا می‌نویسد:

/opt/apigee/var/log/apigee-setup/update.log

اگر فردی که ابزار update.sh را اجرا می‌کند به آن فهرست راهنما دسترسی نداشته باشد، گزارش را در فهرست راهنمای /tmp به‌عنوان فایلی به‌نام update_username.log می‌نویسد.

اگر فرد به /tmp دسترسی نداشته باشد، ابزار update.sh ناموفق خواهد بود.

به‌روزرسانی بدون توقف

به‌روزرسانی بدون توقف، یا به‌روزرسانی چرخشی، به شما امکان می‌دهد نصب Edge را بدون ازکار انداختن Edge به‌روز کنید.

به‌روزرسانی بدون توقف فقط با پیکربندی ۵ گره‌ای و بزرگ‌تر امکان‌پذیر است.

کلید ارتقا بدون توقف، برداشتن هر «مسیریاب» به‌صورت یکی‌یکی از ترازکننده بار است. سپس «مسیریاب» و هر عنصر دیگری را در همان ماشین «مسیریاب» به‌روزرسانی می‌کنید، و سپس «مسیریاب» را به ترازکننده بار اضافه می‌کنید.

1. ماشین‌ها را به ترتیبی که برای نصب شما در بخش ترتیب به‌روزرسانی ماشین توضیح داده شده است به‌روز کنید.
2. وقتی زمان به‌روزرسانی «مسیریاب‌ها» فرا رسید، یکی از «مسیریاب‌ها» را انتخاب کنید و آن را غیرقابل‌دسترس کنید، همان‌طور که در فعال/غیرفعال کردن دسترسی‌پذیری سرور (پردازشگر پیام/مسیریاب) توضیح داده شده است.
3. «مسیریاب» انتخاب‌شده و همه عناصر دیگر «لبه» را در همان ماشین «مسیریاب» به‌روز کنید. همه پیکربندی‌های Edge «پردازشگر پیام» و «مسیریاب» را در یک گره نشان می‌دهند.
4. «رهیاب» را دوباره دردسترس قرار دهید.
5. مراحل ۲ تا ۴ را برای «مسیریاب‌های» باقی‌مانده تکرار کنید.
6. به‌روزرسانی را برای همه ماشین‌های باقیمانده در نصب ادامه دهید.

قبل و بعداز به‌روزرسانی، موارد زیر را انجام دهید:

• در گره ترکیب‌شده «رهیاب» و «پردازشگر پیام»:
  • قبل‌از به‌روزرسانی – موارد زیر را انجام دهید:
    1. «رهیاب» را غیرقابل‌دسترس کنید.
    2. «پردازنده پیام» را غیرقابل‌دسترس کنید.
  • پس‌از به‌روزرسانی – موارد زیر را انجام دهید:
    1. «پردازنده پیام» را دردسترس قرار دهید.
    2. «رهیاب» را دردسترس قرار دهید.
• در گره‌های «رهیاب» تکی:
  • قبل‌از به‌روزرسانی، «روتر» را غیرقابل‌دسترس کنید.
  • پس‌از به‌روزرسانی، «مسیرگزین» را دردسترس قرار دهید.
• در گره‌های «پردازشگر پیام» تکی:
  • قبل‌از به‌روزرسانی، «پردازشگر پیام» را غیرقابل‌دسترس کنید.
  • پس‌از به‌روزرسانی، «پردازشگر پیام» را دردسترس قرار دهید.

استفاده از فایل پیکربندی بی‌صدا

باید فایل پیکربندی بی‌صدایی را به فرمان به‌روزرسانی ارسال کنید. پرونده پیکربندی بی‌صدا باید همان پرونده‌ای باشد که برای نصب Edge for Private Cloud نسخه 4.52.02 یا 4.53.00 استفاده کرده‌اید.

به ۴.۵۳.۰۱ در گرهی با اتصال اینترنت خارجی به‌روزرسانی کنید

از روش زیر برای به‌روزرسانی مؤلفه‌های Edge در گره استفاده کنید:

1. درصورت وجود، همه کارهای cron را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده‌اند تا پس‌از تکمیل به‌روزرسانی غیرفعال کنید.
2. برای نصب کردن Edge RPM، به‌عنوان ریشه به سیستم گره‌تان وارد شوید.
3. ‫SELinux را طبق آنچه در نصب ابزار کمکی apigee-setup در Edge توضیح داده شده است غیرفعال کنید.
4. اگر درحال نصب در AWS هستید، فرمان‌های زیر را اجرا کنید: yum-configure-manager

   yum update rh-amazon-rhui-client.noarch
   sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

5. اگر درحال‌حاضر از Edge 4.52.02 یا 4.53.00 استفاده می‌کنید:

   1. فایل Edge bootstrap_4.53.01.sh را در /tmp/bootstrap_4.53.01.sh بارگیری کنید:

      curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh

   2. برنامه کمکی Edge 4.53.01 apigee-service و وابستگی‌ها را با اجرای فرمان زیر نصب کنید:

      sudo bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord

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

      به‌طور پیش‌فرض، نصب‌کننده بررسی می‌کند که Java 1.8 نصب شده باشد. اگر آن را نداشته باشید، نصب‌کننده آن را برایتان نصب می‌کند.

      از گزینه JAVA_FIX برای مشخص کردن نحوه مدیریت نصب جاوا استفاده کنید. ‫JAVA_FIX مقادیر زیر را می‌گیرد:

      • ‫I: نصب OpenJDK 1.8 (پیش‌فرض).
      • ‫C: بدون نصب Java ادامه دهید.
      • ‫Q: رها کردن. برای این گزینه، باید خودتان Java را نصب کنید.
   3. از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید، همان‌طور که در مثال زیر نشان داده شده است:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

   4. برنامه کمکی apigee-validate را در «سرور مدیریت» به‌روزرسانی کنید، همان‌طور که در مثال زیر نشان داده شده است:

      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

   5. برنامه کمکی apigee-provision را در «سرور مدیریت» به‌روزرسانی کنید، همان‌طور که در مثال زیر نشان داده شده است:

      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

   6. با اجرای فرمان زیر، ابزار update را در گره‌هایتان اجرا کنید:

      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      این کار را به ترتیبی که در ترتیب به‌روزرسانی ماشینتوضیح داده شده است انجام دهید.

      مکان:

      • ‫component جزء Edge برای به‌روزرسانی است. مقادیر ممکن شامل موارد زیر است:
        • ‫cs: Cassandra
        • ‫edge: همه عناصر Edge به‌جز «میانای کاربر Edge»: «سرور مدیریت»، «پردازشگر پیام»، «مسیریاب»، «سرور QPID»، «سرور Postgres»
        • ‫ldap: ال‌دپ باز
        • ‫ps: postgresql
        • qpid: qpidd
        • sso: Apigee SSO (اگر SSO را نصب کرده‌اید)
        • ‫ue: میانای کاربر جدید Edge
        • ‫ui: میانای کاربر کلاسیک Edge
        • ‫zk: Zookeeper
      • ‫configFile همان فایل پیکربندی است که برای تعریف کردن عناصر Edge درطول نصب نسخه 4.52.02 یا 4.53.00 استفاده کردید.

      با تنظیم component روی «همه»، می‌توانید update.sh را روی همه عناصر اجرا کنید، اما فقط درصورتی‌که نمایه نصب «همه در یک» (AIO) در Edge داشته باشید. برای مثال:

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config

   7. اگر قبلاً این کار را نکرده‌اید، مؤلفه‌های Edge UI را در همه گره‌هایی که آن‌ها را اجرا می‌کنند بازراه‌اندازی کنید:

      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart

   8. به‌روزرسانی را با اجرای ابزار apigee-validate در «سرور مدیریت» همان‌طور که در آزمایش نصب توضیح داده شده است آزمایش کنید.

اگر بعداً تصمیم گرفتید به‌روزرسانی را برگردانید، از روش توضیح‌داده‌شده در برگرداندن 4.53.01 استفاده کنید.

به‌روزرسانی به نسخه ۴.۵۳.۰۱ از مخزن محلی

اگر گره‌های Edge شما پشت دیوار آتش باشند، یا به روشی دیگر از دسترسی به مخزن Apigee ازطریق اینترنت منع شده باشند، می‌توانید به‌روزرسانی را از مخزن محلی، یا آینه، مخزن Apigee انجام دهید.

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

• فایل tar .از مخزن ایجاد کنید، فایل tar .را در گره کپی کنید، و سپس Edge را از فایل tar. به‌روز کنید.
• یک وب‌کارساز روی گره با مخزن محلی نصب کنید تا گره‌های دیگر بتوانند به آن دسترسی داشته باشند. ‫Apigee وب‌کارساز Nginx را برای استفاده شما ارائه می‌دهد، یا می‌توانید از وب‌کارساز خودتان استفاده کنید.

برای به‌روزرسانی از مخزن محلی 4.53.01:

1. مخزن محلی 4.53.01 را همان‌طور که در «ایجاد مخزن محلی Apigee» در نصب ابزار کمکی Edge apigee-setup توضیح داده شده است ایجاد کنید.
2. برای نصب apigee-service از فایل ‎ .tar:
   1. در گره دارای مخزن محلی، از دستور زیر برای بسته‌بندی مخزن محلی در یک فایل .tar به‌نام /opt/apigee/data/apigee-mirror/apigee-4.53.01.tar.gz استفاده کنید:

      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

   2. فایل tar .را در گرهی که می‌خواهید Edge را به‌روز کنید کپی کنید. برای مثال، آن را در دایرکتوری /tmp در گره جدید کپی کنید.
   3. در گره جدید، فایل را در دایرکتوری /tmp از حالت فشرده خارج کنید:

      tar -xzf apigee-4.53.01.tar.gz

      این فرمان پوشه جدیدی به نام repos در پوشه حاوی فایل .tar ایجاد می‌کند. برای مثال /tmp/repos.

   4. ابزار و وابستگی‌های Edge apigee-service را از /tmp/repos نصب کنید:

      sudo bash /tmp/repos/bootstrap_4.53.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      توجه داشته باشید که مسیر دایرکتوری repos را در این فرمان اضافه می‌کنید.

3. برای نصب apigee-service بااستفاده از وب‌سرور Nginx:
   1. سرور وب Nginx را همان‌طور که در «نصب از مخزن بااستفاده از سرور وب Nginx» در نصب ابزار کمکی apigee-setup در Edge توضیح داده شده است پیکربندی کنید.
   2. در گره دور، فایل Edge bootstrap_4.53.01.sh را در /tmp/bootstrap_4.53.01.sh بارگیری کنید:

      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh

      که در آن uName:pWord نام کاربری و گذرواژه‌ای است که قبلاً برای مخزن تنظیم کرده‌اید و remoteRepo نشانی IP یا نام ساناد گره مخزن است.

   3. در گره از دور، ابزار apigee-setup Edge و وابستگی‌ها را نصب کنید:

      sudo bash /tmp/bootstrap_4.53.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      که در آن uName:pWord نام کاربری و گذرواژه مخزن است.

4. از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید، همان‌طور که در مثال زیر نشان داده شده است:

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 

5. برنامه کمکی apigee-validate را در «سرور مدیریت» به‌روزرسانی کنید، همان‌طور که در مثال زیر نشان داده شده است:

   /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

6. برنامه کمکی apigee-provision را در «سرور مدیریت» به‌روزرسانی کنید، همان‌طور که در مثال زیر نشان داده شده است:

   /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

7. ابزار update را روی گره‌هایتان به ترتیبی که در ترتیب به‌روزرسانی ماشین توضیح داده شده است اجرا کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

   مکان:

   • ‫component جزء Edge برای به‌روزرسانی است. معمولاً اجزای زیر را به‌روزرسانی می‌کنید:
     • ‫cs: Cassandra
     • ‫edge: همه عناصر Edge به‌جز «میانای کاربر Edge»: «سرور مدیریت»، «پردازشگر پیام»، «مسیریاب»، «سرور QPID»، «سرور Postgres»
     • ‫ldap: ال‌دپ باز
     • ‫ps: postgresql
     • qpid: qpidd
     • sso: Apigee SSO (اگر SSO را نصب کرده‌اید)
     • ue میانای کاربر جدید Edge
     • ‫ui: میانای کاربر کلاسیک Edge
     • ‫zk: Zookeeper
   • ‫configFile همان فایل پیکربندی است که برای تعریف کردن عناصر Edge درطول نصب نسخه 4.52.02 یا 4.53.00 استفاده کردید.

   با تنظیم component به «همه»، می‌توانید update.sh را دربرابر همه عناصر اجرا کنید، اما فقط درصورتی‌که نمایه نصب همه در یک Edge (AIO) داشته باشید. برای مثال:

   /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config

8. اگر قبلاً این کار را نکرده‌اید، مؤلفه‌های واسط کاربر را در همه گره‌هایی که آن را اجرا می‌کنند بازراه‌اندازی کنید:

   /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart

9. به‌روزرسانی را با اجرای ابزار apigee-validate در «سرور مدیریت» همان‌طور که در آزمایش نصب توضیح داده شده است آزمایش کنید.

اگر بعداً تصمیم گرفتید به‌روزرسانی را برگردانید، از روش توضیح‌داده‌شده در برگرداندن 4.53.01 استفاده کنید.

ترتیب به‌روزرسانی ماشین

ترتیب به‌روزرسانی ماشین‌ها در نصب Edge مهم است:

• قبل‌از به‌روزرسانی هریک از عناصر دیگر، باید همه گره‌های LDAP را به‌روزرسانی کنید. برای ارتقا دادن LDAP باید مراحل ویژه‌ای را دنبال کنید.
• باید همه گره‌های Cassandra و ZooKeeper را به‌روز کنید. اگر از نسخه ۴.۵۲.۰۲ ارتقا می‌دهید، مراحل ویژه ارتقا cassandra را دنبال کنید. برای نسخه 4.52.02 یا 4.53.00 باید مراحل ویژه ارتقا دادن Zookeeper را دنبال کنید.
• برای به‌روزرسانی همه «سرورهای مدیریت» و «پردازشگرهای پیام و مسیریاب»، باید آن‌ها را بااستفاده از گزینه -c edge ارتقا دهید.
• باید همه گره‌های Postgres را با دنبال کردن مراحل ویژه ارتقا Postgres ارتقا دهید.
• باید عناصر edge-qpid-server و edge-postgres-server را در همه مراکز داده به‌روز کنید.
• باید همه گره‌های Qpid را ارتقا دهید.
• باید گره‌های «واسط کاربر Edge» را ارتقا دهید و همچنین گره‌های «واسط کاربر Edge جدید» و «شناسایی یگانه» را(درصورت وجود) ارتقا دهید.
• هیچ مرحله جداگانه‌ای برای به‌روزرسانی «درآمدزایی» وجود ندارد. وقتی گزینه لبه -c را مشخص می‌کنید، به‌روزرسانی می‌شود.

ارتقا مستقل ۱ گره

برای ارتقا دادن پیکربندی مستقل ۱ گره به نسخه ۴.۵۳.۰۱:

1. به‌روزرسانی همه عناصر:

   /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

2. (اگر apigee-adminapi را نصب کرده‌اید) ابزار apigee-adminapi را به‌روز کنید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

ارتقا مستقل ۲ گره

برای نصب مستقل ۲ گره، اجزای زیر را به‌روز کنید:

برای فهرست توپولوژی‌های Edge و تعداد گره‌ها، توپولوژی‌های نصب را ببینید.

1. به‌روزرسانی LDAP در ماشین ۱:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

2. به‌روزرسانی Cassandra و ZooKeeper در ماشین ۱:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

3. به‌روزرسانی اجزای Edge در دستگاه ۱:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

4. به‌روزرسانی Postgres در ماشین ۲:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5. به‌روزرسانی اجزای Edge در دستگاه ۱:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. به‌روزرسانی Qpid در «ماشین ۲»:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

7. به‌روزرسانی کردن واسط کاربر در ماشین ۱:

   /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

8. (اگر apigee-adminapi را نصب کرده باشید) ابزار apigee-adminapi در ماشین ۱ به‌روز شد:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. (اگر Apigee SSO را نصب کرده‌اید) Apigee SSO را در ماشین ۱ به‌روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   که در آن sso_config_file فایل پیکربندی‌ای است که هنگام نصب SSO ایجاد کرده‌اید.

10. بازراه‌اندازی مؤلفه Edge UI در ماشین ۱:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقا ۵ گره

برای نصب ۵ گره، اجزای زیر را به‌روز کنید:

برای فهرست توپولوژی‌های Edge و تعداد گره‌ها، توپولوژی‌های نصب را ببینید.

1. به‌روزرسانی LDAP در ماشین ۱:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

2. ‫Cassandra و ZooKeeper را در ماشین‌های ۱، ۲، و ۳ به‌روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

3. به‌روزرسانی اجزای Edge در ماشین ۱، ۲، ۳:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

4. به‌روزرسانی Postgres در ماشین ۴:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5. به‌روزرسانی Postgres در ماشین ۵:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

6. به‌روزرسانی اجزای Edge در ماشین ۴، ۵:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

7. به‌روزرسانی Qpid در ماشین ۴:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

8. به‌روزرسانی Qpid در ماشین ۵:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

9. به‌روزرسانی میانای کاربر Edge:
   • واسط کاربر کلاسیک: اگر از واسط کاربر کلاسیک استفاده می‌کنید، ui عنصر را در ماشین ۱ به‌روز کنید، همان‌طور که در مثال زیر نشان داده شده است:

     /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

   • واسط کاربر جدید Edge: اگر واسط کاربر جدید Edge را نصب کرده‌اید، عنصر ue را در دستگاه مناسب به‌روز کنید (ممکن است دستگاه ۱ نباشد):

     /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf

10. (اگر apigee-adminapi را نصب کرده باشید) ابزار apigee-adminapi در ماشین ۱ به‌روز شد:

    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

11. (اگر Apigee SSO را نصب کرده‌اید) Apigee SSO را در ماشین ۱ به‌روز کنید:

    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    که در آن sso_config_file فایل پیکربندی‌ای است که هنگام نصب SSO ایجاد کرده‌اید.

12. بازراه‌اندازی عنصر واسط کاربر:
    • واسط کاربر کلاسیک: اگر از واسط کاربر کلاسیک استفاده می‌کنید، edge-ui عنصر را در ماشین ۱ بازراه‌اندازی کنید، همان‌طور که در مثال زیر نشان داده شده است:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • واسط کاربر جدید Edge: اگر واسط کاربر جدید Edge را نصب کرده‌اید، edge-management-ui عنصر را در دستگاه مناسب (ممکن است دستگاه ۱ نباشد) بازراه‌اندازی کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

ارتقای خوشه‌ای ۹ گرهی

برای نصب خوشه‌ای ۹ گره‌ای، اجزای زیر را به‌روز کنید:

برای فهرست توپولوژی‌های Edge و تعداد گره‌ها، توپولوژی‌های نصب را ببینید.

1. به‌روزرسانی LDAP در ماشین ۱:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

2. ‫Cassandra و ZooKeeper را در ماشین‌های ۱، ۲، و ۳ به‌روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

3. اجزای Edge را در ماشین‌های ۱، ۴، و ۵ (سرور مدیریت، پردازشگر پیام، مسیریاب) به این ترتیب به‌روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

4. ‫Postgres را در ماشین ۸ به‌روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5. به‌روزرسانی Postgres در ماشین ۹:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

6. اجزای Edge را در ماشین‌های ۶، ۷، ۸، و ۹ به این ترتیب به‌روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

7. ‫Qpid را در ماشین‌های ۶ و ۷ به‌روزرسانی کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

8. میانای کاربر جدید (ue) یا میانای کاربر کلاسیک (ui) را در ماشین ۱ به‌روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

9. (اگر apigee-adminapi را نصب کرده‌اید) ابزار apigee-adminapi را در ماشین ۱ به‌روز کنید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

10. (اگر Apigee SSO را نصب کرده‌اید) Apigee SSO را در ماشین ۱ به‌روز کنید:

    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    که در آن sso_config_file فایل پیکربندی‌ای است که هنگام نصب SSO ایجاد کرده‌اید.

11. بازراه‌اندازی عنصر واسط کاربر:
    • واسط کاربر کلاسیک: اگر از واسط کاربر کلاسیک استفاده می‌کنید، edge-ui عنصر را در ماشین ۱ بازراه‌اندازی کنید، همان‌طور که در مثال زیر نشان داده شده است:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • واسط کاربر جدید Edge: اگر واسط کاربر جدید Edge را نصب کرده‌اید، edge-management-ui عنصر را در دستگاه مناسب (ممکن است دستگاه ۱ نباشد) بازراه‌اندازی کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

ارتقای خوشه‌ای ۱۳ گرهی

برای نصب خوشه‌ای ۱۳ گره‌ای، اجزای زیر را به‌روز کنید:

برای فهرست توپولوژی‌های Edge و تعداد گره‌ها، توپولوژی‌های نصب را ببینید.

1. به‌روزرسانی LDAP در ماشین ۴ و ۵:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

2. به‌روزرسانی Cassandra و ZooKeeper در ماشین‌های ۱، ۲، و ۳:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

3. اجزای Edge را در ماشین‌های ۶، ۷، ۱۰، و ۱۱ به این ترتیب به‌روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

4. ‫Postgres را در ماشین ۸ به‌روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5. به‌روزرسانی Postgres در ماشین ۹:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

6. اجزای Edge را در ماشین‌های ۱۲، ۱۳، ۸، و ۹ به این ترتیب به‌روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

7. به‌روزرسانی Qpid در ماشین‌های ۱۲ و ۱۳:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

8. میانای کاربر جدید (ue) یا میانای کاربر کلاسیک (ui) را در ماشین‌های ۶ و ۷ به‌روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

9. (اگر apigee-adminapi را نصب کرده باشید) ابزار apigee-adminapi در ماشین‌های ۶ و ۷ به‌روزرسانی شد:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

10. (اگر Apigee SSO را نصب کرده‌اید) Apigee SSO را در ماشین‌های ۶ و ۷ به‌روز کنید:

    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    که در آن sso_config_file فایل پیکربندی‌ای است که هنگام نصب SSO ایجاد کرده‌اید.

11. بازراه‌اندازی عنصر واسط کاربر:
    • واسط کاربر کلاسیک: اگر از واسط کاربر کلاسیک استفاده می‌کنید، edge-ui عنصر را در ماشین‌های ۶ و ۷ بازراه‌اندازی کنید، همان‌طور که در مثال زیر نشان داده شده است:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • واسط کاربر جدید Edge: اگر واسط کاربر جدید Edge را نصب کرده‌اید، edge-management-ui عنصر را در ماشین‌های ۶ و ۷ بازراه‌اندازی کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

ارتقای خوشه‌ای ۱۲ گرهی

برای نصب خوشه‌ای ۱۲ گره‌ای، اجزای زیر را به‌روز کنید:

برای فهرست توپولوژی‌های Edge و تعداد گره‌ها، توپولوژی‌های نصب را ببینید.

1. به‌روزرسانی «ال‌دپ»:
   1. دستگاه ۱ در مرکز داده ۱

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

   2. دستگاه ۷ در مرکز داده ۲

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

2. به‌روزرسانی Cassandra و ZooKeeper:
   1. ماشین‌های ۱، ۲، و ۳ در «مرکز داده ۱»:

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

   2. در ماشین‌های ۷، ۸، و ۹ در «مرکز داده ۲»:

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

3. به‌روزرسانی عناصر Edge:
   1. در ماشین‌های ۱، ۲، و ۳ در «مرکز داده ۱»:

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   2. در ماشین‌های ۷، ۸، و ۹ در «مرکز داده ۲»

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

4. به‌روزرسانی Postgres:
   1. دستگاه ۶ در مرکز داده ۱

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

   2. ماشین ۱۲ در مرکز داده ۲

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5. به‌روزرسانی عناصر Edge:
   1. ماشین‌های ۴، ۵، ۶ در «مرکز داده ۱»

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   2. ماشین‌های ۱۰، ۱۱، ۱۲ در «مرکز داده ۲»

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. به‌روزرسانی qpidd:
   1. ماشین‌های ۴ و ۵ در «مرکز داده ۱»
      1. به‌روزرسانی qpidd در ماشین ۴:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. به‌روزرسانی qpidd در ماشین ۵:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

   2. ماشین‌های ۱۰، ۱۱ در «مرکز داده ۲»
      1. به‌روزرسانی qpidd در ماشین ۱۰:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. به‌روزرسانی qpidd در ماشین ۱۱:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

7. میانای کاربر جدید (ue) یا میانای کاربر کلاسیک (ui) را به‌روز کنید:
   1. دستگاه ۱ در مرکز داده ۱:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   2. دستگاه ۷ در مرکز داده ۲:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

8. (اگر apigee-adminapi را نصب کرده‌اید) ابزار apigee-adminapi به‌روزرسانی شد:
   1. دستگاه ۱ در مرکز داده ۱:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   2. دستگاه ۷ در مرکز داده ۲:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. (اگر Apigee SSO را نصب کرده‌اید) Apigee SSO را به‌روز کنید:
   1. دستگاه ۱ در مرکز داده ۱:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   2. دستگاه ۷ در مرکز داده ۲:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   که در آن sso_config_file فایل پیکربندی‌ای است که هنگام نصب SSO ایجاد کرده‌اید.

10. واسط کاربر جدید Edge (edge-management-ui) یا عنصر واسط کاربر کلاسیک Edge (edge-ui) را در ماشین‌های ۱ و ۷ بازراه‌اندازی کنید:

    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

برای پیکربندی غیرمعمولی

اگر پیکربندی غیرمعمولی دارید، اجزای Edge را به ترتیب زیر به‌روز کنید: ترتیب:

1. LDAP
2. Cassandra
3. نگهبان باغ‌وحش
4. سرور مدیریت
5. پردازشگر پیام
6. رهیاب
7. Postgres
8. Edge، یعنی نمایه «-c edge» در همه گره‌ها به ترتیب: گره‌های دارای سرور Qpid، سرور Edge Postgres.
9. qpidd
10. واسط کاربر Edge (کلاسیک یا جدید)
11. apigee-adminapi
12. Apigee SSO

پس‌از تکمیل به‌روزرسانی، حتماً مؤلفه Edge UI را در همه ماشین‌هایی که آن را اجرا می‌کنند بازراه‌اندازی کنید.