به‌روزرسانی Apigee Edge 4.16.01/4.16.05 به 4.17.09

Edge for Private Cloud v. 4.17.09

کدام نسخه‌های Edge را می‌توانید به ۴.۱۷.۰۹ به‌روزرسانی کنید

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

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

• می‌توانید Apigee Edge نسخه ۴.۱۵.۰۷ را به ۴.۱۶.۰۱ انتقال دهید.
• اگر نسخه Edge شما قدیمی‌تر از نسخه 4.15.07 است، ابتدا باید به نسخه 4.15.07 و سپس به نسخه 4.16.01 نقل مکان کنید.
  • اگر از Edge نسخه ۴.۱۴.۰۴ یا بالاتر درحال انتقال هستید: مستقیماً به نسخه ۴.۱۵.۰۷ انتقال دهید.
  • اگر از Edge نسخه ۴.۱۴.۰۱ درحال انتقال هستید: ابتدا باید به نسخه ۴.۱۴.۰۴ منتقل شوید و سپس به نسخه ۴.۱۵.۰۷ منتقل شوید.

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

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

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

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

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

اگر از نسخه ۴.۱۶.۰۱ به‌روزرسانی می‌کنید، Zookeeper را تنزل دهید

نسخه Zookeeper RPM در Edge برای «ابر خصوصی» 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 به نسخه‌های بعدی ارتقا دهد. روش اصلاح این وضعیت این است که قبل‌از به‌روزرسانی Zookeeper، دستور yum downgrade apigee-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 status

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

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

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

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

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

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

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

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

ارتقا به Java JDK نسخه ۸ الزامی است

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

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

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

برای نصب یا به‌روزرسانی Edge، باید بسته‌های اضافی برای Enterprise Linux (یا 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 استفاده می‌شود اضافه کرده است. اگر از نسخه ۴.۱۷.۰۱ به‌روزرسانی می‌کنید، باید SMTPMAILFROM را در فایل پیکربندی هنگام فعال کردن سرور SMTP تنظیم کنید.

نسخه ۴.۱۷.۰۹ از API BaaS همچنین از دارایی SMTPMAILFROM پشتیبانی می‌کند. هنگام به‌روزرسانی API BaaS، باید SMTPMAILFROM را در فایل پیکربندی تنظیم کنید.

این پارامتر به‌صورت زیر است:

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

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

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

برای اطلاعات بیشتر، پیکربندی اصالت‌سنجی خارجی را ببینید.

وقتی اصالت‌سنجی خارجی فعال باشد، اکثر مشتریان از فیلد نام حساب SAM در «دایرکتوری فعال» به‌عنوان نام کاربری برای اصالت‌سنجی استفاده می‌کنند، نه از نشانی ایمیلی که سرور Edge OpenLDAP استفاده می‌کند.

اگر با سرویس دایرکتوری خارجی یکپارچه‌سازی کرده‌اید، هنگام به‌روزرسانی Edge به نسخه ۴.۱۷.۰۹، خط زیر را به فایل پیکربندی خود اضافه کنید:

IS_EXTERNAL_AUTH="true"

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

ارتقا به Qpid 1.35 الزامی است

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

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

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

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

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

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

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

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

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

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

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

1. در Postgres master کنونی، فایل /opt/apigee/customer/application/postgresql.properties را ویرایش کنید تا نشان زیر را تنظیم کنید. اگر این فایل وجود ندارد، آن را ایجاد کنید:
   
   conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust
   
   که در آن existing_slave_ip نشانی IP سرور آماده‌به‌کار Postgres کنونی است و new_slave_ip نشانی IP گره آماده‌به‌کار جدید است.
2. apigee-postgresql را در Postgres master بازراه‌اندازی کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
3. با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf در سرور اصلی، تأیید کنید که گره آماده به‌کار جدید اضافه شده است. باید خطوط زیر را در آن فایل ببینید:
   host replication apigee existing_slave_ip/32 trust
   host replication apigee new_slave_ip/32 trust
4. نصب سرور آماده‌به‌کار جدید Postgres:
   1. فایل پیکربندی را که برای نصب نسخه فعلی Edge استفاده کرده‌اید ویرایش کنید تا موارد زیر را مشخص کنید:
      
      # نشانی IP اصلی فعلی:
      PG_MASTER=192.168.56.103
      # نشانی IP گره آماده به‌کار جدید
      PG_STANDBY=192.168.56.102
   2. ‫SELinux را طبق آنچه در نصب ابزار apigee-setup در Edge توضیح داده شده است غیرفعال کنید.
   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
      
      توجه: اگر از نسخه ۴.۱۶.۰۱ به‌روزرسانی می‌کنید، فایل 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 status
   
   اگر Postgres درحال اجرا نیست، آن را شروع کنید:
   > /opt/apigee/apigee-service/bin/apigee-all start
2. با اجرای دستور cURL زیر در گره آماده به‌کار جدید، شناسه یکتای جهانی گره آماده به‌کار جدید را دریافت کنید:
   > curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self
   
   باید شناسه یکتای جهانی گره را در انتهای برونداد به‌شکل زیر ببینید:
   "type" : [ "postgres-server" ],
   "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
3. با اجرای فرمان زیر در گره آماده‌به‌کار جدید، گره آماده‌به‌کار جدید را متوقف کنید:
   > /opt/apigee/apigee-service/bin/apigee-all stop
4. در گره اصلی Postgres، فایل /opt/apigee/customer/application/postgresql.properties را ویرایش کنید تا گره آماده‌به‌کار جدید را از conf_pg_hba_replication.connection بردارید:
   conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
5. بازراه‌اندازی apigee-postgresql در Postgres master:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
6. با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf در اصلی، تأیید کنید که گره آماده به‌کار جدید برداشته شده است. فقط باید خط زیر را در آن فایل ببینید:
   host replication apigee existing_slave_ip/32 trust
7. با انجام دادن فراخوانی «میانای برنامه‌سازی کاربردی» مدیریت Edge زیر در گره «سرور مدیریت»، شناسه UUID گره آماده به‌کار را از ZooKeeper حذف کنید:
   > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

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

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

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

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

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

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

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

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

باید فایل پیکربندی بی‌صدایی را به فرمان به‌روزرسانی ارسال کنید. فایل پیکربندی بی‌صدا باید همان فایلی باشد که برای نصب Edge نسخه ۴.۱۶.۰۱ یا ۴.۱۶.۰۵ استفاده کرده‌اید.

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

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

1. اگر درحال‌حاضر از تکثیر آماده‌به‌کار اصلی Postgres استفاده می‌کنید، گره آماده‌به‌کار Postgres جدیدی را همان‌طور که در بالا در نصب گره آماده‌به‌کار Postgres جدید توضیح داده شده است نصب کنید.
2. درصورت وجود، همه کارهای CRON را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده‌اند تا پس‌از تکمیل به‌روزرسانی غیرفعال کنید.
3. برای نصب کردن Edge RPM، به‌عنوان ریشه به سیستم گره‌تان وارد شوید.
   توجه: اگرچه نصب RPM به دسترسی ریشه نیاز دارد، می‌توانید پیکربندی Edge را بدون دسترسی ریشه انجام دهید.
4. yum-utils و yum-plugin-priorities را نصب کنید:
   > sudo yum install yum-utils
   > sudo yum install yum-plugin-priorities
5. ‫SELinux را طبق روشی که در نصب ابزار apigee-setup در Edge توضیح داده شده است غیرفعال کنید.
6. مخزن EPEL را همان‌طور که در بالا توضیح داده شده است فعال کنید.
7. اگر در AWS نصب می‌کنید، فرمان yum-configure-manager زیر را اجرا کنید:
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
8. فایل Edge 4.17.09 bootstrap_4.17.09.sh را در /tmp/bootstrap_4.17.09.sh بارگیری کنید:
   > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
9. برنامه کمکی Edge 4.17.09 apigee-service و وابستگی‌ها را نصب کنید:
   > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
   
   که در آن uName:pWord نام کاربری و گذرواژه‌ای است که از Apigee دریافت کرده‌اید. اگر pWord را حذف کنید، از شما خواسته می‌شود آن را وارد کنید.
   
   به‌طور پیش‌فرض، نصب‌کننده بررسی می‌کند که Java 1.8 نصب شده باشد. اگر نصب نداشته باشید، آن را برایتان نصب می‌کند. از گزینه JAVA_FIX برای مشخص کردن نحوه مدیریت نصب Java استفاده کنید. JAVA_FIX مقادیر زیر را می‌پذیرد:
   
   I = نصب OpenJDK 1.8 (پیش‌فرض)
   C = ادامه بدون نصب Java
   Q = خروج. برای این گزینه، باید خودتان Java را نصب کنید.
10. از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید:
    1. اگر نسخه ۴.۱۶.۰۱ را با ارتقا دادن نسخه ۴.۱۵.۰۷.۰x نصب کرده‌اید، باید ابزار 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 update
    2. اگر نسخه ۴.۱۶.۰۱ را مستقیماً نصب کرده‌اید، یعنی از نسخه ۴.۱۵.۰۷.۰x ارتقا نداده‌اید، باید ابزار apigee-setup را به‌روز کنید:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
       
       این به‌روزرسانی apigee-service ابزار update.sh را در /opt/apigee/apigee-setup/bin نصب می‌کند.
    3. اگر نسخه ۴.۱۶.۰۵ را مستقیماً یا ازطریق به‌روزرسانی نصب کرده‌اید، باید برنامه کمکی apigee-setup را به‌روزرسانی کنید:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
       
       این به‌روزرسانی apigee-service برنامه کمکی update.sh را در /opt/apigee/apigee-setup/bin نصب می‌کند.
11. بسته به نسخه فعلی Edge، باید ابزار apigee-validate را در «سرور مدیریت» نصب یا به‌روزرسانی کنید.
    1. اگر درحال‌حاضر از Edge 4.16.05 استفاده می‌کنید: ابزار apigee-validate را در «سرور مدیریت» به‌روز کنید:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. اگر درحال‌حاضر از Edge 4.16.01 استفاده می‌کنید: ابزار apigee-validate را در «سرور مدیریت» نصب کنید:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
       
       توجه: اگر ابزار apigee-validate را در گره «پردازشگر پیام» هنگام نصب 4.16.01 نصب کرده‌اید، می‌توانید آن را بااستفاده از دستور زیر در آن گره به‌روز کنید:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
       
       بااین‌حال، از نسخه 4.16.05 و نسخه‌های جدیدتر، Apigee توصیه می‌کند ابزار apigee-validate را در «سرور مدیریت» نصب و اجرا کنید.
    3. اگر از نسخه ۴.۱۶.۰۱ درحال ارتقا هستید: فایل پیکربندی ارسال‌شده به ابزار apigee-validate را ویرایش کنید. در نسخه 4.16.01 Edge، فایل پیکربندی مورداستفاده apigee-validate به ویژگی‌های زیر نیاز داشت:
       APIGEE_ADMINPW=sysAdminPword
       MP_POD=gateway
       REGION=dc-1
       
       در این نسخه پخش، فایل پیکربندی فقط به ویژگی APIGEE_ADMINPW نیاز دارد. می‌توانید دو دارایی دیگر را از فایل بردارید.
12. ابزار apigee-provision را به‌روز کنید:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
13. برنامه کمکی به‌روزرسانی را در گره‌هایتان به ترتیبی که در بخش «ترتیب به‌روزرسانی ماشین» در زیر توضیح داده شده است اجرا کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
    
    تنها الزام در فایل پیکربندی این است که کاربر «apigee» باید بتواند به فایل پیکربندی دسترسی داشته باشد یا آن را بخواند.
    
    از گزینه «-c» برای مشخص کردن مؤلفه موردنظر برای به‌روزرسانی استفاده کنید. فهرست مؤلفه‌های امکان‌پذیر شامل موارد زیر است:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =همه مؤلفه‌های Edge به‌جز Edge UI: سرور مدیریت، پردازشگر پیام، مسیریاب، سرور QPID، سرور Postgres
    ui = Edge UI
    all = همه مؤلفه‌ها را در دستگاه به‌روزرسانی کنید (فقط برای نمایه نصب Edge aio یا نمایه نصب API BaaS asa استفاده کنید)
    e = ElasticSearch
    b = پشته API BaaS
    p = درگاه API BaaS
    ebp = پشته ElasticSearch،‏ API BaaS، و درگاه API BaaS در گره یکسان
14. با اجرای ابزار apigee-validate در «سرور مدیریت»، همان‌طور که در آزمایش نصب توضیح داده شده است، به‌روزرسانی را آزمایش کنید.
15. اگر گره آماده‌به‌کار جدید Postgres نصب کرده‌اید، گره را همان‌طور که در بالا در ازکار انداختن گره Postgres توضیح داده شده است ازکار بیندازید.

برای برگرداندن به‌روزرسانی در آینده، از روشی که در ۴.۱۷.۰۹ فرایند برگرداندن توضیح داده شده است استفاده کنید.

رویه به‌روزرسانی به نسخه ۴.۱۷.۰۹ از مخزن محلی repo

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

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

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

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

1. اگر درحال‌حاضر از تکثیر آماده‌به‌کار اصلی Postgres استفاده می‌کنید، گره آماده‌به‌کار Postgres جدیدی را همان‌طور که در بالا در نصب گره آماده‌به‌کار Postgres جدید توضیح داده شده است نصب کنید.
2. مخزن محلی 4.17.09 را همان‌طور که در «ایجاد مخزن محلی Apigee» در نصب ابزار Edge apigee-setupتوضیح داده شده است ایجاد کنید.
   توجه: اگر ازقبل مخزن 4.16.01 یا 4.16.05 را دارید، می‌توانید مخزن 4.17.09 را به آن اضافه کنید، همان‌طور که در «به‌روزرسانی مخزن محلی Apigee» در نصب ابزار Edge apigee-setup توضیح داده شده است.
3. برای نصب apigee-service از فایل ‎ .tar:
   1. در گره دارای مخزن محلی، از فرمان زیر برای بسته‌بندی مخزن محلی در یک فایل .tar به‌نام /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz استفاده کنید:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
   2. فایل tar .را در گرهی که می‌خواهید Edge را به‌روز کنید کپی کنید. برای مثال، آن را در دایرکتوری /tmp در گره جدید کپی کنید.
   3. در گره جدید، فایل را در دایرکتوری /tmp از حالت فشرده خارج کنید:
      > tar -xzf apigee-4.17.09.tar.gz
      
      این فرمان دایرکتوری جدیدی به نام repos در دایرکتوری حاوی فایل .tar ایجاد می‌کند. برای مثال /tmp/repos.
   4. برنامه کمکی Edge apigee-service و وابستگی‌ها را از /tmp/repos نصب کنید:
      > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      توجه داشته باشید که مسیر دایرکتوری repos را در این فرمان اضافه می‌کنید.
4. برای نصب apigee-service بااستفاده از سرور وب Nginx:
   1. سرور وب Nginx را همان‌طور که در «نصب از مخزن بااستفاده از سرور وب Nginx» در نصب ابزار کمکی apigee-setup در Edge توضیح داده شده است پیکربندی کنید.
   2. در گره راه دور، فایل Edge bootstrap_4.17.09.sh را در /tmp/bootstrap_4.17.09.sh بارگیری کنید:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
      
      که در آن uName:pWord نام کاربری و گذرواژه‌ای است که در بالا برای مخزن تنظیم کرده‌اید، و remoteRepo نشانی IP یا نام DNS گره مخزن است.
   3. در گره دور، ابزار کمکی Edge apigee-service و وابستگی‌ها را نصب کنید:
      > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
      
      که در آن uName:pWord نام کاربری و گذرواژه مخزن است.
5. از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید:
   1. اگر نسخه ۴.۱۶.۰۱ را با ارتقا دادن نسخه ۴.۱۵.۰۷.۰x نصب کرده‌اید، باید ابزار 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 update
   2. اگر نسخه ۴.۱۶.۰۱ را مستقیماً نصب کرده‌اید، یعنی از نسخه ۴.۱۵.۰۷.۰x ارتقا نداده‌اید، باید ابزار apigee-setup را به‌روزرسانی کنید:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      
      این به‌روزرسانی apigee-service ابزار update.sh را در /opt/apigee/apigee-setup/bin نصب می‌کند.
   3. اگر نسخه ۴.۱۶.۰۵ را مستقیماً یا ازطریق به‌روزرسانی نصب کرده‌اید، باید ابزار apigee-setup را به‌روزرسانی کنید:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      
      این به‌روزرسانی 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 update
   2. اگر درحال‌حاضر از Edge 4.16.01 استفاده می‌کنید: ابزار apigee-validate را در «سرور مدیریت» نصب کنید:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
      
      توجه: اگر ابزار apigee-validate را در گره «پردازشگر پیام» هنگام نصب 4.16.01 نصب کرده‌اید، می‌توانید آن را بااستفاده از دستور زیر در آن گره به‌روز کنید:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      
      بااین‌حال، از نسخه 4.16.05 و نسخه‌های جدیدتر، Apigee توصیه می‌کند ابزار apigee-validate را در «سرور مدیریت» نصب و اجرا کنید.
   3. اگر از نسخه ۴.۱۶.۰۱ درحال ارتقا هستید: فایل پیکربندی ارسال‌شده به ابزار apigee-validate را ویرایش کنید. در نسخه 4.16.01 Edge، فایل پیکربندی مورداستفاده apigee-validate به ویژگی‌های زیر نیاز داشت:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1
      
      در این نسخه پخش، فایل پیکربندی فقط به ویژگی APIGEE_ADMINPW نیاز دارد. می‌توانید دو دارایی دیگر را از فایل بردارید.
7. ابزار apigee-provision را به‌روز کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
8. برنامه کمکی به‌روزرسانی را در گره‌هایتان به ترتیبی که در بخش «ترتیب به‌روزرسانی ماشین» در زیر توضیح داده شده است اجرا کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
   
   تنها الزام در فایل پیکربندی این است که کاربر «apigee» باید بتواند به فایل پیکربندی دسترسی داشته باشد یا آن را بخواند.
   
   از گزینه «-c» برای مشخص کردن مؤلفه موردنظر برای به‌روزرسانی استفاده کنید. فهرست مؤلفه‌های امکان‌پذیر شامل موارد زیر است:
   ldap = OpenLDAP
   cs = Cassandra
   zk = Zookeeper
   qpid = qpidd
   ps = postgresql
   edge =همه مؤلفه‌های Edge به‌جز Edge UI: سرور مدیریت، پردازشگر پیام، مسیریاب، سرور QPID، سرور Postgres
   ui = Edge UI
   all = همه مؤلفه‌ها را در دستگاه به‌روزرسانی کنید (فقط برای نمایه نصب Edge aio یا نمایه نصب API BaaS asa استفاده کنید)
   e = ElasticSearch
   b = پشته API BaaS
   p = درگاه API BaaS
   ebp = پشته ElasticSearch،‏ API BaaS، و درگاه API BaaS در گره یکسان
9. با اجرای ابزار apigee-validate در «سرور مدیریت»، همان‌طور که در آزمایش نصب توضیح داده شده است، به‌روزرسانی را آزمایش کنید.
10. اگر گره آماده‌به‌کار جدید Postgres نصب کرده‌اید، گره را همان‌طور که در بالا در ازکار انداختن گره Postgres توضیح داده شده است ازکار بیندازید.

برای برگرداندن به‌روزرسانی در آینده، از روشی که در ۴.۱۷.۰۹ فرایند برگرداندن توضیح داده شده است استفاده کنید.

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

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

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

برای نصب خوداتکای ۱ میزبان

1. اگر SMTP را در Edge فعال کرده‌اید، SMTPMAILFROM را در فایل پیکربندی تنظیم کنید. این پارامتر دارای قالب زیر است:
   SMTPMAILFROM="My Company <myco@company.com>"
2. اگر از نسخه 4.16.01 به‌روزرسانی می‌کنید، نسخه Zookeeper را تنزل دهید:
   > yum downgrade 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 `hostname` -i eth0 -j DROP
5. صف پیام Qpid را بررسی کنید:
   > qpid-stat -q
   
   بررسی صف را تا زمانی‌که تعداد در ستون «msg» به ۰ برسد ادامه دهید. تا زمانی که 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:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

برای نصب خوداتکای ۲ میزبان

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

1. اگر SMTP را در Edge فعال کرده‌اید، SMTPMAILFROM را در فایل پیکربندی تنظیم کنید. این پارامتر دارای قالب زیر است:
   SMTPMAILFROM="My Company <myco@company.com>"
2. اگر از نسخه ۴.۱۶.۰۱ به‌روزرسانی می‌کنید، نسخه Zookeeper را در ماشین ۱ تنزل دهید:
   > yum downgrade 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 `hostname` -i eth0 -j DROP
5. صف پیام Qpid را در ماشین ۲ بررسی کنید:
   > qpid-stat -q
   
   بررسی صف را تا زمانی‌که تعداد در ستون «msg» به ۰ برسد ادامه دهید. تا زمانی که 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. به‌روزرسانی عناصر Edge در ماشین ۱:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
10. به‌روزرسانی میانای کاربر در ماشین ۱:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
11. به‌روزرسانی postgresql در ماشین ۲:
    1. توقف سرور Postgres، سرور Qpid، و postgresql:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    2. به‌روزرسانی postgresql:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. پایگاه داده Postgres را به‌روز کنید:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. اجزای Edge را در ماشین ۲ و ماشین ۱ به‌روز کنید:
       > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
12. به‌روزرسانی اجزای Edge در ماشین ۲:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

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

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

1. اگر SMTP را در Edge فعال کرده‌اید، SMTPMAILFROM را در فایل پیکربندی تنظیم کنید. این پارامتر دارای قالب زیر است:
   SMTPMAILFROM="My Company <myco@company.com>"
2. مطمئن شوید که گره آماده‌به‌کار جدید Postgres را همان‌طور که در بالا در نصب گره آماده‌به‌کار جدید Postgres توضیح داده شده است نصب کرده‌اید.
3. اگر از نسخه 4.16.01 به‌روزرسانی می‌کنید، Zookeeper را در ماشین‌های ۱، ۲، و ۳ تنزل دهید:
   > yum downgrade apigee-zookeeper
4. به‌روزرسانی Cassandra و ZooKeeper در ماشین ۱، ۲، و ۳:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
5. قانون iptables زیر را در ماشین ۴ تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
6. صف پیام Qpid را در ماشین ۴ بررسی کنید:
   > qpid-stat -q
   
   بررسی صف را تا زمانی که تعداد در ستون «msg» به ۰ برسد ادامه دهید. تا زمانی که Qpid همه پیام‌ها را پردازش نکرده است نمی‌توانید آن را ارتقا دهید.
7. به‌روزرسانی qpidd در ماشین ۴:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
8. پاک کردن iptables در ماشین ۴:
   > sudo iptables -F
9. مراحل ۵ تا ۸ را در ماشین ۵ تکرار کنید.
10. به‌روزرسانی LDAP در ماشین ۱:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
11. به‌روزرسانی اجزای Edge در ماشین‌های ۱، ۲، ۳:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
12. به‌روزرسانی میانای کاربر در ماشین ۱:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
13. به‌روزرسانی ماشین‌های ۴ و ۵:
    1. توقف سرور Postgres و سرور Qpid در ماشین ۴:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    2. توقف سرور Postgres، سرور Qpid، و postgresql در ماشین ۵:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. سرور Postgres و postgresql را در گره آماده به‌کار جدیدی که برای برگرداندن اضافه کرده‌اید متوقف کنید:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. به‌روزرسانی postgresql در ماشین‌های ۴:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. پایگاه داده Postgres را در ماشین ۴ به‌روز کنید (فقط Postgres اصلی):
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. به‌روزرسانی postgresql در ماشین‌های ۵:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. سرور Postgres و سرور Qpid را در ماشین‌های ۴ و ۵ شروع کنید:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    8. با اجرای دستورات زیر در ماشین، Postgres را به‌عنوان گره آماده‌به‌کار پیکربندی کنید ۵:
       > cd /opt/apigee/data/apigee-postgresql/pgdata
       > rm -rf *
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    9. با اجرای دستورگان‌های زیر در هر دو سرور، وضعیت تکثیر را درستی‌سنجی کنید. برای اطمینان از موفقیت‌آمیز بودن تکثیر، سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد:
       
       در ماشین ۴، گره اصلی، این دستور را اجرا کنید:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
       
       تأیید کنید که می‌گوید گره اصلی است.
       
       در ماشین ۵، گره آماده به‌کار:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
       
       تأیید کنید که می‌گوید آماده به‌کار است.
14. به‌روزرسانی اجزای Edge در ماشین‌های ۴ و ۵:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. مطمئن شوید که گره آماده به‌کار جدید را بااستفاده از رویه بالا در ازکار انداختن گره Postgres ازکار می‌اندازید.

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

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

1. اگر SMTP را در Edge فعال کرده‌اید، SMTPMAILFROM را در فایل پیکربندی تنظیم کنید. این پارامتر دارای قالب زیر است:
   SMTPMAILFROM="My Company <myco@company.com>"
2. مطمئن شوید که گره آماده‌به‌کار جدید Postgres را همان‌طور که در بالا در نصب گره آماده‌به‌کار جدید Postgres توضیح داده شده است نصب کرده‌اید.
3. اگر از نسخه 4.16.01 به‌روزرسانی می‌کنید، Zookeeper را در ماشین‌های ۱، ۲، و ۳ تنزل دهید:
   > yum downgrade apigee-zookeeper
4. به‌روزرسانی Cassandra و ZooKeeper در ماشین‌های ۱، ۲، و ۳:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
5. قانون iptables زیر را در ماشین ۶ تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
6. صف پیام Qpid را در ماشین ۶ بررسی کنید:
   > qpid-stat -q
   
   بررسی صف را ادامه دهید تا زمانی که تعداد در ستون «msg» به ۰ برسد. تا زمانی که Qpid همه پیام‌ها را پردازش نکرده است نمی‌توانید آن را ارتقا دهید.
7. به‌روزرسانی qpidd در ماشین ۶:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
8. پاک کردن iptables در ماشین ۶:
   > sudo iptables -F
9. مراحل ۵ تا ۸ را در ماشین ۷ تکرار کنید.
10. به‌روزرسانی LDAP در ماشین ۱:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
11. اجزای Edge را در ماشین‌های ۶، ۷، ۱، ۴، و ۵ به این ترتیب به‌روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
12. به‌روزرسانی میانای کاربر در ماشین ۱:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
13. به‌روزرسانی ماشین‌های ۸ و ۹:
    1. توقف سرور Postgres در ماشین ۸:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. توقف سرور Postgres و postgresql در ماشین ۹:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. توقف سرور Qpid در ماشین‌های ۶ و ۷:
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. سرور Postgres و postgresql را در گره آماده به‌کار جدیدی که برای برگرداندن اضافه کرده‌اید متوقف کنید:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. به‌روزرسانی postgresql در ماشین‌های ۸:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. پایگاه داده Postgres را در ماشین ۸ به‌روز کنید (فقط Postgres اصلی):
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. به‌روزرسانی postgresql در ماشین‌های ۹:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. سرور Postgres را در ماشین‌های ۸ و ۹ شروع کنید:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. شروع سرور Qpid در ماشین‌های ۶ و ۷:
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. با اجرای دستورات زیر در ماشین، Postgres را به‌عنوان گره آماده‌به‌کار پیکربندی کنید ‫۹:
        > cd /opt/apigee/data/apigee-postgresql/pgdata
        > rm -rf *
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. با اجرای دستورگان‌های زیر در هر دو سرور، وضعیت تکثیر را درستی‌سنجی کنید. برای اطمینان از تکثیر موفقیت‌آمیز، سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد:
        در ماشین ۸، گره اصلی، این را اجرا کنید:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
        
        تأیید کنید که می‌گوید گره اصلی است.
        
        در ماشین ۹، گره آماده به‌کار:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
        
        تأیید کنید که می‌گوید آماده به‌کار است.
14. به‌روزرسانی اجزای Edge در ماشین ۸ و ۹:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. مطمئن شوید که گره آماده به‌کار جدید را بااستفاده از رویه بالا در ازکار انداختن گره Postgres ازکار می‌اندازید.

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

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

1. اگر SMTP را در Edge فعال کرده‌اید، SMTPMAILFROM را در فایل پیکربندی تنظیم کنید. این پارامتر دارای قالب زیر است:
   SMTPMAILFROM="My Company <myco@company.com>"
2. مطمئن شوید که گره آماده‌به‌کار جدید Postgres را همان‌طور که در بالا در نصب گره آماده‌به‌کار جدید Postgres توضیح داده شده است نصب کرده‌اید.
3. اگر از نسخه 4.16.01 به‌روزرسانی می‌کنید، Zookeeper را در ماشین‌های ۱، ۲، و ۳ تنزل دهید:
   > yum downgrade apigee-zookeeper
4. به‌روزرسانی Cassandra و ZooKeeper در ماشین‌های ۱، ۲، و ۳:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
5. قانون iptables زیر را در ماشین ۱۲ تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
6. صف پیام Qpid را در ماشین ۱۲ بررسی کنید:
   > qpid-stat -q
   
   بررسی صف را تا زمانی که تعداد در ستون «msg» به ۰ برسد ادامه دهید. تا زمانی که Qpid همه پیام‌ها را پردازش نکرده است نمی‌توانید آن را ارتقا دهید.
7. به‌روزرسانی qpidd در ماشین ۱۲:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
8. پاک کردن iptables در ماشین ۱۲:
   > sudo iptables -F
9. مراحل ۵ تا ۸ را در ماشین ۱۳ تکرار کنید.
10. به‌روزرسانی LDAP در ماشین‌های ۴ و ۵:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
11. به‌روزرسانی اجزای Edge در ماشین‌های ۱۲، ۱۳، ۶، ۷، ۱۰، و ۱۱ به این ترتیب:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
12. به‌روزرسانی واسط کاربر در ماشین‌های ۶ و ۷:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
13. به‌روزرسانی ماشین‌های ۸ و ۹:
    1. توقف سرور Postgres در ماشین ۸:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. توقف سرور Postgres و postgresql در ماشین ۹:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. توقف سرور Qpid در ماشین‌های ۱۲ و ۱۳:
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. سرور Postgres و postgresql را در گره آماده به‌کار جدیدی که برای برگرداندن اضافه کرده‌اید متوقف کنید:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. به‌روزرسانی postgresql در ماشین‌های ۸:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. پایگاه داده Postgres را در ماشین ۸ به‌روز کنید (فقط Postgres اصلی):
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. به‌روزرسانی postgresql در ماشین‌های ۹:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. سرور Postgres را در ماشین‌های ۸ و ۹ شروع کنید:
       > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. سرور Qpid را در ماشین‌های ۱۲ و ۱۳ شروع کنید:
       > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. با اجرای دستورات زیر در ماشین، Postgres را به‌عنوان گره آماده‌به‌کار پیکربندی کنید ‫۹:
        > cd /opt/apigee/data/apigee-postgresql/pgdata
        > rm -rf *
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. با اجرای دستورگان‌های زیر در هر دو سرور، وضعیت تکثیر را درستی‌سنجی کنید. برای اطمینان از تکثیر موفقیت‌آمیز، سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد:
        در ماشین ۸، گره اصلی، این را اجرا کنید:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
        
        تأیید کنید که می‌گوید گره اصلی است.
        
        در ماشین ۹، گره آماده به‌کار:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
        
        تأیید کنید که می‌گوید آماده به‌کار است.
14. به‌روزرسانی اجزای Edge در ماشین ۸ و ۹:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. مطمئن شوید که گره آماده به‌کار جدید را بااستفاده از رویه بالا در ازکار انداختن گره Postgres ازکار می‌اندازید.

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

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

1. اگر SMTP را در Edge فعال کرده‌اید، SMTPMAILFROM را در فایل پیکربندی تنظیم کنید. این پارامتر دارای قالب زیر است:
   SMTPMAILFROM="My Company <myco@company.com>"
2. مطمئن شوید که گره آماده‌به‌کار جدید Postgres را همان‌طور که در بالا در نصب گره آماده‌به‌کار جدید Postgres توضیح داده شده است نصب کرده‌اید.
3. به‌روزرسانی Cassandra و ZooKeeper:
   1. اگر از نسخه ۴.۱۶.۰۱ به‌روزرسانی می‌کنید، Zookeeper را در ماشین‌های ۱، ۲، و ۳ در «مرکز داده ۱» تنزل دهید:
      > yum downgrade apigee-zookeeper
   2. در ماشین‌های ۱، ۲، و ۳ در «مرکز داده ۱»:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
   3. اگر از نسخه ۴.۱۶.۰۱ به‌روزرسانی می‌کنید، Zookeeper را در ماشین‌های ۷، ۸، و ۹ در «مرکز داده ۲» تنزل دهید:
      > yum downgrade apigee-zookeeper
   4. در ماشین‌های ۷، ۸، و ۹ در «مرکز داده ۲»
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. به‌روزرسانی qpidd:
   1. ماشین‌های ۴ و ۵ در «مرکز داده ۱»
      1. قانون iptables زیر را در ماشین ۴ تنظیم کنید:
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. صف پیام Qpid را در ماشین ۴ بررسی کنید:
         > qpid-stat -q
         
         بررسی صف را تا زمانی که تعداد در ستون «msg» به ۰ برسد ادامه دهید. تا زمانی که Qpid همه پیام‌ها را پردازش نکرده است نمی‌توانید آن را ارتقا دهید.
      3. به‌روزرسانی qpidd در ماشین ۴:
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. پاک کردن iptables در ماشین ۴:
         > sudo iptables -F
      5. مراحل ۱ تا ۴ را در ماشین ۵ تکرار کنید.
   2. ماشین‌های ۱۰ و ۱۱ در «مرکز داده ۲»
      1. قانون iptables زیر را در ماشین ۱۰ تنظیم کنید:
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. صف پیام Qpid را در ماشین ۱۰ بررسی کنید:
         > qpid-stat -q
         
         بررسی صف را تا زمانی‌که تعداد در ستون «msg» به ۰ برسد ادامه دهید. تا زمانی که Qpid همه پیام‌ها را پردازش نکرده است نمی‌توانید آن را ارتقا دهید.
      3. به‌روزرسانی qpidd در ماشین ۱۰:
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. پاک کردن جدول‌های iptables در ماشین ۱۰:
         > sudo iptables -F
      5. مراحل ۱ تا ۴ را در ماشین ۱۱ تکرار کنید.
5. به‌روزرسانی «ال‌دپ»:
   1. ماشین‌های ۱ در «مرکز داده ۱»
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
   2. ماشین‌های ۷ در «مرکز داده ۲»
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. به‌روزرسانی عناصر Edge:
   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. به‌روزرسانی میانای کاربر:
   1. ماشین ۱ در «مرکز داده ۱»:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
   2. ماشین ۷ در «مرکز داده ۲»:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
8. به‌روزرسانی ماشین ۶ در «مرکز داده ۱» و ماشین ۱۲ در «مرکز داده ۲»:
   1. توقف سرور Postgres در ماشین ۶:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
   2. توقف سرور Postgres و postgresql در ماشین ۱۲:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   3. توقف سرور Qpid در ماشین‌های ۴، ۵، ۱۰، و ۱۱:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   4. سرور Postgres و postgresql را در گره آماده به‌کار جدیدی که برای برگرداندن اضافه کرده‌اید متوقف کنید:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   5. به‌روزرسانی postgresql در ماشین‌های ۶:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   6. پایگاه داده Postgres را در ماشین ۶ به‌روز کنید (فقط Postgres اصلی):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
   7. به‌روزرسانی postgresql در ماشین‌های ۱۲:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   8. سرور Postgres را در ماشین‌های ۶ و ۱۲ شروع کنید:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
   9. سرور Qpid را در ماشین‌های ۴، ۵، ۱۰، و ۱۱ شروع کنید:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   10. با اجرای دستورات زیر در ماشین، Postgres را به‌عنوان گره آماده به‌کار پیکربندی کنید ‫۱۲:
       > cd /opt/apigee/data/apigee-postgresql/pgdata
       > rm -rf *
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
   11. با اجرای دستورگان‌های زیر در هر دو سرور، وضعیت تکثیر را درستی‌سنجی کنید. سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد تا از تکثیر موفقیت‌آمیز اطمینان حاصل شود:
       در ماشین ۶، گره اصلی، این دستور را اجرا کنید:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
       
       تأیید کنید که می‌گوید گره اصلی است.
       
       در ماشین ۱۲، گره آماده به‌کار:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
       
       تأیید کنید که می‌گوید آماده به‌کار است.
9. به‌روزرسانی اجزای Edge در ماشین‌های ۶ و ۱۲:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
10. مطمئن شوید که گره آماده به‌کار جدید را بااستفاده از رویه بالا در ازکار انداختن گره Postgres ازکار می‌اندازید.

برای API با ۷ میزبان یا ۱۰ میزبان نصب BaaS

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

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

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