‫Apigee Edge نسخه ۴.۱۷.۰۵ یا ۴.۱۷.۰۹ را به ۴.۱۸.۰۵ به‌روزرسانی کنید

Edge for Private Cloud v4.18.05

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

• از ۴.۱۷.۰۵ تا ۴.۱۸.۰۵
• از ۴.۱۷.۰۹ تا ۴.۱۸.۰۵

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

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

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

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

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

حفظ سازگاری

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

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

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

پارامتر پیکربندی SMTPMAILFROM باید اضافه شود

‫Edge 4.17.05 پارامتر الزامی جدیدی به فایل پیکربندی که هنگام فعال کردن سرور SMTP استفاده می‌شود اضافه کرده است.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

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

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

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

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

   host replication apigee existing_slave_ip/32 trust
   host replication apigee new_slave_ip/32 trust

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

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

   2. SELinux را طبق روشی که در نصب ابزار کمکی apigee-setup در Edge توضیح داده شده است غیرفعال کنید.
   3. فایل bootstrap_4.17.0x.sh مربوط به Edge را بارگیری کنید، که در آن x یا ۵ (برای ۴.۱۷.۰۵) یا ۹ (برای ۴.۱۷.۰۹) است تا /tmp/bootstrap_4.17.0x.sh :

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

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

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

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

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

   6. نصب Postgres:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust

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

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

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

   host replication apigee existing_slave_ip/32 trust

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2. درصورت وجود، همه کارهای CRON را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده‌اند تا پس‌از تکمیل به‌روزرسانی غیرفعال کنید.
3. برای نصب کردن Edge RPM، به‌عنوان ریشه به سیستم گره‌تان وارد شوید.
4. نصب yum-utils و yum-plugin-priorities:

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

5. ‫SELinux را طبق آنچه در نصب ابزار کمکی apigee-setup در Edge توضیح داده شده است غیرفعال کنید.
6. اگر روی Oracle 7.x نصب می‌کنید، فرمان زیر را اجرا کنید:

   sudo yum-config-manager --enable ol7_optional_latest

7. اگر درحال نصب روی 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

8. فایل Edge 4.18.05 bootstrap_4.18.05.sh را در /tmp/bootstrap_4.18.05.sh بارگیری کنید:

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

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

   sudo bash /tmp/bootstrap_4.18.05.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 را نصب کنید.
10. از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید:

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

11. برنامه کمکی apigee-validate را در «سرور مدیریت» به‌روز کنید:

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

12. به‌روزرسانی ابزار apigee-provision:

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

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

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

    تنها الزام فایل پیکربندی این است که فایل پیکربندی باید برای کاربر «apigee» دردسترس یا قابل خواندن باشد.

    از گزینه -c برای مشخص کردن مؤلفه موردنظر برای به‌روزرسانی استفاده کنید. فهرست اجزای احتمالی شامل موارد زیر است:

    • ‫«cs» = کاساندرا
    • ‫«e» = ElasticSearch
    • «edge» = همه عناصر Edge به‌جز واسط کاربر Edge. عنصر «لبه» شامل «سرور مدیریت»، «پردازشگر پیام»، «مسیریاب»، «سرور QPID»، «سرور Edge Postgres» است.
    • ‫«ldap» = ال‌دپ باز
    • ‫«ps» = postgresql
    • ‫«qpid» = qpidd
    • ‫«sso» = Edge SSO
    • ‫«ui» = رابط کاربری Edge
    • ‫«zk» = Zookeeper

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

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

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

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

15. به‌روزرسانی را با اجرای ابزار apigee-validate در «سرور مدیریت» همان‌طور که در آزمایش نصب توضیح داده شده است آزمایش کنید.
16. اگر گره آماده‌به‌کار جدید Postgres نصب کرده‌اید، گره را همان‌طور که در ازکار انداختن گره Postgres توضیح داده شده است ازکار بیندازید.

    اگر از فضای ذخیره‌سازی شبکه استفاده می‌کنید، لازم نیست گره جدید را نصب کنید. برای اطلاعات بیشتر، ارتقا الزامی به Postgres 9.6 را ببینید.

برای عقب‌گرد کردن به‌روزرسانی در آینده، از روش شرح‌داده‌شده در عقب‌گرد کردن ۴.۱۸.۰۵ استفاده کنید.

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

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

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

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

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

1. اگر درحال‌حاضر از تکثیر آماده‌به‌کار اصلی Postgres استفاده می‌کنید، گره آماده‌به‌کار Postgres جدیدی را همان‌طور که در نصب گره آماده‌به‌کار Postgres جدید توضیح داده شده است نصب کنید.

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

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

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

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

      tar -xzf apigee-4.18.05tar.gz

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

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

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

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

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

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

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

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

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

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

5. از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید:

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

6. برنامه کمکی apigee-validate را در «سرور مدیریت» به‌روز کنید:

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

7. به‌روزرسانی ابزار apigee-provision:

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

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

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

   تنها الزام فایل پیکربندی این است که فایل پیکربندی باید برای کاربر «apigee» دردسترس یا قابل خواندن باشد.

   از گزینه -c برای مشخص کردن مؤلفه موردنظر برای به‌روزرسانی استفاده کنید. فهرست اجزای احتمالی شامل موارد زیر است:

   • ‫«cs» = کاساندرا
   • ‫«e» = ElasticSearch
   • «edge» = همه عناصر Edge به‌جز واسط کاربر Edge. عنصر «لبه» شامل «سرور مدیریت»، «پردازشگر پیام»، «مسیریاب»، «سرور QPID»، «سرور Edge Postgres» است.
   • ‫«ldap» = ال‌دپ باز
   • ‫«ps» = postgresql
   • ‫«qpid» = qpidd
   • ‫«sso» = Edge SSO
   • ‫«ui» = رابط کاربری Edge
   • ‫«zk» = Zookeeper

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

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

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

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

10. به‌روزرسانی را با اجرای ابزار apigee-validate در «سرور مدیریت» همان‌طور که در آزمایش نصب توضیح داده شده است آزمایش کنید.
11. اگر گره آماده‌به‌کار جدید Postgres نصب کرده‌اید، گره را همان‌طور که در ازکار انداختن گره Postgres توضیح داده شده است ازکار بیندازید.

    اگر از فضای ذخیره‌سازی شبکه استفاده می‌کنید، لازم نیست گره جدید را نصب کنید. برای اطلاعات بیشتر، ارتقای الزامی به Postgres 9.6 را ببینید.

برای عقب‌گرد کردن به‌روزرسانی در آینده، از روش شرح‌داده‌شده در عقب‌گرد کردن ۴.۱۸.۰۵ استفاده کنید.

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

ترتیب به‌روزرسانی ماشین‌ها در نصب Edge مهم است. مهم‌ترین ملاحظات برای به‌روزرسانی عبارت‌اند از:

• قبل‌از به‌روزرسانی هر گره دیگری، باید همه گره‌های Cassandra و ZooKeeper را به‌روزرسانی کنید.
• برای هر ماشینی که چند عنصر Edge دارد (سرور مدیریت، پردازشگر پیام، مسیریاب، سرور QPID، اما نه سرور Postgres)، از گزینه «-c edge» استفاده کنید تا همه آن‌ها را به‌طور هم‌زمان به‌روز کنید.
• اگر مرحله‌ای مشخص می‌کند که باید در چندین ماشین انجام شود، آن را در ترتیب ماشین مشخص‌شده انجام دهید.
• هیچ مرحله جداگانه‌ای برای به‌روزرسانی «درآمدزایی» وجود ندارد. وقتی گزینه «-c 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. به‌روزرسانی LDAP:

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

4. توقف سرور Postgres، سرور Qpid، و PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

5. به‌روزرسانی postgresql:

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

6. پایگاه داده Postgres را به‌روز کنید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

7. اجزای باقی‌مانده Edge را به‌روزرسانی کنید:

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

8. به‌روزرسانی میانای کاربر Edge:

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

9. (اگر «شناسایی یگانه Edge» را نصب کرده‌اید) «شناسایی یگانه Edge» را به‌روز کنید:

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

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

10. بازراه‌اندازی کردن عنصر «واسط کاربر 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 در ماشین ۲:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -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. (اگر Edge SSO را نصب کرده‌اید) Edge SSO را در دستگاه ۱ به‌روز کنید:

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

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

7. به‌روزرسانی postgresql در ماشین ۲:
   1. سرور Postgres، سرور Qpid، و postgresql را متوقف کنید:
      

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

   2. به‌روزرسانی postgresql:

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

   3. پایگاه داده Postgres را به‌روز کنید:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

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

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

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

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

نصب ۵ گره

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

1. مطمئن شوید که گره آماده‌به‌کار جدید Postgres را همان‌طور که در نصب گره آماده‌به‌کار جدید Postgres توضیح داده شده است نصب کرده‌اید.

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

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

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

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

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -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. به‌روزرسانی واسط کاربر در ماشین ۱:

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

7. (اگر Edge SSO را نصب کرده‌اید) Edge SSO را در دستگاه ۱ به‌روز کنید:

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

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

8. به‌روزرسانی ماشین‌های ۴ و ۵:
   1. سرور Postgres و سرور Qpid را در ماشین ۴ متوقف کنید:
      

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop

   2. توقف سرور Postgres، سرور Qpid، و postgresql در ماشین ۵:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

   3. اگر نصب شده است، سرور Postgres و postgresql را در گره آماده به‌کار جدیدی که برای برگرداندن اضافه کرده‌اید متوقف کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

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

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

   5. پایگاه داده Postgres را در ماشین ۴ به‌روز کنید (فقط Postgres master):

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

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

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

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

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

   8. با اجرای فرمان‌های زیر در ماشین ۵، Postgres را به‌عنوان گره آماده به‌کار پیکربندی کنید:

      cd /opt/apigee/data/apigee-postgresql/pgdata
      rm -rf *
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile

   9. با اجرای دستورگان‌های زیر در هر دو سرور، وضعیت تکثیر را درستی‌سنجی کنید. سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد تا از تکثیر موفقیت‌آمیز اطمینان حاصل شود:
      • در ماشین ۴، گره اصلی، این دستور را اجرا کنید:

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

        تأیید کنید که می‌گوید اصلی است.

      • در ماشین ۵، گره آماده‌به‌کار:

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

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

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

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

10. مطمئن شوید که گره آماده‌به‌کار جدید را همان‌طور که در ازکار انداختن گره Postgres توضیح داده شده است ازکار می‌اندازید.

    اگر از فضای ذخیره‌سازی شبکه استفاده می‌کنید، لازم نیست گره جدید را نصب کنید. برای اطلاعات بیشتر، ارتقای الزامی به Postgres 9.6 را ببینید.

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

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

نصب خوشه‌ای ۹ گره‌ای

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

1. مطمئن شوید که گره آماده‌به‌کار Postgres جدیدی را همان‌طور که در نصب گره آماده‌به‌کار Postgres جدید توضیح داده شده است نصب کرده‌اید.

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

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

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

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

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -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. به‌روزرسانی واسط کاربر در ماشین ۱:

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

7. (اگر Edge SSO را نصب کرده‌اید) Edge SSO را در دستگاه ۱ به‌روز کنید:

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

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

8. به‌روزرسانی ماشین‌های ۸ و ۹:
   1. توقف سرور Postgres در ماشین ۸:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

   2. توقف سرور Postgres و postgresql در ماشین ۹:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

   3. توقف سرور Qpid در ماشین‌های ۶ و ۷:

      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop

   4. اگر نصب شده است، سرور Postgres و postgresql را در گره آماده به‌کار جدیدی که برای برگرداندن اضافه کرده‌اید متوقف کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

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

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

   6. پایگاه داده Postgres را در ماشین ۸ به‌روز کنید (فقط Postgres اصلی):

      /-->
      opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

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

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

   8. سرور Postgres را در ماشین‌های ۸ و ۹ شروع کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

   9. سرور Qpid را در ماشین‌های ۶ و ۷ شروع کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

   10. با اجرای فرمان‌های زیر در ماشین ۹، Postgres را به‌عنوان گره آماده به‌کار پیکربندی کنید:

       cd /opt/apigee/data/apigee-postgresql/pgdata
       rm -rf *
       /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile

   11. با اجرای دستورگان‌های زیر در هر دو سرور، وضعیت تکثیر را درستی‌سنجی کنید. سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد تا از تکثیر موفقیت‌آمیز اطمینان حاصل شود:
       • در ماشین ۸، گره اصلی، این دستور را اجرا کنید:

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

         تأیید کنید که می‌گوید اصلی است.

       • در ماشین ۹، گره آماده‌به‌کار:

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

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

9. به‌روزرسانی اجزای Edge در ماشین‌های ۸ و ۹:

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

10. مطمئن شوید که گره آماده به‌کار جدید را همان‌طور که در ازکار انداختن گره Postgres توضیح داده شده است ازکار می‌اندازید.

    اگر از فضای ذخیره‌سازی شبکه استفاده می‌کنید، لازم نیست گره جدید را نصب کنید. برای اطلاعات بیشتر، ارتقای الزامی به Postgres 9.6 را ببینید.

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

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

نصب خوشه‌ای ۱۳ گره‌ای

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

1. مطمئن شوید که گره آماده‌به‌کار Postgres جدیدی را همان‌طور که در نصب گره آماده‌به‌کار Postgres جدید توضیح داده شده است نصب کرده‌اید.

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

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

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

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

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -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. به‌روزرسانی واسط کاربر در ماشین‌های ۶ و ۷:

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

7. (اگر «شناسایی یگانه Edge» را نصب کرده‌اید) «شناسایی یگانه Edge» را در ماشین ۶ و ۷ به‌روز کنید:

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

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

8. به‌روزرسانی ماشین‌های ۸ و ۹:
   1. توقف سرور Postgres در ماشین ۸:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

   2. توقف سرور Postgres و postgresql در ماشین ۹:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

   3. توقف سرور Qpid در ماشین‌های ۱۲ و ۱۳:

      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop

   4. اگر نصب شده است، سرور Postgres و postgresql را در گره آماده به‌کار جدیدی که برای برگرداندن اضافه کرده‌اید متوقف کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

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

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

   6. پایگاه داده Postgres را در ماشین ۸ به‌روز کنید (فقط Postgres اصلی):

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

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

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

   8. سرور Postgres را در ماشین‌های ۸ و ۹ شروع کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

   9. سرور Qpid را در ماشین‌های ۱۲ و ۱۳ شروع کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

   10. با اجرای فرمان‌های زیر در ماشین ۹، Postgres را به‌عنوان گره آماده به‌کار پیکربندی کنید:

       cd /opt/apigee/data/apigee-postgresql/pgdata
       rm -rf *
       /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile

   11. با اجرای دستورگان‌های زیر در هر دو سرور، وضعیت تکثیر را درستی‌سنجی کنید. سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد تا از تکثیر موفقیت‌آمیز اطمینان حاصل شود:
       • در ماشین ۸، گره اصلی، این دستور را اجرا کنید:

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

         تأیید کنید که می‌گوید اصلی است.

       • در ماشین ۹، گره آماده‌به‌کار:

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

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

9. به‌روزرسانی اجزای Edge در ماشین‌های ۸ و ۹:

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

10. مطمئن شوید که گره آماده به‌کار جدید را همان‌طور که در ازکار انداختن گره Postgres توضیح داده شده است ازکار می‌اندازید.

    اگر از فضای ذخیره‌سازی شبکه استفاده می‌کنید، لازم نیست گره جدید را نصب کنید. برای اطلاعات بیشتر، ارتقای الزامی به Postgres 9.6 را ببینید.

11. مؤلفه Edge UI را در ماشین‌های ۶ و ۷ بازراه‌اندازی کنید:

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

نصب خوشه‌ای ۱۲ گره‌ای

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

1. مطمئن شوید که گره آماده‌به‌کار Postgres جدیدی را همان‌طور که در نصب گره آماده‌به‌کار Postgres جدید توضیح داده شده است نصب کرده‌اید.

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

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

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

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

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

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

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

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

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

      2. مرحله ۱ را در ماشین ۱۱ تکرار کنید.
4. به‌روزرسانی «ال‌دپ»:
   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. به‌روزرسانی میانای کاربر:
   1. دستگاه ۱ در مرکز داده ۱:

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

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

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

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

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

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

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

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

8. به‌روزرسانی ماشین ۶ در «مرکز داده ۱» و ماشین ۱۲ در «مرکز داده ۲»:
   1. توقف سرور Postgres در ماشین ۶:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

   2. توقف سرور Postgres و postgresql در ماشین ۱۲:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

   3. توقف سرور Qpid در ماشین‌های ۴، ۵، ۱۰، و ۱۱:

      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop

   4. اگر نصب شده است، سرور Postgres و postgresql را در گره آماده به‌کار جدیدی که برای برگرداندن اضافه کرده‌اید متوقف کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

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

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

   6. پایگاه داده Postgres را در ماشین ۶ به‌روز کنید (فقط Postgres master):

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

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

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

   8. سرور Postgres را در ماشین‌های ۶ و ۱۲ شروع کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

   9. سرور Qpid را در ماشین‌های ۴، ۵، ۱۰، و ۱۱ شروع کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

   10. با اجرای فرمان‌های زیر در ماشین ۱۲، Postgres را به‌عنوان گره آماده‌به‌کار پیکربندی کنید:

       cd /opt/apigee/data/apigee-postgresql/pgdata
       rm -rf *
       /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile

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

       در دستگاه ۶، گره اصلی، این دستور را اجرا کنید:

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

       تأیید کنید که می‌گوید اصلی است.

       در ماشین ۱۲، گره آماده‌به‌کار:

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

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

9. به‌روزرسانی اجزای Edge در ماشین‌های ۶ و ۱۲:

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

10. مطمئن شوید که گره آماده به‌کار جدید را همان‌طور که در ازکار انداختن گره Postgres توضیح داده شده است ازکار می‌اندازید.

    اگر از فضای ذخیره‌سازی شبکه استفاده می‌کنید، لازم نیست گره جدید را نصب کنید. برای اطلاعات بیشتر، ارتقا الزامی به Postgres 9.6 را ببینید.

11. مؤلفه Edge UI را در ماشین‌های ۱ و ۷ بازراه‌اندازی کنید:

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

برای نصب غیرمعمولی

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

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

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