آپدیت Apigee Edge 4.16.01/4.16.05 به 4.17.09

Edge for Private Cloud نسخه 4.17.09

کدام نسخه های Edge را می توانید به 4.17.09 به روز کنید

با استفاده از این روش می توانید Apigee Edge نسخه 4.16.01.0x و 4.16.05.x را به 4.17.09 به روز کنید.

اگر نسخه ای از Edge قبل از نسخه 4.16.01 دارید، ابتدا باید به نسخه 4.16.01 مهاجرت کنید و سپس به نسخه 4.17.09 آپدیت کنید.

• می توانید Apigee Edge نسخه 4.15.07 را به 4.16.01 منتقل کنید.
• اگر نسخه ای از Edge قبل از نسخه 4.15.07 دارید، ابتدا باید به نسخه 4.15.07 و سپس به نسخه 4.16.01 مهاجرت کنید.
  • اگر از Edge نسخه 4.14.04 یا جدیدتر مهاجرت می کنید: مستقیماً به نسخه 4.15.07 مهاجرت کنید.
  • اگر از Edge نسخه 4.14.01 مهاجرت می کنید: ابتدا باید به نسخه 4.14.04 و سپس به نسخه 4.15.07 مهاجرت کنید.

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

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

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

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

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

کاهش رتبه Zookeeper در صورت به روز رسانی از 4.16.01

نسخه Zookeeper RPM در Edge برای Private Cloud 4.16.01 apigee-zookeeper-3.4.5-1.0.905.noarch.rpm است. در نسخه‌های بعدی Edge، نسخه Zookeeper به apigee-zookeeper-3.4.5-0.0.94x برگردانده شد. این امر از yum از ارتقای Zookeeper به نسخه های بعدی از 4.16.01 جلوگیری می کند. راه اصلاح این وضعیت اجرای yum downgrade apigee-zookeeper قبل از به‌روزرسانی Zookeeper است.

با استفاده از دستور زیر می توانید نسخه Zookeeper خود را بررسی کنید:

> rpm -qa |grep apigee-zookeeper

اگر این دستور نسخه Zookeeper را برگرداند:

apigee-zookeeper-3.4.5-1.0.905

سپس باید دانگرید را انجام دهید.

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

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

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

قبل از ارتقاء Apigee Edge به پیش نیازهای زیر توجه کنید:

• پشتیبان گیری از تمام گره ها
  قبل از به‌روزرسانی، توصیه می‌شود به دلایل ایمنی یک نسخه پشتیبان کامل از تمام گره‌ها انجام دهید. از رویه نسخه فعلی Edge برای انجام پشتیبان استفاده کنید.
  
  این به شما این امکان را می دهد که یک برنامه پشتیبان داشته باشید، در صورتی که به روز رسانی به نسخه جدید به درستی کار نمی کند. برای اطلاعات بیشتر در مورد پشتیبان‌گیری، به پشتیبان‌گیری و بازیابی مراجعه کنید.
• مطمئن شوید که Edge در حال اجرا است
  با استفاده از دستور زیر اطمینان حاصل کنید که Edge در طول فرآیند به‌روزرسانی فعال است:
  
  > وضعیت /opt/apigee/apigee-service/bin/apigee-all

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

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

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

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

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

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

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

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

نیاز به ارتقاء به Java JDK نسخه 8

این نسخه از Edge مستلزم آن است که Java JDK نسخه 8 را روی تمام گره‌های پردازش Edge نصب کرده باشید. می توانید Oracle JDK 8 یا OpenJDK 8 را نصب کنید. اگر Java JDK 8 قبلاً نصب نشده باشد، اسکریپت به روز رسانی می تواند آن را برای شما نصب کند.

به‌عنوان بخشی از به‌روزرسانی به جاوا 8، برخی از رمزهای TLS دیگر در Oracle JDK 8 در دسترس نیستند. برای فهرست کامل، به بخش «مجموعه‌های پیش‌فرض رمز غیرفعال‌شده» در http://docs.oracle.com/javase/8/ مراجعه کنید. docs/technotes/guides/security/SunProviders.html .

برای فعال کردن مخزن EPEL مورد نیاز است

برای نصب یا به‌روزرسانی Edge باید بسته‌های اضافی برای لینوکس سازمانی (یا EPEL) را فعال کنید. دستوری که استفاده می کنید به نسخه RedHat/CentOS شما بستگی دارد:

• برای RedHat/CentOS 7.x:
  > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm؛ rpm -ivh epel-release-latest-7.noarch.rpm
• برای RedHat/CentOS 6.x:
  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

اضافه کردن پارامتر پیکربندی SMTPMAILFROM الزامی است

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

API BaaS نسخه 4.17.09 همچنین پشتیبانی از ویژگی SMTPMAILFROM را اضافه کرد. هنگام به روز رسانی API BaaS، باید SMTPMAILFROM را در فایل پیکربندی تنظیم کنید.

این پارامتر به شکل زیر است:

SMTPMAILFROM="My Company <myco@company.com>"

در صورت به‌روزرسانی هنگام استفاده از احراز هویت خارجی، لازم است

می‌توانید یک سرویس فهرست خارجی را در نصب Apigee Edge Private Cloud ادغام کنید. این ویژگی برای کار با هر سرویس دایرکتوری که از LDAP پشتیبانی می‌کند، مانند Active Directory، OpenLDAP و غیره طراحی شده است. یک راه حل خارجی LDAP به مدیران سیستم اجازه می دهد تا اعتبار کاربری را از یک سرویس مدیریت دایرکتوری متمرکز، خارج از سیستم هایی مانند Apigee Edge که از آنها استفاده می کنند، مدیریت کنند.

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

هنگامی که احراز هویت خارجی فعال است، اکثر مشتریان از قسمت نام حساب Active Directory SAM به عنوان نام کاربری برای احراز هویت استفاده می کنند، به جای آدرس ایمیلی که توسط سرور Edge OpenLDAP استفاده می شود.

اگر با یک سرویس دایرکتوری خارجی ادغام شده اید، هنگام به روز رسانی Edge به 4.17.09 خط زیر را به فایل پیکربندی خود اضافه کنید:

IS_EXTERNAL_AUTH="true"

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

ارتقاء مورد نیاز به Qpid 1.35

این نسخه حاوی یک به روز رسانی لازم برای Qpid 1.35 است. به عنوان بخشی از به روز رسانی یک گره Qpid، شما باید:

• با مسدود کردن پورت 5672 در گره Qpid، به طور موقت از نوشتن روترها و پردازشگرهای پیام در گره Qpid جلوگیری کنید. می توانید از دستور زیر برای مسدود کردن این پورت در گره Qpid استفاده کنید:
  > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -i eth0 -j DROP
• منتظر بمانید تا صف Qpid از پیام ها خالی شود تا مطمئن شوید که گره Qpid همه پیام ها را قبل از به روز رسانی پردازش کرده است. برای اطمینان از خالی بودن صف پیام Qpid از دستور زیر استفاده کنید:
  > qpid-stat -q
• گره Qpid را به روز کنید.
• پورت 5672 را در گره Qpid رفع انسداد کنید تا امکان دسترسی از روترها و پردازشگرهای پیام فراهم شود. برای رفع انسداد این پورت می توانید از دستور زیر استفاده کنید:
  > sudo iptables -F
  
  توجه داشته باشید که اگر از iptables برای قوانین دیگر استفاده می کنید، می توانید از گزینه -D برای معکوس کردن تغییر خاص استفاده کنید:
  > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -i eth0 -j DROP

این فرآیند به تفصیل در زیر برای هر توپولوژی Edge توضیح داده شده است.

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

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

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

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

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

این روش یک سرور آماده به کار Postgres را در یک گره جدید ایجاد می کند. اطمینان حاصل کنید که یک سرور آماده به کار Postgres جدید را برای نسخه موجود Edge (4.16.01 یا 4.16.05) نصب کرده اید، نه برای نسخه 4.17.09.

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

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

1. در استاد فعلی Postgres، فایل /opt/apigee/customer/application/postgresql.properties را ویرایش کنید تا توکن زیر را تنظیم کنید. اگر آن فایل وجود ندارد، آن را ایجاد کنید:
   
   conf_pg_hba_replication.connection=تکثیر میزبان apigee exist_slave_ip /32 trust\ \nتکثیر میزبان apigee new_slave_ip /32 trust
   
   که موجود_slave_ip آدرس IP سرور آماده به کار Postgres فعلی و new_slave_ip آدرس IP گره آماده به کار جدید است.
2. apigee-postgresql را در Master Postgres راه اندازی مجدد کنید:
   > /opt/apigee/apigee-service/bin/apigee-service راه اندازی مجدد apigee-postgresql
3. بررسی کنید که گره آماده به کار جدید با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf در اصلی اضافه شده است. شما باید خطوط زیر را در آن فایل ببینید:
   Host Replication apigee exist_slave_ip/32 trust
   Host Replication apigee new_slave_ip/32 trust
4. سرور آماده به کار جدید Postgres را نصب کنید:
   1. فایل پیکربندی را که برای نصب نسخه فعلی Edge استفاده کردید، ویرایش کنید تا موارد زیر را مشخص کنید:
      
      # آدرس IP استاد فعلی:
      PG_MASTER=192.168.56.103
      # آدرس IP گره آماده به کار جدید
      PG_STANDBY=192.168.56.102
   2. همانطور که در Install the Edge apigee-setup utility توضیح داده شد SELinux را غیرفعال کنید.
   3. فایل Edge bootstrap_4.16.05.sh را در /tmp/bootstrap_4.16.05.sh دانلود کنید:
      > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
      
      توجه : اگر از 4.16.01 به روز رسانی می کنید، فایل Edge bootstrap.sh را دانلود کنید.
   4. ابزار و وابستگی های Edge apigee-service را نصب کنید:
      > sudo bash /tmp/bootstrap_4.16.05.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
   
   اگر Postgres در حال اجرا نیست، آن را شروع کنید:
   > /opt/apigee/apigee-service/bin/apigee-all start
2. UUID گره آماده به کار جدید را با اجرای دستور cURL زیر در گره آماده به کار جدید دریافت کنید:
   > curl -u sysAdminEmail:password http:// <node_IP> :8084/v1/servers/self
   
   شما باید UUID گره را در انتهای خروجی به شکل زیر ببینید:
   "نوع" : [ "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=تکثیر میزبان apigee exist_slave_ip /32 trust
5. apigee-postgresql را در Master Postgres راه اندازی مجدد کنید:
   > /opt/apigee/apigee-service/bin/apigee-service راه اندازی مجدد apigee-postgresql
6. بررسی کنید که گره آماده به کار جدید با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf در اصلی حذف شده است. شما باید فقط خط زیر را در آن فایل ببینید:
   Host Replication apigee exist_slave_ip /32 trust
7. UUID گره آماده به کار را از ZooKeeper با فراخوانی API مدیریت Edge زیر در گره مدیریت سرور حذف کنید:
   > curl -u sysAdminEmail:password -X DELETE http:// <ms_IP> :8080/v1/servers/ <new_slave_uuid>

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

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

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

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

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

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

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

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

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

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

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

1. اگر در حال حاضر از Replication Master-standby Postgres استفاده می کنید، یک گره آماده به کار Postgres جدید را همانطور که در بالا در نصب یک گره آماده به کار جدید Postgres توضیح داده شد نصب کنید.
2. در صورت وجود، کارهای CRON را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده اند، تا زمانی که به روز رسانی کامل نشده است، غیرفعال کنید.
3. برای نصب Edge RPM به عنوان root وارد گره خود شوید.
   توجه : در حالی که نصب RPM به دسترسی ریشه نیاز دارد، می‌توانید پیکربندی Edge را بدون دسترسی ریشه انجام دهید.
4. yum-utils و yum-plugin-priorities را نصب کنید:
   > sudo yum نصب yum-utils
   > sudo yum نصب yum-plugin-priorities
5. همانطور که در Install the Edge apigee-setup utility توضیح داده شد SELinux را غیرفعال کنید.
6. همانطور که در بالا توضیح داده شد EPEL repo را فعال کنید.
7. اگر روی AWS نصب می‌کنید ، دستور yum-configure-manager زیر را اجرا کنید:
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
8. فایل Edge 4.17.09 bootstrap_4.17.09.sh را در /tmp/bootstrap_4.17.09.sh دانلود کنید:
   > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
9. ابزار Edge 4.17.09 apigee-service و وابستگی ها را نصب کنید:
   > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser= uName apigeepassword= pWord
   
   که در آن uName:pWord نام کاربری و رمز عبوری است که از Apigee دریافت کرده اید. اگر pWord را حذف کنید، از شما خواسته می شود آن را وارد کنید.
   
   به طور پیش فرض، نصب کننده بررسی می کند که جاوا 1.8 را نصب کرده اید. اگر این کار را نکنید، آن را برای شما نصب می کند. از گزینه JAVA_FIX برای تعیین نحوه مدیریت نصب جاوا استفاده کنید. JAVA_FIX مقادیر زیر را می گیرد:
   
   I = نصب OpenJDK 1.8 (پیش‌فرض)
   C = بدون نصب جاوا ادامه دهید
   Q = ترک. برای این گزینه باید خود جاوا را نصب کنید.
10. از apigee-service برای به روز رسانی ابزار apigee-setup استفاده کنید:
    1. اگر نسخه 4.16.01 را با ارتقاء Edge نسخه 4.15.07.0x نصب کرده اید، باید ابزار apigee-setup را نصب کنید:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
       
       این دستور ابزار update.sh را در /opt/apigee/apigee-setup/bin نصب می کند.
       
       اگر قبلاً ابزار apigee-setup را نصب کرده اید، آن را به روز کنید:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup به روز رسانی
    2. اگر نسخه 4.16.01 را مستقیماً نصب کرده اید، به این معنی که ارتقاء را از 4.15.07.0x انجام نداده اید، باید ابزار apigee-setup را به روز کنید :
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup به روز رسانی
       
       این به‌روزرسانی برای apigee-service ، ابزار update.sh را در /opt/apigee/apigee-setup/bin نصب می‌کند.
    3. اگر نسخه 4.16.05 را مستقیماً یا با به روز رسانی نصب کرده اید، باید ابزار apigee-setup را به روز کنید :
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup به روز رسانی
       
       این به‌روزرسانی برای apigee-service ، ابزار update.sh را در /opt/apigee/apigee-setup/bin نصب می‌کند.
11. بسته به نسخه فعلی Edge، باید ابزار apigee-validate را در مدیریت سرور نصب یا به‌روزرسانی کنید.
    1. اگر در حال حاضر از Edge 4.16.05 استفاده می کنید : ابزار apigee-validate را در سرور مدیریت به روز کنید:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-validate به روز رسانی
    2. اگر در حال حاضر از Edge 4.16.01 استفاده می کنید : ابزار apigee-validate را روی سرور مدیریت نصب کنید:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
       
       توجه : اگر هنگام نصب 4.16.01 ابزار apigee-validate را بر روی گره پردازشگر پیام نصب کرده اید، می توانید با استفاده از دستور زیر در آن گره، آن را به روز کنید:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-validate به روز رسانی
       
       با این حال، از تاریخ 4.16.05 و بعد از آن، Apigee توصیه می‌کند که برنامه apigee-validate را روی سرور مدیریت نصب و اجرا کنید.
    3. اگر در حال ارتقا از 4.16.01 هستید : فایل پیکربندی ارسال شده به ابزار apigee-validate را ویرایش کنید. در نسخه 4.16.01 Edge، فایل پیکربندی مورد استفاده توسط apigee-validate به ویژگی‌های زیر نیاز داشت:
       APIGEE_ADMINPW=sysAdminPword
       MP_POD = دروازه
       REGION=dc-1
       
       در این نسخه، فایل پیکربندی فقط به ویژگی APIGEE_ADMINPW نیاز دارد. می توانید دو ویژگی دیگر را از فایل حذف کنید.
12. ابزار apigee-provision را به روز کنید:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision به روز رسانی
13. ابزار به روز رسانی را بر روی گره های خود به ترتیبی که در زیر در " ترتیب به روز رسانی ماشین " در زیر توضیح داده شده است اجرا کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
    
    تنها مورد نیاز در فایل پیکربندی این است که فایل پیکربندی باید توسط کاربر "apigee" قابل دسترسی یا خواندن باشد.
    
    از گزینه "-c" برای تعیین کامپوننت برای به روز رسانی استفاده کنید. لیست اجزای احتمالی شامل:
    ldap = OpenLDAP
    cs = کاساندرا
    zk = نگهبان باغ وحش
    qpid = qpidd
    ps = postgresql
    edge = همه اجزای Edge به جز Edge UI: سرور مدیریت، پردازشگر پیام، روتر، سرور QPID، سرور Postgres
    UI = رابط کاربری لبه
    همه = به‌روزرسانی همه اجزای دستگاه (فقط برای پروفایل نصب Edge aio یا نمایه نصب API BaaS asa استفاده کنید)
    e = ElasticSearch
    b = پشته API BaaS
    p = پورتال API BaaS
    ebp = ElasticSearch، API BaaS Stack، و API BaaS Portal در همان گره
14. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.
15. اگر یک گره آماده به کار Postgres جدید نصب کرده اید، گره را همانطور که در بالا در Decommissioning a Postgres توضیح داده شد، از کار خارج کنید.

برای بازگرداندن بعدی به‌روزرسانی، از رویه‌ای که در 4.17.09 Process Rollback توضیح داده شده است استفاده کنید.

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

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

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

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

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

1. اگر در حال حاضر از Replication Master-standby Postgres استفاده می کنید، یک گره آماده به کار Postgres جدید را همانطور که در بالا در نصب یک گره آماده به کار جدید Postgres توضیح داده شد نصب کنید.
2. یک مخزن محلی 4.17.09 همانطور که در "ایجاد یک مخزن محلی Apigee" در نصب ابزار Edge apigee-setup توضیح داده شده است، ایجاد کنید.
   توجه : اگر قبلاً مخزن 4.16.01 یا 4.16.05 موجود دارید، می‌توانید مخزن 4.17.09 را همانطور که در «به‌روزرسانی یک مخزن محلی Apigee» در نصب ابزار Edge apigee-setup توضیح داده شده است، به آن اضافه کنید.
3. برای نصب apigee-service از فایل tar :
   1. در گره دارای مخزن محلی، از دستور زیر برای بسته بندی مخزن محلی در یک فایل .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz استفاده کنید:
      > /opt/apigee/apigee-service/bin/apigee-service بسته apigee-mirror
   2. فایل tar را در گره ای که می خواهید Edge را به روز کنید کپی کنید. به عنوان مثال، آن را در پوشه /tmp در گره جدید کپی کنید.
   3. در گره جدید، فایل را در پوشه /tmp untar کنید:
      > tar -xzf apigee-4.17.09.tar.gz
      
      این دستور یک دایرکتوری جدید به نام repos در دایرکتوری حاوی فایل tar ایجاد می کند. به عنوان مثال /tmp/repos.
   4. ابزار و وابستگی های Edge apigee-service را از /tmp/repos نصب کنید:
      > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      توجه داشته باشید که مسیر دایرکتوری repos را در این دستور قرار داده اید.
4. برای نصب apigee-service با استفاده از وب سرور Nginx:
   1. وب سرور Nginx را همانطور که در «نصب از مخزن با استفاده از وب سرور Nginx» در نصب ابزار Edge apigee-setup توضیح داده شده پیکربندی کنید.
   2. در گره راه دور، فایل Edge bootstrap_4.17.09.sh را در /tmp/bootstrap_4.17.09.sh دانلود کنید:
      > /usr/bin/curl http:// uName: pWord @ remoteRepo :3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
      
      که در آن uName:pWord نام کاربری و رمز عبوری است که در بالا برای مخزن تنظیم کرده اید و remoteRepo آدرس IP یا نام DNS گره repo است.
   3. در گره راه دور، ابزار Edge apigee-service و وابستگی ها را نصب کنید:
      > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost= remoteRepo :3939 apigeeuser= uName apigeepassword= pWord apigeeprotocol=http://
      
      که در آن uName:pWord نام کاربری و رمز عبور مخزن است.
5. از apigee-service برای به روز رسانی ابزار apigee-setup استفاده کنید:
   1. اگر نسخه 4.16.01 را با ارتقاء Edge نسخه 4.15.07.0x نصب کرده اید، باید ابزار apigee-setup را نصب کنید:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      
      این دستور ابزار update.sh را در /opt/apigee/apigee-setup/bin نصب می کند.
      
      اگر قبلاً ابزار apigee-setup را نصب کرده اید، آن را به روز کنید:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup به روز رسانی
   2. اگر نسخه 4.16.01 را مستقیماً نصب کرده اید، به این معنی که ارتقاء را از 4.15.07.0x انجام نداده اید، باید ابزار apigee-setup را به روز کنید:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup به روز رسانی
      
      این به‌روزرسانی برای apigee-service ، ابزار update.sh را در /opt/apigee/apigee-setup/bin نصب می‌کند.
   3. اگر نسخه 4.16.05 را مستقیماً یا با به روز رسانی نصب کرده اید، باید ابزار apigee-setup را به روز کنید:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup به روز رسانی
      
      این به‌روزرسانی برای apigee-service ، ابزار update.sh را در /opt/apigee/apigee-setup/bin نصب می‌کند.
6. بسته به نسخه فعلی Edge، باید ابزار apigee-validate را در مدیریت سرور نصب یا به‌روزرسانی کنید.
   1. اگر در حال حاضر از Edge 4.16.05 استفاده می کنید : ابزار apigee-validate را در سرور مدیریت به روز کنید:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate به روز رسانی
   2. اگر در حال حاضر از Edge 4.16.01 استفاده می کنید : ابزار apigee-validate را روی سرور مدیریت نصب کنید:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
      
      توجه : اگر هنگام نصب 4.16.01 ابزار apigee-validate را بر روی گره پردازشگر پیام نصب کرده اید، می توانید با استفاده از دستور زیر در آن گره، آن را به روز کنید:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate به روز رسانی
      
      با این حال، از تاریخ 4.16.05 و بعد از آن، Apigee توصیه می‌کند که برنامه apigee-validate را روی سرور مدیریت نصب و اجرا کنید.
   3. اگر در حال ارتقاء از 4.16.01 هستید : فایل پیکربندی ارسال شده به ابزار apigee-validate را ویرایش کنید. در نسخه 4.16.01 Edge، فایل پیکربندی مورد استفاده توسط apigee-validate به ویژگی‌های زیر نیاز داشت:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD = دروازه
      REGION=dc-1
      
      در این نسخه، فایل پیکربندی فقط به ویژگی APIGEE_ADMINPW نیاز دارد. می توانید دو ویژگی دیگر را از فایل حذف کنید.
7. ابزار apigee-provision را به روز کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision به روز رسانی
8. ابزار به روز رسانی را بر روی گره های خود به ترتیبی که در زیر در "ترتیب به روز رسانی ماشین" در زیر توضیح داده شده است، اجرا کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
   
   تنها مورد نیاز فایل پیکربندی این است که فایل پیکربندی باید توسط کاربر "apigee" قابل دسترسی یا خواندن باشد.
   
   از گزینه "-c" برای تعیین کامپوننت برای به روز رسانی استفاده کنید. لیست اجزای احتمالی شامل:
   ldap = OpenLDAP
   cs = کاساندرا
   zk = نگهبان باغ وحش
   qpid = qpidd
   ps = postgresql
   edge = همه اجزای Edge به جز Edge UI: سرور مدیریت، پردازشگر پیام، روتر، سرور QPID، سرور Postgres
   UI = رابط کاربری لبه
   همه = به‌روزرسانی همه اجزای دستگاه (فقط برای پروفایل نصب Edge aio یا نمایه نصب API BaaS asa استفاده کنید)
   e = ElasticSearch
   b = پشته API BaaS
   p = پورتال API BaaS
   ebp = ElasticSearch، API BaaS Stack، و API BaaS Portal در همان گره
9. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.
10. اگر یک گره آماده به کار Postgres جدید نصب کرده اید، گره را همانطور که در بالا در Decommissioning a Postgres توضیح داده شد، از کار خارج کنید.

برای بازگرداندن بعدی به‌روزرسانی، از رویه‌ای که در 4.17.09 Process Rollback توضیح داده شده است استفاده کنید.

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

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

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

برای نصب مستقل 1 میزبان

1. اگر SMTP را در Edge فعال کرده اید، SMTPMAILFROM را در فایل پیکربندی خود تنظیم کنید. این پارامتر به شکل زیر است:
   SMTPMAILFROM="شرکت من <myco@company.com>"
2. در صورت به روز رسانی از 4.16.01 ، Zookeeper را کاهش دهید:
   > yum degrade apigee-zookeeper
3. Cassandra و ZooKeeper را به روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. قانون iptables زیر را تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -i eth0 -j DROP
5. صف پیام Qpid را بررسی کنید:
   > qpid-stat -q
   
   به بررسی صف ادامه دهید تا تعداد در ستون "msg" 0 شود. شما نمی توانید Qpid را ارتقا دهید تا زمانی که تمام پیام ها را پردازش نکند.
6. به روز رسانی qpidd :
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
7. فلاش iptables:
   > sudo iptables -F
8. به روز رسانی LDAP:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
9. سرور 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
10. به روز رسانی postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
11. پایگاه داده Postgres را به روز کنید:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
12. اجزای باقی مانده Edge را به روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. به روز رسانی Edge UI:
    > /opt/apigee/apigee-setup/bin/update.sh -c UI -f configFile

برای نصب مستقل 2 میزبان

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

1. اگر SMTP را در Edge فعال کرده اید، SMTPMAILFROM را در فایل پیکربندی خود تنظیم کنید. این پارامتر به شکل زیر است:
   SMTPMAILFROM="شرکت من <myco@company.com>"
2. در صورت به روز رسانی از 4.16.01 ، Zookeeper را در دستگاه 1 کاهش دهید:
   > yum degrade apigee-zookeeper
3. Cassandra و ZooKeeper را در دستگاه 1 به روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. قانون iptables زیر را در ماشین 2 تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -i eth0 -j DROP
5. صف پیام Qpid را در دستگاه 2 بررسی کنید:
   > qpid-stat -q
   
   به بررسی صف ادامه دهید تا تعداد در ستون "msg" 0 شود. شما نمی توانید Qpid را ارتقا دهید تا زمانی که تمام پیام ها را پردازش نکند.
6. به روز رسانی qpidd در ماشین 2:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
7. iptables را روی دستگاه 2 فلاش کنید:
   > sudo iptables -F
8. به روز رسانی LDAP در دستگاه 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
9. به روز رسانی اجزای Edge در دستگاه 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
10. به روز رسانی UI در دستگاه 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c UI -f configFile
11. به روز رسانی postgresql در ماشین 2:
    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 را در ماشین 2 و ماشین 1 به روز کنید:
       > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
12. به روز رسانی اجزای Edge در دستگاه 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

برای نصب خوشه ای 5 میزبانی

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

1. اگر SMTP را در Edge فعال کرده اید، SMTPMAILFROM را در فایل پیکربندی خود تنظیم کنید. این پارامتر به شکل زیر است:
   SMTPMAILFROM="شرکت من <myco@company.com>"
2. اطمینان حاصل کنید که یک گره آماده به کار Postgres جدید را همانطور که در بالا در نصب یک گره آماده به کار جدید Postgres توضیح داده شده نصب کرده اید.
3. در صورت به روز رسانی از 4.16.01 ، Zookeeper را در macine 1، 2 و 3 کاهش دهید:
   > yum degrade apigee-zookeeper
4. Cassandra و ZooKeeper را در دستگاه 1، 2، و 3 به روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs ، zk -f configfile
5. قانون iptables زیر را در دستگاه 4 تنظیم کنید:
   > sudo iptables -A ورودی -p TCP -Destination -Port 5672! -S `HostName` -i ETH0 -J DROP
6. صف پیام QPID را در دستگاه 4 بررسی کنید:
   > qpid -stat -q
   
   ادامه دهید تا صف را بررسی کنید تا شمارش در ستون "MSG" 0 باشد. شما نمی توانید QPID را ارتقا دهید تا زمانی که تمام پیام ها را پردازش نکرده است.
7. QPIDD را در دستگاه 4 به روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configfile
8. iptables در دستگاه 4:
   > sudo iptables -f
9. مراحل 5 تا 8 را در دستگاه 5 تکرار کنید.
10. LDAP را در دستگاه 1 به روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configfile
11. اجزای Edge Edge را در دستگاه 1 ، 2 ، 3 به روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configfile
12. UI را در دستگاه 1 به روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configfile
13. به روزرسانی ماشین های 4 و 5:
    1. سرور Postgres و سرور QPID را در دستگاه 4 متوقف کنید:
       >/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server
       >/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server
    2. سرور Postgres ، سرور QPID و PostgreSQL را در دستگاه 5 متوقف کنید:
       >/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server
       >/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server
       >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
    3. سرور Postgres و PostgreSQL را در گره آماده به کار جدید که برای بازگشت به آن اضافه کرده اید متوقف کنید:
       >/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server
       >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
    4. به روزرسانی postgresql در دستگاه های 4:
       > /opt/apigee/apigee-setup/bin/update.sh -c PS -f ConfigFile
    5. پایگاه داده Postgres را در دستگاه 4 به روز کنید (فقط Master Postgres):
       >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. به روزرسانی postgresql در دستگاه های 5:
       > /opt/apigee/apigee-setup/bin/update.sh -c PS -f ConfigFile
    7. سرور Postgres و سرور QPID را در دستگاه های 4 و 5 شروع کنید:
       >/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server شروع
       >/opt/apigee/apigee-service/bin/apigee-service edge-qpid server شروع
    8. با اجرای دستورات زیر در دستگاه 5 ، Postgres را به عنوان یک گره آماده به کار پیکربندی کنید:
       > CD/OPT/APIGEE/DATA/APIGEE-POSTGRESQL/PGDATA
       > rm -rf *
       >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup- تکرار-در-استحکام -f configfile
    9. با صدور اسکریپت های زیر در هر دو سرور ، وضعیت تکثیر را تأیید کنید. سیستم باید نتایج یکسان را در هر دو سرور نمایش دهد تا از تکثیر موفقیت آمیز اطمینان حاصل شود:
       
       در دستگاه 4 ، گره اصلی ، اجرا کنید:
       >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
       
       تأیید کنید که می گوید استاد است.
       
       در دستگاه 5 ، گره آماده به کار:
       >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
       
       تأیید کنید که می گوید این آماده به کار است.
14. اجزای Edge Edge را در دستگاه 4 ، 5 به روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configfile
15. اطمینان حاصل کنید که با استفاده از روش فوق در انتقال یک گره Postgres ، گره آماده به کار جدید را از بین می برید.

برای یک نصب خوشه ای 9 میزبان

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

1. اگر SMTP را در Edge فعال کرده اید SMTPMAILFROM را در پرونده پیکربندی خود تنظیم کنید. این پارامتر فرم دارد:
   smtpmailfrom = "شرکت من <myco@company.com>"
2. اطمینان حاصل کنید که یک گره آماده به کار Postgres جدید را همانطور که در بالا در نصب یک گره آماده به کار Postgres توضیح داده شده است ، نصب کرده اید.
3. در صورت بروزرسانی از 4.16.01 ، Zookeeper را در Macine 1 ، 2 و 3 کاهش دهید:
   > yum downgrade apigee-Zookeeper
4. کاساندرا و Zookeeper را در دستگاه 1 ، 2 و 3 به روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs ، zk -f configfile
5. قانون iptables زیر را در دستگاه 6 تنظیم کنید:
   > sudo iptables -A ورودی -p TCP -Destination -Port 5672! -S `HostName` -i ETH0 -J DROP
6. صف پیام QPID را در دستگاه 6 بررسی کنید:
   > qpid -stat -q
   
   ادامه دهید تا صف را بررسی کنید تا شمارش در ستون "MSG" 0 باشد. شما نمی توانید QPID را ارتقا دهید تا زمانی که تمام پیام ها را پردازش نکرده است.
7. QPIDD را در دستگاه 6 به روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configfile
8. iptables در دستگاه 6:
   > sudo iptables -f
9. مراحل 5 تا 8 را در دستگاه 7 تکرار کنید.
10. LDAP را در دستگاه 1 به روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configfile
11. اجزای Edge را در دستگاه 6 ، 7 ، 1 ، 4 و 5 به روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configfile
12. UI را در دستگاه 1 به روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configfile
13. دستگاه های به روزرسانی 8 و 9:
    1. سرور Postgres را در دستگاه 8 متوقف کنید:
       >/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server
    2. STOP SERVER SERVER و POSTGRESQL در دستگاه 9:
       >/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server
       >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
    3. سرور QPID را در دستگاه های 6 و 7 متوقف کنید:
       >/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server
    4. سرور Postgres و PostgreSQL را در گره آماده به کار جدید که برای بازگشت به آن اضافه کرده اید متوقف کنید:
       >/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server
       >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
    5. به روزرسانی postgresql در دستگاه های 8:
       > /opt/apigee/apigee-setup/bin/update.sh -c PS -f ConfigFile
    6. پایگاه داده Postgres را در دستگاه 8 به روز کنید (فقط استاد Postgres):
       >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. به روزرسانی postgresql در دستگاه های 9:
       > /opt/apigee/apigee-setup/bin/update.sh -c PS -f ConfigFile
    8. سرور سرور Postgres را در دستگاه های 8 و 9 شروع کنید:
       >/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server شروع
    9. سرور QPID سرور را در دستگاه های 6 و 7 شروع کنید:
       >/opt/apigee/apigee-service/bin/apigee-service edge-qpid server شروع
    10. با اجرای دستورات زیر در دستگاه 9 ، Postgres را به عنوان یک گره آماده به کار پیکربندی کنید:
        > CD/OPT/APIGEE/DATA/APIGEE-POSTGRESQL/PGDATA
        > rm -rf *
        >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup- تکرار-در-استحکام -f configfile
    11. با صدور اسکریپت های زیر در هر دو سرور ، وضعیت تکثیر را تأیید کنید. سیستم باید نتایج یکسان را در هر دو سرور نمایش دهد تا از تکثیر موفقیت آمیز اطمینان حاصل شود:
        در دستگاه 8 ، گره اصلی ، اجرا کنید:
        >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
        
        تأیید کنید که می گوید استاد است.
        
        در دستگاه 9 ، گره آماده به کار:
        >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
        
        تأیید کنید که می گوید این آماده به کار است.
14. اجزای Edge Edge را در دستگاه 8 و 9 به روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configfile
15. اطمینان حاصل کنید که با استفاده از روش فوق در انتقال یک گره Postgres ، گره آماده به کار جدید را از بین می برید.

برای یک نصب خوشه ای 13 میزبان

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

1. اگر SMTP را در Edge فعال کرده اید SMTPMAILFROM را در پرونده پیکربندی خود تنظیم کنید. این پارامتر فرم دارد:
   smtpmailfrom = "شرکت من <myco@company.com>"
2. اطمینان حاصل کنید که یک گره آماده به کار Postgres جدید را همانطور که در بالا در نصب یک گره آماده به کار Postgres توضیح داده شده است ، نصب کرده اید.
3. در صورت بروزرسانی از 4.16.01 ، Zookeeper را در Macine 1 ، 2 و 3 کاهش دهید:
   > yum downgrade apigee-Zookeeper
4. کاساندرا و Zookeeper را در دستگاه 1 ، 2 و 3 به روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs ، zk -f configfile
5. قانون iptables زیر را در دستگاه 12 تنظیم کنید:
   > sudo iptables -A ورودی -p TCP -Destination -Port 5672! -S `HostName` -i ETH0 -J DROP
6. صف پیام QPID را در دستگاه 12 بررسی کنید:
   > qpid -stat -q
   
   ادامه دهید تا صف را بررسی کنید تا شمارش در ستون "MSG" 0 باشد. شما نمی توانید QPID را ارتقا دهید تا زمانی که تمام پیام ها را پردازش نکرده است.
7. QPIDD را در دستگاه 12 به روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configfile
8. iptables در دستگاه 12:
   > sudo iptables -f
9. مراحل 5 تا 8 را در دستگاه 13 تکرار کنید.
10. LDAP را در دستگاه 4 و 5 به روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configfile
11. اجزای Edge Edge را در دستگاه 12 ، 13 ، 6 ، 7 ، 10 و 11 به روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configfile
12. UI را در دستگاه 6 و 7 به روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configfile
13. دستگاه های به روزرسانی 8 و 9:
    1. سرور Postgres را در دستگاه 8 متوقف کنید:
       >/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server
    2. STOP SERVER SERVER و POSTGRESQL در دستگاه 9:
       >/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server
       >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
    3. سرور QPID را در دستگاه های 12 و 13 متوقف کنید:
       >/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server
    4. سرور Postgres و PostgreSQL را در گره آماده به کار جدید که برای بازگشت به آن اضافه کرده اید متوقف کنید:
       >/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server
       >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
    5. به روزرسانی postgresql در دستگاه های 8:
       > /opt/apigee/apigee-setup/bin/update.sh -c PS -f ConfigFile
    6. پایگاه داده Postgres را در دستگاه 8 به روز کنید (فقط استاد Postgres):
       >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. به روزرسانی postgresql در دستگاه های 9:
       > /opt/apigee/apigee-setup/bin/update.sh -c PS -f ConfigFile
    8. سرور Postgres را در دستگاه های 8 و 9 شروع کنید:
       >/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server شروع
    9. سرور QPID سرور را در دستگاه های 12 و 13 شروع کنید:
       >/opt/apigee/apigee-service/bin/apigee-service edge-qpid server شروع
    10. با اجرای دستورات زیر در دستگاه 9 ، Postgres را به عنوان یک گره آماده به کار پیکربندی کنید:
        > CD/OPT/APIGEE/DATA/APIGEE-POSTGRESQL/PGDATA
        > rm -rf *
        >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup- تکرار-در-استحکام -f configfile
    11. با صدور اسکریپت های زیر در هر دو سرور ، وضعیت تکثیر را تأیید کنید. سیستم باید نتایج یکسان را در هر دو سرور نمایش دهد تا از تکثیر موفقیت آمیز اطمینان حاصل شود:
        در دستگاه 8 ، گره اصلی ، اجرا کنید:
        >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
        
        تأیید کنید که می گوید استاد است.
        
        در دستگاه 9 ، گره آماده به کار:
        >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
        
        تأیید کنید که می گوید این آماده به کار است.
14. اجزای Edge Edge را در دستگاه 8 و 9 به روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configfile
15. اطمینان حاصل کنید که با استفاده از روش فوق در انتقال یک گره Postgres ، گره آماده به کار جدید را از بین می برید.

برای نصب خوشه ای 12 میزبان

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

1. اگر SMTP را در Edge فعال کرده اید SMTPMAILFROM را در پرونده پیکربندی خود تنظیم کنید. این پارامتر فرم دارد:
   smtpmailfrom = "شرکت من <myco@company.com>"
2. اطمینان حاصل کنید که یک گره آماده به کار Postgres جدید را همانطور که در بالا در نصب یک گره آماده به کار Postgres توضیح داده شده است ، نصب کرده اید.
3. کاساندرا و باغ وحش را به روز کنید:
   1. در صورت بروزرسانی از 4.16.01 ، Zookeeper را در مرکز داده 1 ، 2 و 3 در مرکز داده 1 کاهش دهید:
      > yum downgrade apigee-Zookeeper
   2. در دستگاه های 1 ، 2 و 3 در مرکز داده 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs ، zk -f configfile
   3. در صورت بروزرسانی از 4.16.01 ، Zookeeper را در مرکز داده 2 ماکین 7 ، 8 و 9 پایین بیاورید:
      > yum downgrade apigee-Zookeeper
   4. در دستگاه های 7 ، 8 و 9 در مرکز داده 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs ، zk -f configfile
4. qpidd را به روز کنید:
   1. ماشین آلات 4 ، 5 در مرکز داده 1
      1. قانون iptables زیر را در دستگاه 4 تنظیم کنید:
         > sudo iptables -A ورودی -p TCP -Destination -Port 5672! -S `HostName` -i ETH0 -J DROP
      2. صف پیام QPID را در دستگاه 4 بررسی کنید:
         > qpid -stat -q
         
         ادامه دهید تا صف را بررسی کنید تا شمارش در ستون "MSG" 0 باشد. شما نمی توانید QPID را ارتقا دهید تا زمانی که تمام پیام ها را پردازش نکرده است.
      3. QPIDD را در دستگاه 4 به روز کنید:
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configfile
      4. iptables در دستگاه 4:
         > sudo iptables -f
      5. مراحل 1 تا 4 را در دستگاه 5 تکرار کنید.
   2. ماشین آلات 10 ، 11 در مرکز داده 2
      1. قانون iptables زیر را روی دستگاه 10 تنظیم کنید:
         > sudo iptables -A ورودی -p TCP -Destination -Port 5672! -S `HostName` -i ETH0 -J DROP
      2. صف پیام QPID را در دستگاه 10 بررسی کنید:
         > qpid -stat -q
         
         ادامه دهید تا صف را بررسی کنید تا شمارش در ستون "MSG" 0 باشد. شما نمی توانید QPID را ارتقا دهید تا زمانی که تمام پیام ها را پردازش نکرده است.
      3. QPIDD را در دستگاه 10 به روز کنید:
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configfile
      4. iptables در دستگاه 10:
         > sudo iptables -f
      5. مراحل 1 تا 4 را در دستگاه 11 تکرار کنید.
5. LDAP را به روز کنید:
   1. ماشین آلات 1 در مرکز داده 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configfile
   2. دستگاه های 7 در مرکز داده 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configfile
6. به روزرسانی اجزای لبه:
   1. ماشین آلات 4 ، 5 ، 1 ، 2 ، 3 در مرکز داده 1
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configfile
   2. ماشین آلات 10 ، 11 ، 7 ، 8 ، 9 در مرکز داده 2
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configfile
7. UI را به روز کنید:
   1. دستگاه 1 در مرکز داده 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configfile
   2. دستگاه 7 در مرکز داده 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configfile
8. دستگاه 6 را در مرکز داده 1 و 12 در مرکز داده 2 به روز کنید:
   1. سرور Postgres را در دستگاه 6 متوقف کنید:
      >/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server
   2. STOP SERVER SERVER و POSTGRESQL در دستگاه 12:
      >/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server
      >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
   3. سرور QPID را در دستگاه های 4 ، 5 ، 10 و 11 متوقف کنید:
      >/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server
   4. سرور Postgres و PostgreSQL را در گره آماده به کار جدید که برای بازگشت به آن اضافه کرده اید متوقف کنید:
      >/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server
      >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
   5. به روزرسانی postgresql در دستگاه های 6:
      > /opt/apigee/apigee-setup/bin/update.sh -c PS -f ConfigFile
   6. پایگاه داده Postgres را در دستگاه 6 به روز کنید (فقط استاد Postgres):
      >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
   7. به روزرسانی postgresql در دستگاه های 12:
      > /opt/apigee/apigee-setup/bin/update.sh -c PS -f ConfigFile
   8. سرور سرور Postgres را در دستگاه های 6 و 12 شروع کنید:
      >/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server شروع
   9. سرور QPID سرور را در دستگاه های 4 ، 5 ، 10 و 11 شروع کنید:
      >/opt/apigee/apigee-service/bin/apigee-service edge-qpid server شروع
   10. با اجرای دستورات زیر در دستگاه 12 ، Postgres را به عنوان یک گره آماده به کار پیکربندی کنید:
       > CD/OPT/APIGEE/DATA/APIGEE-POSTGRESQL/PGDATA
       > rm -rf *
       >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup- تکرار-در-استحکام -f configfile
   11. با صدور اسکریپت های زیر در هر دو سرور ، وضعیت تکثیر را تأیید کنید. سیستم باید نتایج یکسان را در هر دو سرور نمایش دهد تا از تکثیر موفقیت آمیز اطمینان حاصل شود:
       در دستگاه 6 ، گره اصلی ، اجرا کنید:
       >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
       
       تأیید کنید که می گوید استاد است.
       
       در دستگاه 12 ، گره آماده به کار:
       >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
       
       تأیید کنید که می گوید این آماده به کار است.
9. اجزای Edge Edge را در دستگاه 6 و 12 به روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configfile
10. اطمینان حاصل کنید که با استفاده از روش فوق در انتقال یک گره Postgres ، گره آماده به کار جدید را از بین می برید.

برای نصب API BAAS 7 میزبان یا 10 میزبان

برای نصب غیر استاندارد

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

1. باغ وحش
2. کاساندرا
3. qpidd
4. LDAP
5. لبه ، به معنی پروفایل "-C Edge" در همه گره ها به ترتیب: گره هایی با سرور QPID اما نه سرور Postgres ، سرور مدیریت ، پردازنده پیام و روتر.
   توجه : اگر گره هم سرور QPID و هم سرور Postgres را نصب کرده است ، مرحله مشخصات "-C Edge" را به عنوان بخشی از مرحله 8 اجرا کنید.
6. لبه UI
7. PostgreSQL در استاد Postgres ، از جمله به روزرسانی.
8. PostgreSQL در آماده به کار Postgres.
9. لبه ، به معنی مشخصات "-C Edge" در تمام گره های QPID و Postgres ترکیبی یا هر گره Postgres مستقل.