به روز رسانی Apigee Edge 4.51.00 یا 4.52.00 یا 4.52.01 به 4.52.02

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

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

شخصی که آپدیت را اجرا می کند باید همان شخصی باشد که Edge را در ابتدا نصب کرده است یا شخصی که به عنوان روت اجرا می شود.

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

کدام مؤلفه ها را باید به روز کنید

شما باید تمام اجزای Edge را به روز کنید. Edge از تنظیماتی که شامل مؤلفه‌هایی از چندین نسخه است پشتیبانی نمی‌کند.

پیش نیازها را به روز کنید

قبل از ارتقاء Apigee Edge از پیش نیازهای زیر اطمینان حاصل کنید:

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

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

  • اطمینان حاصل کنید که Edge در حال اجرا است
    با استفاده از دستور: 
    /opt/apigee/apigee-service/bin/apigee-all status
    اطمینان حاصل کنید که Edge در طول فرآیند به‌روزرسانی فعال است.
  • اطمینان حاصل کنید که استراتژی فشرده سازی کاساندرا LeveledCompactionStrategy است
    اطمینان حاصل کنید که استراتژی فشرده سازی Cassandra روی LeveledCompactionStrategy تنظیم شده است، همانطور که در تغییر استراتژی فشرده سازی Cassandra توضیح داده شده است.

چه مراحل خاصی را برای ارتقا در نظر بگیرید

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

نسخه فعلی نرم افزارهایی که برای ارتقا به 4.52.02 به مراحل خاصی نیاز دارند
4.52.01 کاساندرا
4.52.00 Cassandra، Zookeeper، Qpid
4.51.00 Cassandra، Zookeeper، Qpid، Postgres

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

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

ارتقاء مورد نیاز به Cassandra 3.11.16

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

از آنجایی که این یک ارتقاء بزرگ است، تغییرات خاصی در مدل داده های Apigee در Cassandra برای اطمینان از عملکرد بهینه در نسخه های جدیدتر ضروری بود. اگرچه این تغییرات حداقل هستند، فرآیند ارتقاء APIهای مدیریتی خاصی را مختل می کند و بر رابط کاربری Apigee و پورتال توسعه دهنده تأثیر می گذارد. سند زیر APIهای دقیقی را مشخص می‌کند که کار نمی‌کنند و مراحلی را که در حین ارتقاء هنگام شروع و پایان اختلال انجام می‌شود، مشخص می‌کند. نکته مهم این است که در طول ارتقاء نباید اختلالی در ترافیک زمان اجرا ایجاد شود.

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

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

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

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

مستندسازی APIها در پورتال توسعه دهنده

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

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

اصطلاحات مورد استفاده در بخش های زیر

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

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

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

مرحله 0: حالت شروع

  1. Cassandra در Apigee در حال اجرا با نسخه 2.1.22.
  2. Edge برای اجزای Private Cloud 4.52.02:
    • مدیریت-سرور در حال ارتباط با کاساندرا از طریق پروتکل قدیمی تر تریفت.
    • سرورهای زمان اجرا (پردازنده‌های پیام و روترها) با کاساندرا از طریق پروتکل قدیمی‌تر Thrift ارتباط برقرار می‌کنند.
حالت زمان اجرا در این مرحله وضعیت مدیریت در این مرحله
زمان اجرا کاملاً کاربردی است مدیریت کاملاً کاربردی

مرحله 1: برای ارتقاء آماده شوید

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

  1. Cassandra را برای استفاده از LeveledCompactionStrategy تغییر دهید.
  2. از کاساندرا با استفاده از Apigee نسخه پشتیبان تهیه کنید.
  3. از گره های کاساندرا (در صورت امکان) عکس های فوری VM بگیرید.
  4. یک فایل پیکربندی ارتقاء کاساندرا در هر گره کاساندرا در /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 را با محتویات یکسان در هر گره کاساندرا ایجاد کنید.
  • اگر از ویژگی SmartDocs پورتال توسعه‌دهنده Apigee Drupal 7 استفاده می‌کنید، هر یک از مدل‌های خود را با دانلود آن‌ها با فرمت JSON از رابط کاربری پورتال توسعه‌دهنده ، صادر کنید . این مدل‌ها پس از به‌روزرسانی سرورهای مدیریتی باید دوباره به Apigee وارد شوند.
  • مطمئن شوید که پورت‌های 9160 و 9042 از تمام اجزای Edge for Private Cloud 4.52.02 به گره‌های Cassandra در دسترس هستند، اگر قبلاً وجود ندارند. برای اطلاعات بیشتر به الزامات بندر مراجعه کنید.

مرحله 2: تمام گره های 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
  3. در بالا چیزی در امتداد خطوط خروجی خواهد شد: 
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
حالت زمان اجرا در این مرحله وضعیت مدیریت در این مرحله
زمان اجرا کاملاً کاربردی است عملکرد مدیریت زیر پس از ارتقاء کاساندرا کاهش می یابد:

مرحله 3: تمام گره های مدیریت را ارتقا دهید

تمام گره های مدیریت را در همه مناطق یک به یک ارتقا دهید:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
وضعیت زمان اجرا دولت مدیریت
زمان اجرا کاملاً کاربردی است مدیریت API تنزل یافته است:

مرحله 3a: [اختیاری] SmartDocs را که قبلا صادر شده اند وارد کنید

هنگامی که همه سرورهای مدیریت ارتقا یافتند، می توانید مدل های SmartDocs را که در مرحله 1 صادر کرده بودید وارد کنید . می توانید بعداً نیز تصمیم بگیرید که این کار را انجام دهید.

وضعیت زمان اجرا دولت مدیریت
زمان اجرا کاملاً کاربردی است مدیریت کاملاً کاربردی

مرحله 4: تمام گره های Runtime را ارتقا دهید

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

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
وضعیت زمان اجرا دولت مدیریت
زمان اجرا کاملاً کاربردی است مدیریت کاملاً کاربردی

مرحله 5: تمام اجزای Edge باقیمانده را برای Private Cloud 4.52.02 ارتقا دهید

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

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

وضعیت زمان اجرا دولت مدیریت
زمان اجرا کاملاً کاربردی است مدیریت کاملاً کاربردی

مرحله 6: مراحل ارتقا را ارسال کنید

پس از تکمیل ارتقا، دستور زیر را روی هر گره Cassandra یکی یکی اجرا کنید:

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

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

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

اگر قبلاً این کار را نکرده اید، مرحله 3a را کامل کنید.

وضعیت زمان اجرا دولت مدیریت
زمان اجرا کاملاً کاربردی است مدیریت کاملاً کاربردی

ارتقاء لازم به Zookeeper 3.8.3

اگرچه Edge for Private Cloud 4.52.02 شامل ارتقاء به Zookeeper نیست، اگر از نسخه‌های قدیمی‌تر از 4.52.01 ارتقا می‌دهید، باید مراحل ارتقا Zookeeper را دنبال کنید.

  • اگر از Edge برای Private Cloud نسخه های 4.51.00 یا 4.52.00 ارتقا می دهید، برای ارتقا Zookeeper به مراحل Required upgrade به Zookeeper 3.8.3 مراجعه کنید.
  • اگر از Edge برای Private Cloud نسخه 4.52.01 ارتقا می دهید، باید قبلاً از Zookeeper نسخه 3.8.3 استفاده کنید و نیازی به دنبال کردن مراحل خاصی برای ارتقا Zookeeper ندارید.

ارتقاء مورد نیاز به Postgres 14

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

نیاز به ارتقاء به Qpid J-Broker

اگرچه Edge for Private Cloud 4.52.02 شامل ارتقاء به QPID نمی شود، اگر از نسخه های قدیمی تر از 4.52.01 ارتقا می دهید، باید مراحل ارتقاء QPID را دنبال کنید.

  • اگر از Edge برای Private Cloud 4.51.00 یا 4.52.00 به 4.52.02 ارتقا می دهید، لازم است مراحل ارتقاء QPID اضافی را دنبال کنید. اگر از نسخه 4.51.00 یا 4.52.00 به 4.52.02 ارتقا می دهید، لطفاً به بخش ارتقاء Qpid مراجعه کنید.
  • اگر از Edge برای Private Cloud 4.52.01 به 4.52.02 ارتقا می دهید، باید از آخرین نسخه Qpid Broker استفاده کنید و هیچ مرحله ارتقاء QPID اضافی لازم نیست.

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

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

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

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

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

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

رابط کاربری Edge را به روز کنید

برای به‌روزرسانی مؤلفه Edge UI، نسخه Edge را برای Private Cloud که از آن ارتقا می‌دهید در نظر بگیرید:

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

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

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

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

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

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

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

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

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

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

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

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

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

کلید ارتقای زمان خاموشی صفر این است که هر روتر را یکی یکی از بار متعادل کننده حذف کنید. سپس روتر و هر جزء دیگر را در همان دستگاه روتر به روز می کنید و سپس روتر را دوباره به بار متعادل کننده اضافه می کنید.

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

قبل و بعد از آپدیت به موارد زیر توجه کنید:

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

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

به روز رسانی به 4.52.02 در یک گره با اتصال اینترنت خارجی

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

  1. در صورت وجود، هر cron job پیکربندی شده برای انجام عملیات تعمیر در Cassandra را تا زمانی که به‌روزرسانی کامل نشده است، غیرفعال کنید.
  2. برای نصب Edge RPM به عنوان root وارد گره خود شوید.
  3. yum-utils و yum-plugin-priorities را نصب کنید: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. همانطور که در Install the Edge apigee-setup utility توضیح داده شد SELinux را غیرفعال کنید.
  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 حذف کنید، از شما خواسته می شود آن را وارد کنید.

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

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

      • I : OpenJDK 1.8 (پیش‌فرض) را نصب کنید.
      • C : بدون نصب جاوا ادامه دهید.
      • Q : ترک برای این گزینه باید خود جاوا را نصب کنید.
    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

      این کار را به ترتیبی که در Order of machine update توضیح داده شده است انجام دهید.

      جایی که:

      • component کامپوننت Edge برای به روز رسانی است. مقادیر ممکن عبارتند از:
        • cs : کاساندرا
        • edge : همه اجزای Edge به جز Edge UI: سرور مدیریت، پردازشگر پیام، روتر، سرور QPID، سرور Postgres
        • ldap : OpenLDAP
        • ps : postgresql
        • qpid : qpidd
        • sso : Apigee SSO (اگر SSO را نصب کرده باشید)
        • ue : رابط کاربری جدید Edge
        • ui : رابط کاربری کلاسیک Edge
        • zk : نگهبان باغ وحش
      • configFile همان فایل پیکربندی است که برای تعریف اجزای Edge خود در هنگام نصب 4.50.00 یا 4.51.00 استفاده کردید.

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

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. اگر قبلاً این کار را نکرده‌اید، مؤلفه رابط کاربری Edge را در تمام گره‌هایی که آن را اجرا می‌کنند، مجدداً راه‌اندازی کنید: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    8. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.

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

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

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

پس از ایجاد یک مخزن 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 untar کنید: 
      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» در نصب ابزار Edge apigee-setup توضیح داده شده پیکربندی کنید.
    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 یا نام DNS گره repo است.

    3. در گره راه دور، ابزار Edge apigee-setup و وابستگی ها را نصب کنید: 
      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 : کاساندرا
      • edge : همه اجزای Edge به جز Edge UI: سرور مدیریت، پردازشگر پیام، روتر، سرور QPID، سرور Postgres
      • ldap : OpenLDAP
      • ps : postgresql
      • qpid : qpidd
      • sso : Apigee SSO (اگر SSO را نصب کرده باشید)
      • ue New Edge UI
      • ui : رابط کاربری کلاسیک Edge
      • zk : نگهبان باغ وحش
    • configFile همان فایل پیکربندی است که برای تعریف اجزای Edge خود در هنگام نصب 4.50.00 یا 4.51.00 استفاده کردید.

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

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. اگر قبلاً این کار را نکرده‌اید، مؤلفه‌های UI را در تمام گره‌هایی که آن را اجرا می‌کنند، مجدداً راه‌اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.

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

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

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

  • قبل از اینکه گره های دیگری را به روز کنید، باید تمام گره های Cassandra و ZooKeeper را به روز کنید.
  • برای هر ماشینی با چندین مؤلفه Edge (Management Server، Message Processor، Router، QPID Server اما نه Postgres Server)، از گزینه -c edge استفاده کنید تا همه آنها را همزمان به روز کنید.
  • اگر مرحله ای مشخص می کند که باید روی چندین ماشین انجام شود، آن را به ترتیب ماشین مشخص شده انجام دهید.
  • هیچ مرحله جداگانه ای برای به روز رسانی کسب درآمد وجود ندارد. زمانی که گزینه -c edge را مشخص کنید به روز می شود.

ارتقاء مستقل 1 گره

برای ارتقاء یک پیکربندی مستقل 1 گره به 4.52.02:

  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

ارتقاء مستقل 2 گره

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

توپولوژی های نصب را برای لیست توپولوژی های لبه و شماره گره ها ببینید.

  1. Cassandra و ZooKeeper را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Postgres را در دستگاه 2 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. LDAP را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. اجزای Edge را در دستگاه 2 و 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. Qpid را در ماشین 2 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. رابط کاربری را در دستگاه 1 به‌روزرسانی کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کردید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  9. مؤلفه Edge UI را در دستگاه 1 راه اندازی مجدد کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقاء 5 گره

اجزای زیر را برای نصب 5 گره به روز کنید:

توپولوژی های نصب را برای لیست توپولوژی های لبه و شماره گره ها ببینید.

  1. Cassandra و ZooKeeper را در دستگاه 1، 2 و 3 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Postgres را در دستگاه 4 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Postgres را در دستگاه 5 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. LDAP را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. به روز رسانی اجزای Edge در دستگاه 4، 5، 1، 2، 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Qpid را در دستگاه 4 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. Qpid را در دستگاه 5 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. رابط کاربری Edge را به روز کنید:
    • رابط کاربری کلاسیک: اگر از رابط کاربری کلاسیک استفاده می‌کنید، مؤلفه ui را در دستگاه 1 به‌روزرسانی کنید، همانطور که مثال زیر نشان می‌دهد: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • رابط کاربری New Edge: اگر رابط کاربری جدید Edge را نصب کرده‌اید، مؤلفه ue را در دستگاه مناسب به‌روزرسانی کنید (ممکن است دستگاه 1 نباشد): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کردید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  11. کامپوننت UI را مجددا راه اندازی کنید:
    • رابط کاربری کلاسیک: اگر از رابط کاربری کلاسیک استفاده می‌کنید، مؤلفه edge-ui را در دستگاه 1 مجدداً راه‌اندازی کنید، همانطور که مثال زیر نشان می‌دهد: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • New Edge UI: اگر رابط کاربری Edge جدید را نصب کرده اید، سپس مولفه edge-management-ui در دستگاه مناسب راه اندازی مجدد کنید (ممکن است دستگاه 1 نباشد): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

ارتقاء خوشه ای 9 گره

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

توپولوژی های نصب را برای لیست توپولوژی های لبه و شماره گره ها ببینید.

  1. Cassandra و ZooKeeper را در دستگاه 1، 2 و 3 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Postgres را در دستگاه 8 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Postgres را در دستگاه 9 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. LDAP را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. اجزای Edge را در دستگاه 6، 7، 8، 9، 1، 4 و 5 به ترتیب به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. Qpid را در ماشین‌های 6 و 7 به‌روزرسانی کنید: 
    /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
  8. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کنید: 
    /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

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

  10. کامپوننت UI را مجددا راه اندازی کنید:
    • رابط کاربری کلاسیک: اگر از رابط کاربری کلاسیک استفاده می‌کنید، مؤلفه edge-ui را در دستگاه 1 مجدداً راه‌اندازی کنید، همانطور که مثال زیر نشان می‌دهد: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • New Edge UI: اگر Edge UI جدید را نصب کرده اید، سپس مولفه edge-management-ui در دستگاه مناسب راه اندازی مجدد کنید (ممکن است دستگاه 1 نباشد): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

ارتقاء خوشه ای 13 گره

مؤلفه های زیر را برای نصب خوشه ای 13 گره به روز کنید:

توپولوژی های نصب را برای لیست توپولوژی های لبه و شماره گره ها ببینید.

  1. Cassandra و ZooKeeper را در ماشین‌های 1، 2 و 3 به‌روزرسانی کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Postgres را در دستگاه 8 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. Postgres را در دستگاه 9 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. LDAP را در دستگاه 4 و 5 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. اجزای Edge را در ماشین‌های 12، 13، 8، 9، 6، 7، 10 و 11 به ترتیب به‌روزرسانی کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. QPID را در دستگاه های 12 و 13 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. UI جدید ( ue ) یا UI کلاسیک ( ui ) را در دستگاه های 6 و 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    به روز کنید
  8. (اگر apigee-adminapi را نصب کردید) ابزار apigee-adminapi را در دستگاه های 6 و 7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    به روز کرد
  9. (اگر Apigee SSO را نصب کردید) Apigee SSO را در دستگاه های 6 و 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    به روز کنید

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

  10. مؤلفه UI را مجدداً راه اندازی کنید:
    • UI کلاسیک: اگر از UI کلاسیک استفاده می کنید ، سپس مؤلفه edge-ui در دستگاه های 6 و 7 مجدداً راه اندازی کنید ، همانطور که مثال زیر نشان می دهد: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • UI New Edge: اگر UI Edge New را نصب کردید ، سپس مؤلفه edge-management-ui روی ماشین های 6 و 7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
      مجدداً راه اندازی کنید

ارتقاء خوشه ای 12 گره

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

به توپولوژی های نصب برای لیست توپولوژی های لبه و شماره های گره مراجعه کنید.

  1. کاساندرا و باغ وحش را به روز کنید:
    1. در دستگاه های 1 ، 2 و 3 در مرکز داده 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. در دستگاه های 7 ، 8 و 9 در مرکز داده 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. به روزرسانی Postgres:
    1. دستگاه 6 در مرکز داده 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. دستگاه 12 در مرکز داده 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. LDAP را به روز کنید:
    1. دستگاه 1 در مرکز داده 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. دستگاه 7 در مرکز داده 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. به روزرسانی اجزای لبه:
    1. ماشین آلات 4 ، 5 ، 6 ، 1 ، 2 ، 3 در مرکز داده 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. ماشین آلات 10 ، 11 ، 12 ، 7 ، 8 ، 9 در مرکز داده 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. qpidd را به روز کنید:
    1. ماشین آلات 4 ، 5 در مرکز داده 1
      1. qpidd در دستگاه 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
        به روز کنید
      2. qpidd در دستگاه 5 به روز کنید: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. ماشین آلات 10 ، 11 در مرکز داده 2
      1. qpidd در دستگاه 10 به روز کنید: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. qpidd در دستگاه 11 به روز کنید: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. UI جدید ( ue ) یا UI کلاسیک ( ui ) را به روز کنید:
    1. دستگاه 1 در مرکز داده 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. دستگاه 7 در مرکز داده 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (اگر apigee-adminapi را نصب کردید) ابزار apigee-adminapi را به روز کرد:
    1. دستگاه 1 در مرکز داده 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. دستگاه 7 در مرکز داده 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (اگر Apigee SSO را نصب کردید) Apigee SSO را به روز کنید:
    1. دستگاه 1 در مرکز داده 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. دستگاه 7 در مرکز داده 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  9. مؤلفه جدید UI Edge UI ( edge-management-ui ) یا Edge Edge UI ( edge-ui ) را در دستگاه های 1 و 7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
    راه اندازی کنید

برای پیکربندی غیر استاندارد

اگر پیکربندی غیر استاندارد دارید ، سپس اجزای Edge را به ترتیب زیر به روز کنید:

  1. نگهبان باغ وحش
  2. کاساندرا
  3. ps
  4. LDAP
  5. لبه ، به معنی پروفایل "-C Edge" در همه گره ها به ترتیب: گره هایی با سرور QPID ، سرور Edge Postgres ، سرور مدیریت ، پردازنده پیام و روتر.
  6. qpidd
  7. Edge UI (یا کلاسیک یا جدید)
  8. apigee-adminapi
  9. Apigee SSO

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