‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

به‌روزرسانی Apigee Edge نسخه ۴.۵۳.۰۰ یا ۴.۵۳.۰۱ به ۴.۵۴.۰۰

Apigee از ارتقای Edge for Private Cloud مستقیماً از نسخه 4.53.00 یا 4.53.01 به نسخه 4.54.00 پشتیبانی می‌کند. این صفحه نحوه انجام چنین ارتقاهایی را شرح می‌دهد.

برای نمای کلی مسیرهای ارتقای سازگار، ماتریس سازگاری ارتقا برای نسخه‌های Edge for Private Cloud را ببینید.

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

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

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

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

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

مطالب پیش‌مطالعه

برای اطلاع از اطلاعات مهم درباره تغییرات معرفی‌شده در Edge for Private Cloud نسخه ۴.۵۴.۰۰، موضوعات زیر را مرور کنید:

تغییرات در نسخه ۴.۵۴.۰۰: تغییرات در «فراخوانی جاوا» و «امنیت لایه انتقال» را که قبل‌از ارتقا نیاز به آماده‌سازی دارند بررسی کنید. برای اطلاعات بیشتر، تغییرات در نسخه ۴.۵۴.۰۰ را ببینید.
معماری زمان اجرای Dual-Java (‏Java 17 و Java 21): از نسخه ۴.۵۴.۰۰، Edge for Private Cloud پشتیبانی از Java 8 را حذف می‌کند و مؤلفه‌ها را روی Java 17 یا Java 21 اجرا می‌کند. برای اطلاعات بیشتر، تغییرات در نسخه ۴.۵۴.۰۰ را ببینید.
عدم نصب خودکار Java درطول راه‌اندازی اولیه: Edge for Private Cloud نسخه ۴.۵۴.۰۰ قابلیت شناسایی نصب‌های Java را دارد و تأیید می‌کند که Java 17 و 21 را نصب کرده‌اید.
واسط کاربر Edge جدید در نسخه ۴.۵۴.۰۰: با انتقال به واسط کاربر Edge جدید به‌عنوان میانای مدیریت پیش‌فرض و حذف واسط کاربر کلاسیک (edge-ui) آشنا شوید. برای اطلاعات بیشتر، واسط کاربر Edge جدید را ببینید.
‫Apigee SSO در نسخه 4.54.00: با معماری SSO به‌روزشده و تغییرات پیکربندی برای اصالت‌سنجی آشنا شوید. برای اطلاعات بیشتر، به Apigee SSO مراجعه کنید.
Nginx 1.30 در 4.54.00: ارتقای خودکار Nginx 1.30.x در Edge Routers، تأثیرات احتمالی زمان اجرا، و مراحل کاهش را مرور کنید. برای اطلاعات بیشتر، تغییرات Nginx 1.30 را ببینید.

پیش‌نیازهای ارتقا

پیش‌از ارتقا دادن Apigee Edge، پیش‌نیازهای زیر را بررسی کنید:

مرور یادداشت‌های انتشار و ویژگی‌های جدید

پیش‌از شروع فرایند ارتقا، مطمئن شوید که همه ویژگی‌های جدید، تغییرات رفتاری، و موارد منسوخ‌شده را که در یادداشت‌های انتشار Edge for Private Cloud برای نسخه ۴.۵۴.۰۰ به‌طور مفصل شرح داده شده است به‌دقت مرور کرده‌اید و متوجه شده‌اید.
کشف و همزیستی خودکار باینری جاوا درطول ارتقا: جاوا را بااستفاده از مدیران بسته استاندارد (مثل yum) یا مکان‌های استاندارد (مثل /usr/lib/jvm یا update-alternatives) نصب کنید. لازم نیست هر دو نسخه را به‌طور هم‌زمان در PATH سیستم پیکربندی کنید. پیش‌از ارتقا دادن، Java 8 را حذف نصب نکنید. Java 8 را درکنار Java 17 و Java 21 نصب‌شده نگه دارید تا سرویس‌های Edge for Private Cloud 4.53.xx موجود بدون وقفه به کار خود ادامه دهند تا زمانی که به‌روز شوند.
پشتیبان‌گیری از همه گره‌ها

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

مطمئن شوید که نسخه‌های پشتیبان فایل‌های پیکربندی بی‌صدا برای Edge for Private Cloud نسخه 4.53.00 یا 4.53.01 حفظ شده‌اند تا درصورت نیاز، بازگشت به نسخه قبلی تسهیل شود.
مطمئن شوید Edge درحال اجرا است

بااستفاده از فرمان زیر، مطمئن شوید که Edge درطول فرایند به‌روزرسانی فعال و درحال اجرا است:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
درستی‌سنجی پیش‌نیازهای Cassandra

اگر قبلاً از نسخه قدیمی‌تر Edge for Private Cloud به نسخه 4.53.00 (یا) 4.53.01 ارتقا داده‌اید و اکنون قصد دارید به نسخه 4.54.00 ارتقا دهید، مطمئن شوید که مراحل لازم پس‌از ارتقا را برای Cassandra تکمیل کرده‌اید. این مراحل در سند ارتقای نسخه ۴.۵۳.۰۰ (یا) ۴.۵۳.۰۱ شرح داده شده است و همچنین در بخش پیش‌نیازهای ارتقای Cassandra ذکر شده است. اگر مطمئن نیستید که این مراحل درطول ارتقای قبلی تکمیل شده‌اند یا نه، قبل‌از ادامه دادن ارتقا به نسخه ۴.۵۴.۰۰، آن‌ها را دوباره تکمیل کنید.
Stop apigee-monit: If apigee-monit is running on the node, stop it with /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop prior to upgrading. این کار از بازراه‌اندازی خودکار مؤلفه‌ها توسط apigee-monit درحین ارتقا یافتن آن‌ها جلوگیری می‌کند. پس‌از تکمیل ارتقا، آن را با apigee-service apigee-monit start دوباره فعال کنید.

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

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

ارتقا دادن «رهیاب» و «پردازشگر پیام»

همه گره‌های «پردازشگر پیام» و «مسیریاب» را در مراکز داده یکی‌یکی ارتقا دهید:

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

ارتقا دادن سرور مدیریت

همه گره‌های «سرور مدیریت» را در مراکز داده یکی‌یکی ارتقا دهید:

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

ارتقا به OpenLDAP 2.6.10

‫Edge for Private Cloud نسخه ۴.۵۴.۰۰ ‏OpenLDAP 2.6.10 را معرفی می‌کند. این ارتقا برای همه توپولوژی‌های استقرار Apigee OpenLDAP اعمال می‌شود: تک‌کارساز، فعال-غیرفعال، و فعال-فعال (چندکارساز).

آماده‌سازی و نصب (همه سرورهای LDAP)

مراحل ارتقا دادن LDAP از نسخه ۴.۵۳.۰۰ به ۴.۵۴.۰۰

پیش‌نیازها و ملاحظات

توجه داشته باشید که درطول فرایند انتقال OpenLDAP 2.4 به 2.6.10 (هنگام ارتقا از 4.53.00)، میاناهای برنامه‌سازی کاربردی مدیریت و درنتیجه میانای کاربری Apigee در هیچ منطقه‌ای دردسترس نخواهند بود. همه وظایف سرپرستی—مثل مدیریت کاربران، نقش‌ها، برنامه‌ها، و سازمان‌ها—انجام نخواهد شد و باید متوقف شود. این امر تأثیری بر پردازش ترافیک پراکسی میانای برنامه‌سازی کاربردی شما ندارد. پیش‌از ادامه دادن انتقال LDAP، همه نمونه‌های edge-management-server و edge-ui را خاموش کنید.
پشتیبان‌گیری ضروری است (هنگام ارتقا از نسخه ۴.۵۳.۰۰): هنگام ارتقا از Edge برای Private Cloud نسخه ۴.۵۳.۰۰ (OpenLDAP نسخه ۲.۴.۴۶)، پشتیبان‌گیری کامل و معتبر از داده‌های LDAP موجود الزامی است. ادامه دادن بدون پشتیبان‌گیری معتبر باعث ازدست رفتن غیرقابل‌برگشت داده‌ها می‌شود. پشتیبان‌گیری را درحالی‌که سرویس LDAP هنوز درحال اجرا است شروع کنید تا یک تصویر فوری سازگار و هم‌زمان از داده‌های LDAP ضبط کنید. بدون پشتیبان‌گیری، نمی‌توانید انتقال از نسخه ۲.۴ به ۲.۶.۱۰ را اجرا کنید یا به نسخه قبلی برگردید، زیرا مراحل انتقال نسخه ۴.۵۳.۰۰ دایرکتوری‌های داده‌های LDAP قدیمی را پاک می‌کند.

خاموش کردن سرور مدیریت و میانای کاربر: قبل‌از ادامه دادن انتقال LDAP از نسخه ۴.۵۳.۰۰، همه نمونه‌های edge-management-server و edge-ui را خاموش کنید.
```
apigee-service edge-management-server stop
apigee-service edge-ui stop
```
پشتیبان‌گیری از داده‌های LDAP موجود: قبل‌از ایجاد هرگونه تغییر هنگام ارتقا از نسخه ۴.۵۳.۰۰ (OpenLDAP 2.4.46)، پشتیبان‌گیری کامل از داده‌های LDAP فعلی را از همه سرورهای LDAP انجام دهید. این کار نقطه بازگرداندن ایمنی ایجاد می‌کند. (هنگام ارتقا از نسخه ۴.۵۳.۰۱ به ۴.۵۴.۰۰، این توالی پشتیبان‌گیری، توقف، و پاک‌سازی لازم نیست.)
- فرمان پشتیبان‌گیری را اجرا کنید. این کنش بایگانی پشتیبان‌گیری با مُهر زمان در دایرکتوری /opt/apigee/backup/openldap ایجاد می‌کند.
```
apigee-service apigee-openldap backup
```
- دریافت تعداد کل سوابق: تعداد سوابق موجود در دایرکتوری‌تان را برای اعتبارسنجی پس‌از ارتقا ثبت کنید. (تعداد سوابق باید در همه سرورهای LDAP مطابقت داشته باشد.)
```
# Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
-D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
```
متوقف کردن LDAP و پاک کردن فهرست‌های راهنمای داده: این مرحله را در همه سرورهای LDAP فقط درصورتی‌که از نسخه ۴.۵۳.۰۰ (OpenLDAP 2.4.46) ارتقا می‌دهید انجام دهید. اگر درحال ارتقا دادن از نسخه 4.53.01 (OpenLDAP 2.6.7) هستید، LDAP را متوقف نکنید یا /opt/apigee/data/apigee-openldap/* را حذف نکنید. برای ارتقاهای 4.53.00، این مرحله به‌دلیل تغییر نسخه اصلی و تفاوت‌های ساختاری پایگاه داده زیربنایی اجباری است. وقتی همه سرورهای LDAP متوقف شوند، اختلال در Management API و میانای کاربر شروع می‌شود.
- سرویس LDAP را متوقف کنید.
```
apigee-service apigee-openldap stop
```
- فهرست‌های پیکربندی و داده‌های قدیمی LDAP را برای همیشه بردارید.
```
rm -rf /opt/apigee/data/apigee-openldap/*
```
نصب و پیکربندی نسخه جدید LDAP در همه سرورهای LDAP، از دستورگان استاندارد Apigee برای بارگیری و نصب نسخه جدید عنصر استفاده کنید.
- نصب مؤلفه جدید LDAP: اسکریپت به‌روزرسانی فایل پیکربندی شما را می‌خواند و بسته جدید apigee-openldap را نصب می‌کند.
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
- نسخه جدید LDAP را اعتبارسنجی کنید: پس‌از تکمیل نصب، نمایه را مجدد بار کنید و تأیید کنید که نسخه جدید LDAP (2.6.10) نصب شده است:
```
echo 'export PATH=/opt/symas/bin:$PATH' >> ~/.bash_profile
source ~/.bash_profile
ldapsearch -VV
```
  برونداد فرمان مشخص‌شده در بالا باید نسخه ۲.۶.۱۰ «پروتکل سبک‌وزن دایرکتوری» را همان‌طور که در زیر نشان داده شده است تأیید کند:
```
Expected output:
ldapsearch: @(#) OpenLDAP: ldapsearch 2.6.10
```
قبل‌از بازیابی داده‌ها، LDAP را در همه سرورها متوقف کنید: مراحل ۵، ۶، و ۷ را فقط درصورتی انجام دهید که از نسخه ۴.۵۳.۰۰ (OpenLDAP 2.4.46) ارتقا می‌دهید (اگر در مرحله ۴ از نسخه ۴.۵۳.۰۱ ارتقا داده‌اید، داده‌های LDAP موجود شما حفظ می‌شود و ارتقا تکمیل شده است). قبل‌از بازیابی نسخه پشتیبان از 4.53.00، مطمئن شوید سرویس LDAP تازه نصب‌شده در همه سرورها متوقف شده است. در هر سرور LDAP، فرمان‌های زیر را اجرا کنید:
```
apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/ldap/*
```
بازیابی داده‌های LDAP: راهبرد این است که نسخه پشتیبان را در اولین سرور فعال بازیابی کنید. این سرور سپس به‌عنوان منبع حقیقت عمل می‌کند و داده‌ها را در تنظیمات چندسروری به همتایان خود تکثیر می‌کند.
1. شناسایی اولین سرور فعال برای بازیابی:
  - برای راه‌اندازی تک‌سرور: این تنها سرور LDAP شما است. می‌توانید مستقیماً به مرحله بعدی بروید.
  - برای راه‌اندازی‌های فعال-غیرفعال و فعال-فعال: فرمان عیب‌یابی زیر را در هر سرور LDAP اجرا کنید:
```
grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*.ldif
```
    توجه:
    - اگر فرمان بالا برونداد برگرداند، سرور یک سرور منفعل است.
    - اگر خروجی‌ای برنگرداند، سرور همان سرور فعال است.
2. بازیابی داده‌های پشتیبان‌گیری: قبل‌از ادامه دادن، دوباره بررسی کنید که مرحله ۵ در همه سرورهای LDAP با موفقیت تکمیل شده باشد.
  - در اولین سرور فعالی که در بالا شناسایی کردید، به فهرست راهنمای پشتیبان‌گیری پیمایش کنید.
```
cd /opt/apigee/backup/openldap
```
  - فرمان بازیابی را اجرا کنید. برای جلوگیری از بازیابی نسخه ناخواسته یا قدیمی‌تر، مُهر زمان دقیق نسخه پشتیبان را از «مرحله ۲» مشخص کنید.
```
# To restore a specific backup (recommended):
apigee-service apigee-openldap restore 2025.08.11,23.34.00

# To restore the latest available backup by default:
apigee-service apigee-openldap restore
```
  - پس‌از تکمیل موفقیت‌آمیز فرایند بازیابی، سرویس LDAP را در اولین سرور فعال راه‌اندازی کنید.
```
apigee-service apigee-openldap start
```
راه‌اندازی سرورهای LDAP باقی‌مانده: اگر راه‌اندازی چندسروری دارید، در هریک از سرورهای LDAP، سرویس را راه‌اندازی کنید:
```
apigee-service apigee-openldap start
```
توجه: نیازی نیست داده‌ها را به‌صورت دستی در این سرورهای همتا بازیابی کنید. پس‌از شروع، آن‌ها به سرور اول (که اکنون حاوی داده‌های بازیابی‌شده است) متصل می‌شوند و به‌طور خودکار کل دایرکتوری را ازطریق تکرار همگام‌سازی می‌کنند.
اعتبارسنجی نهایی گام نهایی این است که تأیید کنید ارتقا موفقیت‌آمیز بوده است و داده‌ها در سراسر خوشه LDAP سازگار هستند.
- فرمان اعتبارسنجی را در همه سرورهای LDAP اجرا کنید. تعداد سوابق باید در همه سرورها یکسان باشد و با تعدادی که در «مرحله ۲» ثبت کردید مطابقت داشته باشد:
```
# Note: Replace 'YOUR_PASSWORD' with your LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
```
- پس‌از اینکه تأیید کردید داده‌ها درست و سازگار است، ارتقای LDAP شما تکمیل می‌شود. اکنون می‌توانید edge-management-server،‏ edge-ui، و هر مؤلفه وابسته دیگری را طبق روال ارتقای استاندارد سازمانتان شروع کنید.

مراحل ارتقا دادن LDAP از نسخه ۴.۵۳.۰۱ به ۴.۵۴.۰۰

نصب و پیکربندی نسخه جدید LDAP در همه سرورهای LDAP، از اسکریپت‌های استاندارد Apigee برای بارگیری و نصب نسخه جدید مؤلفه استفاده کنید.

نصب مؤلفه جدید LDAP: اسکریپت به‌روزرسانی فایل پیکربندی شما را می‌خواند و بسته جدید apigee-openldap را نصب می‌کند.
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
نسخه جدید LDAP را اعتبارسنجی کنید: پس‌از تکمیل نصب، نمایه را مجدد بار کنید و تأیید کنید که نسخه جدید LDAP (2.6.10) نصب شده است:
```
echo 'export PATH=/opt/symas/bin:$PATH' >> ~/.bash_profile
source ~/.bash_profile
ldapsearch -VV
```
خروجی فرمان مشخص‌شده در بالا باید نسخه LDAP‏ ۲.۶.۱۰ را همان‌طور که در زیر نشان داده شده است تأیید کند:
```
Expected output:
ldapsearch: @(#) OpenLDAP: ldapsearch 2.6.10
```

به «میانای کاربری New Edge» و «ورود به سیستم Apigee» ارتقا دهید (درصورت نصب)

در Apigee Edge برای Private Cloud نسخه ۴.۵۴.۰۰، «رابط کاربری کلاسیک» (edge-ui) برداشته شده و با رابط کاربری Edge جدید (edge-management-ui) جایگزین شده است. بسته به اینکه «ورود یکپارچه» (SSO) در Apigee در راه‌اندازی شما نصب شده و استفاده می‌شود یا نه، یکی از دو گزینه زیر را دنبال کنید:

گزینه ۱: ارتقا دادن واسط کاربر (بدون Apigee SSO)

این بخش منحصراً درصورتی اعمال می‌شود که Apigee SSO (apigee-sso) در نصب Edge for Private Cloud نسخه 4.53.00 یا 4.53.01 موجود شما پیکربندی / نصب نشده باشد

به‌عنوان بخشی از فرایند ارتقا به Edge for Private Cloud نسخه ۴.۵۴.۰۰، «واسط کاربر کلاسیک» (edge-ui) برداشته می‌شود. اجرای فرمان ارتقا زیر گره میانای کاربر را از میانای کاربر کلاسیک (edge-ui) به میانای کاربر جدید Edge(edge-management-ui) منتقل می‌کند.

مرحله ۱: پشتیبان‌گیری از فایل‌های پیکربندی

پیش‌از شروع، از فایل پیکربندی بی‌صدای موجود (configFile) و دایرکتوری /opt/apigee/customer/application/ در همه گره‌های میانای کاربر پشتیبان‌گیری کنید.

مرحله ۲: به‌روزرسانی فایل پیکربندی بی‌صدا برای «اصالت‌سنجی پایه»

فایل پیکربندی بی‌صدا (برای مثال، /opt/silent.conf) را ویرایش کنید و ویژگی‌های New Edge UI زیر را برای «اصالت‌سنجی پایه» اضافه کنید:

# Authentication mode for New Edge UI (Basic Authentication - No Apigee SSO)
AUTH_MODE=basic

# Access configuration for the New Edge UI
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_IP=MANAGEMENT_UI_NODE_IP #Replace MANAGEMENT_UI_NODE_IP with the IP address or hostname of the UI node.
MANAGEMENT_UI_SCHEME=http

مرحله ۳: ارتقا دادن مؤلفه میانای کاربر

برای ارتقا از «واسط کاربر کلاسیک» (edge-ui) به «واسط کاربر جدید Edge» (edge-management-ui)، متن update.sh را با عنصر -c ue اجرا کنید:

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

مرحله ۴: تأیید ارتقای New Edge UI

پس‌از تکمیل موفقیت‌آمیز فرایند ارتقا در همه گره(های) میانای کاربر، لطفاً درستی‌سنجی کنید که نسخه 4.54.00 New Edge UI کاملاً عملیاتی و دردسترس است:

بررسی کنید که سرویس edge-management-ui درحال اجرا باشد:
```
apigee-service edge-management-ui status
```
مرورگری را باز کنید و به این نشانی بروید:
```
http://MANAGEMENT_UI_NODE_IP:3001
```
پس‌از درستی‌سنجی، از گزینه ۲: ارتقا دادن میانای کاربر (با «شناسایی یگانه» Apigee) رد شوید و مستقیماً به ارتقا دادن الزامی به Qpid بروید.

گزینه ۲: ارتقا دادن میانای کاربری (با Apigee SSO)

اگر Apigee SSO (apigee-sso) در محیط Edge for Private Cloud نسخه ۴.۵۳.۰۰ یا ۴.۵۳.۰۱ شما پیکربندی / نصب شده است، از این بخش استفاده کنید.

در Apigee Edge برای Private Cloud نسخه ۴.۵۴.۰۰:

سرویس زیربنایی Apigee SSO از عنصر قدیمی apigee-sso به Apigee SSO که تحت apigee-openldap مدیریت می‌شود منتقل می‌شود. اگر «ورود یکپارچه» در Edge برای Private Cloud نسخه ۴.۵۳.۰۰ یا ۴.۵۳.۰۱ فعال باشد، این ارتقا هنگام ارتقا به Apigee Edge برای Private Cloud نسخه ۴.۵۴.۰۰ اجباری است.
هم 4.53.x Classic UI (edge-ui) با SSO و هم 4.53.x New Edge UI (edge-management-ui) با SSO به 4.54.00 New Edge UI (edge-management-ui) با Apigee SSO ارتقا می‌یابند.

برای درک طراحی جدید Apigee SSO و تأثیر آن بر برنامه‌های کمکی و جریان‌های خودکارسازی با Management API، مقاله‌های زیر را بخوانید:
درباره ساختار جدید Apigee SSO
تکالیف خودکارسازی‌شده بااستفاده از SSO

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

مرحله ۱: پشتیبان‌گیری از فایل‌های پیکربندی

قبل‌از ادامه دادن، از configFile بی‌صدای موجود و دایرکتوری /opt/apigee/customer/application/ در همه گره‌های UI و SSO پشتیبان‌گیری کنید.

مرحله ۲: متغیرهای منسوخ‌شده UI/SSO را بردارید و فایل پیکربندی بی‌صدا (`configFile`) را به‌روز کنید

قبل‌از ارتقا دادن «میانای کاربر New Edge» و پیکربندی واحد Apigee SSO، فایل پیکربندی بی‌صدای خود (configFile) را در یک مرحله براساس راه‌اندازی کنونی میانای کاربر 4.53.x به‌روز کنید:

متغیرهای منسوخ‌شده 4.53.x UI و SSO را از configFile بردارید یا نظر دهید:

اگر از «میانای کاربر کلاسیک» (edge-ui) با apigee-sso ارتقا می‌دهید: ویژگی‌های مربوط به «میانای کاربر کلاسیک» و «شناسایی یگانه» را بردارید یا برای آن‌ها نظر بگذارید:
```
EDGEUI_SSO_ENABLED=y
EDGEUI_SSO_CLIENT_NAME=edgeui
EDGEUI_SSO_CLIENT_SECRET=edgeuisecret
EDGEUI_PUBLIC_URIS=
EDGEUI_SSO_CLIENT_OVERWRITE=y
EDGEUI_SSO_REGISTERD_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS
```

اگر از New Edge UI (edge-management-ui) با apigee-sso ارتقا می‌دهید: ویژگی‌های منسوخ‌شده مربوط به Classic UI نسخه 4.53.x،‏ Shoehorn، و SSO را بردارید یا به‌صورت نظر درآورید:

EDGEUI_SSO_ENABLED=y
EDGEUI_SSO_CLIENT_NAME=edgeui
EDGEUI_SSO_CLIENT_SECRET=edgeuisecret
EDGEUI_PUBLIC_URIS=
EDGEUI_SSO_CLIENT_OVERWRITE=y
EDGEUI_SSO_REGISTERD_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS
EDGEUI_ENABLE_UNIFIED_UI=n
SHOEHORN_SCHEME=$MANAGEMENT_UI_SCHEME
SHOEHORN_IP=$MANAGEMENT_UI_IP
SHOEHORN_PORT=9000
CLASSIC_UI_SCHEME=http
CLASSIC_UI_PORT=9000
MANAGEMENT_UI_PUBLIC_URIS=http://Public_IP:3001
MANAGEMENT_UI_SSO_REGISTERD_PUBLIC_URIS=$MANAGEMENT_UI_PUBLIC_URIS
ROUTES_CLASSICUI=""
ROUTES_SHOEHORN=""

از دستور زیر در گره apigee-openldap برای ایجاد کاربر ماشین برای «میانای کاربری New Edge» استفاده کنید و مطمئن شوید که هنگام تعریف دارایی در فایل پیکربندی بی‌صدا (configFile) در مرحله بعدی، از همان اطلاعات اعتباری استفاده می‌کنید. برای اطلاعات بیشتر، ایجاد کاربر ماشین برای واسط کاربر را ببینید.
```
/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh add -u ui-machine-user@apigee.com -p Secret123
```

«شناسایی یگانه Apigee» نسخه 4.54.00 و ویژگی‌های «رابط کاربری Edge جدید» را در configFile اضافه یا به‌روز کنید:

# ==========================================
# SSO Enablement
# ==========================================
ENABLE_SSO=y

# ==========================================
# SSO Hostname/IP and Port config for Apigee SSO
# ==========================================
SSO_PUBLIC_URL_SCHEME=http
SSO_PUBLIC_URL_HOSTNAME=YOUR_SSO_NODE_IP_OR_HOSTNAME #Replace YOUR_SSO_NODE_IP_OR_HOSTNAME with the IP address or hostname of the SSO node.
SSO_PUBLIC_URL_PORT=9099

# ==========================================
# Static Client UI credentials
# ==========================================
MANAGEMENT_UI_SSO_CLIENT_ID=YOUR_SSO_CLIENT_ID #Example : MANAGEMENT_UI_SSO_CLIENT_ID=unifiedui
MANAGEMENT_UI_SSO_CLIENT_SECRET=YOUR_SSO_CLIENT_SECRET #Example : MANAGEMENT_UI_SSO_CLIENT_SECRET=secret123

# ==========================================
# Management UI & SSO redirect URLs
# ==========================================
MANAGEMENT_UI_SCHEME=http
MANAGEMENT_UI_IP=MANAGEMENT_UI_NODE_IP #Replace MANAGEMENT_UI_NODE_IP with the IP address or hostname of the UI node.
MANAGEMENT_UI_PORT=3001

# ==========================================
# Management Server parameters (Required for SSO registration)
# ==========================================
MSIP=MS_IP_OR_HOSTNAME #Replace MS_IP_OR_HOSTNAME with the IP address or hostname of the Management Server node.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=your_password

# ==========================================
# Machine user for UI
# ==========================================
UI_MACHINE_USER=ui-machine-user@apigee.com
UI_MACHINE_PWD=Secret123

# ==========================================
# Postgres connection parameters
# ==========================================
# Postgres username and password as set when you installed Edge.
PG_HOST=PG_IP_OR_HOSTNAME
PG_USER=apigee
PG_PWD=YOUR_PG_PASSWORD

# ==========================================
# Other UI Parameters
# ==========================================
AUTH_MODE=sso

# Y to use Internal/Local LDAP for authentication, N to use external IDP
SSO_LOCAL_LDAP=y

MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_SSO_ENABLED=y
MANAGEMENT_UI_SSO_CSRF_SECRET=YOUR_CSRF_SECRET
MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24
MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=24
MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS=0.5

مرحله ۳: ارتقا دادن مؤلفه New Edge UI

توجه:

درباره میانای کاربر Edge جدید با توپولوژی‌های چندگره‌ای (قبل‌از Edge برای Private Cloud نسخه ۴.۵۳.۰۱، نگهداری گره‌های جداگانه برای میانای کاربر کلاسیک و میانای کاربر Edge جدید اجباری بود): به‌عنوان مثال، در راه‌اندازی چندگره‌ای ۴.۵۳.۰۱ که گره ۱ edge-ui را اجرا می‌کند (پیکربندی‌شده ازطریق ui.properties) و گره ۲ edge-management-ui را درکنار Shoehorn UI edge-ui اجرا می‌کند (پیکربندی‌شده ازطریق management-ui.properties):

کپی کردن پیکربندی‌های سفارشی (CWC) : فایل /opt/apigee/customer/application/management-ui.properties را از «گره ۲» به «گره ۱» در همان مسیر انتقال دهید. مطمئن شوید هرگونه لغو apigee-sso قدیمی «مرکز کنترل تبلیغات» برداشته شده باشد و مالکیت فایل به apigee:apigee واگذار شود.

اگر درحال‌حاضر از New Edge UI استفاده می‌شود، هر دو مؤلفه edge-management-ui (New Edge UI) و edge-ui (Shoehorn UI) را متوقف و حذف نصب کنید :

#Remove 4.53.xx New Edge UI from installation node 
apigee-service edge-management-ui stop
apigee-service edge-management-ui uninstall

#Remove Shoehorn UI from the node with 4.53.xx New Edge UI
apigee-service edge-ui stop
apigee-service edge-ui uninstall

اسکریپت update.sh را در گره (های) «واسط کاربر کلاسیک» (edge-ui) اجرا کنید تا مؤلفه «واسط کاربر Edge جدید» (edge-management-ui) را نصب و ارتقا دهید:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```

مرحله ۴: توقف `apigee-sso`

سرویس قدیمی apigee-sso را در همه گره‌هایی که نصب شده است متوقف کنید:

apigee-service apigee-sso stop

مرحله ۵: ایجاد پایگاه داده `apigee_dex` برای Apigee SSO در گره Postgres

در گره اصلی Postgres، بااستفاده از فرمان زیر به Postgresql وارد شوید:
```
psql -h $(hostname -i) -U apigee
```
فرمان زیر را در پیام‌واره psql اجرا کنید تا پایگاه داده Apigee SSO ایجاد شود:
```
create database apigee_dex;
```

مرحله ۶: راه‌اندازی Apigee SSO در گره‌های OpenLDAP

فرمان زیر را در گره apigee-openldap که Apigee SSO در آن نصب خواهد شد اجرا کنید:

/opt/apigee/apigee-service/bin/apigee-service apigee-openldap setup-sso -f configFile

مرحله ۷: پیکربندی میانای کاربر مدیریت برای Apigee SSO و بازراه‌اندازی میانای کاربر

فرمان‌های زیر را در هر گره‌ای که Edge for Private Cloud 4.54.00 edge-management-ui در آن نصب شده است اجرا کنید:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile

مرحله ۸: تأیید ارتقای New Edge UI و Apigee SSO

پس‌از تکمیل مراحل بالا، بررسی کنید که 4.54.00 New Edge UI و Apigee SSO درحال اجرا و دردسترس باشند:

بررسی کنید که سرویس edge-management-ui درحال اجرا باشد:
```
apigee-service edge-management-ui status
```
مرورگری را باز کنید و به این نشانی بروید:
```
http://MANAGEMENT_UI_NODE_IP:3001
```
بااستفاده از اطلاعات اعتباری SSO پیکربندی‌شده به سیستم وارد شوید.

مرحله ۹: حذف نصب `apigee-sso` قدیمی

در همه گره‌هایی که apigee-sso قدیمی نصب شده است، مؤلفه apigee-sso را حذف نصب کنید:

apigee-service apigee-sso uninstall

ارتقا به Qpid 10.0.1

این روش تضمین می‌کند که هیچ زمان ازکارافتادگی‌ای برای محیط زمان اجرای Edge شما وجود نداشته باشد و ازدست رفتن داده‌های زمان اجرا (درصورت وجود) را که برای تجزیه‌وتحلیل به‌دست آمده است به حداقل می‌رساند.

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

یک گره Qpid را برای شروع انتخاب کنید.
کارگزار Qpid را در گره متوقف کنید:
```
apigee-service apigee-qpidd stop
```
با اعمال دیوار آتش، ترافیک ورودی در درگاه کارگزار ۵۶۷۲ را از همه پردازشگرهای پیام مسدود کنید. می‌توانید این دیوار آتش را در سطح نمونه گره Qpid یا برخی دیگر از اجزای شبکه/دیوار آتش خارجی اعمال کنید.

توصیه می‌کنیم همین مرحله را برای همه نشانی‌های IP پردازشگر پیام انجام دهید. برای مثال، برای «رها کردن» درخواست‌هایی که از نشانی‌های IP پردازشگر پیام به گره Qpid در درگاه ۵۶۷۲ بااستفاده از IPTables می‌آیند، می‌توانید از فرمانی مانند این استفاده کنید:
```
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
```
کارگزار Qpid را دوباره راه‌اندازی کنید تا پیام‌های موجود (درصورت وجود) تخلیه شوند:
```
apigee-service apigee-qpidd start
```
بررسی کنید که صف‌های موجود خالی باشند:
```
/opt/apigee/apigee-qpidd/bin/qpid-stat -q
```
اگر پیام‌ها در صف پیام‌های ناموفق (DLQ) (ax-q-axgroup-001-consumer-group-001-dl) گیر کرده‌اند، بااستفاده از مراحل حل مشکل گیر کردن داده‌های Analytics در صف پیام‌های ناموفق، صف را خالی کنید.
پس‌از درستی‌سنجی اینکه صف‌ها در گره قدیمی تخلیه شده‌اند، 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
```
قانون دیوار آتش اعمال‌شده در مرحله ۳ را بردارید.

همین مرحله برداشتن را برای همه نشانی‌های IP پردازشگر پیام که دیوار آتش برای آن‌ها اعمال شده است انجام دهید. پس‌از برداشته شدن دیوارهای آتش، درخواست‌هایی که از نشانی‌های IP پردازشگر پیام به گره Qpid در درگاه ۵۶۷۲ می‌آیند پذیرفته خواهند شد. اگر از iptables برای افزودن دیوار آتش استفاده کرده‌اید، برای برداشتن دیوار آتش و فهرست کردن تنظیمات موجود می‌توانید از فرمان‌هایی مانند موارد زیر استفاده کنید:
```
iptables -F
iptables -L
```
از پایش وب برای تأیید اینکه صف‌های Qpid پیام دریافت می‌کنند استفاده کنید:
```
http://QPID_NODE_IP:8090
```
مراحل ۱ تا ۹ را برای هر گره Qpid تکرار کنید.

ارتقا به Postgres 18.6

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

اکثر سیستم‌های تولید Edge از دو گره Postgres استفاده می‌کنند که برای تکثیر اولیه-آماده‌به‌کار پیکربندی شده‌اند. درطول فرایند به‌روزرسانی، وقتی گره‌های Postgres برای به‌روزرسانی غیرفعال هستند، داده‌های تجزیه‌وتحلیل همچنان در گره‌های Qpid نوشته می‌شوند. پس‌از به‌روزرسانی گره‌های Postgres و آنلاین شدن مجدد آن‌ها، داده‌های تجزیه‌وتحلیل به گره‌های Postgres ارسال می‌شود.

نحوه انجام به‌روزرسانی Postgres به نحوه پیکربندی فضای ذخیره‌سازی داده برای گره‌های Postgres بستگی دارد:

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

در پیکربندی ۱ گره‌ای و ۲ گره‌ای Edge، توپولوژی‌های مورداستفاده برای نمونه‌سازی و آزمایش، فقط یک گره Postgres دارید. می‌توانید این گره‌های Postgres را مستقیماً بدون نیاز به ایجاد گره Postgres جدید به‌روز کنید.
اگر از فضای ذخیره‌سازی شبکه برای گره‌های Postgres خود استفاده می‌کنید، همان‌طور که Apigee توصیه می‌کند، نیازی به نصب گره Postgres جدید ندارید. در رویه‌های زیر، می‌توانید از مراحلی که نصب و سپس ازکاراندازی گره آماده‌به‌کار Postgres جدید را مشخص می‌کنند رد شوید. قبل‌از شروع فرایند به‌روزرسانی، یک عکس آنی شبکه از مخزن داده مورداستفاده Postgres بگیرید. سپس، اگر درطول به‌روزرسانی خطایی رخ دهد و مجبور شوید بازگشت به نسخه قبلی انجام دهید، می‌توانید گره Postgres را از آن عکس آنی بازیابی کنید.

درحال نصب گره آماده به‌کار Postgres جدید

این رویه یک سرور آماده‌به‌کار Postgres در گره جدید ایجاد می‌کند. مطمئن شوید که سرور آماده‌به‌کار Postgres جدیدی را برای نسخه موجود Edge (‏۴.۵۳.۰۰ یا ۴.۵۳.۰۱) نصب می‌کنید، نه برای نسخه ۴.۵۴.۰۰.

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

برای ایجاد گره آماده‌به‌کار Postgres جدید:

در Postgres اصلی فعلی، فایل /opt/apigee/customer/application/postgresql.properties را ویرایش کنید تا کد زیر را تنظیم کنید. اگر آن فایل وجود ندارد، آن را ایجاد کنید:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
```
که در آن existing_standby_ip نشانی IP سرور آماده‌به‌کار Postgres کنونی و new_standby_ip نشانی IP گره آماده‌به‌کار جدید است.
apigee-postgresql را در Postgres اصلی بازراه‌اندازی کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
```
با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf در گره اصلی، مطمئن شوید گره آماده‌به‌کار جدید اضافه شده است. باید خطوط زیر را در آن فایل ببینید:
```
host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
```
سرور آماده‌به‌کار Postgres جدید را نصب کنید:
1. فایل پیکربندی را که برای نصب نسخه فعلی Edge استفاده کرده‌اید ویرایش کنید تا موارد زیر را مشخص کنید:
```
# IP address of the current primary(master):
PG_MASTER=PG_MASTER_NODE_IP
# IP address of the new standby node
PG_STANDBY=PG_STANDBY_NODE_IP
```
2. SELinux را طبق توضیحات نصب ابزار کمکی apigee-setup در Edge غیرفعال کنید.
3. دستورگان راه‌اندازی را براساس نسخه فعلی Edge بارگیری و اجرا کنید:
  - اگر درحال‌حاضر از Edge نسخه 4.53.00 استفاده می‌کنید:
    
    فایل Edge bootstrap_4.53.00.sh را در /tmp/bootstrap_4.53.00.sh بارگیری کنید:
```
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
```
    ابزار Edge apigee-service و وابستگی‌ها را نصب کنید:
```
bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
```
  - اگر درحال‌حاضر از Edge 4.53.01 استفاده می‌کنید:
    
    فایل Edge bootstrap_4.53.01.sh را در /tmp/bootstrap_4.53.01.sh بارگیری کنید:
```
curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
```
    برنامه کمکی Edge apigee-service و وابستگی‌ها را نصب کنید:
```
bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord
```
4. برای نصب ابزار apigee-setup، از apigee-service استفاده کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. نصب Postgres:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
6. در گره آماده‌به‌کار جدید، فرمان زیر را اجرا کنید و تأیید کنید که آماده‌به‌کار است:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```

درحال انجام ارتقای درجا برای Postgres

مرحله مقدماتی

قبل‌از انجام ارتقای درجا به Postgres، مراحل زیر را در میزبان اصلی و آماده‌به‌کار انجام دهید تا ویژگی max_locks_per_transaction در apigee-postgresql به‌روز شود:

اگر وجود ندارد، فایل /opt/apigee/customer/application/postgresql.properties را ایجاد کنید .

مالکیت این فایل را به apigee تغییر دهید :

chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

دارایی زیر را به فایل اضافه کنید:
```
conf/postgresql.conf+max_locks_per_transaction=30000
```

پیکربندی apigee-postgresql :

apigee-service apigee-postgresql configure

بازراه‌اندازی apigee-postgresql :
```
apigee-service apigee-postgresql restart
```

انجام ارتقای درجا

برای انجام ارتقای درجا به Postgres 18، مراحل زیر را انجام دهید:

ارتقا دادن postgres در میزبان اصلی

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

فرمان راه‌اندازی را در میزبان اصلی اجرا کنید:
```
apigee-service apigee-postgresql setup -f configFile
```
فرمان پیکربندی را در میزبان اصلی اجرا کنید:
```
apigee-service apigee-postgresql configure
```
میزبان اصلی را بازراه‌اندازی کنید:
```
apigee-service apigee-postgresql restart
```

آن را به‌عنوان اصلی پیکربندی کنید:

apigee-service apigee-postgresql setup-replication-on-master -f configFile

مطمئن شوید میزبان اصلی شروع کرده باشد:
```
apigee-service apigee-postgresql wait_for_ready
```
توقف حالت آماده‌به‌کار:
```
apigee-service apigee-postgresql stop
```
آماده‌به‌کار را ارتقا دهید.

توجه: اگر این مرحله با خطا مواجه شد/ناموفق بود، می‌توانید آن را نادیده بگیرید. ‫update.sh تلاش خواهد کرد سرور آماده‌به‌کار را با پیکربندی نادرست شروع کند. اگر نصب Postgres به ۱۸ ارتقا داده شود، می‌توان از این خطا صرف‌نظر کرد.
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
مطمئن شوید حالت آماده‌به‌کار متوقف شده باشد:
```
apigee-service apigee-postgresql stop
```
پیکربندی آماده‌به‌کار قدیمی را بردارید:
```
rm -rf /opt/apigee/data/apigee-postgresql/
```

راه‌اندازی تکثیر در سرور آماده‌به‌کار:

apigee-service apigee-postgresql setup-replication-on-standby -f configFile

خط conf/postgresql.conf+max_locks_per_transaction=30000 را از فایل /opt/apigee/customer/application/postgresql.properties در میزبان اصلی و آماده‌به‌کار بردارید. این خط در مرحله مقدماتی اضافه شده است .

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

ازکار انداختن گره Postgres

پس‌از تکمیل به‌روزرسانی، گره آماده‌به‌کار جدید را از رده خارج کنید:

مطمئن شوید Postgres درحال اجرا باشد:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
اگر Postgres اجرا نمی‌شود، آن را شروع کنید:
```
/opt/apigee/apigee-service/bin/apigee-all start
```
با اجرای فرمان curl زیر در گره آماده‌به‌کار جدید، شناسه UUID گره آماده‌به‌کار جدید را دریافت کنید:
```
curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
```
باید UUID گره را در انتهای خروجی به این شکل ببینید:
```
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
```
با اجرای فرمان زیر در گره آماده‌به‌کار جدید، گره آماده‌به‌کار جدید را متوقف کنید:
```
/opt/apigee/apigee-service/bin/apigee-all stop
```
در گره اصلی Postgres،‏ /opt/apigee/customer/application/postgresql.properties را ویرایش کنید تا گره آماده‌به‌کار جدید از conf_pg_hba_replication.connection برداشته شود:
```
conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
```
apigee-postgresql را در Postgres اصلی بازراه‌اندازی کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
```
با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf در گره اصلی، تأیید کنید که گره آماده‌به‌کار جدید برداشته شده است. باید فقط خط زیر را در آن فایل ببینید:
```
host replication apigee existing_standby_ip/32 trust
```
با برقراری تماس میانای برنامه‌سازی کاربردی مدیریت Edge زیر در گره «سرور مدیریت»، UUID گره آماده‌به‌کار را از ZooKeeper حذف کنید:
```
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
```

مراحل پس‌از ارتقا برای Postgres

پس‌از ارتقای عمده Postgres، آمار داخلی Postgres پاک می‌شود. این آمارها به برنامه‌ریز پُرسمان Postgres کمک می‌کند تا از بهینه‌ترین نمایه‌ها و مسیرها برای اجرای پُرسمان‌ها استفاده کند.

Postgres می‌تواند به‌تدریج آمار خود را درطول زمان با اجرای پُرسمان‌ها و هنگام اجرای دیمن autovacuum بازسازی کند. بااین‌حال، تا زمانی که آمار بازسازی شود، پُرسمان‌های شما ممکن است کند باشد.

برای رفع این مشکل، ANALYZE را روی همه جدول‌های پایگاه داده در گره اصلی Postgres اجرا کنید. یا می‌توانید ANALYZE را برای چند جدول به‌طور هم‌زمان اجرا کنید.

به ZooKeeper 3.8.5 ارتقا دهید

این نسخهٔ پخش Edge for Private Cloud شامل ارتقا به ZooKeeper 3.8.5 است. به‌عنوان بخشی از این ارتقا، همه داده‌های ZooKeeper به ZooKeeper 3.8.5 منتقل خواهد شد.

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

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

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

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

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

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

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

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

اگر روی گره ZooKeeper نصب نشده است، nc را نصب کنید:
```
yum install nc
```
فرمان nc زیر را در گره اجرا کنید، که در آن ۲۱۸۱ درگاه ZooKeeper است:
```
echo stat | nc localhost 2181
```
باید بروندادی مانند زیر ببینید:
```
Zookeeper version: 3.8.5-19f1842d4b6ee1f82cc8b05284959b26c6ae507d, built on 2025-09-03 21:35 UTC
Clients:
 /[0:0:0:0:0:0:0:1]:40696[0](queued=0,recved=1,sent=0)

Latency min/avg/max: 3/4.3333/6
Received: 4
Sent: 3
Connections: 1
Outstanding: 0
Zxid: 0x500000005
Mode: follower
```
در خط Mode برونداد گره‌ها، بسته به پیکربندی گره باید مشاهده‌گر، رهبر، یا پیرو (یعنی رأی‌دهنده‌ای که رهبر نیست) را ببینید.

مراحل ۱ و ۲ را در هر گره ZooKeeper تکرار کنید.

ZooKeeper را در گره‌های ناظر و دنبال‌کننده ارتقا دهید

‫ZooKeeper را در هریک از گره‌های ناظر و پیرو به این ترتیب ارتقا دهید:

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

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

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

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

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

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

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

ارتقای رهبر

همان مراحل ارتقا دادن ZooKeeper در گره‌های پیرو و ناظر در بالا را دنبال کنید.

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

ارتقا به Cassandra 5.0.8

‫Apigee Edge for Private Cloud 4.54.00 شامل ارتقا Cassandra به نسخه ۵.۰.۸ است.

ارتقا و بازگشت به نسخه قبلی

ارتقا دادن از Cassandra 4.0.X به Cassandra 5.0.X فرایندی چرخشی است.
برگرداندن مستقیم درجا از Cassandra 5.0.X به 4.0.X امکان‌پذیر نیست. بازگرداندن بااستفاده از نسخه‌های کپی یا پشتیبان‌گیری‌ها فرایندی پیچیده است و ممکن است شامل زمان ازکارافتادگی و/یا ازدست رفتن داده‌ها باشد. عیب‌یابی کردن مشکلات و ارتقا دادن به Cassandra 5.0.X بر بازگرداندن به نسخه قبلی ارجحیت دارد.
مهم است که قبل‌از اقدام به ارتقا، با رویه‌های بازگشت به نسخه قبلی آشنا شوید. توجه به جزئیات بازگرداندن درطول ارتقا برای اطمینان از دردسترس بودن مسیرهای بازگرداندن مناسب بسیار مهم است.

مرکز داده تکی

ارتقا دادن Cassandra از نسخه 4.0.X به 5.0.X در یک مرکز داده واحد یکپارچه است، اما برگرداندن به نسخه قبلی پیچیده است و ممکن است منجر به زمان توقف و ازدست رفتن داده‌ها شود. برای حجم‌های کاری تولید، اکیداً توصیه می‌شود قبل‌از شروع ارتقا، مرکز داده جدیدی اضافه کنید که حداقل گره‌های Cassandra در مرکز داده جدید دردسترس باشد. این کار امکان برگرداندن Cassandra را بدون ازدست رفتن داده‌ها یا اختلال در ترافیک API شما فراهم می‌کند. پس‌از اتمام ارتقا، این مرکز داده اضافی می‌تواند ازکار انداخته شود.

اگر افزودن مرکز داده جدید امکان‌پذیر نباشد اما همچنان به قابلیت بازگشت به نسخه قبلی نیاز باشد، برای بازیابی Cassandra 4.0.X به نسخه‌های پشتیبان نیاز خواهد بود. بااین‌حال، این روش احتمالاً هم شامل زمان توقف و هم ازدست رفتن داده‌ها می‌شود.

چندین مرکز داده

اجرای چندین مرکز داده با Edge for Private Cloud نسخه 4.53.00 (یا) 4.53.01 انعطاف‌پذیری بیشتری برای بازگرداندن نسخه‌ها درطول ارتقا به Edge for Private Cloud نسخه 4.54.00 ارائه می‌دهد.

برای بازگشت به نسخه قبلی، حداقل یک مرکز داده باید نسخه قبلی Cassandra‏ (4.0.X) را اجرا کند.

روش‌شناسی ارتقای توصیه‌شده

هر بار یک مرکز داده Cassandra را ارتقا دهید: با ارتقای گره‌های Cassandra به‌صورت جداگانه در یک مرکز داده شروع کنید. پیش‌از رفتن به مرکز داده بعدی، ارتقای همه گره‌های Cassandra را در یک مرکز داده تکمیل کنید.
توقف موقت و اعتبارسنجی: پس‌از ارتقا دادن یک مرکز داده، موقتاً متوقف کنید تا مطمئن شوید خوشه «ابر خصوصی» شما، به‌ویژه مرکز داده ارتقایافته، به‌درستی کار می‌کند.
به‌یاد داشته باشید: فقط درصورتی می‌توانید به نسخه قبلی Cassandra برگردید که حداقل یک مرکز داده هنوز نسخه قدیمی‌تر را اجرا کند.
حساس به زمان: اگرچه می‌توانید برای مدت کوتاهی (توصیه می‌شود چند ساعت) برای اعتبارسنجی عملکرد موقتاً متوقف کنید، نمی‌توانید برای همیشه در وضعیت نسخه مختلط باقی بمانید. دلیل این امر این است که خوشه غیریکنواخت Cassandra (با گره‌هایی در نسخه‌های مختلف) محدودیت‌های عملیاتی دارد.
آزمایش کامل: Apigee اکیداً توصیه می‌کند که قبل‌از ارتقا دادن مرکز داده بعدی، عملکرد و کارایی را به‌طور جامع آزمایش کنید. پس‌از ارتقا یافتن همه مراکز داده، بازگرداندن به نسخه قبلی غیرممکن است.

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

نقطه بازگشت واحد: وقتی همه عناصر به نسخه ۴.۵۴.۰۰ ارتقا یابند، بازگشت Cassandra فقط درصورتی امکان‌پذیر است که حداقل یک مرکز داده Cassandra همچنان نسخه قدیمی‌تر را اجرا کند. وقتی آخرین مرکز داده Cassandra ارتقا یافت، ارتقا به Edge for Private Cloud 4.54.00 تکمیل می‌شود و دیگر امکان بازگشت به نسخه قبلی وجود ندارد.

مثال

خوشه دو مرکز داده (DC) را درنظر بگیرید:

وضعیت شروع: گره‌های Cassandra در هر دو مرکز داده روی نسخه 4.0.X هستند. همه گره‌های دیگر در Edge برای Private Cloud نسخه ۴.۵۴.۰۰ هستند. فرض کنید سه گره Cassandra برای هر DC وجود دارد.
ارتقا DC-1: سه گره Cassandra در DC-1 را یکی‌یکی ارتقا دهید.
توقف موقت و اعتبارسنجی: توقف موقت برای اطمینان از اینکه خوشه، به‌ویژه DC-1، به‌درستی کار می‌کند (بررسی عملکرد، کارایی). بااستفاده از گره‌های Cassandra در DC-2 می‌توانید به وضعیت اولیه برگردید. به‌خاطر داشته باشید که این توقف موقت باید به‌دلیل محدودیت‌های خوشه Cassandra با نسخه ترکیبی باشد.
ارتقا دادن DC-2: سه گره Cassandra باقی‌مانده در DC-2 را ارتقا دهید. وقتی همه گره‌های Cassandra در DC-2 باموفقیت ارتقا یافتند، ارتقای Edge for Private Cloud 4.54.00 تکمیل می‌شود.

پیش‌نیازهای ارتقای Cassandra

باید Cassandra 4.0.X را با Edge for Private Cloud 4.53.00 (یا) 4.53.01 اجرا کنید و موارد زیر را تضمین کنید:

Java 17 را به‌عنوان نسخه پیش‌فرض Java در سرور تنظیم کنید: Cassandra 5.0.X پشتیبانی از Java 8 را برمی‌دارد. نمی‌توانید Cassandra 5.0.X یا ابزار nodetool آن را با Java 8 اجرا کنید. مطمئن شوید که Java 17 روی هر گره Cassandra نصب شده باشد و Java 17 را به‌عنوان نسخه پیش‌فرض Java قبل‌از اجرای مراحل ارتقای Cassandra تنظیم کنید تا فرمان‌های nodetool با Java 17 اجرا شوند:
```
alternatives --set java JAVA_17_PATH/bin/java
```
تأیید کنید که نسخه پیش‌فرض فعال Java،‏ Java 17 است:
```
java -version
```
کل خوشه با Cassandra 4.0.X عملیاتی و کاملاً کاربردی است.
استراتژی فشرده‌سازی روی LeveledCompactionStrategy تنظیم شده است (پیش‌نیاز ارتقا به نسخه ۴.۵۳.۰۰ (یا) ۴.۵۳.۰۱).
تأیید کنید که هریک از مراحل زیر به‌عنوان بخشی از ارتقای اولیه Cassandra 4.0.X در Edge برای «ابر خصوصی» نسخه 4.53.00 (یا) 4.53.01 تکمیل شده است.
- فرمان post_upgrade درطول ارتقای قبلی در هر گره Cassandra اجرا شد
- فرمان drop_old_tables درطول ارتقای قبلی در کل خوشه Cassandra اجرا شد.

اگر مطمئن نیستید که فرمان‌های post_upgrade و drop_old_tables در Cassandra 4.0.X هنگام استفاده از Edge for Private Cloud 4.53.00 (یا) 4.53.01 اجرا شده‌اند، می‌توانید آن‌ها را قبل‌از تلاش برای ارتقا به 4.54.00 دوباره اجرا کنید.

مرحله ۱: آماده شدن برای ارتقا دادن

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

بااستفاده از Apigee از Cassandra پشتیبان‌گیری کنید.
از گره‌های Cassandra عکس‌های فوری ماشین مجازی بگیرید (درصورت امکان).
مطمئن شوید که درگاه ۹۰۴۲ از همه مؤلفه‌های Edge for Private Cloud، ازجمله Management Server،‏ Message Processor،‏ Router،‏ Qpid، و Postgres، به گره‌های Cassandra قابل‌دسترسی باشد، اگر قبلاً پیکربندی نشده است. برای اطلاعات بیشتر، به الزامات درگاه مراجعه کنید.

مرحله ۲: ارتقا دادن همه گره‌های Cassandra

همه گره‌های Cassandra باید یکی‌یکی در هر مرکز داده به‌روزرسانی شوند، هر بار یک مرکز داده. بین ارتقای گره‌ها در یک مرکز داده، چند دقیقه صبر کنید تا مطمئن شوید که گره به‌روزشده کاملاً راه‌اندازی شده و به خوشه پیوسته است، سپس گره دیگری را در همان مرکز داده ارتقا دهید.

پس‌از ارتقا دادن همه گره‌های Cassandra در مرکز داده، مدتی (۳۰ دقیقه تا چند ساعت) صبر کنید و سپس گره‌های مرکز داده بعدی را ارتقا دهید. درطول این مدت، مرکز داده‌ای را که به‌روز شده است به‌طور کامل بازبینی کنید و مطمئن شوید که سنجه‌های عملکردی و کارکردی خوشه Apigee شما دست‌نخورده باقی مانده است. این مرحله برای اطمینان از پایداری مرکز داده‌ای که Cassandra در آن به نسخه 5.0.X ارتقا یافته است، درحالی‌که بقیه مؤلفه‌های Apigee به 4.54.00 ارتقا یافته‌اند، بسیار مهم است.

برای ارتقا دادن گره 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 6.2.0 | Cassandra 5.0.8 | CQL spec 3.4.7 | Native protocol v5]
Metadata is verified

فرمان post_upgrade زیر را در گره Cassandra اجرا کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
```
فرمان cleanup_old_index زیر را در گره Cassandra اجرا کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra cleanup_old_index
```
فرمان‌های nodetool زیر را اجرا کنید تا نمایه‌های گره Cassandra را بازسازی کنید:

/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx    
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx

اگر از درآمدزایی استفاده می‌کنید، فرمان‌های بازسازی نمایه‌های زیر را نیز که مربوط به فضاهای کلید درآمدزایی هستند اجرا کنید:

/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx

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

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

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

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

اگر این خرابی باعث می‌شود که به‌روزرسانی را به نسخه قبلی برگردانید، برای دریافت دستورالعمل‌های دقیق، برگرداندن به نسخه ۴.۵۴.۰۰ را ببینید.

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

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

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

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

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

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

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

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

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

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

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

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

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

باید فایل پیکربندی بی‌صدایی را به فرمان به‌روزرسانی ارسال کنید. اگرچه فایل پیکربندی بی‌صدا عمدتاً مشابه فایلی است که برای نصب Edge for Private Cloud نسخه ۴.۵۳.۰۰ یا ۴.۵۳.۰۱ استفاده کردید، ممکن است لازم باشد تغییراتی برای مؤلفه‌هایی مانند میانای کاربر و «احراز هویت یکپارچه» ایجاد کنید، همان‌طور که در ارتقا به میانای کاربر Edge جدید و «احراز هویت یکپارچه» Apigee (درصورت نصب) شرح داده شده است.

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

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

درصورت وجود، همه کارهای cron پیکربندی‌شده برای انجام عملیات تعمیر در Cassandra را تا پس‌از تکمیل به‌روزرسانی غیرفعال کنید.
برای نصب Edge RPM، به‌عنوان root به سیستم گره وارد شوید.

توجه: اگرچه نصب RPM به دسترسی ریشه نیاز دارد، می‌توانید پیکربندی Edge را بدون دسترسی ریشه انجام دهید.
SELinux را طبق توضیحات نصب ابزار کمکی Edge apigee-setup غیرفعال کنید .

اگر درحال نصب روی AWS هستید ، فرمان‌های yum-configure-manager زیر را اجرا کنید:

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

اگر درحال‌حاضر از Edge برای Private Cloud نسخه ۴.۵۳.۰۰ (یا) ۴.۵۳.۰۱ استفاده می‌کنید:
1. فایل Edge bootstrap_4.54.00.sh را در /tmp/bootstrap_4.54.00.sh بارگیری کنید :
```
curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
```
2. با اجرای فرمان زیر، ابزار کمکی Edge 4.54.00 apigee-service و وابستگی‌ها را نصب کنید:
```
bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord
```
  که uName:pWord نام کاربری و گذرواژه‌ای است که از Apigee دریافت کرده‌اید. اگر pWord را حذف کنید، از شما خواسته می‌شود آن را وارد کنید.
  
  به‌طور پیش‌فرض، نصب‌کننده بررسی می‌کند که Java 17 و 21 را نصب کرده باشید.
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
```
  این کار را به‌ترتیب شرح داده‌شده در ترتیب به‌روزرسانی دستگاه انجام دهید.
  
  مکان:
  - component مؤلفه Edge برای به‌روزرسانی است. مقادیر ممکن عبارتند از:
    - edge : All Edge components except New Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
    - ‫ldap : ال‌دپ باز
    - ue : New Edge UI
    - qpid : Apigee Qpid
    - ps : Apigee Postgresql
    - ‫zk : ZooKeeper
    - ‫cs : Cassandra
  - ‫configFile همان فایل پیکربندی است که برای تعریف مؤلفه‌های Edge درطول نصب نسخه ۴.۵۳.۰۰ (یا) ۴.۵۳.۰۱ استفاده کردید.
  توجه: فایل پیکربندی باید برای کاربر «apigee» قابل‌خواندن باشد. برای تغییر مالک، از فرمان زیر استفاده کنید:
```
chown apigee:apigee configFile
```
  با تنظیم component روی «همه»، می‌توانید update.sh را روی همه عناصر اجرا کنید، اما فقط درصورتی‌که نمایه نصب «همه در یک» (AIO) در Edge داشته باشید. برای مثال:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
```
7. اگر قبلاً این کار را نکرده‌اید، مؤلفه‌های «میانای کاربری Edge جدید» را در همه گره‌هایی که آن‌ها را اجرا می‌کنند بازراه‌اندازی کنید:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
8. به‌روزرسانی را با اجرای ابزار کمکی apigee-validate در «سرور مدیریت» آزمایش کنید، همان‌طور که در آزمایش نصب شرح داده شده است.

اگر بعداً تصمیم گرفتید به‌روزرسانی را برگردانید، از روش شرح‌داده‌شده در برگرداندن 4.54.00 استفاده کنید

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

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

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

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

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

یک مخزن محلی 4.54.00 ایجاد کنید، همان‌طور که در «ایجاد مخزن Apigee محلی» در نصب ابزار کمکی apigee-setup در Edge توضیح داده شده است.

توجه: اگر ازقبل مخزن موجودی دارید، می‌توانید مخزن 4.54.00 را به آن اضافه کنید، همان‌طور که در «به‌روزرسانی مخزن Apigee محلی» در نصب ابزار کمکی apigee-setup در Edge توضیح داده شده است.
بااستفاده از یکی از روش‌های زیر، apigee-service را در گره‌های هدف نصب کنید:
- گزینه ۱: نصب apigee-service از فایل ‎ .tar
  1. در گره با مخزن محلی، از فرمان زیر برای بسته‌بندی مخزن محلی در یک فایل ‎ .tar تکی به‌نام /opt/apigee/data/apigee-mirror/apigee-4.54.00.tar.gz استفاده کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
  2. فایل tar .را در گرهی که می‌خواهید Edge را به‌روز کنید کپی کنید. برای مثال، آن را در دایرکتوری /tmp در گره جدید کپی کنید.
  3. در گره جدید، فایل را در دایرکتوری /tmp از حالت tar خارج کنید:
```
tar -xzf apigee-4.54.00.tar.gz
```
    این فرمان فهرست راهنمای جدیدی به نام repos در فهرست راهنمای حاوی فایل .tar ایجاد می‌کند. برای مثال /tmp/repos.
  4. برنامه کمکی Edge apigee-service و وابستگی‌ها را از /tmp/repos نصب کنید:
```
bash /tmp/repos/bootstrap_4.54.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    توجه داشته باشید که مسیر دایرکتوری repos را در این فرمان اضافه می‌کنید.
- گزینه ۲: نصب apigee-service بااستفاده از سرور وب Nginx
  1. سرور وب Nginx را همان‌طور که در «نصب از مخزن بااستفاده از سرور وب Nginx» در نصب ابزار کمکی apigee-setup در Edge توضیح داده شده است پیکربندی کنید.
  2. در گره دور، فایل Edge bootstrap_4.54.00.sh را در /tmp/bootstrap_4.54.00.sh بارگیری کنید:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
```
    که در آن uName:pWord نام کاربری و گذرواژه‌ای است که قبلاً برای مخزن تنظیم کرده‌اید و remoteRepo نشانی IP یا نام ساناد گره مخزن است.
  3. در گره از دور، ابزار apigee-service Edge و وابستگی‌ها را نصب کنید:
```
bash /tmp/bootstrap_4.54.00.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 برای به‌روزرسانی است. مقادیر ممکن شامل موارد زیر است:
  - edge : All Edge components except New Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
  - ‫ldap : ال‌دپ باز
  - ue : New Edge UI
  - qpid : Apigee Qpid
  - ps : Apigee Postgresql
  - ‫zk : ZooKeeper
  - ‫cs : Cassandra
- ‫configFile همان فایل پیکربندی است که برای تعریف مؤلفه‌های Edge درطول نصب 4.53.00 (یا) 4.53.01 استفاده کردید.
  
  توجه: کاربر «apigee» باید بتواند فایل پیکربندی را بخواند. برای تغییر مالک، از فرمان زیر استفاده کنید:
```
chown apigee:apigee configFile
```
می‌توانید update.sh را با تنظیم component روی «همه» برای همه مؤلفه‌ها اجرا کنید، اما فقط درصورتی‌که نمایه نصب Edge همه‌کاره (AIO) داشته باشید. برای مثال:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
```
اگر قبلاً این کار را نکرده‌اید، مؤلفه‌های UI را در همه گره‌هایی که آن را اجرا می‌کنند بازراه‌اندازی کنید:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
به‌روزرسانی را با اجرای ابزار کمکی apigee-validate در «سرور مدیریت» آزمایش کنید، همان‌طور که در آزمایش نصب شرح داده شده است.

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

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

ترتیب به‌روزرسانی ماشین‌ها در نصب Edge مهم است. مؤلفه‌هایتان را به‌ترتیب زیر ارتقا دهید.

همه گره‌های «پردازشگر پیام» و «مسیریاب» را در همه مراکز داده بااستفاده از گزینه -c edge ارتقا دهید.
بااستفاده از گزینه -c edge، همه گره‌های «سرور مدیریت» را در همه مراکز داده ارتقا دهید.
همه گره‌های LDAP را در همه مراکز داده ارتقا دهید. اگر از Edge for Private Cloud 4.53.00 ارتقا می‌دهید، باید مراحل بیشتری را برای مراحل ویژه ارتقای LDAP دنبال کنید
رابط کاربری و Apigee SSO (درصورت نصب) را در همه مراکز داده ارتقا دهید:
1. اگر apigee-sso نصب نشده است: برای ارتقا به «میانای کاربر Edge جدید»، گزینه ۱: ارتقا دادن میانای کاربر (بدون Apigee SSO) را دنبال کنید.
2. اگر apigee-sso نصب شده است: برای ارتقا به «میانای کاربری New Edge» و Apigee SSO، گزینه ۲: ارتقا دادن میانای کاربری (با Apigee SSO) را دنبال کنید.
با دنبال کردن مراحل ویژه Qpid، همه مؤلفه‌های Qpid و edge-qpid-server را در همه مراکز داده ارتقا دهید.
با دنبال کردن مراحل ویژه Postgres، همه مؤلفه‌های Postgresql و edge-postgres-server را در همه مراکز داده ارتقا دهید
با دنبال کردن مراحل ویژه ارتقای Zookeeper، همه مؤلفه‌های Zookeeper را در همه مراکز داده ارتقا دهید.
با دنبال کردن مراحل ویژه ارتقای Cassandra، همه مؤلفه‌های Cassandra را در همه مراکز داده ارتقا دهید.
مرحله جداگانه‌ای برای به‌روزرسانی «درآمدزایی» وجود ندارد. وقتی گزینه -c edge را مشخص کنید، به‌روز می‌شود.

ارتقای مستقل ۱ گره

برای ارتقا دادن پیکربندی مستقل ۱ گره‌ای به نسخه ۴.۵۴.۰۰:

هنگام ارتقا از Edge for Private Cloud 4.53.00، ابتدا باید LDAP را با دنبال کردن مراحل ارتقا از 4.53.00 به 4.54.00 ارتقا دهید و سپس ارتقا همه عناصر را شروع کنید.

به‌روزرسانی همه مؤلفه‌ها:

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

ارتقا مستقل ۲ گره

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

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

به‌روزرسانی مؤلفه‌های Edge در دستگاه ۱:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

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

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

رابط کاربری Edge جدید را در دستگاه ۱ به‌روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
توجه: اگر apigee-sso نصب شده است، لطفاً برای دستورالعمل‌های پیکربندی آن در Apigee SSO به گزینه ۲: ارتقای میانای کاربر (با Apigee SSO) مراجعه کنید.
به‌روزرسانی مؤلفه‌های Edge در دستگاه ۲:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

به‌روزرسانی Qpid در Machine 2:

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

Postgres را در دستگاه ۲ به‌روز کنید:

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

به‌روزرسانی Cassandra و ZooKeeper در ماشین ۱:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile
```
(اگر apigee-adminapi را نصب کرده‌اید) ابزار apigee-adminapi را در دستگاه ۱ به‌روز کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

ارتقای ۵ گره‌ای

برای نصب ۵ گره‌ای، مؤلفه‌های زیر را به‌روز کنید:

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

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

به‌روزرسانی LDAP در ماشین ۱:

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

به‌روزرسانی New Edge UI در ماشین ۱:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
توجه: اگر apigee-sso نصب شده است، لطفاً برای دستورالعمل‌های پیکربندی آن در Apigee SSO به گزینه ۲: ارتقای میانای کاربر (با Apigee SSO) مراجعه کنید.
به‌روزرسانی مؤلفه‌های Edge در ماشین ۴، ۵:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

به‌روزرسانی Qpid در ماشین ۴، ۵:

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

به‌روزرسانی Postgres در دستگاه ۴، ۵:

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

‫Cassandra و ZooKeeper را در ماشین‌های ۱، ۲، و ۳ به‌روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile
```
(اگر apigee-adminapi را نصب کرده‌اید) ابزار apigee-adminapi را در دستگاه ۱ به‌روز کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

ارتقای خوشه‌ای ۹ گرهی

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

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

مؤلفه‌های Edge را در دستگاه‌های ۴، ۵، و ۱ (رهیاب، پردازشگر پیام، و سرور مدیریت) به‌ترتیب زیر به‌روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

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

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

واسط کاربر New Edge را در ماشین ۱ به‌روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
توجه: اگر apigee-sso نصب شده است، لطفاً برای دستورالعمل‌های پیکربندی آن در Apigee SSO به گزینه ۲: ارتقای میانای کاربر (با Apigee SSO) مراجعه کنید.
مؤلفه‌های Edge را در دستگاه‌های ۶، ۷، ۸، و ۹ به‌ترتیب به‌روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
به‌روزرسانی Qpid در دستگاه‌های ۶ و ۷:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```

Postgres را در دستگاه ۸ به‌روز کنید:

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

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

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

‫Cassandra و ZooKeeper را در ماشین‌های ۱، ۲، و ۳ به‌روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile
```
(اگر apigee-adminapi را نصب کرده‌اید) ابزار apigee-adminapi را در دستگاه ۱ به‌روز کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

ارتقای خوشه‌ای ۱۳ گره‌ای

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

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

اجزای Edge را در ماشین‌های ۱۰، ۱۱، ۶، و ۷ به این ترتیب به‌روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

به‌روزرسانی LDAP در ماشین ۴ و ۵:

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

واسط کاربر New Edge را در ماشین ۶، ۷ به‌روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
توجه: اگر apigee-sso نصب شده است، لطفاً برای دستورالعمل‌های پیکربندی آن برای «شناسایی یگانه Apigee»، به گزینه ۲: ارتقا دادن میانای کاربری (با «شناسایی یگانه Apigee») مراجعه کنید.
مؤلفه‌های Edge را در ماشین‌های ۱۲، ۱۳، ۸، و ۹ به‌ترتیب به‌روز کنید:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
به‌روزرسانی Qpid در دستگاه‌های ۱۲ و ۱۳:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```

‫Postgres را در ماشین ۸ به‌روز کنید:

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

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

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

به‌روزرسانی Cassandra و ZooKeeper در ماشین‌های ۱، ۲، و ۳:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile
```
(اگر apigee-adminapi را نصب کرده‌اید) ابزار apigee-adminapi را در دستگاه‌های ۶ و ۷ به‌روز کنید:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

ارتقای خوشه‌ای ۱۲ گره‌ای

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

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

به‌روزرسانی عناصر Edge (رهیاب و پردازشگر پیام):
- در دستگاه‌های ۲ و ۳ در «مرکز داده ۱»:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
- در دستگاه‌های ۸ و ۹ در «مرکز داده ۲»:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
به‌روزرسانی مؤلفه‌های Edge (سرور مدیریت):
- در دستگاه ۱ در مرکز داده ۱:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
- در دستگاه ۷ در مرکز داده ۲:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

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

دستگاه ۱ در مرکز داده ۱:

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

دستگاه ۷ در مرکز داده ۲:

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

به‌روزرسانی مؤلفه‌های واسط کاربر Edge جدید:
- در دستگاه ۱ در مرکز داده ۱:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
  توجه: اگر apigee-sso نصب شده است، لطفاً برای دستورالعمل‌های پیکربندی آن در Apigee SSO به گزینه ۲: ارتقای میانای کاربر (با Apigee SSO) مراجعه کنید.
- در دستگاه ۷ در مرکز داده ۲:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
  توجه: اگر apigee-sso نصب شده است، لطفاً برای دستورالعمل‌های پیکربندی آن برای «شناسایی یگانه Apigee»، به گزینه ۲: ارتقا دادن میانای کاربری (با «شناسایی یگانه Apigee») مراجعه کنید.
به‌روزرسانی مؤلفه‌های Edge:
- ماشین‌های ۴، ۵، ۶ در «مرکز داده ۱»:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
- ماشین‌های ۱۰، ۱۱، ۱۲ در «مرکز داده ۲»:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
به‌روزرسانی qpidd:
- ماشین‌های ۴ و ۵ در «مرکز داده ۱»:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
- ماشین‌های ۱۰ و ۱۱ در مرکز داده ۲:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
به‌روزرسانی Postgres:
- دستگاه ۶ در مرکز داده ۱:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
- دستگاه ۱۲ در مرکز داده ۲:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
به‌روزرسانی Cassandra و ZooKeeper:
- ماشین‌های ۱، ۲، و ۳ در «مرکز داده ۱»:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile
```
- در ماشین‌های ۷، ۸، و ۹ در «مرکز داده ۲»:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile
```
(اگر apigee-adminapi را نصب کرده‌اید) ابزار apigee-adminapi را به‌روز کنید:
- دستگاه ۱ در مرکز داده ۱:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
- دستگاه ۷ در مرکز داده ۲:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

برای پیکربندی غیرمعیار

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

رهیاب
پردازشگر پیام
سرور مدیریت
LDAP
واسط کاربر (واسط کاربر کلاسیک یا واسط کاربر جدید)
SSO (درصورت وجود)
Qpid و edge-qpid-server
Postgres و edge-postgres-server
ZooKeeper
Cassandra
apigee-adminapi

به‌روزرسانی Apigee Edge نسخه ۴.۵۳.۰۰ یا ۴.۵۳.۰۱ به ۴.۵۴.۰۰

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

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

مطالب پیش‌مطالعه

پیش‌نیازهای ارتقا

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

ارتقا دادن «رهیاب» و «پردازشگر پیام»

ارتقا دادن سرور مدیریت

ارتقا به OpenLDAP 2.6.10

آماده‌سازی و نصب (همه سرورهای LDAP)

مراحل ارتقا دادن LDAP از نسخه ۴.۵۳.۰۰ به ۴.۵۴.۰۰

پیش‌نیازها و ملاحظات

مراحل ارتقا دادن LDAP از نسخه ۴.۵۳.۰۱ به ۴.۵۴.۰۰

به «میانای کاربری New Edge» و «ورود به سیستم Apigee» ارتقا دهید (درصورت نصب)

گزینه ۱: ارتقا دادن واسط کاربر (بدون Apigee SSO)

مرحله ۱: پشتیبان‌گیری از فایل‌های پیکربندی

مرحله ۲: به‌روزرسانی فایل پیکربندی بی‌صدا برای «اصالت‌سنجی پایه»

مرحله ۳: ارتقا دادن مؤلفه میانای کاربر

مرحله ۴: تأیید ارتقای New Edge UI

گزینه ۲: ارتقا دادن میانای کاربری (با Apigee SSO)

مرحله ۱: پشتیبان‌گیری از فایل‌های پیکربندی

مرحله ۲: متغیرهای منسوخ‌شده UI/SSO را بردارید و فایل پیکربندی بی‌صدا (configFile) را به‌روز کنید

مرحله ۳: ارتقا دادن مؤلفه New Edge UI

مرحله ۴: توقف apigee-sso

مرحله ۵: ایجاد پایگاه داده apigee_dex برای Apigee SSO در گره Postgres

مرحله ۶: راه‌اندازی Apigee SSO در گره‌های OpenLDAP

مرحله ۷: پیکربندی میانای کاربر مدیریت برای Apigee SSO و بازراه‌اندازی میانای کاربر

مرحله ۸: تأیید ارتقای New Edge UI و Apigee SSO

مرحله ۹: حذف نصب apigee-sso قدیمی

ارتقا به Qpid 10.0.1

ارتقا به Postgres 18.6

درحال نصب گره آماده به‌کار Postgres جدید

درحال انجام ارتقای درجا برای Postgres

مرحله مقدماتی

انجام ارتقای درجا

ازکار انداختن گره Postgres

مراحل پس‌از ارتقا برای Postgres

به ZooKeeper 3.8.5 ارتقا دهید

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

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

ZooKeeper را در گره‌های ناظر و دنبال‌کننده ارتقا دهید

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

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

ارتقای رهبر

ارتقا به Cassandra 5.0.8

ارتقا و بازگشت به نسخه قبلی

مرکز داده تکی

چندین مرکز داده

روش‌شناسی ارتقای توصیه‌شده

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

مثال

پیش‌نیازهای ارتقای Cassandra

مرحله ۱: آماده شدن برای ارتقا دادن

مرحله ۲: ارتقا دادن همه گره‌های Cassandra

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

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

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

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

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

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

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

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

ارتقای مستقل ۱ گره

ارتقا مستقل ۲ گره

ارتقای ۵ گره‌ای

ارتقای خوشه‌ای ۹ گرهی

ارتقای خوشه‌ای ۱۳ گره‌ای

ارتقای خوشه‌ای ۱۲ گره‌ای

برای پیکربندی غیرمعیار

مرحله ۲: متغیرهای منسوخ‌شده UI/SSO را بردارید و فایل پیکربندی بی‌صدا (`configFile`) را به‌روز کنید

مرحله ۴: توقف `apigee-sso`

مرحله ۵: ایجاد پایگاه داده `apigee_dex` برای Apigee SSO در گره Postgres

مرحله ۹: حذف نصب `apigee-sso` قدیمی