به‌روزرسانی Apigee Edge 4.19.01 به 4.19.06

این بخش نحوه انجام ارتقای زیر را شرح می‌دهد:

  • از ۴.۱۹.۰۱ تا ۴.۱۹.۰۶

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

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

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

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

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

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

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

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

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

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

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

  • مطمئن شوید Edge درحال اجرا است
    بااستفاده از این فرمان، مطمئن شوید Edge درطول فرایند به‌روزرسانی فعال و درحال اجرا است: 
    /opt/apigee/apigee-service/bin/apigee-all status

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

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

نصب Edge UI

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

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

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

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

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

  • از 4.18.0x: اگر نسخه Beta از Edge UI (که قبلاً با نام تجربه Edge جدید یا UE جدید شناخته می‌شد) را در 4.18.0x نصب کرده‌اید، باید آن را حذف نصب کنید و نسخه 4.19.06 از Edge UI را به‌طور کامل نصب کنید، همان‌طور که در نصب Edge UI جدید شرح داده شده است.
  • از نسخه 4.19.01 (با واسط کاربر Edge جدید که قبلاً نصب شده است): از دستورالعمل‌های ارتقا در این بخش برای مؤلفه edge-management-ui استفاده کنید.
  • از نسخه 4.19.01 (با واسط کاربر کلاسیک): Edge را برای نصب Private Cloud همان‌طور که در این بخش شرح داده شده است ارتقا دهید و سپس Edge UI را همان‌طور که در نصب Edge UI جدید شرح داده شده است نصب کنید.

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

Apigee Edge برای Private Cloud نسخه ۴.۱۹.۰۶ درحال‌حاضر کتابخانه‌های ارتقایافته برای Apigee mTLS ندارد. اگر درحال‌حاضر نسخه ۴.۱۹.۰۱ را با Apigee mTLS اجرا می‌کنید و می‌خواهید به نسخه ۴.۱۹.۰۶ ارتقا دهید، با پشتیبانی Apigee Edge تماس بگیرید.

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

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

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

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

به‌طور پیش‌فرض، ابزار کمکی 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 دیگر را در همان دستگاهی که «رهیاب» قرار دارد به‌روز کنید. همه پیکربندی‌های Edge یک «مسیریاب» و «پردازشگر پیام» را در یک گره نشان می‌دهند.
  4. رهیاب را دوباره دردسترس قرار دهید.
  5. مراحل ۲ تا ۴ را برای بقیه «رهیاب‌ها» تکرار کنید.
  6. به‌روزرسانی را برای بقیه دستگاه‌های موجود در نصب ادامه دهید.

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

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

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

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

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

  1. اگر وجود دارد، هرگونه کار cron را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده است تا پس‌از تکمیل به‌روزرسانی غیرفعال کنید.
  2. برای نصب Edge RPM، به‌عنوان root به سیستم گره وارد شوید.
  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.19.06 bootstrap_4.19.06.sh را در /tmp/bootstrap_4.19.06.sh بارگیری کنید: 
    curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
  8. با اجرای فرمان زیر، ابزار کمکی Edge 4.19.06 apigee-service و وابستگی‌ها را نصب کنید: 
    sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

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

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

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

    • I: نصب OpenJDK 1.8 (پیش‌فرض).
    • ‫C: بدون نصب Java ادامه دهید.
    • Q: رها کردن. برای این گزینه، باید Java را خودتان نصب کنید.
  9. از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید، همان‌طور که در مثال زیر نشان داده شده است: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  10. برنامه کمکی apigee-validate را در «سرور مدیریت» به‌روز کنید، همان‌طور که در مثال زیر نشان داده شده است: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  11. برنامه کمکی apigee-provision را در «سرور مدیریت» به‌روز کنید، همان‌طور که در مثال زیر نشان داده شده است: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  12. با اجرای فرمان زیر، ابزار 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: New Edge UI
      • ui: Classic Edge UI
      • zk: نگهبان باغ‌وحش
    • configFile همان فایل پیکربندی است که برای تعریف مؤلفه‌های Edge درطول نصب نسخه ۴.۱۹.۰۱ استفاده کردید.

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

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  13. اگر قبلاً این کار را نکرده‌اید، مؤلفه Edge UI را در همه گره‌هایی که آن را اجرا می‌کنند بازراه‌اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  14. به‌روزرسانی را با اجرای ابزار کمکی apigee-validate در «سرور مدیریت» آزمایش کنید، همان‌طور که در آزمایش نصب شرح داده شده است.

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

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

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

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

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

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

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

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

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

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

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

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

    3. در گره راه دور، ابزار کمکی Edge apigee-setup و وابستگی‌ها را نصب کنید: 
      sudo bash /tmp/bootstrap_4.19.06.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 New Edge UI
      • ui: Classic Edge UI
      • zk: نگهبان باغ‌وحش
    • configFile همان فایل پیکربندی است که برای تعریف مؤلفه‌های Edge درطول نصب نسخه ۴.۱۹.۰۱ استفاده کردید.

    می‌توانید update.sh را با تنظیم component روی «همه» برای همه مؤلفه‌ها اجرا کنید، اما فقط درصورتی‌که نمایه نصب Edge همه‌کاره (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. به‌روزرسانی را با اجرای ابزار کمکی apigee-validate در «سرور مدیریت» آزمایش کنید، همان‌طور که در آزمایش نصب شرح داده شده است.

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

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

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

  • باید همه گره‌های Cassandra و ZooKeeper را پیش‌از به‌روزرسانی هر گره دیگری به‌روز کنید.
  • برای هر دستگاهی که چند مؤلفه Edge دارد (سرور مدیریت، پردازشگر پیام، رهیاب، سرور QPID، اما نه سرور Postgres)، از گزینه -c edge برای به‌روزرسانی همه آن‌ها به‌طور هم‌زمان استفاده کنید.
  • اگر در مرحله‌ای مشخص شده است که باید در چندین دستگاه انجام شود، آن را به‌ترتیب دستگاه‌های مشخص‌شده انجام دهید.
  • مرحله جداگانه‌ای برای به‌روزرسانی «درآمدزایی» وجود ندارد. وقتی گزینه -c edge را مشخص کنید، به‌روزرسانی می‌شود.

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

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

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

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

  8. مؤلفه واسط کاربر Edge را در دستگاه ۱ بازراه‌اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقای ۵ گره‌ای

برای نصب ۵ گره‌ای، مؤلفه‌های زیر را به‌روز کنید:

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

  1. Cassandra و ZooKeeper را در ماشین ۱، ۲، و ۳ به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Qpid و Postgres را در دستگاه ۴ به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  3. Qpid و Postgres را در دستگاه ۵ به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  4. به‌روزرسانی LDAP در دستگاه ۱: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. به‌روزرسانی مؤلفه‌های Edge در ماشین ۴، ۵، ۱، ۲، ۳: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. میانای کاربر 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
  7. (اگر apigee-adminapi را نصب کرده‌اید) ابزار کمکی apigee-adminapi در دستگاه ۱ به‌روز شد: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (اگر Apigee SSO را نصب کرده‌اید) Apigee SSO را در دستگاه ۱ به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  9. جزء واسط کاربر را بازراه‌اندازی کنید:
    • واسط کاربر کلاسیک: اگر از واسط کاربر کلاسیک استفاده می‌کنید، مؤلفه 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. Cassandra و ZooKeeper را در ماشین ۱، ۲، و ۳ به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. به‌روزرسانی Qpid در دستگاه‌های ۶ و ۷: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Postgres را در دستگاه ۸ به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. به‌روزرسانی Postgres در دستگاه ۹: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. به‌روزرسانی LDAP در دستگاه ۱: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. مؤلفه‌های Edge را در دستگاه‌های ۶، ۷، ۸، ۹، ۱، ۴، و ۵ به‌ترتیب به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. میانای کاربر جدید (ue) یا میانای کاربر کلاسیک (ui) را در دستگاه ۱ به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -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 جدید: اگر واسط کاربر Edge جدید را نصب کرده‌اید، مؤلفه edge-management-ui را در دستگاه مناسب بازراه‌اندازی کنید (ممکن است دستگاه ۱ نباشد): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. Cassandra و ZooKeeper را در ماشین‌های ۱، ۲، و ۳ به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. به‌روزرسانی Qpid در دستگاه‌های ۱۲ و ۱۳: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. Postgres را در دستگاه ۸ به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. به‌روزرسانی Postgres در دستگاه ۹: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. به‌روزرسانی LDAP در ماشین ۴ و ۵: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. مؤلفه‌های Edge را در ماشین‌های ۱۲، ۱۳، ۸، ۹، ۶، ۷، ۱۰، و ۱۱ به‌ترتیب زیر به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. میانای کاربر جدید (ue) یا میانای کاربر کلاسیک (ui) را در دستگاه‌های ۶ و ۷ به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -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 جدید: اگر رابط کاربری Edge جدید را نصب کرده‌اید، مؤلفه edge-management-ui را در دستگاه‌های ۶ و ۷ بازراه‌اندازی کنید: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. به‌روزرسانی Cassandra و ZooKeeper:
    1. در ماشین‌های ۱، ۲، و ۳ در «مرکز داده ۱»: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. در دستگاه‌های ۷، ۸، و ۹ در «مرکز داده ۲» 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. به‌روزرسانی qpidd:
    1. ماشین‌های ۴ و ۵ در مرکز داده ۱
      1. به‌روزرسانی qpidd در دستگاه ۴: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. به‌روزرسانی qpidd در دستگاه ۵: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. ماشین‌های ۱۰، ۱۱ در مرکز داده ۲
      1. به‌روزرسانی qpidd در دستگاه ۱۰: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. به‌روزرسانی qpidd در دستگاه ۱۱: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. به‌روزرسانی Postgres:
    1. دستگاه ۶ در مرکز داده ۱ 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. دستگاه ۱۲ در مرکز داده ۲ 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. به‌روزرسانی LDAP:
    1. دستگاه ۱ در مرکز داده ۱ 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. دستگاه ۷ در مرکز داده ۲ 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. به‌روزرسانی مؤلفه‌های Edge:
    1. دستگاه‌های ۴، ۵، ۶، ۱، ۲، ۳ در مرکز داده ۱ 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. ماشین‌های ۱۰، ۱۱، ۱۲، ۷، ۸، ۹ در مرکز داده ۲ 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. میانای کاربری جدید (ue) یا میانای کاربری کلاسیک (ui) را به‌روز کنید:
    1. دستگاه ۱ در مرکز داده ۱: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. دستگاه ۷ در مرکز داده ۲: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (اگر apigee-adminapi را نصب کرده‌اید) ابزار apigee-adminapi به‌روز شد:
    1. دستگاه ۱ در مرکز داده ۱: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. دستگاه ۷ در مرکز داده ۲: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (اگر Apigee SSO را نصب کرده‌اید) Apigee SSO را به‌روز کنید:
    1. دستگاه ۱ در مرکز داده ۱: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. دستگاه ۷ در مرکز داده ۲: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  9. مؤلفه واسط کاربر Edge جدید (edge-management-ui) یا واسط کاربر Edge کلاسیک (edge-ui) را در ماشین‌های ۱ و ۷ بازراه‌اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

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

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

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

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