به‌روزرسانی Apigee Edge از نسخه ۴.۱۶.۰۹ به ۴.۱۷.۰۹

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

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

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

اگر نسخه‌ای از Edge دارید که قدیمی‌تر از نسخه ۴.۱۶.۰۱ است، ابتدا باید به نسخه ۴.۱۶.۰۱.x مهاجرت کنید و سپس به نسخه ۴.۱۷.۰۹ به‌روزرسانی کنید.

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

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

پس‌از نصب 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/Oracle 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/Oracle 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 که از آن‌ها استفاده می‌کنند، مدیریت کنند.

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

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

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

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 را دوباره اجرا کنید. می‌توانید به‌روزرسانی را چندین بار اجرا کنید و به‌روزرسانی از جایی که آخرین‌بار متوقف شده است ادامه می‌یابد.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. درصورت وجود، هرگونه کار CRON را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده است غیرفعال کنید تا زمانی که به‌روزرسانی تکمیل شود.
2. برای نصب Edge RPM، به‌عنوان root به سیستم گره وارد شوید.
   توجه: اگرچه نصب RPM به دسترسی ریشه نیاز دارد، می‌توانید پیکربندی Edge را بدون دسترسی ریشه انجام دهید.
3. yum-utils و yum-plugin-priorities را نصب کنید:
   > sudo yum install yum-utils
   > sudo yum install yum-plugin-priorities
4. SELinux را طبق توضیحات نصب ابزار کمکی apigee-setup Edge غیرفعال کنید.
5. مخزن EPEL را طبق توضیحات بالا فعال کنید.
6. اگر در AWS نصب می‌کنید، فرمان yum-configure-manager زیر را اجرا کنید:
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
7. Download the Edge 4.17.09 bootstrap_4.17.09.sh file to /tmp/bootstrap_4.17.09.sh:
   > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
8. برنامه کمکی 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 را خودتان نصب کنید.
9. از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
10. apigee-validate را در «سرور مدیریت» به‌روز کنید:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
11. Update the apigee-provision utility:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
12. ابزار به‌روزرسانی را در گره‌هایتان به‌ترتیبی که در بخش «ترتیب به‌روزرسانی دستگاه» در زیر شرح داده شده است اجرا کنید:
    > /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 در همان گره
13. به‌روزرسانی را با اجرای ابزار کمکی apigee-validate در «سرور مدیریت» آزمایش کنید، همان‌طور که در آزمایش نصب شرح داده شده است.

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

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

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

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

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

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

1. مخزن محلی 4.17.09 را همان‌طور که در «ایجاد مخزن Apigee محلی» در نصب ابزار کمکی apigee-setup در Edge شرح داده شده است ایجاد کنید.
   توجه: اگر ازقبل مخزن 4.16.09 دارید، می‌توانید مخزن 4.17.09 را به آن اضافه کنید، همان‌طور که در «به‌روزرسانی مخزن Apigee محلی» در نصب ابزار کمکی apigee-setup در Edge شرح داده شده است.
2. برای نصب apigee-service از فایل tar .:
   1. On the node with the local repo, use the following command to package the local repo into a single .tar file named /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 خارج کنید:
      > 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 را در این فرمان اضافه کنید.
3. برای نصب apigee-service بااستفاده از وب‌سرور Nginx:
   1. سرور وب Nginx را همان‌طور که در «نصب از مخزن بااستفاده از سرور وب Nginx» در نصب ابزار کمکی apigee-setup در Edge شرح داده شده است پیکربندی کنید.
   2. On the remote node, download the Edge bootstrap_4.17.09.sh file to /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
      
      where uName:pWord are the username and password you set above for the repo, and remoteRepo is the IP address or DNS name of the repo node.
   3. On the remote node, install the Edge apigee-service utility and dependencies:
      > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
      
      where uName:pWord are the repo username and password.
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. Update the apigee-provision utility:
   > /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 در «سرور مدیریت» آزمایش کنید، همان‌طور که در آزمایش نصب شرح داده شده است.

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

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

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

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

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

1. اگر SMTP را در Edge فعال کرده‌اید، SMTPMAILFROM را در فایل پیکربندی‌تان تنظیم کنید. این پارامتر این فرم را دارد:
   SMTPMAILFROM="My Company <myco@company.com>"
2. Update Cassandra and ZooKeeper:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. قانون iptables زیر را تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. صف پیام Qpid را بررسی کنید:
   > qpid-stat -q
   
   بررسی صف را ادامه دهید تا زمانی که تعداد در ستون «msg» به ۰ برسد. تا زمانی که Qpid همه پیام‌ها را پردازش نکرده باشد، نمی‌توانید آن را ارتقا دهید.
5. Update qpidd:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. پاک کردن iptables:
   > sudo iptables -F
7. Update postgresql:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. Start postgresql:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
9. به‌روزرسانی LDAP:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
10. Update the remaining Edge components:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
11. Update Edge UI:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. اگر SMTP را در Edge فعال کرده‌اید، SMTPMAILFROM را در فایل پیکربندی‌تان تنظیم کنید. این پارامتر این فرم را دارد:
   SMTPMAILFROM="My Company <myco@company.com>"
2. Update Cassandra and ZooKeeper on machine 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. قانون iptables زیر را در دستگاه ۲ تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. صف پیام Qpid را در دستگاه ۲ بررسی کنید:
   > qpid-stat -q
   
   به بررسی صف ادامه دهید تا زمانی که تعداد در ستون «msg» به ۰ برسد. تا زمانی که Qpid همه پیام‌ها را پردازش نکرده باشد، نمی‌توانید آن را ارتقا دهید.
5. Update qpidd on machine 2:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. پاک کردن iptables در دستگاه ۲:
   > sudo iptables -F
7. Update postgresql on machine 2:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. postgresql را در دستگاه ۲ شروع کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
9. Update LDAP on machine 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
10. Update Edge components on machine 2 and 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
11. Update UI on machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. اگر SMTP را در Edge فعال کرده‌اید، SMTPMAILFROM را در فایل پیکربندی‌تان تنظیم کنید. این پارامتر این فرم را دارد:
   SMTPMAILFROM="My Company <myco@company.com>"
2. Update Cassandra and ZooKeeper on machine 1, 2, and 3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. قانون iptables زیر را در دستگاه ۴ تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. صف پیام Qpid را در دستگاه ۴ بررسی کنید:
   > qpid-stat -q
   
   بررسی صف را تا زمانی که تعداد در ستون «msg» به ۰ برسد ادامه دهید. تا زمانی که Qpid همه پیام‌ها را پردازش نکرده باشد، نمی‌توانید آن را ارتقا دهید.
5. Update qpidd on machine 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. پاک کردن iptables در دستگاه ۴:
   > sudo iptables -F
7. مراحل ۳ تا ۶ را در ماشین ۵ تکرار کنید.
8. Update postgresql on machine 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
9. Start postgresql on machine 4:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
10. مراحل ۸ و ۹ را در دستگاه ۵ تکرار کنید.
11. Update LDAP on machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
12. Update Edge components on machine 4, 5, 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. Update UI on machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. اگر SMTP را در Edge فعال کرده‌اید، SMTPMAILFROM را در فایل پیکربندی‌تان تنظیم کنید. این پارامتر این فرم را دارد:
   SMTPMAILFROM="My Company <myco@company.com>"
2. Update Cassandra and ZooKeeper on machine 1, 2, and 3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. قانون iptables زیر را در دستگاه ۶ تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. صف پیام Qpid را در دستگاه ۶ بررسی کنید:
   > qpid-stat -q
   
   بررسی صف را تا زمانی که تعداد در ستون «msg» به ۰ برسد ادامه دهید. تا زمانی که Qpid همه پیام‌ها را پردازش نکرده باشد، نمی‌توانید آن را ارتقا دهید.
5. qpidd را در دستگاه ۶ به‌روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. پاک کردن iptables در دستگاه ۶:
   > sudo iptables -F
7. مراحل ۳ تا ۶ را در ماشین ۷ تکرار کنید.
8. postgresql را در دستگاه ۶ به‌روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
9. Start postgresql on machine 6:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
10. مراحل ۸ و ۹ را در دستگاه ۷ تکرار کنید.
11. Update LDAP on machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
12. Update Edge components on machine 6, 7, 8, 9, 1, 4, and 5 in that order:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. Update UI on machine 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. اگر SMTP را در Edge فعال کرده‌اید، SMTPMAILFROM را در فایل پیکربندی‌تان تنظیم کنید. این پارامتر این فرم را دارد:
   SMTPMAILFROM="My Company <myco@company.com>"
2. Update Cassandra and ZooKeeper on machine 1, 2, and 3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. قانون iptables زیر را در دستگاه ۱۲ تنظیم کنید:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. صف پیام Qpid را در دستگاه ۱۲ بررسی کنید:
   > qpid-stat -q
   
   بررسی صف را تا زمانی که تعداد در ستون «msg» به ۰ برسد ادامه دهید. تا زمانی که Qpid همه پیام‌ها را پردازش نکرده باشد، نمی‌توانید آن را ارتقا دهید.
5. Update qpidd on machine 12:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. Flush iptables on machine 12:
   > sudo iptables -F
7. مراحل ۳ تا ۶ را در دستگاه ۱۳ تکرار کنید.
8. Update postgresql on machine 12:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
9. postgresql را در دستگاه ۱۲ راه‌اندازی کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
10. مراحل ۸ و ۹ را در دستگاه ۱۳ تکرار کنید.
11. LDAP را در دستگاه ۴ و ۵ به‌روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
12. Update Edge components on machine 12, 13, 8, 9, 6, 7, 10, and 11 in that order:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. رابط کاربری را در ماشین ۶ و ۷ به‌روز کنید:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. اگر SMTP را در Edge فعال کرده‌اید، SMTPMAILFROM را در فایل پیکربندی‌تان تنظیم کنید. این پارامتر این فرم را دارد:
   SMTPMAILFROM="My Company <myco@company.com>"
2. Cassandra و ZooKeeper را به‌روز کنید:
   1. On machines 1, 2 and 3 in Data Center 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
   2. در دستگاه‌های ۷، ۸، و ۹ در «مرکز داده ۲»
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. ‫qpidd را به‌روز کنید:
   1. ماشین‌های ۴ و ۵ در مرکز داده ۱
      1. قانون iptables زیر را در دستگاه ۴ تنظیم کنید:
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. صف پیام Qpid را در دستگاه ۴ بررسی کنید:
         > qpid-stat -q
         
         بررسی صف را تا زمانی که تعداد در ستون «msg» به ۰ برسد ادامه دهید. تا زمانی که Qpid همه پیام‌ها را پردازش نکرده است، نمی‌توانید آن را ارتقا دهید.
      3. Update qpidd on machine 4:
         > /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. مراحل ۱ تا ۴ را در دستگاه ۱۱ تکرار کنید.
4. به‌روزرسانی postgresql:
   1. Machines 6 in Data Center 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
5. به‌روزرسانی LDAP:
   1. Machines 1 in Data Center 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
   2. Machines 7 in Data Center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. به‌روزرسانی مؤلفه‌های Edge:
   1. Machines 4, 5, 6, 1, 2, 3 in Data Center 1
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
   2. Machines 10, 11, 12, 7, 8, 9 in Data Center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. به‌روزرسانی میانای کاربر:
   1. Machine 1 in Data Center 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
   2. Machine 7 in Data Center 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

برای نصب API 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"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

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

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

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

1. Update Cassandra on machine 5, 6, and 7:
   > /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. Update API BaaS Portal on machine 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

برای نصب API 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"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

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

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

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

1. Cassandra را در دستگاه‌های ۸، ۹، و ۱۰ به‌روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
2. Update ElasticSearch on machine 1, 2, and 3:
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
3. Update API BaaS Stack on machine 4, 5, and 6:
   > /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