به‌روزرسانی Apigee Edge 4.17.01/4.17.05 به 4.17.09

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

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

بااستفاده از این روش می‌توانید Apigee Edge نسخه ‎4.17.01.0x/4.17.05.0x را به ‎4.17.09 به‌روز کنید.

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

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

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

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

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

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

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

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

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

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

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

این پارامتر این فرم را دارد:

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

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

قبل‌از ارتقا دادن 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 دیگر را در همان دستگاهی که «رهیاب» قرار دارد به‌روز کنید. همه پیکربندی‌های Edge یک «مسیریاب» و «پردازشگر پیام» را در یک گره نشان می‌دهند.
4. رهیاب را دوباره دردسترس قرار دهید.
5. مراحل ۲ تا ۴ را برای بقیه «رهیاب‌ها» تکرار کنید.
6. به‌روزرسانی را برای بقیه دستگاه‌های موجود در نصب ادامه دهید.

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

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

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

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

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

از روش زیر برای به‌روزرسانی مؤلفه‌های 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. اگر در AWS نصب می‌کنید، فرمان yum-configure-manager زیر را اجرا کنید:
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
6. 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
7. برنامه کمکی 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 را خودتان نصب کنید.
8. از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
9. apigee-validate را در «سرور مدیریت» به‌روز کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
10. Update the apigee-provision utility:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
11. ابزار به‌روزرسانی را در گره‌هایتان به‌ترتیبی که در بخش «ترتیب به‌روزرسانی دستگاه» در زیر شرح داده شده است اجرا کنید:
    > /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 در همان گره
12. به‌روزرسانی را با اجرای ابزار کمکی apigee-validate در «سرور مدیریت» آزمایش کنید، همان‌طور که در آزمایش نصب شرح داده شده است.

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

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

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

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

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

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

1. یک مخزن محلی 4.17.09 ایجاد کنید، همان‌طور که در «ایجاد مخزن Apigee محلی» در نصب ابزار کمکی apigee-setup Edge شرح داده شده است.
   توجه: اگر ازقبل مخزن 4.17.01/4.17.05 دارید، می‌توانید مخزن 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 در «سرور مدیریت» آزمایش کنید، همان‌طور که در آزمایش نصب شرح داده شده است.

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

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

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

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

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

1. اگر از نسخه 4.17.01 به‌روزرسانی می‌کنید، اگر 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. Update Qpid and Postgres:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. Start postgresql:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. به‌روزرسانی LDAP:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. Update the remaining Edge components:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. Update Edge UI:
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. اگر از نسخه 4.17.01 به‌روزرسانی می‌کنید، اگر 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. Qpid و Postgres را در ماشین ۲ به‌روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. postgresql را در دستگاه ۲ شروع کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. Update LDAP on machine 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. Update Edge components on machine 2 and 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. Update UI on machine 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. اگر از نسخه 4.17.01 به‌روزرسانی می‌کنید، اگر 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. Update Qpid and Postgres on machine 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. Start postgresql on machine 4:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. مراحل ۳ و ۴ را در ماشین ۵ تکرار کنید.
6. Update LDAP on machine 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. Update Edge components on machine 4, 5, 1, 2, 3:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
8. Update UI on machine 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. اگر از نسخه 4.17.01 به‌روزرسانی می‌کنید، اگر 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. Update Qpid and Postgres on machine 6:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. Start postgresql on machine 6:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. مراحل ۳ و ۴ را در ماشین ۷ تکرار کنید.
6. Update LDAP on machine 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. 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
8. Update UI on machine 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. اگر از نسخه 4.17.01 به‌روزرسانی می‌کنید، اگر 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. Qpid و Postgres را در دستگاه ۱۲ به‌روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. postgresql را در دستگاه ۱۲ راه‌اندازی کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. مراحل ۳ و ۴ را در دستگاه ۱۳ تکرار کنید.
6. LDAP را در دستگاه ۴ و ۵ به‌روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. 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
8. رابط کاربری را در ماشین ۶ و ۷ به‌روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. اگر از نسخه 4.17.01 به‌روزرسانی می‌کنید، اگر 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. Update qpidd on machine 4:
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. مرحله ۱ را در دستگاه ۵ تکرار کنید.
   2. ماشین‌های ۱۰ و ۱۱ در مرکز داده ۲
      1. Update qpidd on machine 10:
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. مرحله ۱ را در دستگاه ۱۱ تکرار کنید.
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 با ۷ میزبان

1. SMTPMAILFROM را در فایل پیکربندی‌تان تنظیم کنید. این پارامتر این فرم را دارد:
   SMTPMAILFROM="My Company <myco@company.com>"
2. Update Cassandra on machine 5, 6, and 7:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

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

4. Update API BaaS Portal on machine 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

1. SMTPMAILFROM را در فایل پیکربندی‌تان تنظیم کنید. این پارامتر این فرم را دارد:
   SMTPMAILFROM="My Company <myco@company.com>"
2. Cassandra را در دستگاه‌های ۸، ۹، و ۱۰ به‌روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
3. Update ElasticSearch on machine 1, 2, and 3:
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
4. Update API BaaS Stack on machine 4, 5, and 6:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
5. Update API BaaS Portal on machine 7:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

برای نصب API Baas دو مرکز داده

این رویه مستلزم آن است که گره‌های Cassandra را در هر دو مرکز داده به‌روز کنید. اگر آن گره‌های Cassandra را با Edge هم‌رسانی می‌کنید، معمولاً آن گره‌ها را به‌عنوان بخشی از به‌روزرسانی Edge به‌روز می‌کنید.

1. SMTPMAILFROM را در فایل‌های پیکربندی‌تان تنظیم کنید. این پارامتر این فرم را دارد:
   SMTPMAILFROM="My Company <myco@company.com>"
2. فضاهای کلید Cassandra را با ضریب تکرار صحیح برای دو مرکز داده به‌روز کنید. فقط باید این مرحله را یک‌بار در هر سرور Cassandra در هریک از مراکز داده اجرا کنید:
   
   توجه: همه فرمان‌های زیر ضریب تکرار را روی «۳» تنظیم می‌کنند که نشان‌دهنده سه گره Cassandra در خوشه است. این مقدار را درصورت لزوم برای نصب خود تغییر دهید.
   1. Start the Cassandra cqlsh utility:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
   2. فرمان‌های CQL زیر را در پیام‌واره «cqlsh>» اجرا کنید تا سطوح تکرار را برای فضاهای کلید Cassandra تنظیم کنید:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cqlsh> ALTER KEYSPACE "system_traces" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      6. بااستفاده از این فرمان، فضاهای کلید را مشاهده کنید:
         cqlsh> select * from system.schema_keyspaces;
      7. از cqlsh خارج شوید:
         cqlsh> exit
3. (فقط اگر Cassandra را به‌عنوان بخشی از به‌روزرسانی Edge به‌روز نکرده‌اید) گره‌های Cassandra را در مرکز داده ۱، هر بار یک دستگاه، به‌روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
4. (فقط اگر Cassandra را به‌عنوان بخشی از به‌روزرسانی Edge به‌روز نکرده‌اید) گره‌های Cassandra را در مرکز داده ۲، هر بار یک دستگاه، به‌روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
5. Update ElasticSearch on machines in data center 1, one machine at a time:
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
6. Update ElasticSearch on machines in data center 2, one machine at a time:
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
7. Update API BaaS Stack on machines in data center 1, one machine at a time:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
8. Update API BaaS Stack on machines in data center 2, one machine at a time:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
9. Update API BaaS Portal on machines in data center 1, one machine at a time:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
10. Update API BaaS Portal on machines in data center 2, one machine at a time:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
11. مقادیر فضای کلید BaaS را به‌روز کنید. این فضاهای کلید باید برای تکرار در زمان نصب تنظیم شوند، اما لازم نیست در زمان اجرا تنظیم شوند. برداشتن تکرار باعث صرفه‌جویی در حافظه Cassandra نیز می‌شود.
    
    این مرحله را فقط باید یک‌بار در هر سرور Cassandra در هریک از مراکز داده اجرا کنید:
    1. ابزار Cassandra cqlsh را راه‌اندازی کنید:
       > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. فرمان‌های CQL زیر را برای تنظیم سطوح تکرار برای فضاهای کلید Cassandra اجرا کنید:
       1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
       2. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
       3. بااستفاده از این فرمان، فضاهای کلید را مشاهده کنید:
          cqlsh> select * from system.schema_keyspaces;
       4. خروج از cqlsh:
          cqlsh> exit

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

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

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