Apigee Edge 4.18.05 را به 4.50.00 به روز کنید

این بخش نحوه انجام ارتقاء زیر را شرح می دهد:

• از 4.18.05 تا 4.50.00

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

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

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

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

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

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

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

پیش نیازها را به روز کنید

قبل از ارتقاء Apigee Edge به پیش نیازهای زیر توجه کنید:

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

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

• مطمئن شوید که Edge در حال اجرا است
  با استفاده از دستور زیر اطمینان حاصل کنید که Edge در طول فرآیند به‌روزرسانی فعال است:

  /opt/apigee/apigee-service/bin/apigee-all status

رابط کاربری جدید Edge

این بخش ملاحظات مربوط به رابط کاربری جدید Edge را فهرست می کند.

رابط کاربری Edge را نصب کنید

پس از اتمام نصب اولیه، Apigee توصیه می کند که رابط کاربری Edge را نصب کنید، که یک رابط کاربری پیشرفته برای توسعه دهندگان و مدیران Apigee Edge برای Private Cloud است.

برای اطلاعات بیشتر، به نصب رابط کاربری جدید Edge مراجعه کنید.

رابط کاربری Edge را به روز کنید

اگر نسخه بتا رابط کاربری Edge (که قبلاً به نام New Edge experience یا UE شناخته می‌شد) را در نسخه 4.18.05 نصب کرده‌اید، باید آن را حذف نصب کرده و نسخه 4.19.01، 4.19.06 یا 4.50.00 را نصب کنید. رابط کاربری Edge. برای اطلاعات بیشتر، به رابط کاربری جدید Edge برای Private Cloud مراجعه کنید.

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

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

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

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

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

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

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

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

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

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

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

کلید ارتقای زمان خاموشی صفر این است که هر روتر را یکی یکی از بار متعادل کننده حذف کنید. سپس روتر و هر جزء دیگر را در همان دستگاه روتر به روز می کنید و سپس روتر را دوباره به بار متعادل کننده اضافه می کنید.

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

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

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

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

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

به روز رسانی به 4.50.00 در یک گره با اتصال اینترنت خارجی

برای به روز رسانی اجزای Edge در یک گره از روش زیر استفاده کنید:

1. در صورت وجود، کارهای CRON را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده اند، تا زمانی که به روز رسانی کامل نشده است، غیرفعال کنید.
2. برای نصب Edge RPM به عنوان root وارد گره خود شوید.
3. yum-utils و yum-plugin-priorities را نصب کنید:

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. همانطور که در Install the Edge apigee-setup utility توضیح داده شد SELinux را غیرفعال کنید.
5. اگر روی Oracle 7.x نصب می‌کنید ، دستور زیر را اجرا کنید:

   sudo yum-config-manager --enable ol7_optional_latest

6. اگر روی AWS نصب می‌کنید ، دستورات yum-configure-manager زیر را اجرا کنید:

   yum update rh-amazon-rhui-client.noarch
   sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

7. فایل Edge 4.50.00 bootstrap_4.50.00.sh را در /tmp/bootstrap_4.50.00.sh دانلود کنید:

   curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

8. ابزار Edge 4.50.00 apigee-service و وابستگی ها را نصب کنید:

   sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

   جایی که uName:pWord نام کاربری و رمز عبوری است که از Apigee دریافت کرده‌اید. اگر pWord حذف کنید، از شما خواسته می شود آن را وارد کنید.

   به طور پیش فرض، نصب کننده بررسی می کند که جاوا 1.8 را نصب کرده اید. اگر این کار را نکنید، آن را برای شما نصب می کند. از گزینه JAVA_FIX برای تعیین نحوه مدیریت نصب جاوا استفاده کنید. JAVA_FIX مقادیر زیر را می گیرد:

   • I : OpenJDK 1.8 (پیش‌فرض) را نصب کنید.
   • C : بدون نصب جاوا ادامه دهید.
   • Q : ترک برای این گزینه باید خود جاوا را نصب کنید.
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. همانطور که مثال زیر نشان می دهد، ابزار apigee-provision را در سرور مدیریت به روز کنید:

    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

12. برنامه update را بر روی گره های خود به ترتیبی که در ترتیب به روز رسانی ماشین توضیح داده شده است اجرا کنید:

    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    جایی که component کامپوننت Edge برای به روز رسانی است. مقادیر ممکن عبارتند از:

    • "cs": کاساندرا
    • "edge": تمام اجزای Edge به جز Edge UI: سرور مدیریت، پردازشگر پیام، روتر، سرور QPID، سرور Postgres
    • "ldap": OpenLDAP
    • "ps": postgresql
    • « قپید » : qpidd
    • "sso": Apigee SSO (اگر SSO را نصب کرده باشید)
    • "ui": رابط کاربری Edge
    • «زک»: نگهبان باغ وحش

    و configFile همان فایل پیکربندی است که برای تعریف اجزای Edge خود در هنگام نصب 4.18.05 استفاده کردید.

    می‌توانید update.sh روی همه مؤلفه‌ها با تنظیم component روی «all» اجرا کنید، اما فقط در صورتی که نمایه نصب Edge all-in-one (aio) داشته باشید. به عنوان مثال:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config

13. اگر قبلاً این کار را نکرده‌اید، مؤلفه Edge UI را در تمام گره‌هایی که آن را اجرا می‌کنند، مجدداً راه‌اندازی کنید:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

14. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.

اگر بعداً تصمیم به بازگرداندن به‌روزرسانی گرفتید، از روشی که در Roll back 4.50.00 توضیح داده شده است استفاده کنید.

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

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

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

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

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

1. یک مخزن محلی 4.50.00 همانطور که در "ایجاد یک مخزن محلی Apigee" در نصب ابزار Edge apigee-setup توضیح داده شده است، ایجاد کنید.
2. برای نصب apigee-service از فایل tar :
   1. در گره دارای مخزن محلی، از دستور زیر برای بسته بندی مخزن محلی در یک فایل .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.50.00.tar.gz استفاده کنید:

      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

   2. فایل tar را در گره ای که می خواهید Edge را به روز کنید کپی کنید. به عنوان مثال، آن را در پوشه /tmp در گره جدید کپی کنید.
   3. در گره جدید، فایل را در پوشه /tmp untar کنید:

      tar -xzf apigee-4.50.00.tar.gz

      این دستور یک دایرکتوری جدید به نام repos در دایرکتوری حاوی فایل tar ایجاد می کند. به عنوان مثال /tmp/repos .

   4. ابزار و وابستگی های Edge apigee-service از /tmp/repos نصب کنید:

      sudo bash /tmp/repos/bootstrap_4.50.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      توجه داشته باشید که مسیر دایرکتوری repos را در این دستور قرار داده اید.

3. برای نصب apigee-service با استفاده از وب سرور Nginx:
   1. وب سرور Nginx را همانطور که در «نصب از مخزن با استفاده از وب سرور Nginx» در نصب ابزار Edge apigee-setup توضیح داده شده پیکربندی کنید.
   2. در گره راه دور، فایل Edge bootstrap_4.50.00.sh را در /tmp/bootstrap_4.50.00.sh دانلود کنید:

      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

      که در آن uName:pWord نام کاربری و رمز عبوری است که قبلاً برای مخزن تنظیم کرده‌اید و remoteRepo آدرس IP یا نام DNS گره repo است.

   3. در گره راه دور، ابزار Edge apigee-setup و وابستگی ها را نصب کنید:

      sudo bash /tmp/bootstrap_4.50.00.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. برنامه update را بر روی گره های خود به ترتیبی که در ترتیب به روز رسانی ماشین توضیح داده شده است اجرا کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

   کجا:

   • component کامپوننت Edge برای به روز رسانی است. شما معمولاً مؤلفه های زیر را به روز می کنید:
     • "cs": کاساندرا
     • "edge": همه اجزای Edge به جز Edge UI. جزء "لبه" شامل سرور مدیریت، پردازشگر پیام، روتر، سرور QPID و سرور Edge Postgres است.
     • "ldap": OpenLDAP
     • "ps": postgresql
     • « قپید » : qpidd
     • "sso": Apigee SSO (اگر SSO را نصب کرده باشید)
     • "ui": رابط کاربری Edge
     • «زک»: نگهبان باغ وحش
   • configFile همان فایل پیکربندی است که برای تعریف اجزای Edge خود در هنگام نصب 4.18.05 استفاده کردید.

   می‌توانید با تنظیم component روی «all» update.sh روی همه مؤلفه‌ها اجرا کنید، اما فقط در صورتی که نمایه نصب Edge all-in-one (AIO) داشته باشید. به عنوان مثال:

   /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config

8. اگر قبلاً این کار را نکرده‌اید، مؤلفه Edge UI را در تمام گره‌هایی که آن را اجرا می‌کنند، مجدداً راه‌اندازی کنید:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

9. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.

اگر بعداً تصمیم به بازگرداندن به‌روزرسانی گرفتید، از روشی که در Roll back 4.50.00 توضیح داده شده است استفاده کنید.

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

ترتیب به روز رسانی دستگاه ها در نصب Edge مهم است:

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

ارتقاء مستقل 1 گره

برای ارتقاء یک پیکربندی مستقل 1 گره به 4.50.00:

1. به روز رسانی تمام اجزا:

   /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

2. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را به روز کردید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

ارتقاء مستقل 2 گره

اجزای زیر را برای نصب مستقل 2 گره به روز کنید:

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

1. Cassandra و ZooKeeper را در دستگاه 1 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. Qpid و Postgres را در دستگاه 2 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile

3. به روز رسانی LDAP در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

4. به روز رسانی اجزای Edge در ماشین 2 و 1:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

5. به روز رسانی UI در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

6. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کردید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

7. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.

8. مؤلفه Edge UI را در دستگاه 1 مجدداً راه اندازی کنید:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقاء 5 گره

اجزای زیر را برای نصب 5 گره به روز کنید:

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

1. Cassandra و ZooKeeper را در دستگاه 1، 2 و 3 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. Qpid و Postgres را در دستگاه 4 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile

3. Qpid و Postgres را در دستگاه 5 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile

4. به روز رسانی LDAP در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

5. به روز رسانی اجزای Edge در دستگاه 4، 5، 1، 2، 3:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. به روز رسانی UI در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

7. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کردید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.

9. مؤلفه Edge UI را در دستگاه 1 مجدداً راه اندازی کنید:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقاء خوشه ای 9 گره

اجزای زیر را برای نصب خوشه ای 9 گره به روز کنید:

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

1. Cassandra و ZooKeeper را در دستگاه 1، 2 و 3 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. به روز رسانی Qpid در ماشین های 6 و 7:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. به روز رسانی Postgres در دستگاه 8:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. به روز رسانی Postgres در دستگاه 9:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5. به روز رسانی LDAP در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

6. اجزای Edge را در دستگاه 6، 7، 8، 9، 1، 4 و 5 به ترتیب به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

7. به روز رسانی UI در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

8. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کردید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.

10. مؤلفه Edge UI را در دستگاه 1 مجدداً راه اندازی کنید:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقاء خوشه ای 13 گره

مؤلفه های زیر را برای نصب خوشه ای 13 گره به روز کنید:

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

1. Cassandra و ZooKeeper را در ماشین‌های 1، 2 و 3 به‌روزرسانی کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. به روز رسانی Qpid در ماشین های 12 و 13:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. به روز رسانی Postgres در دستگاه 8:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. به روز رسانی Postgres در دستگاه 9:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5. به روز رسانی LDAP در دستگاه 4 و 5:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

6. اجزای Edge را در ماشین‌های 12، 13، 8، 9، 6، 7، 10 و 11 به ترتیب به‌روزرسانی کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

7. به روز رسانی UI در ماشین های 6 و 7:

   /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

8. (اگر apigee-adminapi نصب کرده اید) ابزار apigee-adminapi در ماشین های 6 و 7 به روز کردید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در ماشین های 6 و 7 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.

10. کامپوننت Edge UI را در ماشین‌های 6 و 7 مجدداً راه‌اندازی کنید:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقاء خوشه ای 12 گره

اجزای زیر را برای نصب خوشه ای 12 گره به روز کنید:

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

1. Cassandra و ZooKeeper را به روز کنید:
   1. در ماشین های 1، 2 و 3 در مرکز داده 1:

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

   2. در ماشین های 7، 8، و 9 در مرکز داده 2

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. به روز رسانی qpidd:
   1. Machines 4, 5 در مرکز داده 1
      1. به روز رسانی qpidd در ماشین 4:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. به روز رسانی qpidd در ماشین 5:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

   2. Machines 10, 11 in Data Center 2
      1. به روز رسانی qpidd در دستگاه 10:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. به روز رسانی qpidd در ماشین 11:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. به روز رسانی Postgres:
   1. ماشین 6 در مرکز داده 1

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

   2. ماشین 12 در مرکز داده 2

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. به روز رسانی LDAP:
   1. ماشین 1 در مرکز داده 1

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

   2. ماشین 7 در مرکز داده 2

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

5. به روز رسانی اجزای Edge:
   1. ماشین های 4، 5، 6، 1، 2، 3 در مرکز داده 1

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   2. ماشین های 10، 11، 12، 7، 8، 9 در مرکز داده 2

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. به روز رسانی UI:
   1. ماشین 1 در مرکز داده 1:

      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

   2. ماشین 7 در مرکز داده 2:

      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

   3. کامپوننت Edge UI را در ماشین‌های 1 و 7 مجدداً راه‌اندازی کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

7. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را به روز کردید:
   1. ماشین 1 در مرکز داده 1:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   2. ماشین 7 در مرکز داده 2:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را به روز کنید:
   1. ماشین 1 در مرکز داده 1:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   2. ماشین 7 در مرکز داده 2:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.

برای یک پیکربندی غیر استاندارد

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

1. باغ وحش
2. کاساندرا
3. qpidd، ps
4. LDAP
5. Edge، به معنای نمایه "-c edge" در تمام گره ها به ترتیب: گره های دارای سرور Qpid، سرور Edge Postgres، سرور مدیریت، پردازشگر پیام و روتر.
6. رابط کاربری لبه
7. apigee-adminapi
8. Apigee SSO

پس از اتمام به‌روزرسانی، حتماً مؤلفه Edge UI را در همه دستگاه‌هایی که آن را اجرا می‌کنند، مجدداً راه‌اندازی کنید.

این بخش نحوه انجام ارتقاء زیر را شرح می دهد:

• از 4.18.05 تا 4.50.00

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

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

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

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

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

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

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

پیش نیازها را به روز کنید

قبل از ارتقاء Apigee Edge به پیش نیازهای زیر توجه کنید:

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

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

• مطمئن شوید که Edge در حال اجرا است
  با استفاده از دستور زیر اطمینان حاصل کنید که Edge در طول فرآیند به‌روزرسانی فعال است:

  /opt/apigee/apigee-service/bin/apigee-all status

رابط کاربری جدید Edge

این بخش ملاحظات مربوط به رابط کاربری جدید Edge را فهرست می کند.

رابط کاربری Edge را نصب کنید

پس از اتمام نصب اولیه، Apigee توصیه می کند که رابط کاربری Edge را نصب کنید، که یک رابط کاربری پیشرفته برای توسعه دهندگان و مدیران Apigee Edge برای Private Cloud است.

برای اطلاعات بیشتر، به نصب رابط کاربری جدید Edge مراجعه کنید.

رابط کاربری Edge را به روز کنید

اگر نسخه بتا رابط کاربری Edge (که قبلاً به نام New Edge experience یا UE شناخته می‌شد) را در نسخه 4.18.05 نصب کرده‌اید، باید آن را حذف نصب کرده و نسخه 4.19.01، 4.19.06 یا 4.50.00 را نصب کنید. رابط کاربری Edge. برای اطلاعات بیشتر، به رابط کاربری جدید Edge برای Private Cloud مراجعه کنید.

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

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

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

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

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

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

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

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

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

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

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

کلید ارتقای زمان خاموشی صفر این است که هر روتر را یکی یکی از بار متعادل کننده حذف کنید. سپس روتر و هر جزء دیگر را در همان دستگاه روتر به روز می کنید و سپس روتر را دوباره به بار متعادل کننده اضافه می کنید.

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

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

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

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

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

به روز رسانی به 4.50.00 در یک گره با اتصال اینترنت خارجی

برای به روز رسانی اجزای Edge در یک گره از روش زیر استفاده کنید:

1. در صورت وجود، کارهای CRON را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده اند، تا زمانی که به روز رسانی کامل نشده است، غیرفعال کنید.
2. برای نصب Edge RPM به عنوان root وارد گره خود شوید.
3. yum-utils و yum-plugin-priorities را نصب کنید:

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. همانطور که در Install the Edge apigee-setup utility توضیح داده شد SELinux را غیرفعال کنید.
5. اگر روی Oracle 7.x نصب می‌کنید ، دستور زیر را اجرا کنید:

   sudo yum-config-manager --enable ol7_optional_latest

6. اگر روی AWS نصب می‌کنید ، دستورات yum-configure-manager زیر را اجرا کنید:

   yum update rh-amazon-rhui-client.noarch
   sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

7. فایل Edge 4.50.00 bootstrap_4.50.00.sh را در /tmp/bootstrap_4.50.00.sh دانلود کنید:

   curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

8. ابزار Edge 4.50.00 apigee-service و وابستگی ها را نصب کنید:

   sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

   جایی که uName:pWord نام کاربری و رمز عبوری است که از Apigee دریافت کرده‌اید. اگر pWord حذف کنید، از شما خواسته می شود آن را وارد کنید.

   به طور پیش فرض، نصب کننده بررسی می کند که جاوا 1.8 را نصب کرده اید. اگر این کار را نکنید، آن را برای شما نصب می کند. از گزینه JAVA_FIX برای تعیین نحوه مدیریت نصب جاوا استفاده کنید. JAVA_FIX مقادیر زیر را می گیرد:

   • I : OpenJDK 1.8 (پیش‌فرض) را نصب کنید.
   • C : بدون نصب جاوا ادامه دهید.
   • Q : ترک برای این گزینه باید خود جاوا را نصب کنید.
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. همانطور که مثال زیر نشان می دهد، ابزار apigee-provision را در سرور مدیریت به روز کنید:

    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

12. برنامه update را بر روی گره های خود به ترتیبی که در ترتیب به روز رسانی ماشین توضیح داده شده است اجرا کنید:

    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    جایی که component کامپوننت Edge برای به روز رسانی است. مقادیر ممکن عبارتند از:

    • «cs»: کاساندرا
    • "edge": تمام اجزای Edge به جز Edge UI: سرور مدیریت، پردازشگر پیام، روتر، سرور QPID، سرور Postgres
    • "ldap": OpenLDAP
    • "ps": postgresql
    • « قپید » : qpidd
    • "sso": Apigee SSO (اگر SSO را نصب کرده باشید)
    • "ui": رابط کاربری Edge
    • «زک»: نگهبان باغ وحش

    و configFile همان فایل پیکربندی است که برای تعریف اجزای Edge خود در هنگام نصب 4.18.05 استفاده کردید.

    می‌توانید update.sh روی همه مؤلفه‌ها با تنظیم component روی «all» اجرا کنید، اما فقط در صورتی که نمایه نصب Edge all-in-one (aio) داشته باشید. به عنوان مثال:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config

13. اگر قبلاً این کار را نکرده‌اید، مؤلفه Edge UI را در تمام گره‌هایی که آن را اجرا می‌کنند، مجدداً راه‌اندازی کنید:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

14. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.

اگر بعداً تصمیم به بازگرداندن به‌روزرسانی گرفتید، از روشی که در Roll back 4.50.00 توضیح داده شده است استفاده کنید.

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

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

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

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

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

1. یک مخزن محلی 4.50.00 همانطور که در "ایجاد یک مخزن محلی Apigee" در نصب ابزار Edge apigee-setup توضیح داده شده است، ایجاد کنید.
2. برای نصب apigee-service از فایل tar :
   1. در گره دارای مخزن محلی، از دستور زیر برای بسته بندی مخزن محلی در یک فایل .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.50.00.tar.gz استفاده کنید:

      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

   2. فایل tar را در گره ای که می خواهید Edge را به روز کنید کپی کنید. به عنوان مثال، آن را در پوشه /tmp در گره جدید کپی کنید.
   3. در گره جدید، فایل را در پوشه /tmp untar کنید:

      tar -xzf apigee-4.50.00.tar.gz

      این دستور یک دایرکتوری جدید به نام repos در دایرکتوری حاوی فایل tar ایجاد می کند. به عنوان مثال /tmp/repos .

   4. ابزار و وابستگی های Edge apigee-service از /tmp/repos نصب کنید:

      sudo bash /tmp/repos/bootstrap_4.50.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      توجه داشته باشید که مسیر دایرکتوری repos را در این دستور قرار داده اید.

3. برای نصب apigee-service با استفاده از وب سرور Nginx:
   1. وب سرور Nginx را همانطور که در «نصب از مخزن با استفاده از وب سرور Nginx» در نصب ابزار Edge apigee-setup توضیح داده شده پیکربندی کنید.
   2. در گره راه دور، فایل Edge bootstrap_4.50.00.sh را در /tmp/bootstrap_4.50.00.sh دانلود کنید:

      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

      که در آن uName:pWord نام کاربری و رمز عبوری است که قبلاً برای مخزن تنظیم کرده‌اید و remoteRepo آدرس IP یا نام DNS گره repo است.

   3. در گره راه دور، ابزار Edge apigee-setup و وابستگی ها را نصب کنید:

      sudo bash /tmp/bootstrap_4.50.00.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. برنامه update را بر روی گره های خود به ترتیبی که در ترتیب به روز رسانی ماشین توضیح داده شده است اجرا کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

   کجا:

   • component کامپوننت Edge برای به روز رسانی است. شما معمولاً مؤلفه های زیر را به روز می کنید:
     • "cs": کاساندرا
     • "edge": همه اجزای Edge به جز Edge UI. جزء "لبه" شامل سرور مدیریت، پردازشگر پیام، روتر، سرور QPID و سرور Edge Postgres است.
     • "ldap": OpenLDAP
     • "ps": postgresql
     • « قپید » : qpidd
     • "sso": Apigee SSO (اگر SSO را نصب کرده باشید)
     • "ui": رابط کاربری Edge
     • «زک»: نگهبان باغ وحش
   • configFile همان فایل پیکربندی است که برای تعریف اجزای Edge خود در هنگام نصب 4.18.05 استفاده کردید.

   می‌توانید با تنظیم component روی «all» update.sh روی همه مؤلفه‌ها اجرا کنید، اما فقط در صورتی که نمایه نصب Edge all-in-one (AIO) داشته باشید. به عنوان مثال:

   /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config

8. اگر قبلاً این کار را نکرده‌اید، مؤلفه Edge UI را در تمام گره‌هایی که آن را اجرا می‌کنند، مجدداً راه‌اندازی کنید:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

9. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.

اگر بعداً تصمیم به بازگرداندن به‌روزرسانی گرفتید، از روشی که در Roll back 4.50.00 توضیح داده شده است استفاده کنید.

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

ترتیب به روز رسانی دستگاه ها در نصب Edge مهم است:

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

ارتقاء مستقل 1 گره

برای ارتقاء یک پیکربندی مستقل 1 گره به 4.50.00:

1. به روز رسانی تمام اجزا:

   /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

2. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را به روز کردید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

ارتقاء مستقل 2 گره

اجزای زیر را برای نصب مستقل 2 گره به روز کنید:

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

1. Cassandra و ZooKeeper را در دستگاه 1 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. Qpid و Postgres را در دستگاه 2 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile

3. به روز رسانی LDAP در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

4. به روز رسانی اجزای Edge در ماشین 2 و 1:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

5. به روز رسانی UI در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

6. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کردید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

7. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.

8. مؤلفه Edge UI را در دستگاه 1 مجدداً راه اندازی کنید:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقاء 5 گره

اجزای زیر را برای نصب 5 گره به روز کنید:

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

1. Cassandra و ZooKeeper را در دستگاه 1، 2 و 3 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. Qpid و Postgres را در دستگاه 4 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile

3. Qpid و Postgres را در دستگاه 5 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile

4. به روز رسانی LDAP در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

5. به روز رسانی اجزای Edge در دستگاه 4، 5، 1، 2، 3:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. به روز رسانی UI در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

7. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کردید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.

9. مؤلفه Edge UI را در دستگاه 1 مجدداً راه اندازی کنید:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقاء خوشه ای 9 گره

اجزای زیر را برای نصب خوشه ای 9 گره به روز کنید:

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

1. Cassandra و ZooKeeper را در دستگاه 1، 2 و 3 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. به روز رسانی Qpid در ماشین های 6 و 7:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. به روز رسانی Postgres در دستگاه 8:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. به روز رسانی Postgres در دستگاه 9:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5. به روز رسانی LDAP در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

6. اجزای Edge را در دستگاه 6، 7، 8، 9، 1، 4 و 5 به ترتیب به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

7. به روز رسانی UI در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

8. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کردید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.

10. مؤلفه Edge UI را در دستگاه 1 مجدداً راه اندازی کنید:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقاء خوشه ای 13 گره

مؤلفه های زیر را برای نصب خوشه ای 13 گره به روز کنید:

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

1. Cassandra و ZooKeeper را در ماشین‌های 1، 2 و 3 به‌روزرسانی کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. به روز رسانی Qpid در ماشین های 12 و 13:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. به روز رسانی Postgres در دستگاه 8:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. به روز رسانی Postgres در دستگاه 9:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5. به روز رسانی LDAP در دستگاه 4 و 5:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

6. اجزای Edge را در ماشین‌های 12، 13، 8، 9، 6، 7، 10 و 11 به ترتیب به‌روزرسانی کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

7. به روز رسانی UI در ماشین های 6 و 7:

   /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

8. (اگر apigee-adminapi نصب کرده اید) ابزار apigee-adminapi در ماشین های 6 و 7 به روز کردید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در ماشین های 6 و 7 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.

10. کامپوننت Edge UI را در ماشین‌های 6 و 7 مجدداً راه‌اندازی کنید:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقاء خوشه ای 12 گره

اجزای زیر را برای نصب خوشه ای 12 گره به روز کنید:

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

1. Cassandra و ZooKeeper را به روز کنید:
   1. در ماشین های 1، 2 و 3 در مرکز داده 1:

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

   2. در ماشین های 7، 8، و 9 در مرکز داده 2

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. به روز رسانی qpidd:
   1. Machines 4, 5 در مرکز داده 1
      1. به روز رسانی qpidd در ماشین 4:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. به روز رسانی qpidd در ماشین 5:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

   2. Machines 10, 11 in Data Center 2
      1. به روز رسانی qpidd در دستگاه 10:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. به روز رسانی qpidd در ماشین 11:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. به روز رسانی Postgres:
   1. ماشین 6 در مرکز داده 1

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

   2. ماشین 12 در مرکز داده 2

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. به روز رسانی LDAP:
   1. ماشین 1 در مرکز داده 1

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

   2. ماشین 7 در مرکز داده 2

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

5. به روز رسانی اجزای Edge:
   1. ماشین های 4، 5، 6، 1، 2، 3 در مرکز داده 1

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   2. ماشین های 10، 11، 12، 7، 8، 9 در مرکز داده 2

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. به روز رسانی UI:
   1. ماشین 1 در مرکز داده 1:

      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

   2. ماشین 7 در مرکز داده 2:

      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

   3. کامپوننت Edge UI را در ماشین‌های 1 و 7 مجدداً راه‌اندازی کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

7. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را به روز کردید:
   1. ماشین 1 در مرکز داده 1:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   2. ماشین 7 در مرکز داده 2:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را به روز کنید:
   1. ماشین 1 در مرکز داده 1:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   2. ماشین 7 در مرکز داده 2:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.

برای یک پیکربندی غیر استاندارد

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

1. باغ وحش
2. کاساندرا
3. qpidd، ps
4. LDAP
5. Edge، به معنای نمایه "-c edge" در تمام گره ها به ترتیب: گره های دارای سرور Qpid، سرور Edge Postgres، سرور مدیریت، پردازشگر پیام و روتر.
6. رابط کاربری لبه
7. apigee-adminapi
8. Apigee SSO

پس از اتمام به‌روزرسانی، حتماً مؤلفه Edge UI را در همه دستگاه‌هایی که آن را اجرا می‌کنند، مجدداً راه‌اندازی کنید.

این بخش نحوه انجام ارتقاء زیر را شرح می دهد:

• از 4.18.05 تا 4.50.00

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

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

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

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

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

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

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

پیش نیازها را به روز کنید

قبل از ارتقاء Apigee Edge به پیش نیازهای زیر توجه کنید:

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

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

• مطمئن شوید که Edge در حال اجرا است
  با استفاده از دستور زیر اطمینان حاصل کنید که Edge در طول فرآیند به‌روزرسانی فعال است:

  /opt/apigee/apigee-service/bin/apigee-all status

رابط کاربری جدید Edge

این بخش ملاحظات مربوط به رابط کاربری جدید Edge را فهرست می کند.

رابط کاربری Edge را نصب کنید

پس از اتمام نصب اولیه، Apigee توصیه می کند که رابط کاربری Edge را نصب کنید، که یک رابط کاربری پیشرفته برای توسعه دهندگان و مدیران Apigee Edge برای Private Cloud است.

برای اطلاعات بیشتر، به نصب رابط کاربری جدید Edge مراجعه کنید.

رابط کاربری Edge را به روز کنید

اگر نسخه بتا رابط کاربری Edge (که قبلاً به نام New Edge experience یا UE شناخته می‌شد) را در نسخه 4.18.05 نصب کرده‌اید، باید آن را حذف نصب کرده و نسخه 4.19.01، 4.19.06 یا 4.50.00 را نصب کنید. رابط کاربری Edge. برای اطلاعات بیشتر، به رابط کاربری جدید Edge برای Private Cloud مراجعه کنید.

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

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

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

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

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

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

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

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

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

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

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

کلید ارتقای زمان خاموشی صفر این است که هر روتر را یکی یکی از بار متعادل کننده حذف کنید. سپس روتر و هر جزء دیگر را در همان دستگاه روتر به روز می کنید و سپس روتر را دوباره به بار متعادل کننده اضافه می کنید.

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

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

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

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

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

به روز رسانی به 4.50.00 در یک گره با اتصال اینترنت خارجی

برای به روز رسانی اجزای Edge در یک گره از روش زیر استفاده کنید:

1. در صورت وجود، کارهای CRON را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده اند، تا زمانی که به روز رسانی کامل نشده است، غیرفعال کنید.
2. برای نصب Edge RPM به عنوان root وارد گره خود شوید.
3. yum-utils و yum-plugin-priorities را نصب کنید:

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. همانطور که در Install the Edge apigee-setup utility توضیح داده شد SELinux را غیرفعال کنید.
5. اگر روی Oracle 7.x نصب می‌کنید ، دستور زیر را اجرا کنید:

   sudo yum-config-manager --enable ol7_optional_latest

6. اگر روی AWS نصب می‌کنید ، دستورات yum-configure-manager زیر را اجرا کنید:

   yum update rh-amazon-rhui-client.noarch
   sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

7. فایل Edge 4.50.00 bootstrap_4.50.00.sh را در /tmp/bootstrap_4.50.00.sh دانلود کنید:

   curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

8. ابزار Edge 4.50.00 apigee-service و وابستگی ها را نصب کنید:

   sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

   جایی که uName:pWord نام کاربری و رمز عبوری است که از Apigee دریافت کرده‌اید. اگر pWord حذف کنید، از شما خواسته می شود آن را وارد کنید.

   به طور پیش فرض، نصب کننده بررسی می کند که جاوا 1.8 را نصب کرده اید. اگر این کار را نکنید، آن را برای شما نصب می کند. از گزینه JAVA_FIX برای تعیین نحوه مدیریت نصب جاوا استفاده کنید. JAVA_FIX مقادیر زیر را می گیرد:

   • I : OpenJDK 1.8 (پیش‌فرض) را نصب کنید.
   • C : بدون نصب جاوا ادامه دهید.
   • Q : ترک برای این گزینه باید خود جاوا را نصب کنید.
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. همانطور که مثال زیر نشان می دهد، ابزار apigee-provision را در سرور مدیریت به روز کنید:

    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

12. برنامه update را بر روی گره های خود به ترتیبی که در ترتیب به روز رسانی ماشین توضیح داده شده است اجرا کنید:

    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    جایی که component کامپوننت Edge برای به روز رسانی است. مقادیر ممکن عبارتند از:

    • «cs»: کاساندرا
    • "edge": تمام اجزای Edge به جز Edge UI: سرور مدیریت، پردازشگر پیام، روتر، سرور QPID، سرور Postgres
    • "ldap": OpenLDAP
    • "ps": postgresql
    • « قپید » : qpidd
    • "sso": Apigee SSO (اگر SSO را نصب کرده باشید)
    • "ui": رابط کاربری Edge
    • «زک»: نگهبان باغ وحش

    و configFile همان فایل پیکربندی است که برای تعریف اجزای Edge خود در هنگام نصب 4.18.05 استفاده کردید.

    می‌توانید update.sh روی همه مؤلفه‌ها با تنظیم component روی «all» اجرا کنید، اما فقط در صورتی که نمایه نصب Edge all-in-one (aio) داشته باشید. به عنوان مثال:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config

13. اگر قبلاً این کار را نکرده‌اید، مؤلفه Edge UI را در تمام گره‌هایی که آن را اجرا می‌کنند، مجدداً راه‌اندازی کنید:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

14. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.

اگر بعداً تصمیم به بازگرداندن به‌روزرسانی گرفتید، از روشی که در Roll back 4.50.00 توضیح داده شده است استفاده کنید.

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

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

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

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

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

1. یک مخزن محلی 4.50.00 همانطور که در "ایجاد یک مخزن محلی Apigee" در نصب ابزار Edge apigee-setup توضیح داده شده است، ایجاد کنید.
2. برای نصب apigee-service از فایل tar :
   1. در گره دارای مخزن محلی، از دستور زیر برای بسته بندی مخزن محلی در یک فایل .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.50.00.tar.gz استفاده کنید:

      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

   2. فایل tar را در گره ای که می خواهید Edge را به روز کنید کپی کنید. به عنوان مثال، آن را در پوشه /tmp در گره جدید کپی کنید.
   3. در گره جدید، فایل را در پوشه /tmp untar کنید:

      tar -xzf apigee-4.50.00.tar.gz

      این دستور یک دایرکتوری جدید به نام repos در دایرکتوری حاوی فایل tar ایجاد می کند. به عنوان مثال /tmp/repos .

   4. ابزار و وابستگی های Edge apigee-service از /tmp/repos نصب کنید:

      sudo bash /tmp/repos/bootstrap_4.50.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      توجه داشته باشید که مسیر دایرکتوری repos را در این دستور قرار داده اید.

3. برای نصب apigee-service با استفاده از وب سرور Nginx:
   1. وب سرور Nginx را همانطور که در «نصب از مخزن با استفاده از وب سرور Nginx» در نصب ابزار Edge apigee-setup توضیح داده شده پیکربندی کنید.
   2. در گره راه دور، فایل Edge bootstrap_4.50.00.sh را در /tmp/bootstrap_4.50.00.sh دانلود کنید:

      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

      که در آن uName:pWord نام کاربری و رمز عبوری است که قبلاً برای مخزن تنظیم کرده‌اید و remoteRepo آدرس IP یا نام DNS گره repo است.

   3. در گره راه دور، ابزار Edge apigee-setup و وابستگی ها را نصب کنید:

      sudo bash /tmp/bootstrap_4.50.00.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. برنامه update را بر روی گره های خود به ترتیبی که در ترتیب به روز رسانی ماشین توضیح داده شده است اجرا کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

   کجا:

   • component کامپوننت Edge برای به روز رسانی است. شما معمولاً مؤلفه های زیر را به روز می کنید:
     • "cs": کاساندرا
     • "edge": همه اجزای Edge به جز Edge UI. جزء "لبه" شامل سرور مدیریت، پردازشگر پیام، روتر، سرور QPID و سرور Edge Postgres است.
     • "ldap": OpenLDAP
     • "ps": postgresql
     • « قپید » : qpidd
     • "sso": Apigee SSO (اگر SSO را نصب کرده باشید)
     • "ui": رابط کاربری Edge
     • «زک»: نگهبان باغ وحش
   • configFile همان فایل پیکربندی است که برای تعریف اجزای Edge خود در هنگام نصب 4.18.05 استفاده کردید.

   می‌توانید با تنظیم component روی «all» update.sh روی همه مؤلفه‌ها اجرا کنید، اما فقط در صورتی که نمایه نصب Edge all-in-one (AIO) داشته باشید. به عنوان مثال:

   /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config

8. اگر قبلاً این کار را نکرده‌اید، مؤلفه Edge UI را در تمام گره‌هایی که آن را اجرا می‌کنند، مجدداً راه‌اندازی کنید:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

9. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.

اگر بعداً تصمیم به بازگرداندن به‌روزرسانی گرفتید، از روشی که در Roll back 4.50.00 توضیح داده شده است استفاده کنید.

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

ترتیب به روز رسانی دستگاه ها در نصب Edge مهم است:

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

ارتقاء مستقل 1 گره

برای ارتقاء یک پیکربندی مستقل 1 گره به 4.50.00:

1. به روز رسانی تمام اجزا:

   /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

2. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را به روز کردید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

ارتقاء مستقل 2 گره

اجزای زیر را برای نصب مستقل 2 گره به روز کنید:

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

1. Cassandra و ZooKeeper را در دستگاه 1 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. Qpid و Postgres را در دستگاه 2 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile

3. به روز رسانی LDAP در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

4. به روز رسانی اجزای Edge در ماشین 2 و 1:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

5. به روز رسانی UI در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

6. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کردید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

7. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.

8. مؤلفه Edge UI را در دستگاه 1 مجدداً راه اندازی کنید:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقاء 5 گره

اجزای زیر را برای نصب 5 گره به روز کنید:

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

1. Cassandra و ZooKeeper را در دستگاه 1، 2 و 3 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. Qpid و Postgres را در دستگاه 4 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile

3. Qpid و Postgres را در دستگاه 5 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile

4. به روز رسانی LDAP در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

5. به روز رسانی اجزای Edge در دستگاه 4، 5، 1، 2، 3:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. به روز رسانی UI در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

7. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کردید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.

9. مؤلفه Edge UI را در دستگاه 1 مجدداً راه اندازی کنید:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقاء خوشه ای 9 گره

اجزای زیر را برای نصب خوشه ای 9 گره به روز کنید:

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

1. Cassandra و ZooKeeper را در دستگاه 1، 2 و 3 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. به روز رسانی Qpid در ماشین های 6 و 7:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. به روز رسانی Postgres در دستگاه 8:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. به روز رسانی Postgres در دستگاه 9:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5. به روز رسانی LDAP در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

6. اجزای Edge را در دستگاه 6، 7، 8، 9، 1، 4 و 5 به ترتیب به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

7. به روز رسانی UI در دستگاه 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

8. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کردید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.

10. مؤلفه Edge UI را در دستگاه 1 مجدداً راه اندازی کنید:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقاء خوشه ای 13 گره

مؤلفه های زیر را برای نصب خوشه ای 13 گره به روز کنید:

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

1. Cassandra و ZooKeeper را در ماشین‌های 1، 2 و 3 به‌روزرسانی کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. به روز رسانی Qpid در ماشین های 12 و 13:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. به روز رسانی Postgres در دستگاه 8:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. به روز رسانی Postgres در دستگاه 9:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5. به روز رسانی LDAP در دستگاه 4 و 5:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

6. اجزای Edge را در ماشین‌های 12، 13، 8، 9، 6، 7، 10 و 11 به ترتیب به‌روزرسانی کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

7. به روز رسانی UI در ماشین های 6 و 7:

   /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

8. (اگر apigee-adminapi نصب کرده اید) ابزار apigee-adminapi در ماشین های 6 و 7 به روز کردید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در ماشین های 6 و 7 به روز کنید:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.

10. کامپوننت Edge UI را در ماشین‌های 6 و 7 مجدداً راه‌اندازی کنید:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقاء خوشه ای 12 گره

اجزای زیر را برای نصب خوشه ای 12 گره به روز کنید:

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

1. Cassandra و ZooKeeper را به روز کنید:
   1. در ماشین های 1، 2 و 3 در مرکز داده 1:

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

   2. در ماشین های 7، 8، و 9 در مرکز داده 2

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. به روز رسانی qpidd:
   1. Machines 4, 5 در مرکز داده 1
      1. به روز رسانی qpidd در ماشین 4:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. به روز رسانی qpidd در ماشین 5:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

   2. Machines 10, 11 in Data Center 2
      1. به روز رسانی qpidd در دستگاه 10:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. به روز رسانی qpidd در ماشین 11:

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. به روز رسانی Postgres:
   1. ماشین 6 در مرکز داده 1

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

   2. ماشین 12 در مرکز داده 2

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. به روز رسانی LDAP:
   1. ماشین 1 در مرکز داده 1

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

   2. ماشین 7 در مرکز داده 2

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

5. به روز رسانی اجزای Edge:
   1. ماشین های 4، 5، 6، 1، 2، 3 در مرکز داده 1

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   2. ماشین های 10، 11، 12، 7، 8، 9 در مرکز داده 2

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. به روز رسانی UI:
   1. ماشین 1 در مرکز داده 1:

      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

   2. ماشین 7 در مرکز داده 2:

      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

   3. کامپوننت Edge UI را در ماشین‌های 1 و 7 مجدداً راه‌اندازی کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

7. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را به روز کردید:
   1. ماشین 1 در مرکز داده 1:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   2. ماشین 7 در مرکز داده 2:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را به روز کنید:
   1. ماشین 1 در مرکز داده 1:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   2. ماشین 7 در مرکز داده 2:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.

برای یک پیکربندی غیر استاندارد

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

1. باغ وحش
2. کاساندرا
3. qpidd، ps
4. LDAP
5. Edge، به معنای نمایه "-c edge" در تمام گره ها به ترتیب: گره های دارای سرور Qpid، سرور Edge Postgres، سرور مدیریت، پردازشگر پیام و روتر.
6. رابط کاربری لبه
7. apigee-adminapi
8. Apigee SSO

پس از اتمام به‌روزرسانی، حتماً مؤلفه Edge UI را در همه دستگاه‌هایی که آن را اجرا می‌کنند، مجدداً راه‌اندازی کنید.