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

Edge for Private Cloud نسخه ۴.۱۸.۰۵

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

• از ۴.۱۷.۰۵ تا ۴.۱۸.۰۵
• از 4.17.09 تا 4.18.05

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

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

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

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

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

حفظ سازگاری

هنگام ارتقا دادن Apigee Edge برای Private Cloud به نسخه ۴.۱۸.۰۵، باید مطمئن شوید که پیاده‌سازی حاصل فقط به ویژگی‌های پشتیبانی‌شده در فایل‌های پیکربندی آن ارجاع می‌دهد.

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

اگر با ویرایش فایل‌های .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 و آنلاین شدن مجدد آن‌ها، داده‌های تجزیه‌وتحلیل به گره‌های 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 master:

   /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. فایل Edge bootstrap_4.17.0x.sh را بارگیری کنید، که در آن x یا 5 (برای 4.17.05) یا 9 (برای 4.17.09) است به /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-service برای نصب ابزار apigee-setup استفاده کنید:

      /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. با انجام فراخوانی API مدیریت 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 را اجرا می‌کند به آن فهرست راهنما دسترسی نداشته باشد، گزارش را در فهرست راهنمای /tmp به‌عنوان فایلی با نام update_username.log می‌نویسد.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2. درصورت وجود، هرگونه کار CRON را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده است غیرفعال کنید تا زمانی که به‌روزرسانی تکمیل شود.
3. برای نصب Edge RPM، به‌عنوان root به سیستم گره وارد شوید.
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» = Cassandra
    • «e» = ElasticSearch
    • "edge" =همه مؤلفه‌های Edge به‌جز Edge UI. مؤلفه «edge» شامل Management Server،‏ Message Processor،‏ Router،‏ QPID Server،‏ Edge Postgres Server است.
    • "ldap" = OpenLDAP
    • "ps" = postgresql
    • "qpid" = qpidd
    • "sso" = Edge SSO
    • "ui" = Edge UI
    • «zk» = Zookeeper

    می‌توانید update.sh را با تنظیم component روی «همه» برای همه مؤلفه‌ها اجرا کنید، اما فقط درصورتی‌که نمایه نصب 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 را ببینید.

برای عقب‌گرد کردن به‌روزرسانی در آینده، از روش شرح‌داده‌شده در عقب‌گرد کردن 4.18.05 استفاده کنید.

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

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

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

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

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

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

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

2. یک مخزن محلی 4.18.05 ایجاد کنید، همان‌طور که در «ایجاد یک مخزن محلی Apigee» در نصب ابزار کمکی apigee-setup Edge توضیح داده شده است.
   
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 خارج کنید:

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

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

      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» = Cassandra
   • «e» = ElasticSearch
   • "edge" =همه مؤلفه‌های Edge به‌جز Edge UI. مؤلفه «edge» شامل Management Server،‏ Message Processor،‏ Router،‏ QPID Server،‏ Edge Postgres Server است.
   • "ldap" = OpenLDAP
   • "ps" = postgresql
   • "qpid" = qpidd
   • "sso" = Edge SSO
   • "ui" = Edge UI
   • «zk» = Zookeeper

   می‌توانید update.sh را با تنظیم component روی «همه» برای همه مؤلفه‌ها اجرا کنید، اما فقط درصورتی‌که نمایه نصب 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 مراجعه کنید.

برای عقب‌گرد کردن به‌روزرسانی در آینده، از روش شرح‌داده‌شده در عقب‌گرد کردن 4.18.05 استفاده کنید.

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

ترتیب به‌روزرسانی دستگاه‌ها در نصب 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 SSO را نصب کرده‌اید) Edge SSO را به‌روز کنید:

   /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 را در دستگاه ۱ بازراه‌اندازی کنید:

   /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 در ماشین 5:

      /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 را در دستگاه ۱ بازراه‌اندازی کنید:

    /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 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 را در دستگاه ۱ بازراه‌اندازی کنید:

    /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 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. مطمئن شوید که گره آماده‌به‌کار 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. به‌روزرسانی 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. به‌روزرسانی میانای کاربر:
   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

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