به روز رسانی Apigee Edge 4.52.02 یا 4.53.00 به 4.53.01

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

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

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

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

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

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

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

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

تغییرات Edge را برای Private Cloud 4.53.01 مرور کنید

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

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

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

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

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

    اگر قبلاً از نسخه قدیمی Edge برای Private Cloud به نسخه 4.52.02 ارتقا داده اید و اکنون قصد دارید به نسخه 4.53.01 ارتقا دهید، مطمئن شوید که مراحل لازم پس از ارتقا را برای Cassandra انجام داده اید. این مراحل در اسناد ارتقاء نسخه 4.52.02 و همچنین در زیر پیش نیازهای ارتقاء کاساندرا ذکر شده است. اگر مطمئن نیستید که این مراحل در طول ارتقای قبلی انجام شده است یا خیر، قبل از ادامه ارتقاء به نسخه 4.53.01، دوباره آنها را کامل کنید.

  • پیکربندی کلیدها و گواهی‌های IDP در Edge برای Private Cloud 4.53.01

    در Edge for Private Cloud 4.53.01، کلیدهای IDP و گواهی‌های مورد استفاده در مؤلفه apigee-sso اکنون از طریق یک فروشگاه کلید پیکربندی می‌شوند. باید کلید و گواهینامه ای را که قبلاً استفاده می کردید به یک فروشگاه کلید صادر کنید. قبل از به‌روزرسانی مؤلفه SSO ، مراحل به‌روزرسانی Apigee SSO را از بخش نسخه‌های قدیمی‌تر برای مراحل دقیق دنبال کنید.

  • الزامات پایتون
    اطمینان حاصل کنید که همه گره ها، از جمله گره های Cassandra، پایتون 3 را قبل از اقدام به ارتقاء نصب کرده اند.

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

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

نسخه فعلی نرم افزاری که برای ارتقا به 4.53.01 به مراحل خاصی نیاز دارد
4.52.02 LDAP ، Cassandra ، Zookeeper ، Postgres
4.53.00 LDAP ، Zookeeper ، Postgres

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

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

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

ارتقاء مورد نیاز به OpenLDAP 2.6

در اینجا روش گام به گام برای ارتقای سرویس LDAP زیربنایی Apigee Edge برای Private Cloud از OpenLDAP 2.4 قدیمی به OpenLDAP 2.6 آمده است. این ارتقا برای به‌روزرسانی Apigee Edge برای Private Cloud نسخه 4.53.01 و بالاتر الزامی است. این ارتقا برای همه توپولوژی های استقرار LDAP Apigee قابل اجرا است: تک سرور، فعال-غیرفعال و فعال-فعال (چند استاد).

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

  • توجه داشته باشید که در طول فرآیند ارتقاء LDAP، APIهای مدیریتی و در نتیجه، رابط کاربری Apigee در همه مناطق به طور کامل در دسترس نخواهد بود. همه وظایف اداری - مانند مدیریت کاربران، نقش‌ها، برنامه‌ها و سازمان‌ها با شکست مواجه می‌شوند و باید موقتاً متوقف شوند. هیچ تاثیری بر پردازش ترافیک پروکسی API شما نخواهد داشت. لطفاً قبل از ادامه ارتقاء LDAP، مطمئن شوید که همه سرورهای مدیریت لبه و رابط کاربری لبه را خاموش کرده‌اید.

  • پشتیبان گیری بسیار مهم است: پشتیبان گیری کامل و معتبر از داده های LDAP موجود شما غیرقابل مذاکره است. ادامه بدون پشتیبان گیری معتبر باعث از دست رفتن داده های برگشت ناپذیر می شود. تهیه نسخه پشتیبان باید در حالی شروع شود که سرویس LDAP هنوز در حال اجرا است تا یک عکس لحظه به لحظه ثابت از داده های LDAP گرفته شود. پشتیبان گیری برای انجام ارتقاء واقعی ضروری است. بدون پشتیبان‌گیری، نه می‌توانید ارتقا را اجرا کنید و نه می‌توانید به عقب برگردید زیرا مراحل ارتقا شامل پاک کردن داده‌های LDAP است.

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

مراحل این بخش (مرحله 2 تا مرحله 5) برای همه توپولوژی های استقرار LDAP یکسان است. این اقدامات باید در هر سروری که مؤلفه apigee-openldap در آن نصب شده است، صرف نظر از نقش آن، انجام شود.

  1. لطفاً قبل از ادامه ارتقاء LDAP، مطمئن شوید که همه سرورهای مدیریت لبه و رابط کاربری لبه را خاموش کرده‌اید. 
    apigee-service edge-management-server stop
apigee-service edge-ui stop

  2. پشتیبان گیری از داده های LDAP موجود

    قبل از ایجاد هر گونه تغییر، یک نسخه پشتیبان کامل از داده های 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

  3. LDAP را متوقف کنید و دایرکتوری های داده را پاک کنید

    این مرحله باید در تمام سرورهای LDAP انجام شود. به دلیل تغییر نسخه عمده و تفاوت های ساختاری اساسی، اجباری است. دایرکتوری تمیز تضمین می کند که هیچ درگیری وجود ندارد. وقتی همه سرورهای LDAP متوقف شوند، اختلال در مدیریت API و UI آغاز می شود.

    • سرویس LDAP را متوقف کنید. 
      apigee-service apigee-openldap stop
    • دایرکتوری های پیکربندی و داده های قدیمی LDAP را برای همیشه حذف کنید. 
      rm -rf /opt/apigee/data/apigee-openldap/*

  4. نسخه جدید LDAP را نصب و پیکربندی کنید

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

    • مولفه جدید LDAP را نصب کنید: اسکریپت به روز رسانی فایل پیکربندی شما را می خواند و بسته جدید apigee-openldap را نصب می کند. 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f /opt/silent.conf
    • اعتبار سنجی نسخه جدید LDAP: پس از اتمام نصب، نمایه را بارگذاری مجدد کنید، بررسی کنید که نسخه LDAP جدید به درستی نصب شده باشد. 
      source ~/.bash_profile
ldapsearch -VV
Expected output:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.6.7

  5. قبل از بازیابی اطلاعات، LDAP را در همه سرورها متوقف کنید

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

    apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/ldap/*

  6. بازیابی اطلاعات LDAP

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

    1. اولین سرور فعال برای بازیابی را شناسایی کنید

      • برای راه اندازی تک سرور: این تنها سرور LDAP شما است. می توانید مستقیماً به مرحله بعدی بروید.
      • برای تنظیمات فعال-غیرفعال و فعال-فعال: دستور تشخیصی زیر را روی هر سرور LDAP اجرا کنید: 
        grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*\ldif
Note:
-If this command returns output, the server is a passive server.
-If it returns no output, the server is the active server.

    2. داده های پشتیبان را بازیابی کنید

      قبل از ادامه، دوباره بررسی کنید که مرحله 5 با موفقیت در تمام سرورهای LDAP تکمیل شده باشد.

      • در اولین سرور فعالی که در بالا شناسایی کردید، به دایرکتوری پشتیبان بروید. 
        cd /opt/apigee/backup/openldap
      • دستور restore را اجرا کنید. برای جلوگیری از بازیابی نسخه ناخواسته یا قدیمی، اکیداً توصیه می کنیم که برای تعیین مهر زمانی دقیق پشتیبان گیری از مرحله 2 دقیقاً مشخص کنید. 
        # 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

  7. سرورهای باقیمانده LDAP را شروع کنید

    اگر راه اندازی چند سرور دارید، در هر یک از سرورهای LDAP، سرویس را راه اندازی کنید: 

    apigee-service apigee-openldap start

  8. اعتبار سنجی نهایی

    مرحله نهایی تأیید موفقیت آمیز بودن ارتقا و سازگاری داده ها در کل خوشه LDAP است.

    • دستور اعتبار سنجی را روی همه سرورهای LDAP اجرا کنید. تعداد رکوردها باید در همه سرورها یکسان باشد و باید با تعداد ثبت شده در مرحله 2 مطابقت داشته باشد. 
      • # 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-ui و edge-ui و هر مؤلفه وابسته دیگر طبق رویه ارتقای استاندارد سازمان خود ادامه دهید.

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

Apigee Edge for Private Cloud 4.53.01 شامل ارتقای Cassandra به نسخه 4.0.18 است.

ارتقاء و بازگشت

  • ارتقاء از Cassandra 3.11.X به Cassandra 4.0.X فرآیندی روان است. Cassandra 4.0.X که با Edge برای Private Cloud 4.53.00 منتشر شد، با زمان اجرا و اجزای مدیریتی Private Cloud 4.52.02 سازگار است.
  • بازگشت مستقیم در محل از Cassandra 4.0.X به 3.11.X امکان پذیر نیست. بازگشت به عقب با استفاده از کپی یا نسخه پشتیبان یک روش پیچیده است و ممکن است شامل خرابی و/یا از دست دادن اطلاعات باشد. عیب‌یابی مشکلات و ارتقاء به Cassandra 4.0.X به بازگشت ترجیح داده می‌شود.
  • قبل از اقدام به ارتقا، مهم است که با روش‌های بازگشت مجدد آشنا شوید. در نظر گرفتن تفاوت های ظریف در هنگام ارتقا برای اطمینان از وجود مسیرهای بازگشت مناسب بسیار مهم است.

مرکز داده واحد

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

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

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

راه اندازی چندین مرکز داده با Edge for Private Cloud 4.52.02 انعطاف پذیری بیشتری را برای بازگشت به عقب در طول ارتقا به Edge for Private Cloud 4.53.00 ارائه می دهد.

  • بازگشت به عقب بستگی به داشتن حداقل یک مرکز داده دارد که نسخه قدیمی کاساندرا (3.11.X) را اجرا می کند.
  • اگر کل کلاستر Cassandra شما به 4.0.X ارتقا یافته است، نباید به Cassandra 3.11.X برگردید. باید از نسخه جدیدتر کاساندرا با سایر اجزای Private Cloud 4.53.00 یا 4.52.02 استفاده کنید.
  1. یک مرکز داده کاساندرا را در یک زمان ارتقا دهید: با ارتقاء گره های کاساندرا به صورت جداگانه در یک مرکز داده شروع کنید. قبل از اینکه به مرکز دیگر بروید، تمام گره‌های کاساندرا را در یک مرکز داده ارتقا دهید.
  2. مکث و اعتبارسنجی: پس از ارتقای یک مرکز داده، مکث کنید تا مطمئن شوید که خوشه ابر خصوصی شما، به خصوص مرکز داده ارتقا یافته، به درستی کار می کند.
  3. به یاد داشته باشید: فقط در صورتی می توانید به نسخه قبلی کاساندرا برگردید که حداقل یک مرکز داده هنوز نسخه قدیمی را اجرا می کند.
  4. حساس به زمان: در حالی که می‌توانید برای مدت کوتاهی (چند ساعت توصیه می‌شود) مکث کنید تا عملکرد را تأیید کنید، نمی‌توانید برای مدت نامحدودی در حالت ترکیبی باقی بمانید. این به این دلیل است که یک خوشه Cassandra غیر یکنواخت (با گره‌ها در نسخه‌های مختلف) دارای محدودیت‌های عملیاتی است.
  5. آزمایش کامل: Apigee قویاً آزمایش جامع عملکرد و عملکرد را قبل از ارتقای مرکز داده بعدی توصیه می کند. هنگامی که همه مراکز داده به روز می شوند، بازگشت به نسخه قبلی غیرممکن است.
بازگشت به عنوان یک فرآیند دو نقطه بازرسی
  1. چک پوینت 1: حالت اولیه، با تمامی اجزا در نسخه 4.52.02. بازگشت کامل تا زمانی امکان پذیر است که حداقل یک مرکز داده کاساندرا در نسخه قدیمی باقی بماند.
  2. چک پوینت 2: پس از به روز رسانی تمام گره های Cassandra در تمام مراکز داده. می توانید به این حالت برگردید، اما نمی توانید به Checkpoint 1 برگردید.
مثال

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

  1. حالت شروع: گره های Cassandra در هر دو DC در نسخه 3.11.X هستند. همه گره های دیگر در Edge برای Private Cloud نسخه 4.52.02 هستند. سه گره کاساندرا در هر DC را فرض کنید.
  2. ارتقاء DC-1: سه گره Cassandra را در DC-1 یکی یکی ارتقا دهید.
  3. مکث و اعتبارسنجی: برای اطمینان از اینکه خوشه، به ویژه DC-1، به درستی کار می کند، مکث کنید (عملکرد، عملکرد را بررسی کنید). می توانید با استفاده از گره های Cassandra در DC-2 به حالت اولیه برگردید. به یاد داشته باشید، این مکث به دلیل محدودیت‌های یک خوشه کاساندرا نسخه مختلط باید موقتی باشد.
  4. ارتقاء DC-2: سه گره Cassandra باقی مانده در DC-2 را ارتقا دهید. این نقطه بازرسی جدید شما می شود.
  5. سایر مؤلفه‌ها را ارتقا دهید: گره‌های مدیریت، زمان اجرا و تجزیه و تحلیل را طبق معمول در همه مراکز داده، هر نود، یک گره و یک مرکز داده ارتقا دهید. اگر مشکلی پیش آمد، می توانید به حالت مرحله 4 برگردید.

پیش نیازهای ارتقاء کاساندرا

شما باید Cassandra 3.11.16 را با Edge برای Private Cloud 4.52.02 اجرا کنید و از موارد زیر اطمینان حاصل کنید:
  1. کل خوشه با Cassandra 3.11.16 عملیاتی و کاملاً کاربردی است.
  2. استراتژی فشرده سازی روی LeveledCompactionStrategy (پیش نیازی برای ارتقاء به نسخه 4.52.02) تنظیم شده است.

  3. تأیید کنید که هر مرحله زیر به عنوان بخشی از ارتقای اولیه Cassandra 3.11 در Edge برای Private Cloud نسخه 4.52.02 تکمیل شده است.

    • دستور post_upgrade بر روی هر گره Cassandra در طول ارتقاء قبلی اجرا شد
    • دستور drop_old_tables بر روی کل خوشه Cassandra در طول ارتقاء قبلی اجرا شد.

اگر مطمئن نیستید که دستورات post_upgrade و drop_old_tables در Cassandra 3.11 در حین استفاده از Edge برای Private Cloud 4.52.02 اجرا شده اند، می توانید با خیال راحت آنها را قبل از ارتقا به 4.53.01 دوباره اجرا کنید.

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

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

  1. از کاساندرا با استفاده از Apigee نسخه پشتیبان تهیه کنید.
  2. از گره های کاساندرا (در صورت امکان) عکس های فوری VM بگیرید.
  3. اطمینان حاصل کنید که پورت 9042 از تمام اجزای Edge برای Private Cloud، از جمله مدیریت سرور، پردازشگر پیام، روتر، Qpid و Postgres به گره‌های Cassandra در صورتی که قبلاً پیکربندی نشده‌اند، قابل دسترسی باشد. برای اطلاعات بیشتر به الزامات بندر مراجعه کنید.

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

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

پس از ارتقاء تمام گره‌های کاساندرا در مرکز داده، قبل از ادامه کار با گره‌ها در مرکز داده بعدی، مدتی (30 دقیقه تا چند ساعت) صبر کنید. در این مدت، مرکز داده ای که به روز شده است را به طور کامل بررسی کنید و اطمینان حاصل کنید که معیارهای عملکردی و عملکرد خوشه Apigee شما دست نخورده هستند. این مرحله برای اطمینان از پایداری مرکز داده که در آن Cassandra به نسخه 4.0.X ارتقا یافته است، بسیار مهم است، در حالی که بقیه اجزای Apigee در نسخه 4.52.02 باقی می مانند.

  1. برای ارتقاء گره Cassandra، دستور زیر را اجرا کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. هنگامی که یک گره به روز شد، دستور زیر را بر روی گره اجرا کنید تا قبل از ادامه، برخی از اعتبارسنجی ها اجرا شود: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. خروجی بالا چیزی در امتداد خطوط زیر خواهد بود: 
    Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.18 | CQL spec 3.4.5 | Native protocol v5] 
Metadata is verified
  4. دستور post_upgrade زیر را روی گره Cassandra اجرا کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
  5. دستورات 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 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 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 cache cache_entries cache_entries_cache_name_idx
/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 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 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

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

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

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

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

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

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

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

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

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

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

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

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

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

بک آپ بگیرید

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

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

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

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

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

  1. اگر روی گره ZooKeeper نصب نشده است، nc را نصب کنید: 
      sudo yum install nc
  2. دستور nc زیر را روی گره اجرا کنید، جایی که 2181 پورت ZooKeeper است:
      echo stat | nc localhost 2181

    شما باید خروجی را مانند زیر ببینید: 

      Zookeeper version: 3.8.4-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597

    در خط Mode خروجی گره‌ها، بسته به پیکربندی گره، باید مشاهده‌گر، رهبر یا دنبال‌کننده (به معنای رأی‌دهنده‌ای که رهبر نیست) را ببینید. توجه: در نصب مستقل Edge با یک گره ZooKeeper، Mode روی حالت مستقل تنظیم می شود.

  3. مراحل 1 و 2 را در هر گره ZooKeeper تکرار کنید.

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

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

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

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

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

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

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

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

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

ارتقا رهبر

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

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

ارتقا Nginx 1.26 در Edge-Router

ارتقاء به Edge برای Private Cloud 4.53.01 از نسخه های قبلی، به طور خودکار نرم افزار Nginx را به آخرین نسخه (1.26.x) ارتقا نمی دهد. این برای جلوگیری از هر گونه عوارض جانبی تصادفی در زمان اجرا در نتیجه تغییرات مستند شده در تغییرات Nginx 1.26 در Apigee Edge 4.53.01 است. پس از تایید در محیط های پایین تر، می توانید Nginx را به صورت دستی از 1.20.x به 1.26.x ارتقا دهید. برای ارتقاء دستی:

  1. اطمینان حاصل کنید که نود لبه روتر دارای آخرین نرم افزار 4.53.01 است 

    /opt/apigee/apigee-service/bin/apigee-service edge-router version

  2. نسخه Nginx را که در حال حاضر اجرا می کنید بررسی و تأیید کنید 

    /opt/nginx/sbin/nginx -V

    اگر از نسخه قدیمی Nginx استفاده می کنید، می توانید مراحل زیر را برای ارتقا Nginx به نسخه 1.26.X در گره روتر دنبال کنید.

  3. فرآیند لبه روتر را در گره روتر متوقف کنید 

    /opt/apigee/apigee-service/bin/apigee-service edge-router stop

  4. نرم افزار nginx را در گره روتر ارتقا دهید 

    dnf update apigee-nginx

  5. بررسی کنید که نسخه Nginx به روز شده است 

    /opt/nginx/sbin/nginx -V

  6. فرآیند روتر را روی گره شروع کنید 

    /opt/apigee/apigee-service/bin/apigee-service edge-router start

  7. این فرآیند را در هر نود روتر، یکی یکی تکرار کنید

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

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

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

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

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

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

    در پیکربندی 1 گره و 2 گره Edge، توپولوژی هایی که برای نمونه سازی و آزمایش استفاده می شوند، شما فقط یک گره Postgres دارید. شما می توانید این گره های Postgres را مستقیماً بدون نیاز به ایجاد یک گره Postgres جدید به روز کنید.

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

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

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

این روش یک سرور آماده به کار Postgres را در یک گره جدید ایجاد می کند. مطمئن شوید که یک سرور آماده به کار Postgres جدید را برای نسخه فعلی Edge (4.52.02 یا 4.53.00) نصب کرده اید، نه برای نسخه 4.53.01.

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

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

  1. در استاد فعلی 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 گره آماده به کار جدید است.

  2. apigee-postgresql در Master Postgres راه اندازی مجدد کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. بررسی کنید که گره آماده به کار جدید با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf در اصلی اضافه شده است. شما باید خطوط زیر را در آن فایل ببینید: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. سرور آماده به کار جدید Postgres را نصب کنید:
    1. فایل پیکربندی را که برای نصب نسخه فعلی Edge استفاده کردید، ویرایش کنید تا موارد زیر را مشخص کنید: 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. همانطور که در Install the Edge apigee-setup utility توضیح داده شد SELinux را غیرفعال کنید.

    3. اگر در حال حاضر در Edge 4.52.02 هستید:

      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.51.00.sh
      2. ابزار و وابستگی های Edge apigee-service را نصب کنید: 
        sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      اگر در حال حاضر در Edge 4.53.00 هستید:

      1. فایل 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
      2. ابزار و وابستگی های Edge apigee-service را نصب کنید: 
        sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
    4. از apigee-service برای نصب ابزار apigee-setup استفاده کنید: 
      /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 باید مرحله مقدماتی زیر را انجام دهید.

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

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

  1. اگر موجود نیست، فایل /opt/apigee/customer/application/postgresql.properties را ایجاد کنید.
  2. مالکیت این فایل را به apigee تغییر دهید: 
    sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
  3. ویژگی زیر را به فایل اضافه کنید: 
    conf/postgresql.conf+max_locks_per_transaction=30000
  4. apigee-postgresql پیکربندی کنید: 
    apigee-service apigee-postgresql configure
  5. راه اندازی مجدد apigee-postgresql : 
    apigee-service apigee-postgresql restart

ارتقاء را در محل انجام دهید

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

  1. postgres را در هاست اصلی ارتقا دهید 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. دستور setup را در هاست اصلی اجرا کنید: 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. دستور configure را در هاست اصلی اجرا کنید: 
    apigee-service apigee-postgresql configure
  4. میزبان اصلی را مجددا راه اندازی کنید: 
    apigee-service apigee-postgresql restart
  5. آن را به عنوان استاد پیکربندی کنید: 
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. مطمئن شوید که میزبان اصلی شروع کرده است: 
    apigee-service apigee-postgresql wait_for_ready
  7. حالت آماده به کار را متوقف کنید: 
    apigee-service apigee-postgresql stop
  8. حالت آماده به کار را ارتقا دهید.

    توجه: اگر این مرحله با خطا/شکست مواجه شد، می توان آن را نادیده گرفت. update.sh سعی می کند سرور آماده به کار را با پیکربندی نادرست راه اندازی کند. به شرطی که نصب Postgres به 17 ارتقا یابد، می توان خطا را نادیده گرفت. 

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. اطمینان حاصل کنید که حالت آماده به کار متوقف شده است: 
    apigee-service apigee-postgresql stop
  10. پیکربندی آماده به کار قدیمی را حذف کنید: 
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. تنظیم تکرار در سرور آماده به کار: 
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
  12. خط conf/postgresql.conf+max_locks_per_transaction=30000 از فایل /opt/apigee/customer/application/postgresql.properties هم در میزبان اصلی و هم در حالت آماده به کار حذف کنید. این خط در مرحله مقدماتی اضافه شد.

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

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

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

  1. اطمینان حاصل کنید که Postgres در حال اجرا است:
    /opt/apigee/apigee-service/bin/apigee-all status

    اگر Postgres در حال اجرا نیست ، آن را شروع کنید: 

    /opt/apigee/apigee-service/bin/apigee-all start
  2. با اجرای دستور curl زیر در گره آماده به کار جدید ، UUID گره آماده به کار جدید را دریافت کنید:
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    شما باید UUID گره را در انتهای خروجی ، به شکل مشاهده کنید: 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. با اجرای دستور زیر در گره آماده به کار جدید ، گره آماده به کار جدید را متوقف کنید: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. در گره Master Postgres ، edit /opt/apigee/customer/application/postgresql.properties برای حذف گره آماده به کار جدید از conf_pg_hba_replication.connection : 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
  5. مجدداً Apigee-PostgreSQL را در Master Postgres راه اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. تأیید کنید که گره آماده به کار جدید با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf apigee-postgresql/conf/pg_hba.conf در استاد حذف شد. شما فقط باید خط زیر را در آن پرونده مشاهده کنید: 
    host replication apigee existing_standby_ip/32 trust
  7. با برقراری تماس API مدیریت لبه زیر در گره سرور مدیریت ، UUID گره آماده به کار را از Zookeeper حذف کنید: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

مراحل پس از به روزرسانی برای postgres

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

Postgres می تواند به تدریج آمار خود را با گذشت زمان بازسازی کند زیرا نمایش داده ها اجرا می شوند و هنگامی که Daemon Autovacuum اجرا می شود. با این حال ، تا زمانی که آمار بازسازی نشود ، ممکن است سؤالات شما کند باشد.

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

مراحل به روزرسانی Apigee SSO از نسخه های قدیمی

در Edge for Private Cloud 4.53.01 ، کلیدهای IDP و گواهینامه های مورد استفاده در مؤلفه apigee-sso اکنون از طریق یک کلید اصلی تنظیم شده اند. شما باید کلید و گواهی مورد استفاده را در ابتدا به یک کلید اصلی صادر کنید ، آن را پیکربندی کنید و سپس طبق معمول به روزرسانی SSO را ادامه دهید.

  1. کلید و گواهی موجود را برای پیکربندی IDP شناسایی کنید:

    1. با جستجوی مقدار SSO_SAML_SERVICE_PROVIDER_CERTIFICATE در پرونده پیکربندی نصب SSO یا با پرس و جو از مؤلفه apigee-sso برای conf_login_service_provider_certificate ، گواهینامه را بازیابی کنید.

      از دستور زیر در گره SSO برای پرس و جو apigee-sso برای مسیر گواهی IDP استفاده کنید. در خروجی ، به دنبال مقدار در خط آخر باشید. 

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

    2. با جستجوی مقدار SSO_SAML_SERVICE_PROVIDER_KEY در پرونده پیکربندی نصب SSO یا با پرس و جو از مؤلفه apigee-sso برای conf_login_service_provider_key ، کلید را بازیابی کنید.

      از دستور زیر در گره SSO برای پرس و جو apigee-sso برای مسیر کلید IDP استفاده کنید. در خروجی ، به دنبال مقدار در خط آخر باشید. 

      apigee-service apigee-sso configure -search conf_login_service_provider_key
  2. کلید و گواهی را به یک کلیدی کلیدی صادر کنید:
    1. کلید و گواهینامه را به کلید اصلی PKCS12 صادر کنید:
      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      پارامترها:

      • certificate_path : مسیر پرونده گواهینامه بازیابی شده در مرحله 1.A.
      • key_path : مسیر به پرونده کلید خصوصی که در مرحله 1.b. بازیابی شده است.
      • keystore_path : مسیر به کلیدهای تازه ایجاد شده حاوی گواهی و کلید خصوصی.
      • alias : alias برای جفت کلید و گواهینامه در کلیدینگ استفاده می شود.

      برای اطلاعات بیشتر به مستندات OpenSSL مراجعه کنید.

    2. (اختیاری) کلید و گواهینامه را از PKCS12 به کلیدهای JKS صادر کنید:
      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      پارامترها:

      • PKCS12_keystore_path : مسیر به کلید اصلی PKCS12 ایجاد شده در مرحله 2.A ، حاوی گواهی و کلید.
      • destination_keystore_path : مسیر به کلید اصلی JKS که در آن گواهی و کلید صادر می شود.
      • alias : alias برای جفت کلید و گواهینامه در jks keystore استفاده می شود.

      3. برای اطلاعات بیشتر به مستندات KeyTool مراجعه کنید.

  3. صاحب پرونده کلیدی خروجی را به کاربر "Apigee" تغییر دهید: 
    sudo chown apigee:apigee <keystore_file>
  4. ویژگی های زیر را در پرونده پیکربندی Apigee SSO اضافه کرده و آنها را با مسیر فایل Keystore ، رمز عبور ، نوع کلید اصلی و نام مستعار به روز کنید: 
    # Path to the keystore file
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks

# Keystore password
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore

# Keystore type
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12

# Alias within keystore that stores the key and certificate
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert
  5. نرم افزار Apigee SSO را به طور معمول با استفاده از دستور زیر به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

UI Edge جدید

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

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

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

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

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

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

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

به روزرسانی

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

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

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

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

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

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

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

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

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

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

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

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

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

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

شما باید یک فایل پیکربندی خاموش را به دستور Update منتقل کنید. پرونده پیکربندی خاموش باید همان موردی باشد که شما برای نصب Edge برای Cloud Private 4.52.02 یا 4.53.00 استفاده کرده اید.

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

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

  1. در صورت وجود ، هرگونه شغل cron را که برای انجام یک عملیات تعمیر در کاساندرا تنظیم شده است ، غیرفعال کنید تا پس از اتمام به روزرسانی.
  2. برای نصب RPMS Edge به گره خود به عنوان ریشه وارد شوید.
  3. Selinux را همانطور که در نصب ابزار Edge Apigee-setup توضیح داده شده است ، غیرفعال کنید.
  4. اگر در حال نصب 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

  5. اگر در حال حاضر در لبه 4.52.02 یا 4.53.00 هستید:

    1. پرونده 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
    2. Edge 4.53.01 apigee-service Utility و وابستگی ها را با اجرای دستور زیر نصب کنید:
      sudo bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord

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

      به طور پیش فرض ، نصب را بررسی می کند که جاوا 1.8 را نصب کرده اید. اگر این کار را نکنید ، نصب کننده آن را برای شما نصب می کند.

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

      • I : OpenJDK 1.8 (پیش فرض) را نصب کنید.
      • C : بدون نصب جاوا ادامه دهید.
      • Q : ترک برای این گزینه ، شما باید خودتان جاوا را نصب کنید.
    3. برای به روزرسانی ابزار apigee-setup ، از apigee-service استفاده کنید ، همانطور که مثال زیر نشان می دهد: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. همانطور که در مثال زیر نشان می دهد ، ابزار apigee-validate را در سرور مدیریت به روز کنید: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. همانطور که مثال زیر نشان می دهد ، ابزار apigee-provision را در سرور مدیریت به روز کنید: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. با اجرای دستور زیر ، ابزار update را روی گره های خود اجرا کنید:
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      این کار را به ترتیب شرح داده شده به ترتیب به روزرسانی دستگاه انجام دهید.

      کجا:

      • component مؤلفه Edge برای به روزرسانی است. مقادیر ممکن عبارتند از:
        • cs : کاساندرا
        • edge : All Edge Components به جز Edge UI: سرور مدیریت ، پردازنده پیام ، روتر ، سرور QPID ، سرور Postgres
        • ldap : OpenDap
        • ps : postgresql
        • qpid : QPIDD
        • sso : Apigee SSO (اگر SSO را نصب کردید)
        • ue : ui Edge جدید
        • ui : UI Edge Classic
        • zk : باغ وحش
      • configFile همان فایل پیکربندی است که شما برای تعیین اجزای لبه خود در طول نصب 4.52.02 یا 4.53.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.53.01 استفاده کنید.

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

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

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

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

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

  1. یک repo محلی 4.53.01 ایجاد کنید همانطور که در "ایجاد یک مخزن محلی Apigee" در نصب ابزار Edge Apigee-Setup توضیح داده شده است.
  2. برای نصب سرویس Apigee از یک پرونده .tar :
    1. در گره با repo محلی ، از دستور زیر استفاده کنید تا repo محلی را در یک پرونده .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.53.01.tar.gz : بسته بندی کنید. 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. پرونده .tar را در گره ای که می خواهید Edge را به روز کنید ، کپی کنید. به عنوان مثال ، آن را در فهرست /tmp در گره جدید کپی کنید.
    3. در گره جدید ، پرونده را به فهرست /tmp فهرست کنید:
      tar -xzf apigee-4.53.01.tar.gz

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

    4. ابزار و وابستگی های Edge apigee-service از /tmp/repos نصب کنید:
      sudo bash /tmp/repos/bootstrap_4.53.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  3. برای نصب سرویس Apigee با استفاده از NGINX WebServer:
    1. سرور وب Nginx را همانطور که در "نصب از repo با استفاده از WebServer Nginx" در نصب Edge Apigee-Setup تنظیم شده است ، پیکربندی کنید.
    2. در گره از راه دور ، پرونده Edge bootstrap_4.53.01.sh به /tmp/bootstrap_4.53.01.sh بارگیری کنید:
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh

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

    3. در گره از راه دور ، ابزار و وابستگی های Edge apigee-setup نصب کنید:
      sudo bash /tmp/bootstrap_4.53.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      جایی که uName:pWord نام کاربری و رمز عبور repo است.

  4. برای به روزرسانی ابزار apigee-setup ، از apigee-service استفاده کنید ، همانطور که مثال زیر نشان می دهد: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. همانطور که در مثال زیر نشان می دهد ، ابزار apigee-validate را در سرور مدیریت به روز کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. همانطور که مثال زیر نشان می دهد ، ابزار apigee-provision را در سرور مدیریت به روز کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. ابزار update را روی گره های خود به ترتیب شرح داده شده به ترتیب به روزرسانی دستگاه اجرا کنید:
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    کجا:

    • component مؤلفه Edge برای به روزرسانی است. شما به طور معمول اجزای زیر را به روز می کنید:
      • cs : کاساندرا
      • edge : All Edge Components به جز Edge UI: سرور مدیریت ، پردازنده پیام ، روتر ، سرور QPID ، سرور Postgres
      • ldap : OpenDap
      • ps : postgresql
      • qpid : QPIDD
      • sso : Apigee SSO (اگر SSO را نصب کردید)
      • ue جدید
      • ui : UI Edge Classic
      • zk : باغ وحش
    • configFile همان فایل پیکربندی است که شما برای تعیین اجزای لبه خود در طول نصب 4.52.02 یا 4.53.00 استفاده کرده اید.

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

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. اگر قبلاً این کار را نکرده اید ، اجزای UI را روی همه گره هایی که آن را اجرا کرده اید مجدداً راه اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. همانطور که در تست نصب توضیح داده شده است ، به روزرسانی را با اجرای ابزار apigee-validate در سرور مدیریت آزمایش کنید.

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

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

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

  • شما باید قبل از به روزرسانی هر مؤلفه دیگر ، تمام گره های LDAP را به روز کنید. برای به روزرسانی LDAP باید مراحل ویژه ای را دنبال کنید.
  • شما باید تمام گره های Cassandra و Zookeeper را به روز کنید. اگر از 4.52.02 در حال ارتقا هستید ، مراحل ویژه ای را برای به روزرسانی کاساندرا دنبال کنید. برای به روزرسانی Zookeeper برای 4.52.02 یا 4.53.00 باید مراحل ویژه ای را دنبال کنید.
  • برای به روزرسانی آنها باید تمام سرورهای مدیریت و پردازنده های روتر و پیام را ارتقا دهید.
  • شما باید تمام گره های Postgres را به دنبال مراحل ویژه برای به روزرسانی Postgres ارتقا دهید.
  • شما باید اجزای Edge-QPID-Server & Edge-Postgres-Server را در تمام مراکز داده به روز کنید.
  • شما باید تمام گره های QPID را ارتقا دهید.
  • شما باید گره های Edge UI را ارتقا دهید و همچنین گره های جدید UI و SSO Edge را ارتقا دهید (در صورت وجود).
  • هیچ مرحله جداگانه ای برای به روزرسانی کسب درآمد وجود ندارد. وقتی گزینه -C Edge را مشخص می کنید به روز می شود.

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

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

  1. تمام مؤلفه ها را به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (اگر apigee-adminapi را نصب کردید) ابزار apigee-adminapi را به روز کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

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

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

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

  1. LDAP را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. کاساندرا و Zookeeper را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. اجزای Edge Edge را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. به روزرسانی postgres در دستگاه 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. اجزای Edge Edge را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. QPID را در دستگاه 2 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. UI را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. (اگر apigee-adminapi را نصب کردید) ابزار apigee-adminapi را در دستگاه 1 به روز کرد: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (اگر Apigee SSO را نصب کردید) Apigee SSO را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  10. مؤلفه Edge UI را در دستگاه 1 مجدداً راه اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقاء 5 گره

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

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

  1. LDAP را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. کاساندرا و Zookeeper را در دستگاه 1 ، 2 و 3 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. اجزای Edge Edge را در دستگاه 1 ، 2 ، 3 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. به روزرسانی postgres در دستگاه 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. به روزرسانی postgres در دستگاه 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. اجزای Edge Edge را در دستگاه 4 ، 5 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. QPID را در دستگاه 4 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. QPID را در دستگاه 5 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  9. 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
  10. (اگر apigee-adminapi را نصب کردید) ابزار apigee-adminapi را در دستگاه 1 به روز کرد: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  11. (اگر Apigee SSO را نصب کردید) Apigee SSO را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  12. مؤلفه UI را مجدداً راه اندازی کنید:
    • UI کلاسیک: اگر از UI کلاسیک استفاده می کنید ، سپس مؤلفه edge-ui در دستگاه 1 مجدداً راه اندازی کنید ، همانطور که مثال زیر نشان می دهد: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • UI New Edge: اگر UI Edge جدید را نصب کردید ، سپس مؤلفه edge-management-ui روی دستگاه مناسب مجدداً راه اندازی کنید (ممکن است دستگاه 1 نباشد): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. LDAP را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. کاساندرا و Zookeeper را در دستگاه 1 ، 2 و 3 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. اجزای Edge Edge را در دستگاه 1 ، 4 و 5 به روز کنید (سرور مدیریت ، پردازنده پیام ، روتر) به این ترتیب: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. به روزرسانی postgres در دستگاه 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. به روزرسانی postgres در دستگاه 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. اجزای لبه را در دستگاه 6 ، 7 ، 8 و 9 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. QPID را در دستگاه های 6 و 7 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. UI جدید ( ue ) یا UI کلاسیک ( ui ) را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (اگر apigee-adminapi را نصب کردید) ابزار apigee-adminapi را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (اگر Apigee SSO را نصب کردید) Apigee SSO را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  11. مؤلفه UI را مجدداً راه اندازی کنید:
    • UI کلاسیک: اگر از UI کلاسیک استفاده می کنید ، سپس مؤلفه edge-ui در دستگاه 1 مجدداً راه اندازی کنید ، همانطور که مثال زیر نشان می دهد: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • UI New Edge: اگر UI Edge جدید را نصب کردید ، سپس مؤلفه edge-management-ui روی دستگاه مناسب مجدداً راه اندازی کنید (ممکن است دستگاه 1 نباشد): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. LDAP را در دستگاه 4 و 5 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. کاساندرا و Zookeeper را در دستگاه های 1 ، 2 و 3 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. اجزای Edge را در دستگاه های 6 ، 7 ، 10 و 11 به ترتیب به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. به روزرسانی postgres در دستگاه 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. به روزرسانی postgres در دستگاه 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. اجزای Edge را در دستگاه های 12 ، 13 ، 8 و 9 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. QPID را در دستگاه های 12 و 13 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. UI جدید ( ue ) یا UI کلاسیک ( ui ) را در دستگاه های 6 و 7 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (اگر apigee-adminapi را نصب کردید) ابزار apigee-adminapi را در دستگاه های 6 و 7 به روز کرد: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (اگر Apigee SSO را نصب کردید) Apigee SSO را در دستگاه های 6 و 7 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  11. مؤلفه 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. LDAP را به روز کنید:
    1. دستگاه 1 در مرکز داده 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. دستگاه 7 در مرکز داده 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. کاساندرا و باغ وحش را به روز کنید:
    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
  3. به روزرسانی اجزای لبه:
    1. در دستگاه های 1 ، 2 و 3 در مرکز داده 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. در دستگاه های 7 ، 8 و 9 در مرکز داده 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. به روزرسانی Postgres:
    1. دستگاه 6 در مرکز داده 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. دستگاه 12 در مرکز داده 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. به روزرسانی اجزای لبه:
    1. ماشین آلات 4 ، 5 ، 6 در مرکز داده 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. ماشین آلات 10 ، 11 ، 12 در مرکز داده 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. 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
  7. 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
  8. (اگر 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
  9. (اگر 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

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

  10. مؤلفه جدید 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 را به ترتیب زیر به روز کنید:

  1. LDAP
  2. کاساندرا
  3. نگهبان باغ وحش
  4. سرور مدیریت
  5. پردازنده پیام
  6. روتر
  7. Postgres
  8. لبه ، به معنی پروفایل "-C Edge" در همه گره ها به ترتیب: گره هایی با سرور QPID ، Edge Postgres Server.
  9. qpidd
  10. Edge UI (یا کلاسیک یا جدید)
  11. apigee-adminapi
  12. Apigee SSO

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