‫Apigee Edge نسخه 4.51.00 یا 4.52.00 یا 4.52.01 را به 4.52.02 به‌روزرسانی کنید

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

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

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

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

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

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

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

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

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

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

  • مطمئن شوید Edge درحال اجرا است
    بااستفاده از فرمان زیر، مطمئن شوید که Edge درطول فرایند به‌روزرسانی درحال اجرا است: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • مطمئن شوید که «استراتژی فشرده‌سازی Cassandra» LeveledCompactionStrategy
    بسته به نسخه فعلی‌تان، تغییرات لازم را در استراتژی فشرده‌سازی Cassandra انجام دهید. مراحل زیر را دنبال کنید و سپس به رویه اصلی ارتقا برگردید:

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

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

نسخه کنونی نرم‌افزاری که برای ارتقا به نسخه ۴.۵۲.۰۲ به مراحل ویژه نیاز دارد
4.52.01 Cassandra
4.52.00 Zookeeper، Cassandra، Qpid
4.51.00 Zookeeper، Postgres، Cassandra، Qpid

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

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

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

به Zookeeper 3.8.3 ارتقا دهید

‫Edge for Private Cloud نسخه 4.52.02 شامل ارتقای Zookeeper نیست. بااین‌حال، اگر از نسخه‌ای قدیمی‌تر از ۴.۵۲.۰۱ درحال ارتقا هستید، باید مراحل ارتقای Zookeeper را که در زیر آمده است دنبال کنید.

  • اگر از نسخه‌های Edge for Private Cloud 4.51.00 یا 4.52.00 ارتقا می‌دهید، برای ارتقا دادن Zookeeper به مراحل ارتقای الزامی به Zookeeper 3.8.3 مراجعه کنید.
  • اگر از Edge for Private Cloud نسخه ۴.۵۲.۰۱ درحال ارتقا هستید، باید ازقبل از Zookeeper نسخه ۳.۸.۳ استفاده کنید و نیازی نیست مراحل ویژه‌ای را برای ارتقا دادن Zookeeper دنبال کنید.

به Postgres 14 ارتقا دهید

  • اگر از Edge for Private Cloud 4.51.00 به 4.52.02 ارتقا می‌دهید، باید مراحل ارتقا Postgres را دنبال کنید، حتی اگر Edge for Private Cloud 4.52.02 شامل ارتقا Postgres نباشد. ارتقا از Edge for Private Cloud نسخه 4.51.00 به 4.52.02 به مراحل ارتقا Postgres اضافی نیاز دارد. لطفاً به بخش ارتقای الزامی به Postgres 14 مراجعه کنید.
  • اگر از Edge for Private Cloud نسخه 4.52.00 یا 4.52.01 به نسخه 4.52.02 ارتقا می‌دهید، مراحل ارتقای Postgres اضافی لازم نیست.

به Cassandra 3.11.16 ارتقا دهید

‫Apigee Edge for Private Cloud 4.52.02 شامل ارتقا Cassandra به نسخه 3.11.16 است. ‫Cassandra جزء حیاتی Apigee است و این ارتقا شامل به‌روزرسانی‌های نرم‌افزار راه‌انداز در زمان‌های اجرای مختلف و اجزای مدیریتی مورداستفاده برای پُرسمان و نوشتن در Cassandra نیز می‌شود.

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

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

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

درگاه توسعه‌دهنده Apigee Drupal ویژگی‌های مختلفی برای مستندسازی میاناهای برنامه‌سازی کاربردی شما ارائه می‌دهد. اگرچه توصیه می‌شود از درگاه توسعه‌دهندگان مبتنی بر Drupal 7 استفاده نکنید، اما اگر هنوز از آن استفاده می‌کنید و از ویژگی SmartDocs آن بهره می‌برید، سند استفاده از SmartDocs APIs برای شما اعمال می‌شود. اگر از نسخه‌های جدیدتر درگاه توسعه‌دهندگان استفاده می‌کنید، این ارتقا تأثیری بر مستندات میانای برنامه‌سازی کاربردی شما نخواهد داشت.

وقتی Apigee را به نسخه ۴.۵۲.۰۲ ارتقا می‌دهید، هیچ‌یک از مدل‌های API که بااستفاده از ویژگی SmartDocs در درگاه توسعه‌دهندگان Drupal 7 ایجاد شده‌اند به‌طور خودکار به نسخه جدیدتر منتقل نخواهند شد. انتظار می‌رود که هر مدل را بااستفاده از درگاه توسعه‌دهنده به‌صورت دستی صادر کنید و پس‌از تکمیل ارتقا، آن را دوباره وارد کنید.

اصطلاحات استفاده‌شده در زیر

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

مدیریت: مدیریت شامل اداره سیستم Apigee Edge شما می‌شود. این شامل، اما نه محدود به، استقرارها، تغییرات برنامه‌ها، محصولات، سرورهای هدف، انبار کلیدها، و غیره می‌شود. همه میاناهای برنامه‌سازی کاربردی مدیریت (و مشتریان آن‌ها مثل Apigee UI و درگاه توسعه‌دهنده) در این محدوده قرار می‌گیرند.

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

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

ارتقا دادن استراتژی‌ها

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

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

مرکز داده تکی

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

  • با افزودن مرکز داده در کنار مرکز داده موجود، خوشه Edge for Private cloud را به مرکز داده موقتی گسترش دهید تا بتواند ترافیک را درطول ارتقا مدیریت کند، سپس پس‌از تکمیل فرایند ارتقا، یکی از مراکز داده را ازکار بیندازید.
  • اگر نمی‌توانید به مرکز داده دیگری گسترش دهید، برای زمان ازکارافتادگی آماده شوید و ارتقا را در دوره‌های ترافیک پایین زمان‌بندی کنید تا تأثیر آن بر «میاناهای برنامه‌سازی کاربردی مدیریت» و ترافیک زمان اجرا به حداقل برسد.

توصیه می‌شود به مرکز داده دیگری گسترش دهید تا از تأثیر بر ترافیک زمان اجرا و «میاناهای برنامه‌سازی کاربردی مدیریت» جلوگیری کنید. درطول ارتقا، تأثیرات بر مرکز داده‌ای که درحال ارتقا است شامل موارد زیر می‌شود، اما محدود به آن‌ها نیست:

  • میاناهای برنامه‌سازی کاربردی زمان اجرا که ژتون‌های OAuth را بازآوری می‌کنند
  • میاناهای برنامه‌سازی کاربردی زمان اجرا بااستفاده از خط‌مشی «دسترسی به نهاد»
  • فهرست کردن برنامه‌های توسعه‌دهنده با «میاناهای برنامه‌سازی کاربردی مدیریت»
  • میاناهای برنامه‌سازی کاربردی مدیریت فهرستگان محصولات

تأثیر ذکرشده در بالا علاوه‌بر «میاناهای برنامه‌سازی کاربردی» مدیریت خاصی است که تا زمانی که همه مراکز داده ارتقا نیابند در همه مراکز داده غیرفعال خواهند ماند. این نوع APIهای مدیریت در مراحل بخش‌های بعدی فهرست شده‌اند.

عقب‌گرد - سطح بالا

  • تأثیر درطول بازگردانی

    برگرداندن از Cassandra 3.11.x به 2.1.x بر ترافیک زمان اجرا و مدیریت در مرکز داده (DC) که برگرداندن در آن انجام می‌شود تأثیر می‌گذارد. علاوه‌براین، ممکن است برخی‌از «میاناهای برنامه‌سازی کاربردی» مدیریت در همه مراکز داده، صرف‌نظر از اینکه کدام مرکز داده درحال بازگرداندن است، با اختلال مواجه شوند.

  • دنبال کردن DC با رویکرد بازگرداندن DC

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

  • برگرداندن خوشه‌ای که تا حدی ارتقا یافته است

    اگر حداقل یک مرکز داده در نسخه قدیمی‌تر Cassandra (2.1.22) کاملاً عملیاتی باقی بماند، سایر مراکز داده ارتقایافته را می‌توان با انجام بازسازی از مرکز داده کاملاً کاربردی Cassandra 2.1.X برگرداند.

  • برگرداندن در سطح خوشه

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

  • ملاحظات پیش از ارتقا

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

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

ارتقا دادن Cassandra از نسخه ۲.۱.x به ۳.۱۱.x می‌تواند تأثیر قابل‌توجهی بر ترافیک زمان اجرا و برخی‌از «میاناهای برنامه‌سازی کاربردی» مدیریت داشته باشد. این تأثیرات درطول برگرداندن نیز اعمال می‌شود و ممکن است منجر به زمان ازکارافتادگی یا ازدست رفتن داده شود.

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

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

برگرداندن خوشه‌ها با چندین مرکز داده

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

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

مرحله ۰: وضعیت شروع

  • عناصر Zookeeper،‏ Postgres، و LDAP ازقبل به نسخه‌های 4.52.02 ارتقا یافته‌اند. ‫Edge برای خوشه ابر خصوصی شما پایدار است و کار می‌کند. اگر برگشت به نسخه قبلی لازم باشد، خوشه‌ای به این وضعیت برگردانده خواهد شد.
  • ‫Cassandra در Apigee با نسخه ۲.۱.۲۲ اجرا می‌شود.
  • عناصر لبه:
    • سرور مدیریت ازطریق پروتکل قدیمی‌تر thrift با Cassandra ارتباط برقرار می‌کند.
    • سرورهای زمان اجرا (پردازشگرهای پیام و مسیریاب‌ها) ازطریق پروتکل قدیمی‌تر thrift با Cassandra ارتباط برقرار می‌کنند.
وضعیت زمان اجرا در این مرحله وضعیت مدیریت در این مرحله
زمان اجرا کاملاً کار می‌کند مدیریت کاملاً کار می‌کند

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

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

  1. ‫Cassandra را تغییر دهید تا از LeveledCompactionStrategy استفاده کند.
  2. پشتیبان‌گیری Cassandra بااستفاده از Apigee.
  3. از گره‌های Cassandra عکس‌های فوری ماشین مجازی بگیرید (درصورت امکان).
  4. فایل پیکربندی ارتقا Cassandra را در هر گره Cassandra در /opt/apigee/apigee-cassandra/cass_upgrade.conf با محتوای زیر ایجاد کنید: 
    # IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    اگر فایل در /opt/apigee/apigee-cassandra/cass_upgrade.conf ایجاد نشد، فایل /opt/silent.conf را با محتوای یکسان در هر گره Cassandra ایجاد کنید.
  5. اگر از ویژگی SmartDocs در درگاه توسعه‌دهندگان Apigee Drupal 7 استفاده می‌کنید، با بارگیری مدل‌هایتان در قالب JSON از واسط کاربر درگاه توسعه‌دهندگان، از هریک از مدل‌هایتان برون‌برد بگیرید. پس‌از به‌روزرسانی سرورهای مدیریت، این مدل‌ها باید دوباره به Apigee وارد شوند.
  6. اگر ازقبل وجود ندارد، مطمئن شوید که درگاه‌های ۹۱۶۰ و ۹۰۴۲ از همه عناصر Edge به گره‌های Cassandra دردسترس باشد. برای اطلاعات بیشتر، به الزامات درگاه مراجعه کنید.

مرحله ۲: هدایت ترافیک از مرکز داده اول

  1. ترافیک مدیریت و زمان اجرای ورودی را از مرکز داده اول مسدود کنید.
  2. همه ترافیک زمان اجرا و «میاناهای برنامه‌سازی کاربردی مدیریت» را به مراکز داده کاربردی دیگر هدایت کنید.
  3. تأیید کنید که ترافیک زمان اجرا و مدیریت به‌طور موفقیت‌آمیز توسط DC(های) دیگر مدیریت می‌شود.

مرحله ۳: ارتقا دادن همه گره‌های Cassandra در مرکز داده اول

  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
     برونداد بالا چیزی شبیه این خواهد بود: 
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
  3. پس‌از تکمیل ارتقا، فرمان post_upgrade زیر را روی هر گره Cassandra یکی‌یکی اجرا کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
وضعیت زمان اجرا در این مرحله وضعیت مدیریت در این مرحله
  • ترافیک زمان اجرا در مراکز داده‌ای که درحال ارتقا هستند مسدود شد
  • زمان اجرا در مراکز داده دیگر کاملاً کار می‌کند

مرحله ۴: ارتقا دادن همه گره‌های مدیریت در مرکز داده اول

ارتقا دادن همه گره‌های مدیریت در مرکز داده:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
وضعیت زمان اجرا در این مرحله وضعیت مدیریت در این مرحله
  • ترافیک زمان اجرا در مراکز داده‌ای که درحال ارتقا هستند مسدود شد
  • زمان اجرا کاملاً کار می‌کند

مرحله ۵: ارتقا دادن همه گره‌های زمان اجرا در اولین مرکز داده

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

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
وضعیت زمان اجرا در این مرحله وضعیت مدیریت در این مرحله
  • ترافیک زمان اجرا در مراکز داده‌ای که درحال ارتقا هستند مسدود شد
  • زمان اجرا در مراکز داده دیگر کاملاً کار می‌کند

مرحله ۶: هدایت ترافیک به مرکز داده اول

  • پس‌از اینکه «مرکز داده اول» با Cassandra، عناصر زمان اجرا، و سرور مدیریت ارتقا یافت، ترافیک زمان اجرا و مدیریت را برای «مرکز داده اول» دوباره فعال کنید.
  • مطمئن شوید ترافیک مدیریت و زمان اجرا در سراسر مراکز داده موفق باشد.

مرحله ۷: ارتقا دادن مراکز داده دیگر

مرحله ۱ تا مرحله ۶ را برای مراکز داده باقی‌مانده تکرار کنید، هر بار با هدایت ترافیک از این مراکز داده، به‌روزرسانی نرم‌افزار Apigee، و فعال کردن مجدد ترافیک در این مراکز داده.

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

فرمان ارتقای زیر را در همه گره‌های مدیریت در مراکز داده مجدداً اجرا کنید:

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

مرحله ۹ - [اختیاری] وارد کردن اسناد هوشمندی که قبلاً صادر شده است

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

فقط درصورتی باید این کار را انجام دهید که از درگاه توسعه‌دهندگان مبتنی بر Drupal 7 استفاده می‌کنید و از ویژگی smartdocs استفاده می‌کنید.

وضعیت زمان اجرا در این مرحله وضعیت مدیریت در این مرحله
زمان اجرا کاملاً کار می‌کند مدیریت کاملاً کار می‌کند

مرحله ۱۰ - حذف جدول‌های استفاده‌نشده

فرمان زیر را اجرا کنید تا جدول‌های قدیمی و استفاده‌نشده از خوشه Cassandra حذف شود. تا زمانی که این اجرا نشود، نمی‌توانید از برخی‌از ویژگی‌های Cassandra استفاده کنید (مثل تنظیم اصالت‌سنجی جدید - سازوکارهای اصالت‌سنجی قدیمی همچنان کار خواهند کرد). این فرمان فقط در یک گره در خوشه اجرا می‌شود

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

مرحله ۱۱ - ارتقا دادن همه Edge و دیگر عناصر باقی‌مانده برای «ابر خصوصی» نسخه ۴.۵۲.۰۲

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

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

به Qpid J-Broker ارتقا دهید

اگرچه Edge for Private Cloud نسخه ۴.۵۲.۰۲ شامل ارتقا به Qpid نیست، اگر از نسخه‌های قدیمی‌تر از ۴.۵۲.۰۱ ارتقا می‌دهید، باید مراحل ارتقا QPID را دنبال کنید.

  • اگر از Edge for Private Cloud نسخه 4.51.00 یا 4.52.00 به نسخه 4.52.02 ارتقا می‌دهید، لازم است مراحل ارتقای Qpid اضافی را دنبال کنید. اگر از نسخه ۴.۵۱.۰۰ یا ۴.۵۲.۰۰ به ۴.۵۲.۰۲ ارتقا می‌دهید، لطفاً به بخش ارتقا Qpid مراجعه کنید.
  • اگر از Edge for Private Cloud 4.52.01 به 4.52.02 ارتقا می‌دهید، باید از جدیدترین نسخه Qpid Broker استفاده کنید و هیچ مرحله اضافی Qpidupgrade لازم نیست.

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

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

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

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

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

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

به‌روزرسانی واسط کاربر Edge

برای به‌روزرسانی عنصر «واسط کاربر Edge»، نسخه Edge ویژه «ابر خصوصی» را که می‌خواهید از آن ارتقا دهید درنظر بگیرید:

به‌روزرسانی با 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. به‌روزرسانی را برای همه ماشین‌های باقیمانده در نصب ادامه دهید.

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

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

باید فایل پیکربندی بی‌صدایی را به فرمان به‌روزرسانی ارسال کنید. فایل پیکربندی بی‌صدا باید همان فایلی باشد که برای نصب Edge 4.50.00 یا 4.51.00 استفاده کرده‌اید.

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

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

  1. درصورت وجود، همه کارهای cron را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده‌اند تا پس‌از تکمیل به‌روزرسانی غیرفعال کنید.
  2. برای نصب کردن Edge RPM، به‌عنوان ریشه به سیستم گره‌تان وارد شوید.
  3. نصب yum-utils و yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. ‫SELinux را طبق آنچه در نصب ابزار کمکی apigee-setup در Edge توضیح داده شده است غیرفعال کنید.
  5. اگر روی Oracle 7.x نصب می‌کنید، فرمان زیر را اجرا کنید: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. اگر درحال نصب در 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

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

    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.52.02.sh
    2. با اجرای فرمان زیر، ابزار و وابستگی‌های Edge 4.52.02 apigee-service را نصب کنید: 
      sudo bash /tmp/bootstrap_4.52.02.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 درطول نصب نسخه ۴.۵۰.۰۰ یا ۴.۵۱.۰۰ استفاده کردید.

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

      /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.52.02 توضیح داده شده است استفاده کنید.

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

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

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

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

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

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

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

    4. ابزار و وابستگی‌های Edge apigee-service را از /tmp/repos نصب کنید: 
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  3. برای نصب apigee-service بااستفاده از وب‌سرور Nginx:
    1. سرور وب Nginx را همان‌طور که در «نصب از مخزن بااستفاده از سرور وب Nginx» در نصب ابزار کمکی apigee-setup در Edge توضیح داده شده است پیکربندی کنید.
    2. در گره دور، فایل Edge bootstrap_4.52.02.sh را در /tmp/bootstrap_4.52.02.sh بارگیری کنید: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

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

    3. در گره از دور، ابزار apigee-setup Edge و وابستگی‌ها را نصب کنید: 
      sudo bash /tmp/bootstrap_4.52.02.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 UI: «سرور مدیریت»، «پردازشگر پیام»، «مسیریاب»، «سرور Qpid»، «سرور Postgres»
      • ‫ldap: ال‌دپ باز
      • ‫ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (اگر SSO را نصب کرده‌اید)
      • ue میانای کاربر جدید Edge
      • ‫ui: میانای کاربر کلاسیک Edge
      • ‫zk: Zookeeper
    • ‫configFile همان فایل پیکربندی است که برای تعریف کردن عناصر Edge درطول نصب نسخه 4.50.00 یا 4.51.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.52.02 استفاده کنید.

ترتیب به‌روزرسانی ماشین - ارتقا از ۴.۵۱.۰۰ (یا) ۴.۵۲.۰۰ (یا) ۴.۵۲.۰۱

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

  • قبل‌از ارتقا دادن همه عناصر دیگر، باید همه گره‌های ZooKeeper را در سراسر مراکز داده به‌روز کنید. اگر از Edge Private Cloud نسخه 4.51.00 (یا) 4.52.00 ارتقا می‌دهید، باید مراحل اضافی را برای ارتقا دادن zookeeper نیز دنبال کنید.
  • باید Postgresql را در همه مراکز داده به‌روز کنید. اگر از Edge Private Cloud 4.51.00 ارتقا می‌دهید، باید مراحل اضافی را نیز برای ارتقا دادن postgres دنبال کنید.
  • باید گره‌های LDAP را در همه مراکز داده به‌روز کنید.
  • باید همه گره‌های Cassandra، «سرور مدیریت»، «پردازشگر پیام»، و «مسیریاب» را، هر بار یک مرکز داده، به‌روزرسانی کنید تا همه مراکز داده ارتقا یابند.
  • باید edge-qpid-server و edge-postgres-server عنصر را در همه مراکز داده به‌روز کنید.
  • باید گره‌های Qpid را در همه مراکز داده ارتقا دهید. اگر از Edge Private Cloud نسخه 4.51.00 (یا) 4.52.00 ارتقا می‌دهید، باید مراحل اضافی را نیز برای ارتقا دادن 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. به‌روزرسانی Zookeeper در ماشین ۱: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. به‌روزرسانی Postgres در ماشین ۲: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. به‌روزرسانی LDAP در ماشین ۱: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. به‌روزرسانی Cassandra در ماشین ۱: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -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. به‌روزرسانی ZooKeeper در ماشین‌های ۱، ۲، و ۳: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. به‌روزرسانی Postgres در ماشین ۴: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. به‌روزرسانی Postgres در ماشین ۵: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. به‌روزرسانی LDAP در ماشین ۱: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. به‌روزرسانی Cassandra در ماشین‌های ۱، ۲، و ۳: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -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. ‫ZooKeeper را در ماشین‌های ۱، ۲، و ۳ به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. ‫Postgres را در ماشین ۸ به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. به‌روزرسانی Postgres در ماشین ۹: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. به‌روزرسانی LDAP در ماشین ۱: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. به‌روزرسانی Cassandra در ماشین ۱، ۲، و ۳: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -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. به‌روزرسانی ZooKeeper در ماشین‌های ۱، ۲، و ۳: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. ‫Postgres را در ماشین ۸ به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. به‌روزرسانی Postgres در ماشین ۹: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. به‌روزرسانی LDAP در ماشین‌های ۴ و ۵: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. به‌روزرسانی Cassandra در ماشین‌های ۱، ۲، و ۳: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -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. ‫ZooKeeper را در ماشین‌های ۱، ۲، ۳، ۷، ۸، ۹ در هر دو مرکز داده به‌روز کنید:

    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. ‫Postgres را در ماشین‌های ۶ و ۱۲ در هر دو مرکز داده به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. به‌روزرسانی LDAP در ماشین‌های ۱ و ۷ در هر دو DC: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

  4. ترافیک را در DC-1 مسدود کنید و مطمئن شوید که همه ترافیک به DC-2 هدایت می‌شود

  5. به‌روزرسانی «به‌روزرسانی Cassandra» در ماشین‌های ۱، ۲، ۳ در DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. به‌روزرسانی «سرور مدیریت» در ماشین ۱ در DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. به‌روزرسانی «مسیریاب»، «پردازشگر پیام» در ماشین ۲،۳ در DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. ترافیک را در DC-1 رفع انسداد کنید و DC-1 را اعتبارسنجی کنید و با مسدود کردن ترافیک در DC-2 و هدایت مجدد ترافیک به DC-1، به DC-2 بروید
  9. به‌روزرسانی Cassandra در ماشین‌های ۷، ۸، ۹ در DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  10. به‌روزرسانی «سرور مدیریت» در ماشین ۷ در DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. به‌روزرسانی «رهیاب»، «پردازشگر پیام» در ماشین ۸،۹ در DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. ترافیک را در DC-2 رفع انسداد کنید و اکنون هر دو DC ترافیک را مدیریت خواهند کرد
  13. فرمان به‌روزرسانی را در همه سرورهای مدیریت در سراسر مراکز داده در ماشین‌های ۱ و ۷ دوباره اجرا کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  14. ‫edge-qpid-server و edge-postgres-server را در ماشین‌های ۴، ۵، ۶، ۱۰، ۱۱، ۱۲ در هر دو مرکز داده به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. ‫Qpid را در ماشین‌های ۴، ۵، ۱۰، ۱۱ در هر دو مرکز داده به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  16. واسط کاربر جدید (ue) یا واسط کاربر کلاسیک (ui) را در هر دو مرکز داده به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
  17. (اگر apigee-adminapi را نصب کرده‌اید) apigee-adminapi را در هر دو مرکز داده به‌روز کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  18. (اگر Apigee SSO را نصب کرده‌اید) گره‌های Apigee SSO را در هر دو مرکز داده به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  19. عنصر واسط کاربر Edge جدید (edge-management-ui) یا واسط کاربر Edge کلاسیک (edge-ui) را در هر دو مرکز داده بازراه‌اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart