به‌روزرسانی Apigee Edge 4.16.09 به 4.17.01

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

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

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

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

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

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

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

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

باید همه عناصر Edge را به‌روز کنید. ‫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 به‌طور مفصل شرح داده شده است.

برای فعال کردن مخزن 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

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

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

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

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

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

IS_EXTERNAL_AUTH="true"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. درصورت وجود، همه کارهای CRON را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده‌اند تا پس‌از تکمیل به‌روزرسانی غیرفعال کنید.
2. برای نصب کردن Edge RPM، به‌عنوان ریشه به سیستم گره‌تان وارد شوید.
   توجه: اگرچه نصب RPM به دسترسی ریشه نیاز دارد، می‌توانید پیکربندی Edge را بدون دسترسی ریشه انجام دهید.
3. SELinux را طبق آنچه در نصب ابزار Edge apigee-setup توضیح داده شده است غیرفعال کنید.
4. فایل Edge 4.17.01 bootstrap_4.17.01.sh را در /tmp/bootstrap_4.17.01.sh بارگیری کنید:
   > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
5. ابزار کمکی Edge 4.17.01 apigee-service و وابستگی‌ها را نصب کنید:
   > sudo bash /tmp/bootstrap_4.17.01.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 را نصب کنید.
6. (فقط CentOS-6.x و RedHat-6.x) در همه گره‌های Qpid، دستور زیر را اجرا کنید تا مطمئن شوید نسخه صحیح Qpid را بارگیری می‌کنید:
   > yum install apigee-qpidd --disablerepo=epel
7. از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
8. ابزار apigee-validate را در «سرور مدیریت» به‌روزرسانی کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
9. ابزار apigee-provision را به‌روز کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
10. برنامه کمکی به‌روزرسانی را در گره‌هایتان به ترتیبی که در بخش «ترتیب به‌روزرسانی ماشین» در زیر توضیح داده شده است اجرا کنید:
    > /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 در گره یکسان
11. با اجرای ابزار apigee-validate در «سرور مدیریت»، همان‌طور که در آزمایش نصب توضیح داده شده است، به‌روزرسانی را آزمایش کنید.

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

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

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

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

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

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

1. مخزن محلی 4.17.01 را همان‌طور که در «ایجاد مخزن محلی Apigee» در نصب ابزار کمکی Edge apigee-setup توضیح داده شده است ایجاد کنید.
   توجه: اگر ازقبل مخزن 4.16.09 دارید، می‌توانید مخزن 4.17.01 را به آن اضافه کنید، همان‌طور که در «به‌روزرسانی مخزن محلی Apigee» در نصب ابزار کمکی Edge apigee-setup توضیح داده شده است.
2. برای نصب apigee-service از فایل ‎ .tar:
   1. در گره دارای مخزن محلی، از فرمان زیر برای بسته‌بندی مخزن محلی در یک فایل .tar به‌نام /opt/apigee/data/apigee-mirror/apigee-4.17.01.tar.gz استفاده کنید:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
   2. فایل tar .را در گرهی که می‌خواهید Edge را به‌روز کنید کپی کنید. برای مثال، آن را در دایرکتوری /tmp در گره جدید کپی کنید.
   3. در گره جدید، فایل را در پوشه /tmp از حالت فشرده خارج کنید:
      > tar -xzf apigee-4.17.01.tar.gz
      
      این فرمان پوشه جدیدی به نام repos در پوشه حاوی فایل .tar ایجاد می‌کند. برای مثال /tmp/repos.
   4. برنامه کمکی Edge apigee-service و وابستگی‌ها را از /tmp/repos نصب کنید:
      > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      توجه داشته باشید که مسیر دایرکتوری repos را در این فرمان اضافه می‌کنید.
3. برای نصب apigee-service بااستفاده از سرور وب Nginx:
   1. سرور وب Nginx را همان‌طور که در «نصب از مخزن بااستفاده از سرور وب Nginx» در نصب ابزار کمکی apigee-setup در Edge توضیح داده شده است پیکربندی کنید.
   2. در گره راه دور، فایل Edge bootstrap_4.17.01.sh را در /tmp/bootstrap_4.17.01.sh بارگیری کنید:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
      
      که در آن uName:pWord نام کاربری و گذرواژه‌ای است که در بالا برای مخزن تنظیم کرده‌اید، و remoteRepo نشانی IP یا نام DNS گره مخزن است.
   3. در گره از دور، ابزار کمکی Edge apigee-service و وابستگی‌ها را نصب کنید:
      > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
      
      که در آن uName:pWord نام کاربری و گذرواژه مخزن است.
4. از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
5. ابزار apigee-validate را در «سرور مدیریت» به‌روز کنید.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
6. ابزار apigee-provision را به‌روز کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
7. برنامه کمکی به‌روزرسانی را در گره‌هایتان به ترتیبی که در بخش «ترتیب به‌روزرسانی ماشین» در زیر توضیح داده شده است اجرا کنید:
   > /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 در گره یکسان
8. با اجرای ابزار apigee-validate در «سرور مدیریت»، همان‌طور که در آزمایش نصب توضیح داده شده است، به‌روزرسانی را آزمایش کنید.

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

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

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

• قبل‌از به‌روزرسانی هر گره دیگری، باید همه گره‌های Cassandra و ZooKeeper را به‌روزرسانی کنید.
• برای هر ماشینی که چند عنصر Edge دارد (سرور مدیریت، پردازشگر پیام، مسیریاب، سرور QPID، اما سرور Postgres ندارد)، از گزینه «-c edge» استفاده کنید تا همه آن‌ها را به‌طور هم‌زمان به‌روز کنید.
• اگر مرحله‌ای مشخص می‌کند که باید در چندین ماشین انجام شود، آن را در ترتیب ماشین مشخص‌شده انجام دهید.
• هیچ مرحله جداگانه‌ای برای به‌روزرسانی «درآمدزایی» وجود ندارد. وقتی گزینه «-c edge» را مشخص می‌کنید، به‌روز می‌شود.
• (فقط CentOS-6.x و RedHat-6.x) در همه گره‌های Qpid با اتصال اینترنت خارجی، مطمئن شوید که فرمان زیر را برای بارگیری نسخه صحیح Qpid همان‌طور که در بالا نشان داده شده است اجرا کرده‌اید:
  > yum install apigee-qpidd --disablerepo=epel

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

1. به‌روزرسانی Cassandra و ZooKeeper:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
2. قانون iptables زیر را تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
3. صف پیام Qpid را بررسی کنید:
   > qpid-stat -q
   
   بررسی صف را تا زمانی‌که تعداد در ستون «msg» به ۰ برسد ادامه دهید. تا زمانی که Qpid همه پیام‌ها را پردازش نکرده است نمی‌توانید آن را ارتقا دهید.
4. به‌روزرسانی qpidd:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
5. پاک کردن iptables:
   > sudo iptables -F
6. به‌روزرسانی postgresql:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
7. شروع postgresql:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
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. به‌روزرسانی کردن رابط کاربری Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. به‌روزرسانی Cassandra و ZooKeeper در ماشین ۱:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
2. قانون iptables زیر را در ماشین ۲ تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
3. صف پیام Qpid را در ماشین ۲ بررسی کنید:
   > qpid-stat -q
   
   بررسی صف را تا زمانی‌که تعداد در ستون «msg» به ۰ برسد ادامه دهید. تا زمانی که Qpid همه پیام‌ها را پردازش نکرده است نمی‌توانید آن را ارتقا دهید.
4. به‌روزرسانی qpidd در ماشین ۲:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
5. پاک کردن iptables در ماشین ۲:
   > sudo iptables -F
6. به‌روزرسانی postgresql در ماشین ۲:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
7. ‫postgresql را در ماشین ۲ شروع کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
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

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

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

1. به‌روزرسانی Cassandra و ZooKeeper در ماشین ۱، ۲، و ۳:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
2. قانون iptables زیر را در ماشین ۴ تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
3. صف پیام Qpid را در ماشین ۴ بررسی کنید:
   > qpid-stat -q
   
   بررسی صف را تا زمانی که تعداد در ستون «msg» به ۰ برسد ادامه دهید. تا زمانی که Qpid همه پیام‌ها را پردازش نکرده است نمی‌توانید آن را ارتقا دهید.
4. به‌روزرسانی qpidd در ماشین ۴:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
5. پاک کردن iptables در ماشین ۴:
   > sudo iptables -F
6. مراحل ۲ تا ۵ را در ماشین ۵ تکرار کنید.
7. به‌روزرسانی postgresql در ماشین ۴:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. ‫postgresql را در ماشین ۴ شروع کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
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

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

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

1. به‌روزرسانی Cassandra و ZooKeeper در ماشین‌های ۱، ۲، و ۳:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
2. قانون iptables زیر را در ماشین ۶ تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
3. صف پیام Qpid را در ماشین ۶ بررسی کنید:
   > qpid-stat -q
   
   بررسی صف را ادامه دهید تا زمانی که تعداد در ستون «msg» به ۰ برسد. تا زمانی که Qpid همه پیام‌ها را پردازش نکرده است نمی‌توانید آن را ارتقا دهید.
4. به‌روزرسانی qpidd در ماشین ۶:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
5. پاک کردن iptables در ماشین ۶:
   > sudo iptables -F
6. مراحل ۲ تا ۵ را در ماشین ۷ تکرار کنید.
7. به‌روزرسانی postgresql در ماشین ۶:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. ‫postgresql را در ماشین ۶ شروع کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
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

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

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

1. به‌روزرسانی Cassandra و ZooKeeper در ماشین‌های ۱، ۲، و ۳:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
2. قانون iptables زیر را در ماشین ۱۲ تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
3. صف پیام Qpid را در ماشین ۱۲ بررسی کنید:
   > qpid-stat -q
   
   بررسی صف را تا زمانی که تعداد در ستون «msg» به ۰ برسد ادامه دهید. تا زمانی که Qpid همه پیام‌ها را پردازش نکرده است نمی‌توانید آن را ارتقا دهید.
4. به‌روزرسانی qpidd در ماشین ۱۲:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
5. پاک کردن iptables در ماشین ۱۲:
   > sudo iptables -F
6. مراحل ۲ تا ۵ را در ماشین ۱۳ تکرار کنید.
7. به‌روزرسانی postgresql در ماشین ۱۲:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. ‫postgresql را در ماشین ۱۲ شروع کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
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

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

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

1. به‌روزرسانی Cassandra و ZooKeeper:
   1. در ماشین‌های ۱، ۲، و ۳ در «مرکز داده ۱»:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
   2. در ماشین‌های ۷، ۸، و ۹ در «مرکز داده ۲»
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
2. به‌روزرسانی 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. مراحل ۱ تا ۴ را در ماشین ۱۱ تکرار کنید.
3. به‌روزرسانی postgresql:
   1. ماشین‌های ۶ در «مرکز داده ۱»
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
   2. ‫Machines 12 in Data Center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
4. به‌روزرسانی «ال‌دپ»:
   1. ماشین‌های ۱ در «مرکز داده ۱»
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
   2. ماشین‌های ۷ در «مرکز داده ۲»
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
5. به‌روزرسانی عناصر Edge:
   1. ماشین‌های ۴، ۵، ۶، ۱، ۲، ۳ در «مرکز داده ۱»
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
   2. ماشین‌های ۱۰، ۱۱، ۱۲، ۷، ۸، ۹ در «مرکز داده ۲»
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
6. به‌روزرسانی میانای کاربر:
   1. ماشین ۱ در «مرکز داده ۱»:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
   2. ماشین ۷ در «مرکز داده ۲»:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

برای نصب «بک‌اند به‌عنوان سرویس» میانای برنامه‌سازی کاربردی ۷ میزبان

قبل‌از اجرای رویه ارتقا، باید دو دارایی جدید به فایل پیکربندی اضافه کنید:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

برای نمونه کامل فایل پیکربندی، به نصب API BaaS مراجعه کنید.

همچنین باید مطمئن شوید که درگاه ۲۵۵۱ در همه گره‌های «پشته» برای دسترسی از همه گره‌های «پشته» دیگر باز باشد.

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

1. به‌روزرسانی Cassandra در ماشین‌های ۵، ۶، و ۷:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

2. به‌روزرسانی ElasticSearch و API BaaS Stack در ماشین ۱، ۲، و ۳:
   > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

3. به‌روزرسانی «درگاه BaaS API» در ماشین ۴:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

برای نصب «میانای برنامه‌سازی کاربردی BaaS» با ۱۰ میزبان

قبل‌از اجرای رویه ارتقا، باید دو دارایی جدید به فایل پیکربندی اضافه کنید:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

برای نمونه کامل فایل پیکربندی، به نصب API BaaS مراجعه کنید.

همچنین باید مطمئن شوید که درگاه ۲۵۵۱ در همه گره‌های «پشته» برای دسترسی از همه گره‌های «پشته» دیگر باز باشد.

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

1. به‌روزرسانی Cassandra در ماشین‌های ۸، ۹، و ۱۰:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
2. به‌روزرسانی ElasticSearch در ماشین‌های ۱، ۲، و ۳:
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
3. به‌روزرسانی پشته API BaaS در ماشین‌های ۴، ۵، و ۶:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
4. ‫Update API BaaS Portal on machine 7:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

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

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