این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

به روز رسانی Apigee Edge 4.51.00 یا 4.52.00 به 4.52.01

Apigee از ارتقاء Edge برای Private Cloud از نسخه 4.51.00 یا نسخه 4.52.00 به طور مستقیم به نسخه 4.52.01 پشتیبانی می کند. این صفحه نحوه انجام هر یک از ارتقاء را شرح می دهد.

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

شخصی که آپدیت را اجرا می کند باید همان شخصی باشد که Edge را در ابتدا نصب کرده است یا شخصی که به عنوان روت اجرا می شود.

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

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

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

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

قبل از ارتقاء Apigee Edge از پیش نیازهای زیر اطمینان حاصل کنید:

پشتیبان گیری از تمام گره ها
قبل از به‌روزرسانی، توصیه می‌کنیم به دلایل ایمنی یک نسخه پشتیبان کامل از تمام گره‌ها انجام دهید. از رویه نسخه فعلی Edge برای انجام پشتیبان استفاده کنید.
این به شما این امکان را می دهد که یک برنامه پشتیبان داشته باشید، در صورتی که به روز رسانی به نسخه جدید به درستی کار نمی کند. برای اطلاعات بیشتر در مورد پشتیبان‌گیری، به پشتیبان‌گیری و بازیابی مراجعه کنید.
مطمئن شوید که Edge در حال اجرا است
با استفاده از دستور زیر اطمینان حاصل کنید که Edge در طول فرآیند به‌روزرسانی فعال است:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
اطمینان حاصل کنید که استراتژی Comptification Cassandra LeveledCompactionStrategy است
اطمینان حاصل کنید که استراتژی سازگاری Cassandra روی LeveledCompactionStrategy تنظیم شده است، همانطور که در تغییر استراتژی فشرده سازی Cassandra توضیح داده شده است.

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

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

ارتقاء لازم به Zookeeper 3.8.3

این نسخه از Edge برای Private Cloud شامل ارتقاء به Zookeeper 3.8.3 است. به عنوان بخشی از این ارتقا، تمام داده های Zookeeper به Zookeeper 3.8.3 منتقل می شود.

قبل از ارتقاء Zookeeper، راهنمای نگهداری Zookeeper را مطالعه کنید. اکثر سیستم‌های تولید Edge از دسته‌ای از گره‌های Zookeeper استفاده می‌کنند که در چندین مرکز داده پخش شده‌اند. برخی از این گره ها به عنوان رای دهندگانی که در انتخابات رهبر Zookeeper شرکت می کنند پیکربندی می شوند و بقیه به عنوان ناظر پیکربندی می شوند. برای جزئیات بیشتر ، درباره رهبران، پیروان، رأی دهندگان و ناظران را ببینید. گره‌های رای‌دهنده یک رهبر را انتخاب می‌کنند که پس از آن گره‌های رای‌دهنده خود پیرو می‌شوند.

در طول فرآیند به روز رسانی، زمانی که گره رهبر خاموش می شود، ممکن است تاخیر لحظه ای یا شکست نوشتن در Zookeeper وجود داشته باشد. این می‌تواند بر عملیات مدیریتی که در Zookeeper نوشته می‌شود، مانند عملیات استقرار یک پروکسی، و تغییرات زیرساخت Apigee، مانند اضافه کردن یا حذف یک پردازشگر پیام، و غیره تأثیر بگذارد. API های مدیریت تماس) در حین ارتقاء Zookeeper در حالی که از روش زیر پیروی می کنید.

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

بک آپ بگیرید

یک نسخه پشتیبان از تمام گره های Zookeeper برای استفاده در صورت نیاز به عقب نشینی بگیرید. توجه داشته باشید که یک بازگشت، Zookeeper را به حالتی که در زمان تهیه نسخه پشتیبان تهیه شده بود، باز می‌گرداند. توجه: هر گونه استقرار یا تغییر زیرساخت در Apigee از زمان تهیه نسخه پشتیبان (که اطلاعات آن در Zookeeper ذخیره می شود) در طول بازیابی از بین می رود.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

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

رهبر، پیروان و ناظران را شناسایی کنید

توجه: دستورات نمونه زیر از ابزار nc برای ارسال داده ها به Zookeeper استفاده می کنند. می توانید از ابزارهای جایگزین برای ارسال داده ها به Zookeeper نیز استفاده کنید.

اگر روی گره ZooKeeper نصب نشده است، nc را نصب کنید:
```
  sudo yum install nc
```
دستور nc زیر را روی گره اجرا کنید، جایی که 2181 پورت ZooKeeper است:
```
  echo stat | nc localhost 2181
```
شما باید خروجی را مانند زیر ببینید:
```
  Zookeeper version: 3.8.3-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597
```
در خط Mode خروجی گره‌ها، بسته به پیکربندی گره، باید مشاهده‌گر، رهبر یا دنبال‌کننده (به معنای رأی‌دهنده‌ای که رهبر نیست) را ببینید. توجه: در نصب مستقل Edge با یک گره ZooKeeper، Mode روی حالت مستقل تنظیم می شود.
مراحل 1 و 2 را در هر گره ZooKeeper تکرار کنید.

Zookeeper را در گره های مشاهده گر و دنبال کننده ارتقا دهید

Zookeeper را در هر یک از گره های مشاهده گر و دنبال کننده به صورت زیر ارتقا دهید:

بوت استرپ Edge را برای Private Cloud 4.52 دانلود و اجرا کنید، همانطور که در به روز رسانی به 4.52.01 در یک گره با اتصال اینترنت خارجی توضیح داده شده است. بسته به اینکه گره اتصال اینترنت خارجی داشته باشد یا نصب آفلاین را انجام می دهید، روند احتمالاً متفاوت خواهد بود.
مولفه Zookeeper را ارتقا دهید:
```
  /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
```
توجه: اگر این گره ها مؤلفه های دیگری را نصب کرده اند (مانند Cassandra)، می توانید آنها را هم اکنون ارتقا دهید (مانند پروفایل cs,zk) یا می توانید سایر مؤلفه ها را بعداً ارتقا دهید. Apigee توصیه می‌کند که ابتدا Zookeeper را ارتقا دهید و قبل از ارتقای سایر مؤلفه‌ها، مطمئن شوید که خوشه شما به درستی کار می‌کند.
مراحل بالا را در هر یک از گره های ناظر و پیرو Zookeeper تکرار کنید.

رهبر را خاموش کنید

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

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

توجه داشته باشید که در طول این رویداد، قبل از انتخاب یک رهبر جدید، ممکن است تاخیرهای لحظه ای یا شکست در نوشتن در Zookeeper رخ دهد. این می‌تواند بر عملیات‌هایی که در Zookeeper نوشته می‌شوند، مانند عملیات استقرار پراکسی‌ها یا تغییرات زیرساخت Apigee، مانند افزودن یا حذف پردازنده‌های پیام و غیره تأثیر بگذارد.

بررسی کنید که رهبر جدید انتخاب شده است

با استفاده از مراحل موجود در بخش شناسایی رهبر، پیروان و ناظران در بالا، تأیید کنید که یک رهبر جدید از بین پیروان انتخاب شده است، پس از توقف رهبر موجود. توجه داشته باشید که رهبر می توانست در یک مرکز داده متفاوت از رهبر فعلی انتخاب شود.

ارتقا رهبر

همان مراحلی را که در Upgrading Zookeeper در گره‌های مشاهده‌گر و دنبال‌کننده بالا انجام دادید، دنبال کنید.

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

بازگشت به عقب

در صورت نیاز به بازگشت:

ابتدا مراحل بازگشت را روی ناظران و پیروان انجام دهید.
بوت استرپ نسخه ای را که در حال بازگشت به آن هستید دانلود و اجرا کنید—چه 4.50 یا 4.51. بسته به اینکه گره اتصال اینترنت خارجی داشته باشد یا نصب آفلاین را دنبال می کنید، روند احتمالاً متفاوت خواهد بود.
اگر Zookeeper روی گره اجرا می شود، آن را متوقف کنید:
```
  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
```

حذف نصب باغ وحش موجود:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

Zookeeper را طبق معمول نصب کنید:

  /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

هنگامی که همه دنبال کنندگان و ناظران به عقب برگشتند، با دنبال کردن مراحل 2 تا 5 در گره رهبر، گره رهبر را به عقب برگردانید.
بعد از اینکه همه گره ها به عقب برگشتند، سلامت خوشه را بررسی کنید و مطمئن شوید که یک گره رهبر در خوشه وجود دارد.

بازیابی نسخه پشتیبان

به بازیابی از پشتیبان مراجعه کنید. توجه داشته باشید که نسخه‌های پشتیبان Zookeeper از نسخه‌های قبلی Edge برای Private Cloud مانند 4.50 و 4.51 باید با نسخه Zookeeper در Edge برای Private Cloud 4.52 سازگار باشد.

ارتقاء مورد نیاز به Postgres 14

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

اگر از Edge برای Private Cloud 4.51.00 به 4.52.01 ارتقا می دهید، لازم است مراحل ارتقاء Postgres اضافی را دنبال کنید. اگر از نسخه 4.51.00 به 4.52.01 ارتقا می دهید، به بخش Required upgrade به Postgres 14 مراجعه کنید.
اگر از Edge برای Private Cloud 4.52.00 به 4.52.01 ارتقا می دهید، هیچ مرحله تکمیلی ارتقا Postgres لازم نیست.

Qpid را ارتقا دهید

این نسخه Edge برای Private Cloud شامل ارتقاء Qpid J-Broker است.

الزامات جدید معرفی شده توسط apigee-qpidd-4.52.01-XXX: از نسخه 4.52.01، نیازمندی های جدیدی در حین نصب معرفی شده است. مطمئن شوید که ویژگی های QPID_MGMT_USERNAME و QPID_MGMT_PASSWORD را در فایل پیکربندی قرار دهید. اطمینان حاصل کنید که این ویژگی ها با مقادیر مناسب برای تسهیل نصب موفقیت آمیز اضافه شده اند.

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

ارتقاء در محل با توقف صفر
راه اندازی یک گره Qpid جدید

ارتقاء در محل با توقف صفر

این روش مطمئن می‌شود که هیچ خرابی برای محیط اجرا Edge شما وجود ندارد و از دست دادن داده‌های زمان اجرا، در صورت وجود، برای تجزیه و تحلیل به حداقل می‌رسد.

پیش نیاز: قبل از شروع ارتقاء Qpid مطمئن شوید که edge-message-processor ، edge-management-server و edge-qpid-server ارتقا داده شده اند.

برای انجام یک ارتقاء در محل بدون توقف به Qpid:

برای شروع یک گره Qpid را انتخاب کنید.
کارگزار Qpid را در گره متوقف کنید:
```
apigee-service apigee-qpidd stop
```
با اعمال یک فایروال، ترافیک ورودی در پورت کارگزار 5672 را از تمام پردازشگرهای پیام مسدود کنید. شما می توانید این فایروال را در سطح نمونه گره Qpid یا سایر اجزای فایروال/شبکه خارجی اعمال کنید.
توصیه می‌کنیم برای تمام آدرس‌های IP پردازشگر پیام، همین مرحله را انجام دهید. به عنوان مثال، برای DROP درخواست‌هایی که از آدرس‌های IP پردازنده پیام به گره Qpid در پورت 5672 با استفاده از IPTables می‌آیند، می‌توانید از دستوری مانند این استفاده کنید:
```
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
```
کارگزار Qpid را دوباره راه اندازی کنید تا پیام های موجود را تخلیه کنید، در صورت وجود:
```
apigee-service apigee-qpidd start
```
بررسی کنید که صف های موجود خالی باشند:
```
qpid-stat -q
```
اگر پیام‌ها در صف حرف مرده (DLQ) (ax-q-axgroup-001-consumer-group-001-dl) گیر کرده‌اند، سپس صف را با استفاده از مراحل حل کردن داده‌های تحلیلی که در صف حرف مرده گیر کرده‌اند خالی کنید.
پس از اتمام تأیید صف‌ها در گره قدیمی، apigee-qpidd را متوقف کنید:
```
apigee-service apigee-qpidd stop
```

Qpid را در گره ارتقا دهید:

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

راه اندازی مجدد edge-qpid-server :
```
apigee-service edge-qpid-server restart
```
قانون فایروال اعمال شده در مرحله 3 را حذف کنید.
همان مرحله حذف را برای تمام آدرس های IP پردازشگر پیام که فایروال روی آنها اعمال شده است، انجام دهید. پس از حذف فایروال‌ها، درخواست‌هایی که از آدرس‌های IP پردازنده پیام به گره Qpid در پورت 5672 می‌آیند پذیرفته می‌شوند. اگر iptables برای اضافه کردن فایروال، حذف فایروال و فهرست کردن تنظیمات موجود استفاده کرده اید، می توانید از دستوراتی مانند زیر استفاده کنید:
```
iptables -F
  iptables -L
```
از مانیتورینگ وب برای تأیید اینکه صف های Qpid در حال دریافت پیام هستند استفاده کنید:
```
http://QPID_NODE_IP:8090
```
مرحله 1 تا 9 را برای هر گره Qpid تکرار کنید.

راه اندازی یک گره Qpid جدید

این متد apigee-qpidd و edge-qpid-server بر روی یک گره جدید راه اندازی و نصب می کند.

یک گره Qpid جدید اضافه کنید. این مرحله یک گره Qpid را با J-broker تنظیم می کند. برای جزئیات مراحل، به افزودن سرور Qpid مراجعه کنید.
یک گره Qpid موجود (یک گره از نسخه ای که از آن ارتقا می دهید) را انتخاب کنید.
کارگزار Qpid را در گره متوقف کنید:
```
apigee-service apigee-qpidd stop
```
با اعمال یک فایروال، ترافیک ورودی در پورت کارگزار 5672 را از تمام پردازشگرهای پیام مسدود کنید. شما می توانید این فایروال را در سطح نمونه گره Qpid یا سایر اجزای فایروال/شبکه خارجی اعمال کنید.
توصیه می‌کنیم برای تمام آدرس‌های IP پردازشگر پیام، همین مرحله را انجام دهید. به عنوان مثال، برای DROP درخواست‌هایی که از آدرس‌های IP پردازنده پیام به گره Qpid در پورت 5672 با استفاده از IPTables می‌آیند، می‌توانید از دستوری مانند این استفاده کنید:
```
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
```
کارگزار Qpid را دوباره راه اندازی کنید تا پیام های موجود را تخلیه کنید، در صورت وجود:
```
apigee-service apigee-qpidd start
```
بررسی کنید تا مطمئن شوید که صف های موجود خالی هستند:
```
qpid-stat -q
```
اگر پیام‌ها در صف حرف مرده (DLQ) (ax-q-axgroup-001-consumer-group-001-dl) گیر کرده‌اند، با دنبال کردن مراحل در مبحث عیب‌یابی ، داده‌های تحلیلی که در صف حرف مرده Qpidd گیر کرده‌اند، صف را خالی کنید.
پس از اتمام تأیید صف‌ها در گره قدیمی، apigee-qpidd را متوقف کنید.
```
apigee-service apigee-qpidd stop
```
با دنبال کردن مراحل حذف یک سرور Qpid، گره Qpid قدیمی را لغو ثبت کنید.
اضافه کردن یک گره جدید و حذف یک گره قدیمی، یکی یکی، تا زمانی که تمام گره های Qpid ارتقا داده شوند، ادامه دهید.

بازگشت به عقب

توجه: ابتدا apigee-qpidd به عقب برگردانید، قبل از اینکه بخواهید سایر اجزای Edge را برگردانید ( edge-qpid-server ، edge-message-processor ، edge-management-server ).

برای بازگشت به نسخه قبلی ویژگی، مطمئن شوید که فایل bootstrap.sh را برای نسخه ای که می خواهید به آن برگردانید دانلود کنید. برای بازگشت به نسخه 4.52.00، bootstrap_4.52.00.sh دانلود کنید.

برای بازگرداندن Qpid، این مراحل را در همه میزبان های Qpid دنبال کنید:

کارگزار Qpid موجود را متوقف کنید
```
apigee-service apigee-qpidd stop
```
با اعمال یک فایروال، ترافیک ورودی در پورت کارگزار 5672 را از تمام پردازشگرهای پیام مسدود کنید. شما می توانید این فایروال را در سطح نمونه گره Qpid یا سایر اجزای فایروال/شبکه خارجی اعمال کنید.
توصیه می‌کنیم برای تمام آدرس‌های IP پردازشگر پیام، همین مرحله را انجام دهید. به عنوان مثال، برای DROP درخواست‌هایی که از آدرس‌های IP پردازنده پیام به گره Qpid در پورت 5672 با استفاده از IPTables می‌آیند، می‌توانید از دستوری مانند این استفاده کنید:
```
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
```
کارگزار qpid را دوباره راه اندازی کنید تا در صورت وجود پیام های موجود تخلیه شود:
```
apigee-service apigee-qpidd start
```
مطمئن شوید که صف های موجود خالی هستند. برای بررسی، وارد پورتال مدیریت Qpid شوید:
```
http://QPID_NODE_IP:8090
```
توجه: در صورتی که این پورت 8090 در گره QPID قابل دسترسی نباشد، می توانید از مکانیسم های جایگزین مانند ارسال پورت SSH برای دسترسی به این URL استفاده کنید.
پس از اتمام تأیید صف‌ها، Qpid را متوقف و حذف نصب کنید:
```
apigee-service apigee-apidd uninstall
```
دایرکتوری داده Qpid را حذف کنید:
```
rm -r APIGEE_ROOT/data/apigee-qpidd
```

بروکر Qpid را دوباره نصب کنید:

/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile

هنگامی که بروکر Qpid دوباره نصب شد تنظیمات فایروال را حذف کنید و تنظیمات موجود را با استفاده از دستورات زیر فهرست کنید:
```
iptables -F
```
```
iptables -L
```

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

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

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

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

توجه داشته باشید که رابط کاربری Edge نیاز دارد که احراز هویت پایه را غیرفعال کنید و از یک IDP مانند SAML یا LDAP استفاده کنید.

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

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

برای به‌روزرسانی مؤلفه Edge UI، نسخه Edge را برای Private Cloud که از آن ارتقا می‌دهید در نظر بگیرید:

از 4.51.00 تا 4.52.00 (با رابط کاربری Edge جدید از قبل نصب شده): از دستورالعمل های ارتقاء در این بخش برای مؤلفه edge-management-ui استفاده کنید.

به روز رسانی با Apigee mTLS

برای به‌روزرسانی Apigee mTLS ، مراحل زیر را انجام دهید:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

در صورت وجود، هر cron job پیکربندی شده برای انجام عملیات تعمیر در Cassandra را تا زمانی که به‌روزرسانی کامل نشده است، غیرفعال کنید.
برای نصب Edge RPM به عنوان root وارد گره خود شوید.
توجه: در حالی که نصب RPM به دسترسی ریشه نیاز دارد، می‌توانید پیکربندی Edge را بدون دسترسی ریشه انجام دهید.
yum-utils و yum-plugin-priorities را نصب کنید:
توجه: اگر سیستم عامل شما RHEL 8.0 - 8.6 است، از این مرحله صرفنظر کنید.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
همانطور که در Install the Edge apigee-setup utility توضیح داده شد SELinux را غیرفعال کنید.
اگر روی Oracle 7.x نصب می‌کنید ، دستور زیر را اجرا کنید:
```
sudo yum-config-manager --enable ol7_optional_latest
```

اگر روی 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

اگر در حال حاضر در Edge 4.51.00 هستید:
1. فایل Edge bootstrap_4.52.01.sh را در /tmp/bootstrap_4.52.01.sh دانلود کنید:
```
curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
```
2. ابزار و وابستگی های Edge 4.52.01 apigee-service را با اجرای دستور زیر نصب کنید:
```
sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
```
  جایی که uName:pWord نام کاربری و رمز عبوری است که از Apigee دریافت کرده‌اید. اگر pWord حذف کنید، از شما خواسته می شود آن را وارد کنید.
  به طور پیش فرض، نصب کننده بررسی می کند که جاوا 1.8 را نصب کرده اید. اگر این کار را نکنید، نصب کننده آن را برای شما نصب می کند.
  از گزینه JAVA_FIX برای تعیین نحوه مدیریت نصب جاوا استفاده کنید. JAVA_FIX مقادیر زیر را می گیرد:
  - I : OpenJDK 1.8 (پیش‌فرض) را نصب کنید.
  - C : بدون نصب جاوا ادامه دهید.
  - Q : ترک برای این گزینه باید خود جاوا را نصب کنید.
3. همانطور که در مثال زیر نشان داده شده است، از apigee-service برای به روز رسانی ابزار apigee-setup استفاده کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. همانطور که مثال زیر نشان می دهد، ابزار apigee-validate را در سرور مدیریت به روز کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. همانطور که مثال زیر نشان می دهد، ابزار apigee-provision را در سرور مدیریت به روز کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
6. با اجرای دستور زیر update را بر روی گره های خود اجرا کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  این کار را به ترتیبی که در Order of machine update توضیح داده شده است انجام دهید.
  کجا:
  - component کامپوننت Edge برای به روز رسانی است. مقادیر ممکن عبارتند از:
    - cs : کاساندرا
    - edge : همه اجزای Edge به جز Edge UI: سرور مدیریت، پردازشگر پیام، روتر، سرور QPID، سرور Postgres
    - ldap : OpenLDAP
    - ps : postgresql
    - qpid : qpidd
    - sso : Apigee SSO (اگر SSO را نصب کرده باشید)
    - ue : رابط کاربری جدید Edge
    - ui : رابط کاربری کلاسیک Edge
    - zk : نگهبان باغ وحش
  - configFile همان فایل پیکربندی است که برای تعریف اجزای Edge خود در هنگام نصب 4.50.00 یا 4.51.00 استفاده کردید.
  می‌توانید با تنظیم component روی «all»، update.sh روی همه مؤلفه‌ها اجرا کنید، اما فقط در صورتی که نمایه نصب Edge all-in-one (AIO) داشته باشید. به عنوان مثال:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. اگر قبلاً این کار را نکرده‌اید، مؤلفه‌های رابط کاربری Edge را در تمام گره‌هایی که آنها را اجرا می‌کنند، مجدداً راه‌اندازی کنید:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
8. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.

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

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

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

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

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

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

یک مخزن محلی 4.52.01 همانطور که در "ایجاد یک مخزن محلی Apigee" در نصب ابزار Edge apigee-setup توضیح داده شده است، ایجاد کنید.
توجه: اگر قبلاً یک مخزن موجود دارید، می‌توانید مخزن 4.52.01 را همانطور که در «به‌روزرسانی یک مخزن محلی Apigee» در نصب ابزار Edge apigee-setup توضیح داده شده است، به آن اضافه کنید.
برای نصب apigee-service از فایل tar :
1. در گره دارای مخزن محلی، از دستور زیر برای بسته بندی مخزن محلی در یک فایل .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.52.01.tar.gz استفاده کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
2. فایل tar را در گره ای که می خواهید Edge را به روز کنید کپی کنید. به عنوان مثال، آن را در پوشه /tmp در گره جدید کپی کنید.
3. در گره جدید، فایل را در پوشه /tmp untar کنید:
```
tar -xzf apigee-4.52.01.tar.gz
```
  این دستور یک دایرکتوری جدید به نام repos در دایرکتوری حاوی فایل tar ایجاد می کند. به عنوان مثال /tmp/repos .
4. ابزار و وابستگی های Edge apigee-service را از /tmp/repos نصب کنید:
```
sudo bash /tmp/repos/bootstrap_4.52.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
  توجه داشته باشید که مسیر دایرکتوری repos را در این دستور قرار داده اید.
برای نصب apigee-service با استفاده از وب سرور Nginx:
1. وب سرور Nginx را همانطور که در «نصب از مخزن با استفاده از وب سرور Nginx» در نصب ابزار Edge apigee-setup توضیح داده شده پیکربندی کنید.
2. در گره راه دور، فایل Edge bootstrap_4.52.01.sh را در /tmp/bootstrap_4.52.01.sh دانلود کنید:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
```
  که در آن uName:pWord نام کاربری و رمز عبوری است که قبلاً برای مخزن تنظیم کرده‌اید و remoteRepo آدرس IP یا نام DNS گره repo است.
3. در گره راه دور، ابزار Edge apigee-setup و وابستگی ها را نصب کنید:
```
sudo bash /tmp/bootstrap_4.52.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
  جایی که uName:pWord نام کاربری و رمز عبور مخزن است.
همانطور که در مثال زیر نشان داده شده است، از apigee-service برای به روز رسانی ابزار apigee-setup استفاده کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
همانطور که مثال زیر نشان می دهد، ابزار apigee-validate را در سرور مدیریت به روز کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
همانطور که مثال زیر نشان می دهد، ابزار apigee-provision را در سرور مدیریت به روز کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
برنامه 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
  - qpid : qpidd
  - sso : Apigee SSO (اگر SSO را نصب کرده باشید)
  - ue New Edge UI
  - ui : رابط کاربری کلاسیک Edge
  - zk : نگهبان باغ وحش
- configFile همان فایل پیکربندی است که برای تعریف اجزای Edge خود در هنگام نصب 4.50.00 یا 4.51.00 استفاده کردید.
  توجه: فایل پیکربندی باید توسط کاربر "apigee" قابل خواندن باشد. برای تغییر مالک از دستور زیر استفاده کنید:
```
chown apigee:apigee configFile
```
می‌توانید با تنظیم component روی «all»، update.sh روی همه مؤلفه‌ها اجرا کنید، اما فقط در صورتی که نمایه نصب Edge all-in-one (AIO) داشته باشید. به عنوان مثال:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
اگر قبلاً این کار را نکرده‌اید، مؤلفه‌های UI را در تمام گره‌هایی که آن را اجرا می‌کنند، راه‌اندازی مجدد کنید:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.

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

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

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

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

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

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

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

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

(اگر apigee-adminapi نصب کرده اید) ابزار apigee-adminapi را به روز کردید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

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

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

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

Cassandra و ZooKeeper را در دستگاه 1 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

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

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

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

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

به روز رسانی اجزای Edge در ماشین 2 و 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

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

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

رابط کاربری را در دستگاه 1 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
(اگر apigee-adminapi نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کردید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.
مؤلفه Edge UI را در دستگاه 1 مجدداً راه اندازی کنید:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```

ارتقاء 5 گره

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

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

Cassandra و ZooKeeper را در دستگاه 1، 2 و 3 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

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

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

به روز رسانی Postgres در دستگاه 5:

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

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

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

به روز رسانی اجزای Edge در دستگاه 4، 5، 1، 2، 3:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

به روز رسانی Qpid در دستگاه 4:

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

به روز رسانی Qpid در دستگاه 5:

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

رابط کاربری Edge را به روز کنید:
- رابط کاربری کلاسیک: اگر از رابط کاربری کلاسیک استفاده می کنید، همانطور که در مثال زیر نشان می دهد، مؤلفه ui را در دستگاه 1 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
- رابط کاربری New Edge: اگر رابط کاربری Edge جدید را نصب کرده‌اید، مؤلفه ue را در دستگاه مناسب به‌روزرسانی کنید (ممکن است دستگاه 1 نباشد):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
(اگر apigee-adminapi نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کردید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.
کامپوننت UI را مجددا راه اندازی کنید:
- رابط کاربری کلاسیک: اگر از رابط کاربری کلاسیک استفاده می‌کنید، همانطور که در مثال زیر نشان می‌دهد، مؤلفه edge-ui را در دستگاه 1 مجدداً راه‌اندازی کنید:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- New Edge UI: اگر رابط کاربری Edge جدید را نصب کرده اید، سپس مؤلفه edge-management-ui را در دستگاه مناسب راه اندازی مجدد کنید (ممکن است دستگاه 1 نباشد):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

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

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

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

Cassandra و ZooKeeper را در دستگاه 1، 2، و 3 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

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

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

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

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

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

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

اجزای Edge را در دستگاه 6، 7، 8، 9، 1، 4 و 5 به ترتیب به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

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

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

رابط کاربری جدید ( ue ) یا رابط کاربری کلاسیک ( ui ) را در دستگاه 1 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(اگر apigee-adminapi نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.
کامپوننت UI را مجددا راه اندازی کنید:
- رابط کاربری کلاسیک: اگر از رابط کاربری کلاسیک استفاده می‌کنید، همانطور که در مثال زیر نشان می‌دهد، مؤلفه edge-ui را در دستگاه 1 مجدداً راه‌اندازی کنید:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- New Edge UI: اگر رابط کاربری Edge جدید را نصب کرده اید، سپس مؤلفه edge-management-ui را در دستگاه مناسب راه اندازی مجدد کنید (ممکن است دستگاه 1 نباشد):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

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

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

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

Cassandra و ZooKeeper را در ماشین‌های 1، 2 و 3 به‌روزرسانی کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

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

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

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

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

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

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

اجزای Edge را در ماشین‌های 12، 13، 8، 9، 6، 7، 10 و 11 به ترتیب به‌روزرسانی کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

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

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

رابط کاربری جدید ( ue ) یا رابط کاربری کلاسیک ( ui ) را در ماشین های 6 و 7 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(اگر apigee-adminapi نصب کرده اید) ابزار apigee-adminapi را در ماشین های 6 و 7 به روز کردید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(اگر Apigee SSO را نصب کرده اید) Apigee SSO را در ماشین های 6 و 7 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کردید.
کامپوننت UI را مجددا راه اندازی کنید:
- رابط کاربری کلاسیک: اگر از رابط کاربری کلاسیک استفاده می‌کنید، همانطور که در مثال زیر نشان می‌دهد، مؤلفه edge-ui را در ماشین‌های 6 و 7 مجدداً راه‌اندازی کنید:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- New Edge UI: اگر Edge UI جدید را نصب کرده اید، سپس مولفه edge-management-ui را در ماشین های 6 و 7 راه اندازی مجدد کنید:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

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

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

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

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
```

به روز رسانی Postgres:

ماشین 6 در مرکز داده 1

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

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

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

به روز رسانی LDAP:

ماشین 1 در مرکز داده 1

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

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

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

به روز رسانی اجزای 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
```
به روز رسانی 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
```
رابط کاربری جدید ( ue ) یا رابط کاربری کلاسیک ( ui ) را به روز کنید:
1. ماشین 1 در مرکز داده 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
2. ماشین 7 در مرکز داده 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(اگر 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
```
(اگر 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
```
Edge UI جدید ( edge-management-ui ) یا Edge UI کلاسیک ( edge-ui ) را در ماشین‌های 1 و 7 مجدداً راه‌اندازی کنید:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```

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

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

باغ وحش
کاساندرا
ps
LDAP
Edge، به معنای نمایه "-c edge" در تمام گره ها به ترتیب: گره های دارای سرور Qpid، سرور Edge Postgres، سرور مدیریت، پردازشگر پیام و روتر.
توجه: اگر یک گره هم سرور Qpid و هم سرور Edge Postgres را نصب کرده است، مرحله نمایه "-c edge" را اجرا کنید.
qpidd
رابط کاربری Edge (کلاسیک یا جدید)
apigee-adminapi
Apigee SSO

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

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

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

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

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

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

قبل از ارتقاء Apigee Edge از پیش نیازهای زیر اطمینان حاصل کنید:

پشتیبان گیری از تمام گره ها
قبل از به‌روزرسانی، توصیه می‌کنیم به دلایل ایمنی یک نسخه پشتیبان کامل از تمام گره‌ها انجام دهید. از رویه نسخه فعلی Edge برای انجام پشتیبان استفاده کنید.
این به شما این امکان را می دهد که یک برنامه پشتیبان داشته باشید، در صورتی که به روز رسانی به نسخه جدید به درستی کار نمی کند. برای اطلاعات بیشتر در مورد پشتیبان‌گیری، به پشتیبان‌گیری و بازیابی مراجعه کنید.
اطمینان حاصل کنید که Edge در حال اجرا است
اطمینان حاصل کنید که لبه در طی فرآیند به روزرسانی با استفاده از دستور کار کرده و در حال اجرا است:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
اطمینان حاصل کنید که استراتژی cassandra comptification LeveledCompactionStrategy است
اطمینان حاصل کنید که استراتژی سازگاری Cassandra در LeveledCompactionStrategy تنظیم شده است ، همانطور که در تغییر استراتژی تراکم کاساندرا توضیح داده شده است.

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

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

به روزرسانی مورد نیاز به Zookeeper 3.8.3

این نسخه از Edge for Private Cloud شامل ارتقاء به Zookeeper 3.8.3 است. به عنوان بخشی از این به روزرسانی ، تمام داده های Zookeeper به Zookeeper 3.8.3 منتقل می شوند.

قبل از به روزرسانی Zookeeper ، از طریق راهنمای نگهداری Zookeeper بخوانید. بیشتر سیستم های تولید لبه از خوشه ای از گره های باغ وحش که در چندین مراکز داده پخش می شوند استفاده می کنند. برخی از این گره ها به عنوان رأی دهندگان که در انتخابات رهبر Zookeeper شرکت می کنند ، پیکربندی شده اند و بقیه به عنوان ناظران پیکربندی می شوند. برای جزئیات بیشتر در مورد رهبران ، پیروان ، رأی دهندگان و ناظران مشاهده کنید. گره های رای دهنده رهبری را انتخاب می کنند که پس از آن گره های رای دهنده خود پیروان می شوند.

در طی فرایند به روزرسانی ، هنگامی که گره رهبر خاموش می شود ، می تواند تأخیر لحظه ای داشته باشد یا خرابی را در Zookeeper بنویسد. این می تواند بر عملیات مدیریتی که در Zookeeper می نویسند ، مانند اجرای کارآیی یک پروکسی و تغییرات زیرساخت های Apigee ، مانند افزودن یا حذف پردازنده پیام و غیره تأثیر بگذارد. API های مدیریت تماس) در حین بروزرسانی Zookeeper ضمن دنبال کردن روش زیر.

در سطح بالایی ، روند به روزرسانی شامل تهیه نسخه پشتیبان از هر گره است. این به دنبال ارتقاء همه ناظران و پیروان و در نهایت به روزرسانی گره رهبر است.

بک آپ بگیرید

در صورت نیاز به بازگشت ، از تمام گره های Zookeeper برای استفاده تهیه کنید. توجه داشته باشید که هنگام تهیه نسخه پشتیبان ، یک بازپرداخت Zookeeper را به حالت بازگرداند. توجه: هرگونه استقرار یا تغییر زیرساخت در Apigee از زمان تهیه نسخه پشتیبان تهیه شده است (اطلاعات آنها در Zookeeper ذخیره شده است) در حین ترمیم از بین می رود.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

اگر از ماشینهای مجازی استفاده می کنید و از این قابلیت استفاده می کنید ، عکس های فوری VM یا پشتیبان گیری نیز می توانند برای ترمیم یا بازگشت (در صورت لزوم) گرفته شوند.

رهبر ، پیروان و ناظران را شناسایی کنید

توجه: دستورات نمونه زیر از NC Utility برای ارسال داده ها به Zookeeper استفاده می کنند. شما می توانید از برنامه های جایگزین برای ارسال داده ها به Zookeeper نیز استفاده کنید.

اگر روی گره Zookeeper نصب نشده است ، NC را نصب کنید:
```
  sudo yum install nc
```
دستور NC زیر را روی گره اجرا کنید ، جایی که 2181 بندر Zookeeper است:
```
  echo stat | nc localhost 2181
```
شما باید خروجی را مانند زیر ببینید:
```
  Zookeeper version: 3.8.3-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597
```
در خط Mode خروجی گره ها ، باید بسته به پیکربندی گره ، Observer ، Leader یا پیرو (به معنای رای دهنده ای که رهبر نیست) را ببینید. توجه: در یک نصب مستقل از لبه با یک گره باغ وحش منفرد ، Mode روی مستقل تنظیم شده است.
مراحل 1 و 2 را در هر گره باغ وحش تکرار کنید.

Zookeeper را بر روی گره های Observer و پیروان ارتقا دهید

Zookeeper را در هر یک از گره های Observer و پیرو به شرح زیر ارتقا دهید:

bootstrap از Edge را برای Cloud Private 4.52 بارگیری و اجرا کنید ، همانطور که در به روزرسانی 4.52.01 در یک گره با اتصال اینترنتی خارجی توضیح داده شده است. این روند بسته به اینکه گره دارای اتصال اینترنتی خارجی باشد یا شما در حال انجام نصب آفلاین هستید ، متفاوت خواهد بود.
مؤلفه Zookeeper را ارتقا دهید:
```
  /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
```
توجه: اگر این گره ها اجزای دیگری را نصب کرده اند (مانند کاساندرا) ، اکنون می توانید آنها را نیز ارتقا دهید (مانند مشخصات CS ، ZK) یا بعداً می توانید سایر اجزای دیگر را ارتقا دهید. Apigee توصیه می کند که ابتدا Zookeeper را ارتقا دهید و اطمینان حاصل کنید که خوشه شما قبل از به روزرسانی سایر اجزای دیگر به درستی کار می کند.
مراحل بالایی را روی هر یک از گره های ناظر و Zookeeper تکرار کنید.

رهبر را خاموش کنید

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

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

توجه داشته باشید که در طول این رویداد ، قبل از انتخاب یک رهبر جدید ، می تواند تاخیر لحظه ای رخ دهد یا خرابی را در Zookeeper انجام دهد. این می تواند بر عملیاتی که در Zookeeper می نویسند مانند اقدام به استقرار پروکسی ها یا تغییر زیرساخت های Apigee ، مانند افزودن یا حذف پردازنده های پیام و غیره ، تأثیر بگذارد.

تأیید کنید که رهبر جدید انتخاب شده است

با استفاده از مراحل موجود در بخش شناسایی رهبر ، پیروان و ناظران در بالا ، تأیید کنید که یک رهبر جدید از طرفداران انتخاب شده است ، پس از متوقف شدن رهبر موجود. توجه داشته باشید که رهبر می توانست در یک مرکز داده متفاوت نسبت به رهبر فعلی انتخاب شود.

رهبر ارتقاء

همان مراحل ارتقاء Zookeeper را در گره های ناظر و دنبال کننده در بالا دنبال کنید.

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

بازگشت به عقب

در صورت نیاز به بازگشت:

ابتدا مراحل برگشت بر روی ناظران و پیروان انجام دهید.
bootstrap نسخه مورد نظر خود را بارگیری و اجرا کنید - یا 4.50 یا 4.51. این روند بسته به اینکه گره دارای اتصال اینترنتی خارجی باشد یا شما از نصب آفلاین پیروی می کنید ، متفاوت خواهد بود.
اگر روی گره کار می کند ، zheokeeper را متوقف کنید:
```
  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
```

حذف باغ وحش موجود:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

زاویه دار را طبق معمول نصب کنید:

  /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

هنگامی که همه پیروان و ناظران به عقب برگشتند ، با دنبال کردن مراحل 2 تا 5 روی گره رهبر ، گره رهبر را به عقب برگردانید.
بعد از اینکه همه گره ها به عقب برگردانده شده اند ، سلامت خوشه را تأیید کرده و اطمینان حاصل کنید که یک گره رهبر در خوشه وجود دارد.

بازیابی نسخه پشتیبان

برای بازیابی از پشتیبان مراجعه کنید. توجه داشته باشید که پشتیبان گیری از Zookeeper که از نسخه های قبلی Edge برای ابر خصوصی مانند 4.50 و 4.51 گرفته شده است باید با نسخه Zookeeper in Edge برای Cloud Private 4.52 سازگار باشد.

به روزرسانی مورد نیاز به Postgres 14

این نسخه از Edge for Private Cloud شامل ارتقاء به Postgres 14 است. به عنوان بخشی از این ارتقاء ، تمام داده های Postgres به Postgres 14 منتقل می شوند.

اگر در حال ارتقاء از Edge برای Cloud Private 4.51.00 به 4.52.01 هستید ، لازم است مراحل ارتقاء اضافی Postgres را دنبال کنید. اگر در حال ارتقاء از نسخه 4.51.00 به 4.52.01 هستید ، به بخش ارتقاء لازم به Postgres 14 مراجعه کنید.
اگر در حال ارتقاء از Edge برای Cloud Private 4.52.00 به 4.52.01 هستید ، هیچ مراحل به روزرسانی تکمیلی Postgres لازم نیست.

qpid را ارتقا دهید

این لبه برای انتشار ابری خصوصی شامل به روزرسانی به qpid j-کارگزار است.

الزامات جدید معرفی شده توسط APIGEE-QPIDD-4.52.01-XXX: با شروع از نسخه 4.52.01 ، الزامات جدید در طول نصب معرفی شده است. اطمینان حاصل کنید که در پرونده پیکربندی ، ویژگی های QPID_MGMT_USERNAME و QPID_MGMT_PASSWORD را درج کنید. اطمینان حاصل کنید که این خصوصیات با مقادیر مناسب برای تسهیل نصب موفقیت آمیز اضافه شده اند.

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

ارتقا در محل با خرابی صفر
راه اندازی یک گره QPID جدید

ارتقا در محل با خرابی صفر

این روش اطمینان می دهد که هیچ خرابی برای محیط زمان اجرای لبه شما وجود ندارد و در صورت وجود ، از دست دادن داده های زمان اجرا ، در صورت وجود ، برای تجزیه و تحلیل به حداقل می رسد.

پیش نیاز: اطمینان حاصل کنید که edge-message-processor ، edge-management-server و edge-qpid-server قبل از شروع به روزرسانی QPID به روز می شوند.

برای انجام یک مکان در محل ، صفر به روزرسانی به QPID:

یک گره QPID را برای شروع انتخاب کنید.
کارگزار QPID را روی گره متوقف کنید:
```
apigee-service apigee-qpidd stop
```
ترافیک ورودی را در پورت کارگزار 5672 از کلیه پردازنده های پیام با استفاده از فایروال مسدود کنید. می توانید این فایروال را در سطح نمونه گره QPID یا برخی دیگر از مؤلفه های فایروال/شبکه خارجی اعمال کنید.
توصیه می کنیم برای همه آدرس های IP پردازنده پیام همان مرحله را انجام دهید. به عنوان مثال ، برای رها کردن درخواست های حاصل از آدرس IP پردازنده پیام به گره QPID در پورت 5672 با استفاده از iptables ، می توانید از یک دستور مانند این استفاده کنید:
```
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
```
در صورت وجود ، کارگزار QPID را دوباره شروع کنید تا پیام های موجود را تخلیه کند:
```
apigee-service apigee-qpidd start
```
بررسی کنید که صف های موجود خالی است:
```
qpid-stat -q
```
اگر پیام ها در صف نامه مرده (DLQ) گیر کرده اند (AX-Q-AXGROUP-001-CONSUMER-GROUP-001-DL) ، سپس با استفاده از مراحل حل داده های تجزیه و تحلیل گیر شده در صف نامه مرده ، صف را تخلیه کنید.
پس از تأیید صف ها روی گره قدیمی تخلیه شده است ، apigee-qpidd را متوقف کنید:
```
apigee-service apigee-qpidd stop
```

qpid را بر روی گره ارتقا دهید:

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

راه اندازی مجدد edge-qpid-server :
```
apigee-service edge-qpid-server restart
```
قانون فایروال اعمال شده در مرحله 3 را حذف کنید.
همان مرحله حذف را برای کلیه آدرسهای IP پردازنده پیام که در آن فایروال اعمال شده است ، انجام دهید. پس از حذف فایروال ها ، درخواست های حاصل از آدرس IP پردازنده پیام به گره QPID در پورت 5672 پذیرفته می شوند. اگر از iptables برای اضافه کردن فایروال استفاده کرده اید ، برای حذف فایروال و لیست تنظیمات موجود می توانید از دستوراتی مانند موارد زیر استفاده کنید:
```
iptables -F
  iptables -L
```
از نظارت وب استفاده کنید تا تأیید کنید که صف های QPID پیام دریافت می کنند:
```
http://QPID_NODE_IP:8090
```
مرحله 1 تا 9 را برای هر گره QPID تکرار کنید.

راه اندازی یک گره QPID جدید

این روش apigee-qpidd و edge-qpid-server بر روی یک گره جدید تنظیم و نصب می کند.

یک گره QPID جدید اضافه کنید. این مرحله یک گره QPID را با J-Broker تنظیم می کند. برای مراحل دقیق ، به یک سرور QPID اضافه کنید .
یک گره QPID موجود را انتخاب کنید (گره ای از نسخه ای که از آن به روز می کنید).
کارگزار QPID را روی گره متوقف کنید:
```
apigee-service apigee-qpidd stop
```
ترافیک ورودی را در پورت کارگزار 5672 از کلیه پردازنده های پیام با استفاده از فایروال مسدود کنید. می توانید این فایروال را در سطح نمونه گره QPID یا برخی دیگر از مؤلفه های فایروال/شبکه خارجی اعمال کنید.
توصیه می کنیم برای همه آدرس های IP پردازنده پیام همان مرحله را انجام دهید. به عنوان مثال ، برای رها کردن درخواست های حاصل از آدرس IP پردازنده پیام به گره QPID در پورت 5672 با استفاده از iptables ، می توانید از یک دستور مانند این استفاده کنید:
```
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
```
در صورت وجود ، کارگزار QPID را دوباره شروع کنید تا پیام های موجود را تخلیه کند:
```
apigee-service apigee-qpidd start
```
بررسی کنید تا مطمئن شوید که صف های موجود خالی است:
```
qpid-stat -q
```
اگر پیام ها در صف نامه مرده (DLQ) گیر کرده اند (AX-Q-AXGROUP-001-CONSUMER-GROUP-001-DL) ، با دنبال کردن مراحل موجود در مورد عیب یابی داده های تحلیلی که در صف نامه QPIDD Dead Letter گیر کرده است ، صف را تخلیه کنید.
پس از تأیید صف ها روی گره قدیمی تخلیه شده است ، apigee-qpidd را متوقف کنید
```
apigee-service apigee-qpidd stop
```
با دنبال کردن مراحل حذف یک سرور QPID ، گره QPID قدیمی را ثبت کنید.
یک گره جدید را اضافه کرده و یک گره قدیمی را یک بار از بین ببرید ، تا زمانی که همه گره های QPID به روز شوند.

بازگشت به عقب

توجه: ابتدا قبل از تلاش برای بازگرداندن سایر اجزای لبه ( edge-qpid-server ، edge-message-processor ، edge-management-server ) ، ابتدا apigee-qpidd به عقب برگردانید.

برای بازگشت به نسخه قبلی ویژگی ، حتماً پرونده bootstrap.sh را برای نسخه ای که می خواهید به آن برگردانید بارگیری کنید. برای بازگشت به V 4.52.00 ، bootstrap_4.52.00.sh بارگیری کنید.

برای بازگشت QPID ، این مراحل را در همه میزبان QPID دنبال کنید:

کارگزار QPID موجود را متوقف کنید
```
apigee-service apigee-qpidd stop
```
ترافیک ورودی را در پورت کارگزار 5672 از کلیه پردازنده های پیام با استفاده از فایروال مسدود کنید. می توانید این فایروال را در سطح نمونه گره QPID یا برخی دیگر از مؤلفه های فایروال/شبکه خارجی اعمال کنید.
توصیه می کنیم برای همه آدرس های IP پردازنده پیام همان مرحله را انجام دهید. به عنوان مثال ، برای رها کردن درخواست های حاصل از آدرس IP پردازنده پیام به گره QPID در پورت 5672 با استفاده از iptables ، می توانید از یک دستور مانند این استفاده کنید:
```
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
```
در صورت وجود ، کارگزار QPID را دوباره شروع کنید تا پیام های موجود را تخلیه کند:
```
apigee-service apigee-qpidd start
```
اطمینان حاصل کنید که صف های موجود خالی است. برای بررسی ، به پورتال مدیریت QPID وارد شوید:
```
http://QPID_NODE_IP:8090
```
توجه: در صورتی که این پورت 8090 در گره QPID در دسترس نباشد ، می توانید از مکانیسم های متناوب مانند حمل و نقل پورت SSH برای دسترسی به این URL استفاده کنید.
پس از تأیید صف ها ، متوقف شده و QPID را حذف کرده و حذف نصب کنید:
```
apigee-service apigee-apidd uninstall
```
فهرست داده های QPID را حذف کنید:
```
rm -r APIGEE_ROOT/data/apigee-qpidd
```

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

/opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile

هنگامی که کارگزار QPID دوباره نصب شد ، تنظیمات فایروال را حذف کرده و تنظیمات موجود را با استفاده از دستورات زیر ذکر کنید:
```
iptables -F
```
```
iptables -L
```

UI Edge جدید

در این بخش ملاحظات مربوط به Edge UI ذکر شده است. برای اطلاعات بیشتر ، به UI جدید Edge برای Cloud Private مراجعه کنید.

لبه UI را نصب کنید

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

توجه داشته باشید که Edge UI نیاز به غیرفعال کردن احراز هویت اساسی دارد و از IDP مانند SAML یا LDAP استفاده می کنید.

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

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

برای به روزرسانی مؤلفه Edge UI ، نسخه Edge را برای ابر خصوصی که از آن به روز می کنید در نظر بگیرید:

از 4.51.00 تا 4.52.00 (با UI جدید Edge که قبلاً نصب شده است): از دستورالعمل های ارتقاء در این بخش برای مؤلفه edge-management-ui استفاده کنید.

با MTL های Apigee به روز کنید

برای به روزرسانی MTL های Apigee ، مراحل زیر را انجام دهید:

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

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

اگر خرابی نیاز دارد که به روزرسانی نسخه قبلی خود را برگردانید ، برای دستورالعمل های دقیق به Roll Back 4.52.00 مراجعه کنید.

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

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

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

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

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

بروزرسانی صفر پایین

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

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

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

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

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

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

از یک فایل پیکربندی خاموش استفاده کنید

شما باید یک فایل پیکربندی خاموش را به دستور Update منتقل کنید. پرونده پیکربندی خاموش باید همان موردی باشد که برای نصب Edge 4.50.00 یا 4.51.00 استفاده کرده اید.

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

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

در صورت وجود ، هرگونه شغل cron را که برای انجام یک عملیات تعمیر در کاساندرا تنظیم شده است ، غیرفعال کنید تا پس از اتمام به روزرسانی.
برای نصب RPMS Edge به گره خود به عنوان ریشه وارد شوید.
توجه: در حالی که نصب RPM به دسترسی ریشه نیاز دارد ، می توانید پیکربندی لبه را بدون دسترسی به ریشه انجام دهید.
yum-utils و yum-plugin-priorities نصب کنید:
توجه: اگر سیستم عامل شما RHEL 8.0 - 8.6 است ، از این مرحله پرش کنید.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
Selinux را همانطور که در نصب ابزار Edge Apigee-setup توضیح داده شده است ، غیرفعال کنید.
اگر در حال نصب در Oracle 7.x هستید ، دستور زیر را اجرا کنید:
```
sudo yum-config-manager --enable ol7_optional_latest
```

اگر در حال نصب 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

اگر در حال حاضر در لبه 4.51.00 هستید:
1. پرونده Edge bootstrap_4.52.01.sh را به /tmp/bootstrap_4.52.01.sh بارگیری کنید:
```
curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
```
2. Edge 4.52.01 apigee-service Utility و وابستگی ها را با اجرای دستور زیر نصب کنید:
```
sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
```
  جایی که uName:pWord نام کاربری و رمز عبوری است که از Apigee دریافت کرده اید. اگر از pWord خارج شوید ، از شما خواسته می شود که وارد آن شوید.
  به طور پیش فرض ، نصب را بررسی می کند که جاوا 1.8 را نصب کرده اید. اگر این کار را نکنید ، نصب کننده آن را برای شما نصب می کند.
  برای مشخص کردن نحوه کنترل نصب جاوا از گزینه JAVA_FIX استفاده کنید. JAVA_FIX مقادیر زیر را می گیرد:
  - I : OpenJDK 1.8 (پیش فرض) را نصب کنید.
  - C : بدون نصب جاوا ادامه دهید.
  - Q : ترک برای این گزینه ، شما باید خودتان جاوا را نصب کنید.
3. برای به روزرسانی ابزار apigee-setup ، از apigee-service استفاده کنید ، همانطور که مثال زیر نشان می دهد:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. همانطور که در مثال زیر نشان می دهد ، ابزار apigee-validate را در سرور مدیریت به روز کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. همانطور که مثال زیر نشان می دهد ، ابزار apigee-provision را در سرور مدیریت به روز کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
6. با اجرای دستور زیر ، ابزار update را روی گره های خود اجرا کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
  این کار را به ترتیب شرح داده شده به ترتیب به روزرسانی دستگاه انجام دهید.
  کجا:
  - component مؤلفه Edge برای به روزرسانی است. مقادیر ممکن عبارتند از:
    - cs : کاساندرا
    - edge : All Edge Components به جز Edge UI: سرور مدیریت ، پردازنده پیام ، روتر ، سرور QPID ، سرور Postgres
    - ldap : OpenDap
    - ps : postgresql
    - qpid : QPIDD
    - sso : Apigee SSO (اگر SSO را نصب کردید)
    - ue : ui Edge جدید
    - ui : UI Edge Classic
    - zk : باغ وحش
  - configFile همان فایل پیکربندی است که برای تعیین اجزای لبه خود در طول نصب 4.50.00 یا 4.51.00 استفاده کرده اید.
  شما می توانید با تنظیم component "همه" ، در برابر همه مؤلفه ها update.sh اجرا کنید ، اما تنها در صورتی که دارای یک پروفایل نصب Edge all-in-on-one (AIO) باشید. به عنوان مثال:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
```
7. اگر قبلاً این کار را نکرده اید ، اجزای Edge UI را روی همه گره هایی که در حال اجرا هستند ، مجدداً راه اندازی کنید:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
8. همانطور که در تست نصب توضیح داده شده است ، به روزرسانی را با اجرای ابزار apigee-validate در سرور مدیریت آزمایش کنید.

اگر بعداً تصمیم گرفتید که به روزرسانی را به عقب برگردانید ، از روش شرح داده شده در Roll Back 4.52.01 استفاده کنید.

از یک repo محلی به 4.52.01 بروزرسانی کنید

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

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

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

برای به روزرسانی از یک repo محلی 4.52.01:

یک repo محلی 4.52.01 ایجاد کنید همانطور که در "ایجاد یک مخزن محلی Apigee" در نصب ابزار Edge Apigee-Setup توضیح داده شده است.
توجه: اگر قبلاً یک repo موجود دارید ، می توانید repo 4.52.01 را به آن اضافه کنید ، همانطور که در "به روزرسانی یک مخزن محلی Apigee" در نصب Edge Apigee-Setup Toletical توضیح داده شده است.
برای نصب سرویس Apigee از یک پرونده .tar :
1. در گره با repo محلی ، از دستور زیر استفاده کنید تا repo محلی را در یک پرونده .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.52.01.tar.gz : بسته بندی کنید.
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
2. پرونده .tar را در گره ای که می خواهید Edge را به روز کنید ، کپی کنید. به عنوان مثال ، آن را در فهرست /tmp در گره جدید کپی کنید.
3. در گره جدید ، پرونده را به فهرست /tmp فهرست کنید:
```
tar -xzf apigee-4.52.01.tar.gz
```
  این دستور دایرکتوری جدیدی به نام repos را در دایرکتوری حاوی پرونده .tar ایجاد می کند. به عنوان مثال /tmp/repos .
4. ابزار و وابستگی های Edge apigee-service را از /tmp/repos نصب کنید:
```
sudo bash /tmp/repos/bootstrap_4.52.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
  توجه داشته باشید که شما مسیر دایرکتوری repos را در این دستور قرار می دهید.
برای نصب سرویس Apigee با استفاده از NGINX WebServer:
1. سرور وب Nginx را همانطور که در "نصب از repo با استفاده از WebServer Nginx" در نصب Edge Apigee-Setup تنظیم شده است ، پیکربندی کنید.
2. در گره از راه دور ، پرونده Edge bootstrap_4.52.01.sh را به /tmp/bootstrap_4.52.01.sh بارگیری کنید:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
```
  جایی که uName:pWord نام کاربری و رمز عبوری است که قبلاً برای repo تنظیم کرده اید ، و remoteRepo آدرس IP یا نام DNS گره repo است.
3. در گره از راه دور ، ابزار و وابستگی های Edge apigee-setup را نصب کنید:
```
sudo bash /tmp/bootstrap_4.52.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
  جایی که uName:pWord نام کاربری و رمز عبور repo است.
برای به روزرسانی ابزار apigee-setup ، از apigee-service استفاده کنید ، همانطور که مثال زیر نشان می دهد:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
همانطور که در مثال زیر نشان می دهد ، ابزار apigee-validate را در سرور مدیریت به روز کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
همانطور که مثال زیر نشان می دهد ، ابزار apigee-provision را در سرور مدیریت به روز کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
ابزار update را روی گره های خود به ترتیب شرح داده شده به ترتیب به روزرسانی دستگاه اجرا کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
کجا:
- component مؤلفه Edge برای به روزرسانی است. شما به طور معمول اجزای زیر را به روز می کنید:
  - cs : کاساندرا
  - edge : All Edge Components به جز Edge UI: سرور مدیریت ، پردازنده پیام ، روتر ، سرور QPID ، سرور Postgres
  - ldap : OpenDap
  - ps : postgresql
  - qpid : QPIDD
  - sso : Apigee SSO (اگر SSO را نصب کردید)
  - ue ui جدید
  - ui : UI Edge Classic
  - zk : باغ وحش
- configFile همان فایل پیکربندی است که برای تعیین اجزای لبه خود در طول نصب 4.50.00 یا 4.51.00 استفاده کرده اید.
  توجه: پرونده پیکربندی باید توسط کاربر "Apigee" قابل خواندن باشد. برای تغییر مالک ، از دستور زیر استفاده کنید:
```
chown apigee:apigee configFile
```
شما می توانید با تنظیم component "همه" ، در برابر همه مؤلفه ها update.sh اجرا کنید ، اما تنها در صورتی که دارای یک پروفایل نصب Edge all-in-on-one (AIO) باشید. به عنوان مثال:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
اگر قبلاً این کار را نکرده اید ، اجزای UI را روی همه گره هایی که آن را اجرا کرده اید مجدداً راه اندازی کنید:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
همانطور که در تست نصب توضیح داده شده است ، به روزرسانی را با اجرای ابزار apigee-validate در سرور مدیریت آزمایش کنید.

اگر بعداً تصمیم گرفتید که به روزرسانی را به عقب برگردانید ، از روش شرح داده شده در Roll Back 4.52.01 استفاده کنید.

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

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

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

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

برای به روزرسانی یک پیکربندی مستقل 1 گره به 4.52.01:

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

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

(اگر apigee-adminapi نصب کردید) ابزار apigee-adminapi را به روز کرد:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

به روزرسانی مستقل 2 گره

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

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

کاساندرا و Zookeeper را در دستگاه 1 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

به روزرسانی postgres در دستگاه 2:

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

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

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

اجزای Edge Edge را در دستگاه 2 و 1 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

QPID را در دستگاه 2 به روز کنید:

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

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

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

(اگر apigee-adminapi نصب کردید) ابزار apigee-adminapi را در دستگاه 1 به روز کرد:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(اگر Apigee SSO را نصب کردید) Apigee SSO را در دستگاه 1 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کرده اید.
مؤلفه Edge UI را در دستگاه 1 مجدداً راه اندازی کنید:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```

ارتقاء 5 گره

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

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

کاساندرا و Zookeeper را در دستگاه 1 ، 2 و 3 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

به روزرسانی postgres در دستگاه 4:

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

به روزرسانی postgres در دستگاه 5:

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

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

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

اجزای Edge Edge را در دستگاه 4 ، 5 ، 1 ، 2 ، 3 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

QPID را در دستگاه 4 به روز کنید:

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

QPID را در دستگاه 5 به روز کنید:

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

Edge UI را به روز کنید:
- UI کلاسیک: اگر از UI کلاسیک استفاده می کنید ، سپس مؤلفه ui را در دستگاه 1 به روز کنید ، همانطور که مثال زیر نشان می دهد:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
- UI New Edge: اگر UI Edge New Edge را نصب کردید ، سپس مؤلفه ue را روی دستگاه مناسب به روز کنید (ممکن است دستگاه 1 نباشد):
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
```
(اگر apigee-adminapi نصب کردید) ابزار apigee-adminapi را در دستگاه 1 به روز کرد:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(اگر Apigee SSO را نصب کردید) Apigee SSO را در دستگاه 1 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کرده اید.
مؤلفه UI را مجدداً راه اندازی کنید:
- UI کلاسیک: اگر از UI کلاسیک استفاده می کنید ، سپس مؤلفه edge-ui را در دستگاه 1 مجدداً راه اندازی کنید ، همانطور که مثال زیر نشان می دهد:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- UI New Edge: اگر UI Edge جدید را نصب کردید ، سپس مؤلفه edge-management-ui روی دستگاه مناسب مجدداً راه اندازی کنید (ممکن است دستگاه 1 نباشد):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

به روزرسانی خوشه ای 9 گره

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

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

کاساندرا و Zookeeper را در دستگاه 1 ، 2 و 3 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

به روزرسانی postgres در دستگاه 8:

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

به روزرسانی postgres در دستگاه 9:

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

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

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

اجزای Edge را در دستگاه 6 ، 7 ، 8 ، 9 ، 1 ، 4 و 5 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
QPID را در دستگاه های 6 و 7 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
UI جدید ( ue ) یا UI کلاسیک ( ui ) را در دستگاه 1 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(اگر apigee-adminapi نصب کردید) ابزار apigee-adminapi را در دستگاه 1 به روز کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(اگر Apigee SSO را نصب کردید) Apigee SSO را در دستگاه 1 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کرده اید.
مؤلفه UI را مجدداً راه اندازی کنید:
- UI کلاسیک: اگر از UI کلاسیک استفاده می کنید ، سپس مؤلفه edge-ui را در دستگاه 1 مجدداً راه اندازی کنید ، همانطور که مثال زیر نشان می دهد:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- UI New Edge: اگر UI Edge جدید را نصب کردید ، سپس مؤلفه edge-management-ui روی دستگاه مناسب مجدداً راه اندازی کنید (ممکن است دستگاه 1 نباشد):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

به روزرسانی خوشه ای 13 گره

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

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

کاساندرا و Zookeeper را در دستگاه های 1 ، 2 و 3 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

به روزرسانی postgres در دستگاه 8:

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

به روزرسانی postgres در دستگاه 9:

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

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

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

اجزای Edge را در دستگاه های 12 ، 13 ، 8 ، 9 ، 6 ، 7 ، 10 و 11 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
QPID را در دستگاه های 12 و 13 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
UI جدید ( ue ) یا UI کلاسیک ( ui ) را در دستگاه های 6 و 7 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(اگر apigee-adminapi نصب کردید) ابزار apigee-adminapi را در دستگاه های 6 و 7 به روز کرد:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(اگر Apigee SSO را نصب کردید) Apigee SSO را در دستگاه های 6 و 7 به روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
جایی که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کرده اید.
مؤلفه UI را مجدداً راه اندازی کنید:
- UI کلاسیک: اگر از UI کلاسیک استفاده می کنید ، سپس مؤلفه edge-ui را در دستگاه های 6 و 7 مجدداً راه اندازی کنید ، همانطور که مثال زیر نشان می دهد:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- UI New Edge: اگر UI Edge جدید را نصب کردید ، سپس مؤلفه edge-management-ui را در دستگاه های 6 و 7 شروع کنید:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

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

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

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

کاساندرا و باغ وحش را به روز کنید:
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
```

به روزرسانی Postgres:

دستگاه 6 در مرکز داده 1

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

دستگاه 12 در مرکز داده 2

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

LDAP را به روز کنید:

دستگاه 1 در مرکز داده 1

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

دستگاه 7 در مرکز داده 2

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

به روزرسانی اجزای لبه:
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
```
qpidd را به روز کنید:
1. ماشین آلات 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. ماشین آلات 10 ، 11 در مرکز داده 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
```
UI جدید ( ue ) یا UI کلاسیک ( ui ) را به روز کنید:
1. دستگاه 1 در مرکز داده 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
2. دستگاه 7 در مرکز داده 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(اگر 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
```
(اگر 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
```
مؤلفه جدید UI Edge UI ( edge-management-ui ) یا Edge Edge UI ( edge-ui ) را در دستگاه های 1 و 7 راه اندازی کنید:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```

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

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

باغ وحش
کاساندرا
ps
LDAP
لبه ، به معنی پروفایل "-C Edge" در همه گره ها به ترتیب: گره هایی با سرور QPID ، سرور Edge Postgres ، سرور مدیریت ، پردازنده پیام و روتر.
توجه: اگر یک گره هم سرور QPID و هم سرور Edge Postgres نصب شده است ، مرحله پروفایل "-C Edge" را اجرا کنید.
qpidd
Edge UI (یا کلاسیک یا جدید)
apigee-adminapi
Apigee SSO

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