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

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

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

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

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

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

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

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

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

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

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

چه مراحل خاصی را برای ارتقا در نظر بگیرید

برای ارتقاء به Edge برای Private Cloud 4.52.02، مراحل خاصی را برای ارتقاء نرم افزارهای خاص اجرا کنید. مراحل لازم به نسخه فعلی شما بستگی دارد. برای نرم افزارهای مختلف که به مراحل تکمیلی نیاز دارند به جدول زیر مراجعه کنید و دستورالعمل های دقیق را برای هر کدام دنبال کنید. پس از انجام کارهای لازم، برای ادامه روند ارتقا به روال اصلی ارتقا بازگردید.

نسخه فعلی	نرم افزاری که برای ارتقا به 4.52.02 به مراحل خاصی نیاز دارد	مرجع
4.52.01	کاساندرا	استراتژی تراکم کاساندرا را تغییر دهید
4.52.00	Cassandra، Zookeeper، Qpid	استراتژی تراکم کاساندرا را تغییر دهید
4.51.00	Cassandra، Zookeeper، Qpid، Postgres	استراتژی تراکم کاساندرا را تغییر دهید

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

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

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

ارتقاء مورد نیاز به Cassandra 3.11.16

Apigee Edge for Private Cloud 4.52.02 شامل ارتقای Cassandra به نسخه 3.11.16 است. Cassandra جزء حیاتی Apigee است و این ارتقاء همچنین شامل به‌روزرسانی‌هایی برای نرم‌افزار درایور در زمان اجرا و اجزای مدیریتی مختلف است که برای پرس و جو و نوشتن در Cassandra استفاده می‌شوند.

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

توجه: ابزار cassandra-cli دیگر در Cassandra 3.X پشتیبانی نمی‌شود و برای استفاده شما در دسترس نیست.

عقبگرد سطح بالا

به روز رسانی های کاساندرا را یک نود در یک زمان اعمال کنید. به محض به‌روزرسانی یک گره، تغییرات طرحواره خاصی اعمال می‌شوند که نمی‌توانند مستقیماً به عقب برگردند. بخش بازگشت به عقب را به طور کامل بخوانید، زیرا بسته به اینکه چه مقدار از خوشه ارتقا یافته است، می توان از تکنیک های مختلفی استفاده کرد.

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

برای جزئیات بیشتر، به بخش به روز رسانی Rollback the Cassandra 3.11.16 مراجعه کنید.

مستندسازی APIها در پورتال توسعه دهنده

پورتال توسعه دهنده Apigee Drupal ویژگی های مختلفی را برای مستندسازی API های شما ارائه می دهد. در حالی که توصیه می‌شود از پورتال توسعه‌دهنده مبتنی بر دروپال ۷ دور شوید، اگر همچنان از آن استفاده می‌کنید و از ویژگی SmartDocs آن استفاده می‌کنید، سند استفاده از SmartDocs APIs برای شما اعمال می‌شود. اگر از نسخه‌های جدیدتر پورتال توسعه‌دهنده استفاده می‌کنید، در طول این ارتقا هیچ تأثیری بر اسناد API شما نخواهد داشت.

هنگامی که Apigee را به نسخه 4.52.02 ارتقا می دهید، هر مدل API ایجاد شده با استفاده از ویژگی SmartDocs پورتال توسعه دهنده دروپال 7 به طور خودکار به نسخه جدیدتر منتقل نمی شود. از شما انتظار می رود که به صورت دستی هر مدل را با استفاده از پورتال توسعه دهنده صادر کنید و پس از تکمیل ارتقا دوباره آن را وارد کنید.

اصطلاحات مورد استفاده در بخش های زیر

Runtime: زمان اجرا شامل مدیریت ترافیک پراکسی زمان اجرا شما می شود. این شامل تمام عملیات انجام شده توسط روترها و پردازشگرهای پیام شما برای پردازش موثر درخواست API زمان اجرا برای پراکسی های موجود است. با این حال، شامل استقرار پراکسی‌های جدید یا تجدیدنظرهای جدید پراکسی‌ها نمی‌شود.

مدیریت: مدیریت شامل مدیریت سیستم Apigee Edge شما است. این شامل، اما نه محدود به، استقرار، تغییرات برنامه‌ها، محصولات، سرورهای هدف، فروشگاه‌های کلید، و غیره است. همه APIهای مدیریتی (و کلاینت‌های آن‌ها مانند Apigee UI و پورتال توسعه‌دهنده) در این محدوده گنجانده شده‌اند.

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

مرحله 0: حالت شروع

Cassandra در Apigee در حال اجرا با نسخه 2.1.22.
Edge برای اجزای Private Cloud 4.52.02:

مدیریت-سرور در حال ارتباط با کاساندرا از طریق پروتکل قدیمی تر تریفت.
سرورهای زمان اجرا (پردازنده‌های پیام و روترها) با کاساندرا از طریق پروتکل قدیمی‌تر Thrift ارتباط برقرار می‌کنند.

حالت زمان اجرا در این مرحله	وضعیت مدیریت در این مرحله
زمان اجرا کاملاً کاربردی است	مدیریت کاملاً کاربردی

مرحله 1: برای ارتقاء آماده شوید

مراحل زیر علاوه بر فایل‌های استانداردی است که معمولاً ایجاد می‌کنید، مانند فایل پیکربندی استاندارد Apigee برای فعال کردن ارتقاء مؤلفه‌ها.

Cassandra را برای استفاده از LeveledCompactionStrategy تغییر دهید.
از کاساندرا با استفاده از Apigee نسخه پشتیبان تهیه کنید.
از گره های کاساندرا (در صورت امکان) عکس های فوری VM بگیرید.
یک فایل پیکربندی ارتقاء کاساندرا در هر گره کاساندرا در /opt/apigee/apigee-cassandra/cass_upgrade.conf با محتویات زیر ایجاد کنید:
```
# IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    
```
اگر فایل را نمی توان در /opt/apigee/apigee-cassandra/cass_upgrade.conf ایجاد کرد، فایل /opt/silent.conf را با همان محتویات در هر گره کاساندرا ایجاد کنید.
احتیاط: نصب کننده ارتقاء Apigee فایل را در مکان های ذکر شده در بالا جستجو می کند. اگر فایل در هیچ یک از مکان های ذکر شده در بالا وجود نداشته باشد، ارتقاء با پیامی مانند زیر با شکست مواجه می شود:
```
could not read env location: '/opt/apigee/apigee-cassandra/cass_upgrade.conf'
file does not exist or cannot be sourced
could not read env location: '/opt/silent.conf'
file does not exist or cannot be sourced
```
اگر این اتفاق بیفتد، ارتقاء با شکست مواجه می‌شود، اما سرویس Cassandra روی گره احتمالاً در حالت توقف است. می‌توانید طبق معمول سرویس Cassandra را راه‌اندازی کنید و با قرار دادن فایل پیکربندی در هر یک از مکان‌های مورد انتظار، مجدداً ارتقا دهید. علاوه بر این، اگر فایل پیدا شود اما تنظیمات ارائه شده نادرست باشد (به عنوان مثال، اعتبارنامه Cassandra نادرست است)، ارتقاء با خطای مانند زیر ناموفق خواهد بود:
```
Error in PREIN scriptlet in rpm package apigee-cassandra-X.XX.XX-X.X.XXXX.noarch
```
در این مورد، به طور مشابه، در صورت عدم موفقیت در ارتقا، سرویس Cassandra را راه‌اندازی کنید و پس از اصلاح تنظیمات موجود در فایل، مجدداً ارتقا دهید.

اگر از ویژگی SmartDocs پورتال توسعه‌دهنده Apigee Drupal 7 استفاده می‌کنید، هر یک از مدل‌های خود را با دانلود آن‌ها با فرمت JSON از رابط کاربری پورتال توسعه‌دهنده، صادر کنید . این مدل‌ها پس از به‌روزرسانی سرورهای مدیریتی باید دوباره به Apigee وارد شوند.
مطمئن شوید که پورت‌های 9160 و 9042 از تمام اجزای Edge for Private Cloud 4.52.02 به گره‌های Cassandra در دسترس هستند، اگر قبلاً وجود ندارند. برای اطلاعات بیشتر به الزامات بندر مراجعه کنید.

مرحله 2: تمام گره های Cassandra را ارتقا دهید

تمام گره های Cassandra را در همه مناطق یک به یک ارتقا دهید. دستورات زیر را روی هر گره اجرا کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
هنگامی که یک گره به روز شد، دستور زیر را بر روی گره اجرا کنید تا قبل از ادامه، برخی از اعتبارسنجی ها اجرا شود:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
```

خروجی بالا چیزی در امتداد خطوط زیر خواهد بود:

Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified

حالت زمان اجرا در این مرحله	وضعیت مدیریت در این مرحله
زمان اجرا کاملاً کاربردی است	عملکرد مدیریت زیر پس از ارتقاء کاساندرا کاهش می یابد: مدیریت API برای ایجاد محصول API با محیط مدیریت API برای به روز رسانی یک محصول API با محیط مدیریت API برای حذف یک سازمان

توجه: اگر در حال ارتقا از Edge Private Cloud 4.51.00 یا 4.52.00 هستید، برای ارتقا Zookeeper نیز باید مراحل دیگری را دنبال کنید. حتی اگر Zookeeper و Cassandra ممکن است در یک گره مشترک قرار گیرند، توصیه می شود Zookeeper و Cassandra را جداگانه ارتقا دهید.

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

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

دستور زیر را می توان در یک گره برای ارتقاء Cassandra استفاده کرد:

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

اگر از Edge Private Cloud 4.52.01 به 4.52.02 ارتقا می دهید، ارتقا Zookeeper یک ارتقا جزئی است و می تواند در کنار Cassandra انجام شود. برای ارتقاء هر دو Cassandra و Zookeeper از طریق یک فرمان واحد در گره هایی که در آنها قرار دارند، از دستور زیر استفاده کنید. توصیه می شود این کار را فقط در صورتی انجام دهید که قبلاً نسخه 3.8.3 Zookeeper را در نسخه 4.52.01 Private Cloud اجرا می کنید:

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

مرحله 3: تمام گره های مدیریت را ارتقا دهید

تمام گره های مدیریت را در همه مناطق یک به یک ارتقا دهید:

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

وضعیت زمان اجرا	دولت مدیریت
زمان اجرا کاملاً کاربردی است	مدیریت API تنزل یافته است: ویژگی SmartDocs پورتال توسعه دهنده دروپال 7 هیچ داده ای را نشان نمی دهد

مرحله 3a: [اختیاری] SmartDocs را که قبلا صادر شده اند وارد کنید

هنگامی که همه سرورهای مدیریت ارتقا یافتند، می توانید مدل های SmartDocs را که در مرحله 1 صادر کرده بودید وارد کنید. می توانید بعداً نیز تصمیم بگیرید که این کار را انجام دهید.

وضعیت زمان اجرا	دولت مدیریت
زمان اجرا کاملاً کاربردی است	مدیریت کاملاً کاربردی

مرحله 4: تمام گره های Runtime را ارتقا دهید

تمام روترها و گره های پردازشگر پیام را در همه مناطق یک به یک ارتقا دهید:

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

وضعیت زمان اجرا	دولت مدیریت
زمان اجرا کاملاً کاربردی است	مدیریت کاملاً کاربردی

مرحله 5: تمام اجزای Edge باقیمانده را برای Private Cloud 4.52.02 ارتقا دهید

تمام نودهای باقیمانده edge-qpid-server و edge-postgres-server را در همه مناطق یک به یک ارتقا دهید.

در این مرحله، اگر از نسخه‌های زودتر از Edge برای Private Cloud 4.52.01 ارتقا می‌دهید و مراحل تکمیلی را برای ارتقای Qpid یا Postgres دنبال می‌کنید، مراحل مربوطه را برای ارتقای آن دنبال کنید.

وضعیت زمان اجرا	دولت مدیریت
زمان اجرا کاملاً کاربردی است	مدیریت کاملاً کاربردی

مرحله 6: مراحل ارتقا را ارسال کنید

پس از تکمیل ارتقا، دستور زیر را روی هر گره Cassandra یکی یکی اجرا کنید:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

دستور زیر را اجرا کنید تا جداول قدیمی استفاده نشده را از خوشه Cassandra حذف کنید. تا زمانی که این مورد اجرا نشود، نمی‌توانید از ویژگی‌های خاصی از Cassandra استفاده کنید (مانند تنظیم احراز هویت جدید - مکانیسم‌های احراز هویت قدیمی به کار خود ادامه می‌دهند). این دستور فقط روی 1 گره در خوشه قابل اجراست:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

اگر قبلاً این کار را نکرده اید، مرحله 3a را کامل کنید.

وضعیت زمان اجرا	دولت مدیریت
زمان اجرا کاملاً کاربردی است	مدیریت کاملاً کاربردی

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

اگرچه Edge for Private Cloud 4.52.02 شامل ارتقاء به Zookeeper نیست، اگر از نسخه‌های قدیمی‌تر از 4.52.01 ارتقا می‌دهید، باید مراحل ارتقا Zookeeper را دنبال کنید.

اگر از Edge برای Private Cloud نسخه های 4.51.00 یا 4.52.00 ارتقا می دهید، برای ارتقا Zookeeper به مراحل Required upgrade به Zookeeper 3.8.3 مراجعه کنید.
اگر از Edge برای Private Cloud نسخه 4.52.01 ارتقا می دهید، باید قبلاً از Zookeeper نسخه 3.8.3 استفاده کنید و نیازی به دنبال کردن مراحل خاصی برای ارتقا Zookeeper ندارید.

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

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

نیاز به ارتقاء به Qpid J-Broker

اگرچه Edge for Private Cloud 4.52.02 شامل ارتقاء به QPID نمی شود، اگر از نسخه های قدیمی تر از 4.52.01 ارتقا می دهید، باید مراحل ارتقاء QPID را دنبال کنید.

اگر از Edge برای Private Cloud 4.51.00 یا 4.52.00 به 4.52.02 ارتقا می دهید، لازم است مراحل ارتقاء QPID اضافی را دنبال کنید. اگر از نسخه 4.51.00 یا 4.52.00 به 4.52.02 ارتقا می دهید، لطفاً به بخش ارتقاء Qpid مراجعه کنید.
اگر از Edge برای Private Cloud 4.52.01 به 4.52.02 ارتقا می دهید، باید از آخرین نسخه Qpid Broker استفاده کنید و هیچ مرحله ارتقاء QPID اضافی لازم نیست.

رابط کاربری جدید 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.02 در یک گره با اتصال اینترنت خارجی

برای به روز رسانی اجزای 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.02.sh را در /tmp/bootstrap_4.52.02.sh دانلود کنید:
```
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
2. ابزار و وابستگی های Edge 4.52.02 apigee-service را با اجرای دستور زیر نصب کنید:
```
sudo bash /tmp/bootstrap_4.52.02.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.02 توضیح داده شده است استفاده کنید.

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

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

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

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

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

یک مخزن محلی 4.52.02 همانطور که در "ایجاد یک مخزن محلی Apigee" در نصب ابزار Edge apigee-setup توضیح داده شده است، ایجاد کنید.
توجه: اگر قبلاً یک مخزن موجود دارید، می‌توانید مخزن 4.52.02 را همانطور که در «به‌روزرسانی یک مخزن محلی Apigee» در نصب ابزار Edge apigee-setup توضیح داده شده است، به آن اضافه کنید.
برای نصب apigee-service از فایل tar :
1. در گره دارای مخزن محلی، از دستور زیر برای بسته بندی مخزن محلی در یک فایل .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz استفاده کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
2. فایل tar را در گره ای که می خواهید Edge را به روز کنید کپی کنید. به عنوان مثال، آن را در پوشه /tmp در گره جدید کپی کنید.
3. در گره جدید، فایل را در پوشه /tmp untar کنید:
```
tar -xzf apigee-4.52.02.tar.gz
```
  این دستور یک دایرکتوری جدید به نام repos در دایرکتوری حاوی فایل tar ایجاد می کند. به عنوان مثال /tmp/repos .
4. ابزار و وابستگی های Edge apigee-service را از /tmp/repos نصب کنید:
```
sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
  توجه داشته باشید که مسیر دایرکتوری repos را در این دستور قرار داده اید.
برای نصب apigee-service با استفاده از وب سرور Nginx:
1. وب سرور Nginx را همانطور که در «نصب از مخزن با استفاده از وب سرور Nginx» در نصب ابزار Edge apigee-setup توضیح داده شده پیکربندی کنید.
2. در گره راه دور، فایل Edge bootstrap_4.52.02.sh را در /tmp/bootstrap_4.52.02.sh دانلود کنید:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
  که در آن uName:pWord نام کاربری و رمز عبوری است که قبلاً برای مخزن تنظیم کرده‌اید و remoteRepo آدرس IP یا نام DNS گره repo است.
3. در گره راه دور، ابزار Edge apigee-setup و وابستگی ها را نصب کنید:
```
sudo bash /tmp/bootstrap_4.52.02.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.02 توضیح داده شده است استفاده کنید.

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

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

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

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

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

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

/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 را مجدداً راه اندازی کنید:
- 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 را در تمام دستگاه های موجود در آن مجدداً راه اندازی کنید.

Apigee از لبه ارتقاء برای ابر خصوصی مستقیماً از نسخه 4.51.00 ، 4.52.00 یا 4.52.01 به نسخه 4.52.02 پشتیبانی می کند. در این صفحه نحوه انجام چنین ارتقاء توضیح داده شده است.

احتیاط: از آنجا که Edge for Private Cloud 4.52.02 شامل یک نسخه اصلی به نسخه Cassandra است ، توصیه نمی شود که این مرکز به روزرسانی یک مرکز داده را به طور همزمان انجام دهید. مراحل به روزرسانی ذکر شده در این سند و ادعاهای مطرح شده (مانند هیچ تاثیری در ترافیک پروکسی در زمان اجرا) بر اساس این فرض است که مراحل به روزرسانی به صورت مستند دنبال می شود: ابتدا به روزرسانی خوشه Cassandra در کلیه مراکز داده ، ابتدا و پس از آن به روزرسانی از گره های کاربردی مانند سرور مدیریت لبه ، Edge-Message-Processor و غیره

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

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

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

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

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

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

پیش از پیش نیازهای زیر را قبل از به روزرسانی لبه Apigee اطمینان حاصل کنید:

پشتیبان گیری از همه گره ها
قبل از بروزرسانی ، توصیه می کنیم به دلایل ایمنی پشتیبان گیری کامل از همه گره ها را انجام دهید. برای انجام نسخه پشتیبان از این روش برای نسخه فعلی Edge استفاده کنید.
این امر به شما امکان می دهد در صورت بروزرسانی نسخه جدید به درستی ، یک برنامه پشتیبان تهیه کنید. برای اطلاعات بیشتر در مورد نسخه پشتیبان ، به نسخه پشتیبان و بازیابی مراجعه کنید.
اطمینان حاصل کنید که لبه در حال اجرا است
اطمینان حاصل کنید که لبه در طی فرایند به روزرسانی با استفاده از دستور کار کرده و در حال اجرا است:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
اطمینان حاصل کنید که استراتژی تراکم کاساندرا LeveledCompactionStrategy است
بسته به نسخه فعلی خود ، تغییرات لازم را در استراتژی تراکم کاساندرا انجام دهید. مراحل زیر را دنبال کنید و سپس به روش ارتقاء اصلی برگردید:
- اگر از نسخه 4.51.00 در حال ارتقا هستید ، به سند استراتژی تراکم Cassandra برای v4.51.00 مراجعه کنید.
- اگر از نسخه 4.52.00 در حال ارتقا هستید ، به سند استراتژی تراکم Cassandra برای V4.52.00 مراجعه کنید.
- اگر از نسخه 4.52.01 در حال ارتقا هستید ، به سند استراتژی تراکم Cassandra برای V4.52.01 مراجعه کنید.

چه اقدامات ویژه ای برای به روزرسانی در نظر گرفته شده است

برای به روزرسانی به Edge برای Cloud Private 4.52.02 ، اجرای مراحل خاص برای به روزرسانی نرم افزار خاص را در نظر بگیرید. مراحل لازم به نسخه فعلی شما بستگی دارد. برای نرم افزار مختلف که به مراحل تکمیلی نیاز دارند ، به جدول زیر مراجعه کنید و دستورالعمل های دقیق را برای هر یک دنبال کنید. پس از انجام وظایف لازم ، برای ادامه روند به روزرسانی به روش اصلی ارتقاء بازگشت.

نسخه فعلی	نرم افزاری که برای به روزرسانی به 4.52.02 نیاز به مراحل ویژه ای دارد	مرجع
4.52.01	کاساندرا	تغییر استراتژی تراکم کاساندرا
4.52.00	کاساندرا ، باغ وحش ، qpid	تغییر استراتژی تراکم کاساندرا
4.51.00	کاساندرا ، باغ وحش ، QPID ، Postgres	تغییر استراتژی تراکم کاساندرا

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

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

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

به روزرسانی مورد نیاز Cassandra 3.11.16

Apigee Edge برای Cloud Private 4.52.02 شامل ارتقاء Cassandra به نسخه 3.11.16 است. Cassandra یک مؤلفه مهم Apigee است ، و این ارتقاء همچنین شامل به روزرسانی های نرم افزار درایور در اجزای مختلف اجرا و مدیریت است که برای پرس و جو و نوشتن به کاساندرا استفاده می شود.

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

توجه: ابزار cassandra-cli دیگر در Cassandra 3.x پشتیبانی نمی شود و برای استفاده شما در دسترس نیست.

بازگشت به سطح بالا

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

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

برای اطلاعات بیشتر ، به بخش بروزرسانی Cassandra 3.11.16 مراجعه کنید.

مستند سازی API ها در پورتال توسعه دهنده

پورتال توسعه دهنده Apigee Drupal ویژگی های مختلفی را برای مستند سازی API های شما ارائه می دهد. در حالی که توصیه می شود از استفاده از پورتال توسعه دهنده مبتنی بر دروپال 7 دور شوید ، اگر هنوز از آن استفاده می کنید و از ویژگی SmartDocs آن استفاده می کنید ، استفاده از سند APIS SmartDocs برای شما صدق می کند. اگر از نسخه های جدیدتر پورتال توسعه دهنده استفاده می کنید ، در این بروزرسانی هیچ تاثیری در مستندات API شما نخواهد داشت.

هنگامی که Apigee را به نسخه 4.52.02 ارتقا می دهید ، هر مدل API ایجاد شده با استفاده از ویژگی SmartDocs پورتال توسعه دهنده دروپال 7 به طور خودکار به نسخه جدیدتر منتقل نمی شود. از شما انتظار می رود که هر مدل را با استفاده از پورتال توسعه دهنده به صورت دستی صادر کنید و پس از اتمام به روزرسانی دوباره آن را وارد کنید.

اصطلاحات مورد استفاده در بخش های زیر

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

مدیریت: مدیریت شامل مدیریت سیستم Apigee Edge شما است. این شامل ، اما محدود به استقرار ، اصلاح برنامه ها ، محصولات ، سرورهای هدف ، کلیدهای کلیدی و غیره نیست. کلیه API های مدیریت (و مشتری های آنها مانند Apigee UI و Portal Developer) در این دامنه گنجانده شده اند.

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

مرحله 0: حالت را شروع کنید

Cassandra in apigee با نسخه 2.1.22 اجرا می شود.
Edge for Private Cloud 4.52.02 مؤلفه ها:

ارتباطات-سرور مدیریت با کاساندرا از طریق پروتکل Thrift قدیمی تر.
سرورهای زمان اجرا (پردازنده های پیام و روترها) از طریق پروتکل Thrift قدیمی تر با کاساندرا ارتباط برقرار می کنند.

حالت زمان اجرا در این مرحله	وضعیت مدیریت در این مرحله
زمان اجرا کاملاً کاربردی	مدیریت کاملاً کاربردی

مرحله 1: برای ارتقاء آماده شوید

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

CASSANDRA را برای استفاده از SelepedCompactionStrategy تغییر دهید.
Backup Cassandra با استفاده از Apigee.
عکسهای VM از گره های کاساندرا (در صورت امکان) بگیرید.
یک فایل پیکربندی ارتقاء کاساندرا را در هر گره Cassandra در /opt/apigee/apigee-cassandra/cass_upgrade.conf با محتویات زیر ایجاد کنید:
```
# IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    
```
اگر پرونده را نمی توان در /opt/apigee/apigee-cassandra/cass_upgrade.conf ایجاد کرد ، File /opt/silent.conf را با همان محتویات در هر گره Cassandra ایجاد کنید.
احتیاط: نصب کننده ارتقاء Apigee به دنبال پرونده در مکان های ذکر شده در بالا خواهد بود. اگر پرونده در هر یک از مکانهای ذکر شده در بالا وجود نداشته باشد ، ارتقاء با پیامی مانند زیر شکست می خورد:
```
could not read env location: '/opt/apigee/apigee-cassandra/cass_upgrade.conf'
file does not exist or cannot be sourced
could not read env location: '/opt/silent.conf'
file does not exist or cannot be sourced
```
اگر این اتفاق بیفتد ، به روزرسانی شکست خواهد خورد اما سرویس کاساندرا روی گره احتمالاً در حالت متوقف خواهد بود. شما می توانید سرویس Cassandra را طبق معمول شروع کرده و با قرار دادن پرونده پیکربندی در هر یک از مکان های مورد انتظار ، ارتقاء را دوباره انجام دهید. علاوه بر این ، اگر پرونده پیدا شود اما تنظیمات ارائه شده نادرست است (برای مثال ، اعتبار Cassandra نادرست است) ، آنگاه به روزرسانی با خطایی مانند زیر انجام می شود:
```
Error in PREIN scriptlet in rpm package apigee-cassandra-X.XX.XX-X.X.XXXX.noarch
```
در این حالت ، به طور مشابه ، در صورت متوقف شدن به روزرسانی ، سرویس Cassandra را شروع کنید و پس از رفع تنظیمات در پرونده ، به روزرسانی مجدد را انجام دهید.

اگر از ویژگی SmartDocs از پورتال توسعه دهنده Apigee Drupal 7 استفاده می کنید ، با بارگیری آنها در فرمت JSON از پورتال توسعه دهنده UI ، از هر یک از مدل های خود صادرات کنید . پس از بروزرسانی سرورهای مدیریت ، این مدل ها باید دوباره به Apige وارد شوند.
اطمینان حاصل کنید که درگاه های 9160 و 9042 از Edge برای Cloud Private 4.52.02 اجزای موجود در گره های کاساندرا در صورت وجود در دسترس نیست. برای اطلاعات بیشتر به الزامات بندر مراجعه کنید.

مرحله 2: همه گره های کاساندرا را ارتقا دهید

همه گره های کاساندرا را در همه مناطق یک به یک ارتقا دهید. دستورات زیر را روی هر گره اجرا کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
پس از بروزرسانی یک گره ، دستور زیر را روی گره اجرا کنید تا برخی از اعتبارسنجی ها را قبل از ادامه کار اجرا کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
```

موارد فوق چیزی را در امتداد خطوط:

Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified

حالت زمان اجرا در این مرحله	وضعیت مدیریت در این مرحله
زمان اجرا کاملاً کاربردی	عملکرد مدیریت زیر پس از به روزرسانی کاساندرا تخریب می شود: API مدیریت برای ایجاد محصول API با محیط API مدیریت برای به روزرسانی یک محصول API با محیط API مدیریت برای حذف یک سازمان

توجه: اگر در حال ارتقاء از Edge Private Cloud 4.51.00 یا 4.52.00 هستید ، برای به روزرسانی Zookeeper نیز باید مراحل اضافی را دنبال کنید. حتی اگر Zookeeper و Cassandra ممکن است در همان گره ها مستقر شوند ، توصیه می شود Zookeeper و Cassandra را به طور جداگانه به روز کنید.

برای به روزرسانی باغ وحش می توانید از دستور زیر در یک گره استفاده کنید:

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

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

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

اگر در حال ارتقاء از Edge Private Cloud 4.52.01 به 4.52.02 هستید ، ارتقاء Zookeeper یک به روزرسانی جزئی است و می تواند در کنار کاساندرا انجام شود. برای به روزرسانی هر دو Cassandra و Zookeeper از طریق یک دستور واحد روی گره هایی که در آن جمع شده اند ، از دستور زیر استفاده کنید. توصیه می شود این کار را انجام دهید فقط در صورتی که در حال اجرا Zookeeper نسخه 3.8.3 در نسخه ابر خصوصی 4.52.01 هستید:

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

احتیاط: با یک به روزرسانی عمده کاساندرا ، توصیه می شود به طور هم زمان کل خوشه کاساندرا (در تمام مراکز داده) را ارتقا دهید. به روزرسانی های عمده کاساندرا شامل تغییرات شمای خودکار است و تا زمانی که کل خوشه به روز نشود ، طرح خوشه کاساندرا متناقض باقی می ماند.

اگر قبل از اتمام به روزرسانی کل خوشه Cassandra ، سعی در به روزرسانی سرور مدیریت Edge-Management دارید ، به روزرسانی سرور مدیریت Edge-Management شکست خواهد خورد و سرویس مدیریت سرور مدیریت Edge از شروع کار خودداری خواهد کرد.

مرحله 3: تمام گره های مدیریتی را ارتقا دهید

همه گره های مدیریتی را در همه مناطق یک به یک ارتقا دهید:

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

حالت کار	حالت مدیریت
زمان اجرا کاملاً کاربردی	API مدیریت تخریب شده: ویژگی SmartDocs از پورتال توسعه دهنده دروپال 7 هیچ داده ای را نشان نمی دهد

مرحله 3A: [اختیاری] واردات SmartDocs که قبلاً صادر شده بودند

پس از به روزرسانی همه سرورهای مدیریت ، می توانید مدل های SmartDocs را که در مرحله 1 صادر کرده اید وارد کنید. می توانید بعداً تصمیم بگیرید که این کار را انجام دهید.

حالت کار	حالت مدیریت
زمان اجرا کاملاً کاربردی	مدیریت کاملاً کاربردی

مرحله 4: تمام گره های زمان اجرا را ارتقا دهید

تمام روترها و گره های پردازنده پیام را در همه مناطق یک به یک ارتقا دهید:

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

حالت کار	حالت مدیریت
زمان اجرا کاملاً کاربردی	مدیریت کاملاً کاربردی

مرحله 5: تمام لبه های باقی مانده برای Cloud Private 4.52.02 مؤلفه ها را ارتقا دهید

تمام گره های edge-qpid-server و edge-postgres-server را در همه مناطق یک به یک به روز کنید.

در این مرحله ، اگر در حال ارتقاء از نسخه های زودتر از Edge برای Cloud Private 4.52.01 هستید و مراحل دیگری را برای به روزرسانی QPID یا Postgres دنبال می کنید ، مراحل مربوطه را برای به روزرسانی همان دنبال کنید.

حالت کار	حالت مدیریت
زمان اجرا کاملاً کاربردی	مدیریت کاملاً کاربردی

مرحله 6: مراحل ارتقاء

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

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

دستور زیر را اجرا کنید تا جداول استفاده نشده قدیمی را از خوشه Cassandra رها کنید. تا زمانی که این کار اجرا نشود ، شما نمی توانید از ویژگی های خاصی از Cassandra استفاده کنید (مانند تنظیم احراز هویت جدید - مکانیسم های احراز هویت قدیمی به کار خود ادامه می دهند). این دستور فقط در 1 گره در خوشه قابل اجرا است:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

مرحله 3A را کامل کنید اگر قبلاً چنین کاری نکرده اید.

حالت کار	حالت مدیریت
زمان اجرا کاملاً کاربردی	مدیریت کاملاً کاربردی

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

حتی اگر Edge for Private Cloud 4.52.02 شامل ارتقاء Zookeeper نباشد ، اگر در حال ارتقاء از نسخه های قدیمی تر از 4.52.01 هستید ، برای به روزرسانی Zookeeper باید مراحل را دنبال کنید.

اگر در حال ارتقاء از Edge برای نسخه های ابری خصوصی 4.51.00 یا 4.52.00 هستید ، برای به روزرسانی Zookeeper به مراحل لازم برای ارتقاء Zookeeper 3.8.3 مراجعه کنید.
اگر در حال ارتقاء از Edge for Private Cloud نسخه 4.52.01 هستید ، باید در حال حاضر از نسخه Zookeeper 3.8.3 استفاده کنید و نیازی به دنبال کردن هر مرحله ویژه برای به روزرسانی Zookeeper نیست.

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

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

به روزرسانی مورد نیاز به qpid j-broker

حتی اگر Edge for Private Cloud 4.52.02 شامل ارتقاء QPID نباشد ، اگر در حال ارتقاء از نسخه های قدیمی تر از 4.52.01 هستید ، برای به روزرسانی QPID باید مراحل را دنبال کنید.

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

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.02 بروزرسانی کنید

برای به روزرسانی اجزای 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.02.sh را به /tmp/bootstrap_4.52.02.sh بارگیری کنید:
```
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
2. Edge 4.52.02 apigee-service Utility و وابستگی ها را با اجرای دستور زیر نصب کنید:
```
sudo bash /tmp/bootstrap_4.52.02.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.02 استفاده کنید.

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

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

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

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

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

یک repo محلی 4.52.02 ایجاد کنید همانطور که در "ایجاد یک مخزن محلی Apigee" در نصب ابزار Edge Apigee-setup توضیح داده شده است.
توجه: اگر در حال حاضر یک repo موجود دارید ، می توانید repo 4.52.02 را به آن اضافه کنید همانطور که در "به روزرسانی یک مخزن محلی Apigee" در نصب Edge Apigee-Setup Toletical توضیح داده شده است.
برای نصب سرویس Apigee از یک پرونده .tar :
1. در گره با repo محلی ، از دستور زیر استفاده کنید تا repo محلی را در یک پرونده .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz : بسته بندی کنید.
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
2. پرونده .tar را در گره ای که می خواهید Edge را به روز کنید ، کپی کنید. به عنوان مثال ، آن را در فهرست /tmp در گره جدید کپی کنید.
3. در گره جدید ، پرونده را به فهرست /tmp فهرست کنید:
```
tar -xzf apigee-4.52.02.tar.gz
```
  این دستور دایرکتوری جدیدی به نام repos را در دایرکتوری حاوی پرونده .tar ایجاد می کند. به عنوان مثال /tmp/repos .
4. ابزار و وابستگی های Edge apigee-service را از /tmp/repos نصب کنید:
```
sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
  توجه داشته باشید که شما مسیر دایرکتوری repos را در این دستور قرار می دهید.
برای نصب سرویس Apigee با استفاده از NGINX WebServer:
1. سرور وب Nginx را همانطور که در "نصب از repo با استفاده از WebServer Nginx" در نصب Edge Apigee-Setup تنظیم شده است ، پیکربندی کنید.
2. در گره از راه دور ، پرونده Edge bootstrap_4.52.02.sh را به /tmp/bootstrap_4.52.02.sh بارگیری کنید:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
  جایی که uName:pWord نام کاربری و رمز عبوری است که قبلاً برای repo تنظیم کرده اید ، و remoteRepo آدرس IP یا نام DNS گره repo است.
3. در گره از راه دور ، ابزار و وابستگی های Edge apigee-setup را نصب کنید:
```
sudo bash /tmp/bootstrap_4.52.02.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.02 استفاده کنید.

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

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

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

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

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

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

/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
```
(If you installed Apigee SSO) Update Apigee SSO on machine 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Where sso_config_file is the configuration file you created when you installed SSO .
Restart the UI component:
- Classic UI: If you are using the classic UI, then restart the edge-ui component on machine 1, as the following example shows:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- New Edge UI: If you installed the new Edge UI, then restart the edge-management-ui component on the appropriate machine (may not be machine 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

9-node clustered upgrade

Update the following components for a 9-node clustered installation:

See Installation topologies for the list of Edge topologies and node numbers.

Update Cassandra and ZooKeeper on machine 1, 2, and 3:

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

Update Postgres on machine 8:

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

Update Postgres on machine 9:

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

Update LDAP on machine 1:

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

Update Edge components on machine 6, 7, 8, 9, 1, 4, and 5 in that order:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Update Qpid on machines 6 and 7:

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

Update either the new UI ( ue ) or classic UI ( ui ) on machine 1:

/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

(If you installed apigee-adminapi ) Update the apigee-adminapi utility on machine 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(If you installed Apigee SSO) Update Apigee SSO on machine 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Where sso_config_file is the configuration file you created when you installed SSO .
Restart the UI component:
- Classic UI: If you are using the classic UI, then restart the edge-ui component on machine 1, as the following example shows:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- New Edge UI: If you installed the new Edge UI, then restart the edge-management-ui component on the appropriate machine (may not be machine 1):
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

13-node clustered upgrade

Update the following components for a 13-node clustered installation:

See Installation topologies for the list of Edge topologies and node numbers.

Update Cassandra and ZooKeeper on machines 1, 2, and 3:

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

Update Postgres on machine 8:

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

Update Postgres on machine 9:

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

Update LDAP on machine 4 and 5:

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

Update Edge components on machines 12, 13, 8, 9, 6, 7, 10, and 11 in that order:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

Update Qpid on machines 12 and 13:

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

Update either the new UI ( ue ) or classic UI ( ui ) on machines 6 and 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(If you installed apigee-adminapi ) Updated the apigee-adminapi utility on machines 6 and 7:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(If you installed Apigee SSO) Update Apigee SSO on machines 6 and 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Where sso_config_file is the configuration file you created when you installed SSO .
Restart the UI component:
- Classic UI: If you are using the classic UI, then restart the edge-ui component on machines 6 and 7, as the following example shows:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```
- New Edge UI: If you installed the new Edge UI, then restart the edge-management-ui component on machines 6 and 7:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```

12-node clustered upgrade

Update the following components for a 12-node clustered installation:

See Installation topologies for the list of Edge topologies and node numbers.

Update Cassandra and ZooKeeper:

On machines 1, 2 and 3 in Data Center 1:

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

On machines 7, 8, and 9 in Data Center 2

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

Update Postgres:

Machine 6 in Data Center 1

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

Machine 12 in Data Center 2

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

Update LDAP:

Machine 1 in Data Center 1

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

Machine 7 in Data Center 2

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

Update Edge components:

Machines 4, 5, 6, 1, 2, 3 in Data Center 1

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

Machines 10, 11, 12, 7, 8, 9 in Data Center 2

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

Update qpidd:

Machines 4, 5 in Data Center 1

Update qpidd on machine 4:

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

Update qpidd on machine 5:

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

Machines 10, 11 in Data Center 2

Update qpidd on machine 10:

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

Update qpidd on machine 11:

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

Update either the new UI ( ue ) or classic UI ( ui ):

Machine 1 in Data Center 1:

/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

Machine 7 in Data Center 2:

/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

(If you installed apigee-adminapi ) Updated the apigee-adminapi utility:

Machine 1 in Data Center 1:

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

Machine 7 in Data Center 2:

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

(If you installed Apigee SSO) Update Apigee SSO:
1. Machine 1 in Data Center 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
2. Machine 7 in Data Center 2:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
Restart the new Edge UI ( edge-management-ui ) or classic Edge UI ( edge-ui ) component on machines 1 and 7:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```

For a non-standard configuration

If you have a non-standard configuration, then update Edge components in the following order:

باغ وحش
کاساندرا
ps
LDAP
Edge, meaning the "-c edge" profile on all nodes in the order: nodes with Qpid server, Edge Postgres Server, Management Server, Message Processor, and Router.
NOTE: If a node has both Qpid server and Edge Postgres Server installed, run the "-c edge" profile step.
qpidd
Edge UI (either classic or new)
apigee-adminapi
Apigee SSO

After you finish updating, be sure to restart the Edge UI component on all machines running it.