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

Edge for Private Cloud نسخه 4.18.01

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

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

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

• می توانید 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.18.01 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.18.01 خط زیر را به فایل پیکربندی خود اضافه کنید:

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.6

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

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

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

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

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

برای انجام نصب، از همان فایل پیکربندی که برای نصب نسخه فعلی 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.18.01 در یک گره با اتصال اینترنت خارجی

برای به روز رسانی اجزای 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. اگر روی Oracle 7.x نصب می‌کنید ، دستور زیر را اجرا کنید:
   > sudo yum-config-manager -- ol7_optional_latest را فعال کنید
8. اگر روی 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
9. فایل Edge 4.18.01 bootstrap_4.18.01.sh را در /tmp/bootstrap_4.18.01.sh دانلود کنید:
   > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
10. ابزار و وابستگی های سرویس edge 4.18.01 apigee-service را نصب کنید:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser= uName apigeepassword= pWord
    
    که در آن uName:pWord نام کاربری و رمز عبوری است که از Apigee دریافت کرده اید. اگر pWord را حذف کنید، از شما خواسته می شود آن را وارد کنید.
    
    به طور پیش فرض، نصب کننده بررسی می کند که جاوا 1.8 را نصب کرده اید. اگر این کار را نکنید، آن را برای شما نصب می کند. از گزینه JAVA_FIX برای تعیین نحوه مدیریت نصب جاوا استفاده کنید. JAVA_FIX مقادیر زیر را می گیرد:
    
    I = نصب OpenJDK 1.8 (پیش‌فرض)
    C = بدون نصب جاوا ادامه دهید
    Q = ترک. برای این گزینه باید خود جاوا را نصب کنید.
11. از 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 نصب می‌کند.
12. بسته به نسخه فعلی 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 نیاز دارد. می توانید دو ویژگی دیگر را از فایل حذف کنید.
13. ابزار apigee-provision را به روز کنید:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision به روز رسانی
14. ابزار به روز رسانی را بر روی گره های خود به ترتیبی که در زیر در " ترتیب به روز رسانی ماشین " در زیر توضیح داده شده است اجرا کنید:
    > /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 در همان گره
15. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.
16. اگر یک گره آماده به کار Postgres جدید نصب کرده اید، گره را همانطور که در بالا در Decommissioning a Postgres توضیح داده شد، از کار خارج کنید.

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

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

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

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

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

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

1. اگر در حال حاضر از Replication Master-standby Postgres استفاده می کنید، یک گره آماده به کار Postgres جدید را همانطور که در بالا در نصب یک گره آماده به کار جدید Postgres توضیح داده شد نصب کنید.
2. یک مخزن محلی 4.18.01 همانطور که در "ایجاد یک مخزن محلی Apigee" در نصب ابزار Edge apigee-setup توضیح داده شده است، ایجاد کنید.
   توجه : اگر قبلاً مخزن 4.16.01 یا 4.16.05 موجود دارید، می‌توانید مخزن 4.18.01 را همانطور که در «به‌روزرسانی یک مخزن محلی Apigee» در نصب ابزار Edge apigee-setup توضیح داده شده است، به آن اضافه کنید.
3. برای نصب apigee-service از فایل tar :
   1. در گره دارای مخزن محلی، از دستور زیر برای بسته بندی مخزن محلی در یک فایل .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz استفاده کنید:
      > /opt/apigee/apigee-service/bin/apigee-service بسته apigee-mirror
   2. فایل tar را در گره ای که می خواهید Edge را به روز کنید کپی کنید. به عنوان مثال، آن را در پوشه /tmp در گره جدید کپی کنید.
   3. در گره جدید، فایل را در پوشه /tmp untar کنید:
      > tar -xzf apigee-4.18.01.tar.gz
      
      این دستور یک دایرکتوری جدید به نام repos در دایرکتوری حاوی فایل tar ایجاد می کند. به عنوان مثال /tmp/repos.
   4. ابزار و وابستگی های Edge apigee-service را از /tmp/repos نصب کنید:
      > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      توجه داشته باشید که مسیر دایرکتوری repos را در این دستور قرار داده اید.
4. برای نصب apigee-service با استفاده از وب سرور Nginx:
   1. وب سرور Nginx را همانطور که در «نصب از مخزن با استفاده از وب سرور Nginx» در نصب ابزار Edge apigee-setup توضیح داده شده پیکربندی کنید.
   2. در گره راه دور، فایل Edge bootstrap_4.18.01.sh را در /tmp/bootstrap_4.18.01.sh دانلود کنید:
      > /usr/bin/curl http:// uName: pWord @ remoteRepo :3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
      
      که در آن uName:pWord نام کاربری و رمز عبوری است که در بالا برای مخزن تنظیم کرده اید و remoteRepo آدرس IP یا نام DNS گره repo است.
   3. در گره راه دور، ابزار Edge apigee-service و وابستگی ها را نصب کنید:
      > sudo bash /tmp/bootstrap_4.18.01.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.18.01 Rollback Process توضیح داده شده است استفاده کنید.

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

ترتیب به روز رسانی دستگاه ها در نصب 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:
       > /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 را در دستگاه 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 INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -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 در دستگاه 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 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 در ماشین های 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 start
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    8. با اجرای دستورات زیر در ماشین 5، 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. با صدور اسکریپت های زیر در هر دو سرور، وضعیت تکرار را تأیید کنید. برای اطمینان از تکرار موفقیت آمیز، سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد:
       
       در دستگاه 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 در دستگاه 4، 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. با استفاده از روش بالا در Decommissioning a Postgres، گره آماده به کار جدید را از کار انداخته اید.

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

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

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 زیر را روی ماشین 6 تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -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 stop
    2. توقف سرور Postgres و postgresql در ماشین 9:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. توقف سرور Qpid در ماشین های 6 و 7:
       > /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 در ماشین های 8:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. پایگاه داده Postgres را در ماشین 8 به روز کنید (فقط Postgres master):
       > /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 start
    9. سرور سرور Qpid را در ماشین های 6 و 7 راه اندازی کنید:
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. با اجرای دستورات زیر در ماشین 9، 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. با صدور اسکریپت های زیر در هر دو سرور، وضعیت تکرار را تأیید کنید. برای اطمینان از تکرار موفقیت آمیز، سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد:
        در دستگاه 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 در دستگاه 8 و 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. با استفاده از روش بالا در Decommissioning a Postgres، گره آماده به کار جدید را از کار انداخته اید.

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

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

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 زیر را در دستگاه 12 تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -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 را در دستگاه 12، 13، 6، 7، 10 و 11 به ترتیب به روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
12. به‌روزرسانی رابط کاربری در دستگاه 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 stop
    2. توقف سرور Postgres و postgresql در ماشین 9:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. توقف سرور Qpid در ماشین های 12 و 13:
       > /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 در ماشین های 8:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. پایگاه داده Postgres را در ماشین 8 به روز کنید (فقط Postgres master):
       > /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 start
    9. سرور سرور Qpid را در ماشین های 12 و 13 راه اندازی کنید:
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. با اجرای دستورات زیر در ماشین 9، 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. با صدور اسکریپت های زیر در هر دو سرور، وضعیت تکرار را تأیید کنید. برای اطمینان از تکرار موفقیت آمیز، سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد:
        در دستگاه 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 در دستگاه 8 و 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. با استفاده از روش بالا در Decommissioning a Postgres، گره آماده به کار جدید را از کار انداخته اید.

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

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

1. اگر SMTP را در Edge فعال کرده اید، SMTPMAILFROM را در فایل پیکربندی خود تنظیم کنید. این پارامتر به شکل زیر است:
   SMTPMAILFROM="شرکت من <myco@company.com>"
2. اطمینان حاصل کنید که یک گره آماده به کار Postgres جدید را همانطور که در بالا در نصب یک گره آماده به کار جدید Postgres توضیح داده شده نصب کرده اید.
3. Cassandra و ZooKeeper را به روز کنید:
   1. در صورت به روز رسانی از 4.16.01 ، Zookeeper را در macine 1، 2، و 3 در مرکز داده 1 کاهش دهید:
      > yum degrade apigee-zookeeper
   2. در ماشین های 1، 2 و 3 در مرکز داده 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
   3. در صورت به روز رسانی از 4.16.01 ، Zookeeper را در macine 7، 8 و 9 در مرکز داده 2 کاهش دهید:
      > yum degrade apigee-zookeeper
   4. در ماشین های 7، 8، و 9 در مرکز داده 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. به روز رسانی qpidd:
   1. Machines 4, 5 در مرکز داده 1
      1. قانون iptables زیر را در ماشین 4 تنظیم کنید:
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -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. Machines 10, 11 in Data Center 2
      1. قانون iptables زیر را روی ماشین 10 تنظیم کنید:
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -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. ماشین‌های ۱ در مرکز داده ۱
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
   2. Machines 7 در Data Center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. به روز رسانی اجزای Edge:
   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 stop
   2. توقف سرور Postgres و postgresql در دستگاه 12:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   3. توقف سرور Qpid در ماشین های 4، 5، 10 و 11:
      > /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 در ماشین های 6:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   6. پایگاه داده Postgres را در ماشین 6 به روز کنید (فقط Postgres master):
      > /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 start
   9. سرور سرور Qpid را در ماشین های 4، 5، 10 و 11 راه اندازی کنید:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   10. با اجرای دستورات زیر در دستگاه 12، 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. با صدور اسکریپت های زیر در هر دو سرور، وضعیت تکرار را تأیید کنید. برای اطمینان از تکرار موفقیت آمیز، سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد:
       در دستگاه 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 را در دستگاه 6 و 12 به روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
10. با استفاده از روش بالا در Decommissioning a Postgres، گره آماده به کار جدید را از کار انداخته اید.

برای نصب API BaaS 7 هاست یا 10 هاست

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

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

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

Edge for Private Cloud نسخه 4.18.01

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

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

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

• می توانید 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.18.01 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.18.01 خط زیر را به فایل پیکربندی خود اضافه کنید:

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.6

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

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

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

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

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

برای انجام نصب، از همان فایل پیکربندی که برای نصب نسخه فعلی 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.18.01 در یک گره با اتصال اینترنت خارجی

برای به روز رسانی اجزای 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. اگر روی Oracle 7.x نصب می‌کنید ، دستور زیر را اجرا کنید:
   > sudo yum-config-manager -- ol7_optional_latest را فعال کنید
8. اگر روی 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
9. فایل Edge 4.18.01 bootstrap_4.18.01.sh را در /tmp/bootstrap_4.18.01.sh دانلود کنید:
   > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
10. ابزار و وابستگی های سرویس edge 4.18.01 apigee-service را نصب کنید:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser= uName apigeepassword= pWord
    
    که در آن uName:pWord نام کاربری و رمز عبوری است که از Apigee دریافت کرده اید. اگر pWord را حذف کنید، از شما خواسته می شود آن را وارد کنید.
    
    به طور پیش فرض، نصب کننده بررسی می کند که جاوا 1.8 را نصب کرده اید. اگر این کار را نکنید، آن را برای شما نصب می کند. از گزینه JAVA_FIX برای تعیین نحوه مدیریت نصب جاوا استفاده کنید. JAVA_FIX مقادیر زیر را می گیرد:
    
    I = نصب OpenJDK 1.8 (پیش‌فرض)
    C = بدون نصب جاوا ادامه دهید
    Q = ترک. برای این گزینه باید خود جاوا را نصب کنید.
11. از 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 نصب می‌کند.
12. بسته به نسخه فعلی 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 نیاز دارد. می توانید دو ویژگی دیگر را از فایل حذف کنید.
13. ابزار apigee-provision را به روز کنید:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision به روز رسانی
14. ابزار به روز رسانی را بر روی گره های خود به ترتیبی که در زیر در " ترتیب به روز رسانی ماشین " در زیر توضیح داده شده است اجرا کنید:
    > /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 در همان گره
15. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.
16. اگر یک گره آماده به کار Postgres جدید نصب کرده اید، گره را همانطور که در بالا در Decommissioning a Postgres توضیح داده شد، از کار خارج کنید.

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

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

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

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

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

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

1. اگر در حال حاضر از Replication Master-standby Postgres استفاده می کنید، یک گره آماده به کار Postgres جدید را همانطور که در بالا در نصب یک گره آماده به کار جدید Postgres توضیح داده شد نصب کنید.
2. یک مخزن محلی 4.18.01 همانطور که در "ایجاد یک مخزن محلی Apigee" در نصب ابزار Edge apigee-setup توضیح داده شده است، ایجاد کنید.
   توجه : اگر قبلاً مخزن 4.16.01 یا 4.16.05 موجود دارید، می‌توانید مخزن 4.18.01 را همانطور که در «به‌روزرسانی یک مخزن محلی Apigee» در نصب ابزار Edge apigee-setup توضیح داده شده است، به آن اضافه کنید.
3. برای نصب apigee-service از فایل tar :
   1. در گره دارای مخزن محلی، از دستور زیر برای بسته بندی مخزن محلی در یک فایل .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz استفاده کنید:
      > /opt/apigee/apigee-service/bin/apigee-service بسته apigee-mirror
   2. فایل tar را در گره ای که می خواهید Edge را به روز کنید کپی کنید. به عنوان مثال، آن را در پوشه /tmp در گره جدید کپی کنید.
   3. در گره جدید، فایل را در پوشه /tmp untar کنید:
      > tar -xzf apigee-4.18.01.tar.gz
      
      این دستور یک دایرکتوری جدید به نام repos در دایرکتوری حاوی فایل tar ایجاد می کند. به عنوان مثال /tmp/repos.
   4. ابزار و وابستگی های Edge apigee-service را از /tmp/repos نصب کنید:
      > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      توجه داشته باشید که مسیر دایرکتوری repos را در این دستور قرار داده اید.
4. برای نصب apigee-service با استفاده از وب سرور Nginx:
   1. وب سرور Nginx را همانطور که در «نصب از مخزن با استفاده از وب سرور Nginx» در نصب ابزار Edge apigee-setup توضیح داده شده پیکربندی کنید.
   2. در گره راه دور، فایل Edge bootstrap_4.18.01.sh را در /tmp/bootstrap_4.18.01.sh دانلود کنید:
      > /usr/bin/curl http:// uName: pWord @ remoteRepo :3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
      
      که در آن uName:pWord نام کاربری و رمز عبوری است که در بالا برای مخزن تنظیم کرده اید و remoteRepo آدرس IP یا نام DNS گره repo است.
   3. در گره راه دور، ابزار Edge apigee-service و وابستگی ها را نصب کنید:
      > sudo bash /tmp/bootstrap_4.18.01.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.18.01 Rollback Process توضیح داده شده است استفاده کنید.

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

ترتیب به روز رسانی دستگاه ها در نصب 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:
       > /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 را در دستگاه 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 INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -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 در دستگاه 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 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 در ماشین های 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 start
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    8. با اجرای دستورات زیر در ماشین 5، 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. با صدور اسکریپت های زیر در هر دو سرور، وضعیت تکرار را تأیید کنید. برای اطمینان از تکرار موفقیت آمیز، سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد:
       
       در دستگاه 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 در دستگاه 4، 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. با استفاده از روش بالا در Decommissioning a Postgres، گره آماده به کار جدید را از کار انداخته اید.

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

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

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 زیر را روی ماشین 6 تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -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 stop
    2. توقف سرور Postgres و postgresql در ماشین 9:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. توقف سرور Qpid در ماشین های 6 و 7:
       > /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 در ماشین های 8:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. پایگاه داده Postgres را در ماشین 8 به روز کنید (فقط Postgres master):
       > /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 start
    9. سرور سرور Qpid را در ماشین های 6 و 7 راه اندازی کنید:
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. با اجرای دستورات زیر در ماشین 9، 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. با صدور اسکریپت های زیر در هر دو سرور، وضعیت تکرار را تأیید کنید. برای اطمینان از تکرار موفقیت آمیز، سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد:
        در دستگاه 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 در دستگاه 8 و 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. با استفاده از روش بالا در Decommissioning a Postgres، گره آماده به کار جدید را از کار انداخته اید.

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

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

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 زیر را در دستگاه 12 تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -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 را در دستگاه 12، 13، 6، 7، 10 و 11 به ترتیب به روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
12. به‌روزرسانی رابط کاربری در دستگاه 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 stop
    2. توقف سرور Postgres و postgresql در ماشین 9:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. توقف سرور Qpid در ماشین های 12 و 13:
       > /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 در ماشین های 8:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. پایگاه داده Postgres را در ماشین 8 به روز کنید (فقط Postgres master):
       > /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 start
    9. سرور سرور Qpid را در ماشین های 12 و 13 راه اندازی کنید:
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. با اجرای دستورات زیر در ماشین 9، 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. با صدور اسکریپت های زیر در هر دو سرور، وضعیت تکرار را تأیید کنید. برای اطمینان از تکرار موفقیت آمیز، سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد:
        در دستگاه 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 در دستگاه 8 و 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. با استفاده از روش بالا در Decommissioning a Postgres، گره آماده به کار جدید را از کار انداخته اید.

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

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

1. اگر SMTP را در Edge فعال کرده اید، SMTPMAILFROM را در فایل پیکربندی خود تنظیم کنید. این پارامتر به شکل زیر است:
   SMTPMAILFROM="شرکت من <myco@company.com>"
2. اطمینان حاصل کنید که یک گره آماده به کار Postgres جدید را همانطور که در بالا در نصب یک گره آماده به کار جدید Postgres توضیح داده شده نصب کرده اید.
3. Cassandra و ZooKeeper را به روز کنید:
   1. در صورت به روز رسانی از 4.16.01 ، Zookeeper را در macine 1، 2، و 3 در مرکز داده 1 کاهش دهید:
      > yum degrade apigee-zookeeper
   2. در ماشین های 1، 2 و 3 در مرکز داده 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
   3. در صورت به روز رسانی از 4.16.01 ، Zookeeper را در macine 7، 8 و 9 در مرکز داده 2 کاهش دهید:
      > yum degrade apigee-zookeeper
   4. در ماشین های 7، 8، و 9 در مرکز داده 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. به روز رسانی qpidd:
   1. Machines 4, 5 در مرکز داده 1
      1. قانون iptables زیر را در ماشین 4 تنظیم کنید:
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -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. Machines 10, 11 in Data Center 2
      1. قانون iptables زیر را روی ماشین 10 تنظیم کنید:
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -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. ماشین‌های ۱ در مرکز داده ۱
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
   2. Machines 7 در Data Center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. به روز رسانی اجزای Edge:
   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 stop
   2. توقف سرور Postgres و postgresql در دستگاه 12:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   3. توقف سرور Qpid در ماشین های 4، 5، 10 و 11:
      > /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 در ماشین های 6:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   6. پایگاه داده Postgres را در ماشین 6 به روز کنید (فقط Postgres master):
      > /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 start
   9. سرور سرور Qpid را در ماشین های 4، 5، 10 و 11 راه اندازی کنید:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   10. با اجرای دستورات زیر در دستگاه 12، 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. با صدور اسکریپت های زیر در هر دو سرور، وضعیت تکرار را تأیید کنید. برای اطمینان از تکرار موفقیت آمیز، سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد:
       در دستگاه 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 را در دستگاه 6 و 12 به روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
10. با استفاده از روش بالا در Decommissioning a Postgres، گره آماده به کار جدید را از کار انداخته اید.

برای نصب API BaaS 7 هاست یا 10 هاست

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

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

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

Edge for Private Cloud نسخه 4.18.01

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

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

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

• می توانید 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.18.01 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.18.01 خط زیر را به فایل پیکربندی خود اضافه کنید:

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.6

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

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

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

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

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

برای انجام نصب، از همان فایل پیکربندی که برای نصب نسخه فعلی 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.18.01 در یک گره با اتصال اینترنت خارجی

برای به روز رسانی اجزای 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. اگر روی Oracle 7.x نصب می‌کنید ، دستور زیر را اجرا کنید:
   > sudo yum-config-manager -- ol7_optional_latest را فعال کنید
8. اگر روی 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
9. فایل Edge 4.18.01 bootstrap_4.18.01.sh را در /tmp/bootstrap_4.18.01.sh دانلود کنید:
   > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
10. ابزار و وابستگی های سرویس edge 4.18.01 apigee-service را نصب کنید:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser= uName apigeepassword= pWord
    
    که در آن uName:pWord نام کاربری و رمز عبوری است که از Apigee دریافت کرده اید. اگر pWord را حذف کنید، از شما خواسته می شود آن را وارد کنید.
    
    به طور پیش فرض، نصب کننده بررسی می کند که جاوا 1.8 را نصب کرده اید. اگر این کار را نکنید، آن را برای شما نصب می کند. از گزینه JAVA_FIX برای تعیین نحوه مدیریت نصب جاوا استفاده کنید. JAVA_FIX مقادیر زیر را می گیرد:
    
    I = نصب OpenJDK 1.8 (پیش‌فرض)
    C = بدون نصب جاوا ادامه دهید
    Q = ترک. برای این گزینه باید خود جاوا را نصب کنید.
11. از 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 نصب می‌کند.
12. بسته به نسخه فعلی 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 نیاز دارد. می توانید دو ویژگی دیگر را از فایل حذف کنید.
13. ابزار apigee-provision را به روز کنید:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision به روز رسانی
14. ابزار به روز رسانی را بر روی گره های خود به ترتیبی که در زیر در " ترتیب به روز رسانی ماشین " در زیر توضیح داده شده است اجرا کنید:
    > /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 در همان گره
15. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.
16. اگر یک گره آماده به کار Postgres جدید نصب کرده اید، گره را همانطور که در بالا در Decommissioning a Postgres توضیح داده شد، از کار خارج کنید.

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

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

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

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

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

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

1. اگر در حال حاضر از Replication Master-standby Postgres استفاده می کنید، یک گره آماده به کار Postgres جدید را همانطور که در بالا در نصب یک گره آماده به کار جدید Postgres توضیح داده شد نصب کنید.
2. یک مخزن محلی 4.18.01 همانطور که در "ایجاد یک مخزن محلی Apigee" در نصب ابزار Edge apigee-setup توضیح داده شده است، ایجاد کنید.
   توجه : اگر قبلاً مخزن 4.16.01 یا 4.16.05 موجود دارید، می‌توانید مخزن 4.18.01 را همانطور که در «به‌روزرسانی یک مخزن محلی Apigee» در نصب ابزار Edge apigee-setup توضیح داده شده است، به آن اضافه کنید.
3. برای نصب apigee-service از فایل tar :
   1. در گره دارای مخزن محلی، از دستور زیر برای بسته بندی مخزن محلی در یک فایل .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz استفاده کنید:
      > /opt/apigee/apigee-service/bin/apigee-service بسته apigee-mirror
   2. فایل tar را در گره ای که می خواهید Edge را به روز کنید کپی کنید. به عنوان مثال، آن را در پوشه /tmp در گره جدید کپی کنید.
   3. در گره جدید، فایل را در پوشه /tmp untar کنید:
      > tar -xzf apigee-4.18.01.tar.gz
      
      این دستور یک دایرکتوری جدید به نام repos در دایرکتوری حاوی فایل tar ایجاد می کند. به عنوان مثال /tmp/repos.
   4. ابزار و وابستگی های Edge apigee-service را از /tmp/repos نصب کنید:
      > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      توجه داشته باشید که مسیر دایرکتوری repos را در این دستور قرار داده اید.
4. برای نصب apigee-service با استفاده از وب سرور Nginx:
   1. وب سرور Nginx را همانطور که در «نصب از مخزن با استفاده از وب سرور Nginx» در نصب ابزار Edge apigee-setup توضیح داده شده پیکربندی کنید.
   2. در گره راه دور، فایل Edge bootstrap_4.18.01.sh را در /tmp/bootstrap_4.18.01.sh دانلود کنید:
      > /usr/bin/curl http:// uName: pWord @ remoteRepo :3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
      
      که در آن uName:pWord نام کاربری و رمز عبوری است که در بالا برای مخزن تنظیم کرده اید و remoteRepo آدرس IP یا نام DNS گره repo است.
   3. در گره راه دور، ابزار Edge apigee-service و وابستگی ها را نصب کنید:
      > sudo bash /tmp/bootstrap_4.18.01.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.18.01 Rollback Process توضیح داده شده است استفاده کنید.

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

ترتیب به روز رسانی دستگاه ها در نصب 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:
       > /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 را در دستگاه 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 INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -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 در دستگاه 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 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 در ماشین های 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 start
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    8. با اجرای دستورات زیر در ماشین 5، 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. با صدور اسکریپت های زیر در هر دو سرور، وضعیت تکرار را تأیید کنید. برای اطمینان از تکرار موفقیت آمیز، سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد:
       
       در دستگاه 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 در دستگاه 4، 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. با استفاده از روش بالا در Decommissioning a Postgres، گره آماده به کار جدید را از کار انداخته اید.

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

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

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 زیر را روی ماشین 6 تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -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 stop
    2. توقف سرور Postgres و postgresql در ماشین 9:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. توقف سرور Qpid در ماشین های 6 و 7:
       > /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 در ماشین های 8:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. پایگاه داده Postgres را در ماشین 8 به روز کنید (فقط Postgres master):
       > /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 start
    9. سرور سرور Qpid را در ماشین های 6 و 7 راه اندازی کنید:
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. با اجرای دستورات زیر در ماشین 9، 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. با صدور اسکریپت های زیر در هر دو سرور، وضعیت تکرار را تأیید کنید. برای اطمینان از تکرار موفقیت آمیز، سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد:
        در دستگاه 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 در دستگاه 8 و 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. با استفاده از روش بالا در Decommissioning a Postgres، گره آماده به کار جدید را از کار انداخته اید.

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

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

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 زیر را در دستگاه 12 تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -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 را در دستگاه 12، 13، 6، 7، 10 و 11 به ترتیب به روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
12. به‌روزرسانی رابط کاربری در دستگاه 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 stop
    2. توقف سرور Postgres و postgresql در ماشین 9:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. توقف سرور Qpid در ماشین های 12 و 13:
       > /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 در ماشین های 8:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. پایگاه داده Postgres را در ماشین 8 به روز کنید (فقط Postgres master):
       > /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 start
    9. سرور سرور Qpid را در ماشین های 12 و 13 راه اندازی کنید:
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. با اجرای دستورات زیر در ماشین 9، 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. با صدور اسکریپت های زیر در هر دو سرور، وضعیت تکرار را تأیید کنید. برای اطمینان از تکرار موفقیت آمیز، سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد:
        در دستگاه 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 در دستگاه 8 و 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. با استفاده از روش بالا در Decommissioning a Postgres، گره آماده به کار جدید را از کار انداخته اید.

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

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

1. اگر SMTP را در Edge فعال کرده اید، SMTPMAILFROM را در فایل پیکربندی خود تنظیم کنید. این پارامتر به شکل زیر است:
   SMTPMAILFROM="شرکت من <myco@company.com>"
2. اطمینان حاصل کنید که یک گره آماده به کار Postgres جدید را همانطور که در بالا در نصب یک گره آماده به کار جدید Postgres توضیح داده شده نصب کرده اید.
3. Cassandra و ZooKeeper را به روز کنید:
   1. در صورت به روز رسانی از 4.16.01 ، Zookeeper را در macine 1، 2، و 3 در مرکز داده 1 کاهش دهید:
      > yum degrade apigee-zookeeper
   2. در ماشین های 1، 2 و 3 در مرکز داده 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
   3. در صورت به روز رسانی از 4.16.01 ، Zookeeper را در macine 7، 8 و 9 در مرکز داده 2 کاهش دهید:
      > yum degrade apigee-zookeeper
   4. در ماشین های 7، 8، و 9 در مرکز داده 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. به روز رسانی qpidd:
   1. Machines 4, 5 در مرکز داده 1
      1. قانون iptables زیر را در ماشین 4 تنظیم کنید:
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -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. Machines 10, 11 in Data Center 2
      1. قانون iptables زیر را روی ماشین 10 تنظیم کنید:
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -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. ماشین‌های ۱ در مرکز داده ۱
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
   2. Machines 7 در Data Center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. به روز رسانی اجزای Edge:
   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 stop
   2. توقف سرور Postgres و postgresql در دستگاه 12:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   3. توقف سرور Qpid در ماشین های 4، 5، 10 و 11:
      > /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 در ماشین های 6:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   6. پایگاه داده Postgres را در ماشین 6 به روز کنید (فقط Postgres master):
      > /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 start
   9. سرور سرور Qpid را در ماشین های 4، 5، 10 و 11 راه اندازی کنید:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   10. با اجرای دستورات زیر در دستگاه 12، 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. با صدور اسکریپت های زیر در هر دو سرور، وضعیت تکرار را تأیید کنید. برای اطمینان از تکرار موفقیت آمیز، سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد:
       در دستگاه 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 را در دستگاه 6 و 12 به روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
10. با استفاده از روش بالا در Decommissioning a Postgres، گره آماده به کار جدید را از کار انداخته اید.

برای نصب API BaaS 7 هاست یا 10 هاست

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

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

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