به روز رسانی 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 در حال اجرا است
    با استفاده از دستور زیر مطمئن شوید که Edge در طول فرآیند به‌روزرسانی فعال است:
    /opt/apigee/apigee-service/bin/apigee-all status
  • اطمینان حاصل کنید که استراتژی فشرده سازی کاساندرا 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 UI را در تمام گره‌هایی که آن را اجرا می‌کنند، مجدداً راه‌اندازی کنید:
      /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 جدید را نصب کرده اید، سپس مؤلفه 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. رابط کاربری جدید ( ue ) یا رابط کاربری کلاسیک ( 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 را مجددا راه اندازی کنید:
    • رابط کاربری کلاسیک: اگر از رابط کاربری کلاسیک استفاده می‌کنید، همانطور که در مثال زیر نشان می‌دهد، مؤلفه edge-ui را در ماشین‌های 6 و 7 مجدداً راه‌اندازی کنید:
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • New Edge UI: اگر Edge UI جدید را نصب کرده اید، سپس مولفه edge-management-ui را در ماشین های 6 و 7 راه اندازی مجدد کنید:
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. Cassandra و ZooKeeper را به روز کنید:
    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. به روز رسانی اجزای Edge:
    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. Machines 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. Machines 10, 11 in Data Center 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. رابط کاربری جدید ( ue ) یا رابط کاربری کلاسیک ( 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. Edge UI جدید ( edge-management-ui ) یا 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. Edge، به معنای نمایه "-c edge" در تمام گره ها به ترتیب: گره های دارای سرور Qpid، سرور Edge Postgres، سرور مدیریت، پردازشگر پیام و روتر.
  6. qpidd
  7. رابط کاربری Edge (کلاسیک یا جدید)
  8. apigee-adminapi
  9. Apigee SSO

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