Apigee Edge 4.53.00 را به عقب برگردانید

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

می‌توانید Edge 4.53.00 را به نسخه منتشر شده کوچک زیر برگردانید:

  • نسخه 4.52.02

بازگرداندن یک نسخه شامل بازگرداندن هر مؤلفه ای است که ممکن است ارتقا داده باشید. علاوه بر این، هنگام بازگرداندن کاساندرا به نسخه 4.52.02 باید ملاحظات خاصی را در نظر بگیرید.

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

  1. به نسخه اصلی یا فرعی قبلی برگردید . به عنوان مثال از 4.53.00 تا 4.52.02.
  2. به نسخه پچ قبلی در همان نسخه برگردید . به عنوان مثال، از 4.53.00.01 تا 4.53.00.00.

برای اطلاعات بیشتر، روند انتشار Apigee Edge را ببینید.

ترتیب برگشت

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

یک ترتیب عمومی معمولی بازگشت به حالت اولیه برای Private Cloud 4.53.00 به شکل زیر خواهد بود:

  1. Rollback Postgres، Qpid، و سایر اجزای مرتبط با تجزیه و تحلیل
  2. روترهای برگشتی و پردازشگرهای پیام
  3. بازگشت کاساندرا، نگهبان باغ وحش
  4. سرور مدیریت بازگشت

به عنوان مثال، فرض کنید کل خوشه Cassandra، تمام سرورهای مدیریتی و چند RMP را از نسخه 4.52.02 به نسخه 4.53.00 ارتقا داده اید و می خواهید به عقب برگردید. در این مورد، شما:

  1. همه RMP ها را یک به یک برگردانید
  2. کل خوشه Cassandra را با استفاده از پشتیبان‌گیری برگردانید
  3. گره های سرور مدیریت لبه برگشتی یکی یکی

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

کاربری که rollback انجام می دهد باید همان کاربری باشد که Edge را در ابتدا به روز کرده است یا کاربری که به عنوان root اجرا می شود.

به طور پیش فرض، اجزای Edge به عنوان کاربر "apigee" اجرا می شوند. در برخی موارد، ممکن است اجزای Edge را به عنوان کاربران مختلف اجرا کنید. به عنوان مثال، اگر روتر باید به پورت های دارای امتیاز دسترسی داشته باشد، مانند پورت های زیر 1000، باید روتر را به عنوان روت یا به عنوان کاربر با دسترسی به آن پورت ها اجرا کنید. یا ممکن است یک مؤلفه را به عنوان یک کاربر و مؤلفه دیگر را به عنوان کاربر دیگر اجرا کنید.

کامپوننت هایی با کد مشترک

اجزای Edge زیر کد مشترکی دارند. بنابراین، برای برگرداندن هر یک از این مؤلفه‌ها در یک گره، باید همه این مؤلفه‌ها را که در آن گره هستند، برگردانید.

  • edge-management-server (مدیریت سرور)
  • edge-message-processor (پردازنده پیام)
  • edge-router (روتر)
  • edge-postgres-server (سرور Postgres)
  • edge-qpid-server (سرور Qpid)

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

عقبگرد کاساندرا

عقبگرد کاساندرا

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

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

Cassandra 4.0.X، موجود با Edge for Private Cloud 4.53.00، با سایر اجزای Private Cloud 4.52.02 سازگار است.

لطفاً برای خلاصه ای از استراتژی های مختلف بازگشتی که می توانید استفاده کنید، به جدول زیر مراجعه کنید:

سناریو استراتژی بازگشت
تک DC، برخی از گره های کاساندرا ارتقا یافته اند از پشتیبان گیری استفاده کنید
تک DC، همه گره های کاساندرا ارتقا یافته اند کاساندرا را عقب نکشید. سایر اجزا را می توان به عقب برگرداند.
DC منفرد، همه گره ها (Cassandra و دیگران) ارتقا یافته اند کاساندرا را عقب نکشید. سایر اجزا را می توان به عقب برگرداند.
DC چندگانه، برخی از گره ها در یک DC ارتقا یافته اند بازسازی از DC موجود
DC چندگانه، تمام گره‌های Cassandra در برخی DCها ارتقا یافته‌اند بازسازی از DC موجود
چندین گره DC، Cassandra آخرین DC در حال ارتقاء سعی کنید ارتقا را تمام کنید. اگر امکان پذیر نیست، 1 DC را با استفاده از پشتیبان برگردانید . DCهای باقیمانده را از DC برگشتی بازسازی کنید .
DC چندگانه، همه گره‌های کاساندرا ارتقا یافته‌اند کاساندرا را عقب نکشید. سایر اجزا را می توان به عقب برگرداند.
DC چندگانه، همه گره ها (Cassandra و دیگران) ارتقا یافته اند کاساندرا را عقب نکشید. سایر اجزا را می توان به عقب برگرداند.

ملاحظات کلی

هنگام در نظر گرفتن یک بازگشت، موارد زیر را در نظر داشته باشید:

  • بازگشت اجزای زمان اجرا یا مدیریت: اگر می خواهید اجزایی مانند edge-management-server، edge-message-processor یا هر جزء غیر Cassandra را به Private Cloud نسخه 4.52.02 برگردانید، توصیه می شود Cassandra را به عقب برگردانید. Cassandra ارسال شده با Private Cloud 4.53.00 با تمام اجزای غیر Cassandra Edge برای Private Cloud 4.52.02 سازگار است. شما می توانید اجزای غیر کاساندرا را با استفاده از روشی که در اینجا ذکر شده است برگردانید در حالی که کاساندرا در نسخه 4.0.13 باقی می ماند.
  • بازگشت پس از ارتقای کل کلاستر Cassandra به 4.0.X: اگر کل کلاستر Cassandra شما به عنوان بخشی از ارتقاء به Private Cloud نسخه 4.53.00 به نسخه 4.0.X ارتقا یافته است، توصیه می شود به این راه اندازی کلاستر ادامه دهید و نه بازگشت کاساندرا اجزایی مانند edge-management-server، edge-message-processor، edge-router و غیره نسخه 4.52.02 Private Cloud با نسخه 4.0.X Cassandra سازگار است.
  • بازگشت کاساندرا در حین ارتقاء کاساندرا: اگر در حین ارتقاء کاساندرا با مشکلاتی مواجه شدید، ممکن است بخواهید یک بازگشت را در نظر بگیرید. استراتژی‌های بازگشتی فهرست‌شده در این مقاله را می‌توان بر اساس وضعیتی که در طول فرآیند ارتقا در آن هستید دنبال کرد.
  • بازگشت با استفاده از پشتیبان‌گیری: نسخه‌های پشتیبان گرفته شده از Cassandra 4.0.X با نسخه‌های پشتیبان Cassandra 3.11.X سازگار نیستند. برای بازگرداندن کاساندرا با استفاده از بازیابی پشتیبان، باید قبل از اقدام به ارتقاء، از Cassandra 3.11.X نسخه پشتیبان تهیه کنید.

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

پیش نیازها

  • شما در حال کارکردن یک خوشه Edge for Private Cloud 4.52.02 در چندین مرکز داده هستید.
  • شما در حال ارتقای Cassandra از 3.11.X به 4.0.X هستید و در حین ارتقا با مشکلاتی مواجه شده اید.
  • شما حداقل یک مرکز داده کاملاً کاربردی در خوشه دارید که هنوز نسخه قدیمی کاساندرا (Cassandra 3.11.X) را اجرا می کند.

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

مراحل سطح بالا

  1. یک مرکز داده (به طور جزئی یا به طور کامل ارتقا یافته) را که می خواهید به عقب برگردانید انتخاب کنید. ترافیک زمان اجرا را به یک مرکز داده با عملکرد متفاوت هدایت کنید.
  2. گره seed را در مرکز داده شناسایی کنید و با یکی از گره های seed شروع کنید.
  3. گره Cassandra را متوقف، حذف و پاکسازی کنید.
  4. نسخه قدیمی Cassandra را روی گره نصب کنید و آن را در صورت نیاز پیکربندی کنید.
  5. تنظیمات اضافی را که قبلا اضافه شده اند حذف کنید.
  6. مراحل بالا را برای تمام گره های seed در مرکز داده یک به یک تکرار کنید.
  7. مراحل بالا را برای تمام گره های کاساندرا باقی مانده در مرکز داده، یک به یک تکرار کنید.
  8. گره ها را از مرکز داده عملکردی موجود، یکی یکی بازسازی کنید.
  9. تمام اجزای edge-* را در مرکز داده که به Cassandra متصل هستند، مجددا راه اندازی کنید.
  10. تست کنید و ترافیک را به این مرکز داده بازگردانید.
  11. مراحل را برای هر مرکز داده، یکی یکی تکرار کنید.

مراحل دقیق

  1. یک مرکز داده را انتخاب کنید که در آن همه یا برخی از گره های Cassandra ارتقا یافته باشند. در حالی که گره‌های Cassandra در این مرکز داده در حال بازگرداندن هستند، تمام ترافیک پراکسی زمان اجرا و ترافیک مدیریتی را از این مرکز داده منحرف کنید. مطمئن شوید که تمام گره‌های Cassandra در حالت UN (Up/Normal) هستند، زمانی که فرمان nodetool ring روی گره‌ها اجرا می‌شود. اگر گره های خاصی خراب هستند، مشکل را عیب یابی کنید و قبل از ادامه، آن گره ها را پشتیبان بگیرید.

    مثال زیر را ببینید:

    $ /opt/apigee/apigee-cassandra/bin/nodetool status
Datacenter: dc-1
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC1-1IP1  456.41 KiB  1            100.0%            78fc4ddd-2ed9-4a8c-98a2-63a38c2f1920  ra-1
UN  DC1-1IP2  870.93 KiB  1            100.0%            160db01a-64ab-43a7-b9ea-3b7f8f66d52b  ra-1
UN  DC1-1IP3  824.08 KiB  1            100.0%            21d61543-d59e-403a-bf5d-bfe7f664baa6  ra-1
Datacenter: dc-2
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC2-1IP1   802.08 KiB  1            100.0%            583e0576-336d-4ce7-9729-2ae74e0abde2  ra-1
UN  DC2-1IP2   844.4 KiB  1            100.0%            fef794d5-f4c2-4a4e-bb05-9adaeb4aea4b  ra-1
UN  DC2-1IP3   878.12 KiB  1            100.0%            3894b3d9-1f5a-444d-83db-7b1e338bbfc9  ra-1

    می توانید nodetool describecluster روی گره ها اجرا کنید تا وضعیت فعلی کل خوشه را درک کنید. به عنوان مثال، موارد زیر نمونه ای از یک خوشه مرکز داده 2 را نشان می دهد که در آن همه گره های DC-1 در نسخه 4 کاساندرا هستند، در حالی که همه گره های DC-2 در نسخه 3 کاساندرا هستند:

    # On nodes where Cassandra is upgraded
$ /opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]

Stats for all nodes:
    Live: 6
    Joining: 0
    Moving: 0
    Leaving: 0
    Unreachable: 0

Data Centers:
    dc-1 #Nodes: 3 #Down: 0
    dc-2 #Nodes: 3 #Down: 0

Database versions:
    4.0.13: [DC-1-IP1:7000, DC-1-IP2:7000, DC-1-IP3:7000]
    3.11.16: [DC-2-IP1:7000, DC-2-IP2:7000, DC-2-IP3:7000]

Keyspaces:
    system_schema -> Replication class: LocalStrategy {}
    system -> Replication class: LocalStrategy {}
    auth -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    cache -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    devconnect -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    dek -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    user_settings -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apprepo -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    kms -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    identityzone -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    audit -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    analytics -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    keyvaluemap -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    counter -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apimodel_v2 -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    system_distributed -> Replication class: SimpleStrategy {replication_factor=3}
    system_traces -> Replication class: SimpleStrategy {replication_factor=2}
    system_auth -> Replication class: SimpleStrategy {replication_factor=1}

# On nodes where Cassandra is not upgraded
$ /opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]
  2. شناسایی گره های بذر در مرکز داده: به بخش نحوه شناسایی گره های بذر در پیوست مراجعه کنید. مراحل زیر را روی یکی از گره های بذر اجرا کنید:
  3. توقف، حذف، و پاک کردن داده ها از گره Cassandra. اولین گره بذر را در نسخه 4 کاساندرا در این مرکز داده انتخاب کنید. بس کن 
    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe out Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra
  4. نرم افزار قدیمی کاساندرا را بر روی گره نصب کنید و برخی از تنظیمات را تنظیم کنید. فایل بوت استرپ Edge را برای Private Cloud 4.52.02 اجرا کنید. 
    5. # Download bootstrap of 4.52.02
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u ‘uName:pWord’

# Execute bootstrap of 4.52.02
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

تنظیمات کاساندرا را تنظیم کنید

  1. فایل /opt/apigee/customer/application/cassandra.properties را ایجاد یا ویرایش کنید.
  2. مطالب زیر را به فایل اضافه کنید. ipOfNode آدرس IP گره ای است که Cassandra برای برقراری ارتباط با سایر گره های Cassandra استفاده می کند: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
  3. اطمینان حاصل کنید که فایل متعلق به کاربر apigee و قابل خواندن است: 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  4. Cassandra را نصب و راه اندازی کنید:
    • Cassandra نسخه 3.11.X را نصب کنید: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install
    • Cassandra را با ارسال فایل پیکربندی استاندارد راه اندازی کنید: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
    • اطمینان حاصل کنید که Cassandra 3.11.X نصب شده است و سرویس در حال اجرا است: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status
  5. بررسی کنید که گره شروع شده است. دستور زیر را روی این گره و سایر گره های خوشه بررسی کنید. گره باید گزارش دهد که در حالت "UN" (بالا/عادی) است: 
    /opt/apigee/apigee-cassandra/bin/nodetool status
  6. تنظیمات اضافی اضافه شده قبلی را از فایل /opt/apigee/customer/application/cassandra.properties حذف کنید.
  7. مراحل 3 تا 6 را روی تمام گره‌های بذر کاساندرا در مرکز داده یک به یک تکرار کنید.
  8. مراحل 3 تا 6 را روی تمام گره های کاساندرا باقی مانده در مرکز داده، یک به یک تکرار کنید.
  9. تمام گره های مرکز داده را از یک مرکز داده که نسخه قدیمی کاساندرا را اجرا می کند، بازسازی کنید. این مرحله را یک نود انجام دهید: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc <name of working DC>
    این روش ممکن است کمی طول بکشد. در صورت لزوم می توانید streamingthroughput تنظیم کنید. وضعیت را با استفاده از: 
    /opt/apigee/apigee-cassandra/bin/nodetool netstats
  10. همه اجزای edge-* را در مرکز داده یک به یک راه اندازی مجدد کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  11. اعتبارسنجی و هدایت ترافیک به این مرکز داده. برخی از اعتبارسنجی‌ها را برای ترافیک زمان اجرا و APIهای مدیریتی در این مرکز داده اجرا کنید و مسیریابی مجدد پراکسی و ترافیک API مدیریت به آن را شروع کنید.
  12. مراحل بالا را برای هر مرکز داده ای که می خواهید به عقب برگردانید، تکرار کنید.

بازگشت کاساندرا با استفاده از پشتیبان‌گیری

پیش نیازها

  1. شما در حال ارتقای Cassandra از 3.11.X به 4.0.X هستید و در حین ارتقا با مشکلاتی مواجه شده اید.
  2. برای گره‌ای که در حال بازگرداندن آن هستید، نسخه‌های پشتیبان دارید. پشتیبان گیری قبل از ارتقاء از 3.11.X به 4.0.X گرفته شد.

مراحل

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

  2. گره Cassandra را متوقف، حذف و پاکسازی کنید:

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra

  3. نرم افزار قدیمی Cassandra را روی گره نصب کرده و آن را پیکربندی کنید:

    • فایل بوت استرپ را برای Edge for Private Cloud 4.52.02 اجرا کنید:
      • # Download bootstrap for 4.52.02
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u ‘uName:pWord’

# Execute bootstrap for 4.52.02
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
    • فایل /opt/apigee/customer/application/cassandra.properties را ایجاد یا ویرایش کنید:
      • conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
    • مطمئن شوید که فایل متعلق به کاربر apigee است و قابل خواندن است:
      • chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
    • Cassandra را نصب و راه اندازی کنید:
      • # Install Cassandra version 3.11.X
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

# Set up Cassandra with the standard configuration file
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile

# Verify Cassandra version and check service status
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status

    بررسی کنید که گره شروع شده است. دستور زیر را روی این گره و سایر گره های خوشه بررسی کنید. گره ها باید گزارش دهند که این گره در وضعیت "UN" است:

    /opt/apigee/apigee-cassandra/bin/nodetool status

  4. سرویس Cassandra را متوقف کنید و نسخه پشتیبان را بازیابی کنید. برای جزئیات بیشتر به اسناد پشتیبان و بازیابی مراجعه کنید:

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Wipe the data directory in preparation for restore
rm -rf /opt/apigee/data/apigee-cassandra/data

# Restore the backup taken before the upgrade attempt
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backupFile

  5. پس از بازیابی نسخه پشتیبان، تنظیمات اضافی را حذف کنید:

    پیکربندی اضافه شده قبلی را از فایل /opt/apigee/customer/application/cassandra.properties حذف کنید.

  6. سرویس Cassandra را در گره راه اندازی کنید:

    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start

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

  8. هنگامی که تمام گره های Cassandra بازیابی شدند، همه اجزای edge-* را یکی یکی مجدداً راه اندازی کنید: 

    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

بهینه سازی های پشتیبان (گزینه پیشرفته)

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

ضمیمه

نحوه شناسایی گره های بذر

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

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure -search conf_cassandra_seeds

این دستور چندین خط خروجی می دهد. به دنبال آخرین خط خروجی باشید. آدرس های IP لیست شده در خط آخر گره های اولیه هستند. در مثال زیر، DC-1-IP1 ، DC-1-IP2 ، DC-2-IP1 ، و DC-2-IP2 IP های گره اولیه هستند:

Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties

Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties

Found key conf_cassandra_seeds, with value, "DC-1-IP1, DC-1-IP2, DC-2-IP1, DC-2-IP2", in /opt/apigee/token/application/cassandra.properties
apigee-configutil: apigee-cassandra: # OK

به نسخه اصلی یا فرعی قبلی برگردید

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

  1. فایل bootstrap.sh را برای نسخه ای که می خواهید به آن برگردید دانلود کنید:

    • برای بازگشت به 4.52.02، bootstrap_4.52.02.sh دانلود کنید: 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  2. متوقف کردن مؤلفه برای برگشت به عقب:
    1. برای برگرداندن هر یک از مؤلفه‌های دارای کد مشترک در گره، باید همه آنها را متوقف کنید، همانطور که مثال زیر نشان می‌دهد: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. برای برگرداندن هر مؤلفه دیگری در گره، فقط آن مؤلفه را متوقف کنید: 
      /opt/apigee/apigee-service/bin/apigee-service component stop
  3. اگر می خواهید کسب درآمد را به عقب برگردانید، آن را از تمام گره های سرور مدیریت و پردازشگر پیام حذف نصب کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. کامپوننت را حذف نصب کنید تا دوباره روی گره بازگردد:
    1. برای برگرداندن هر یک از مؤلفه‌های دارای کد مشترک در گره، باید همه آنها را با حذف گروه مؤلفه edge-gateway حذف نصب کنید، همانطور که مثال زیر نشان می‌دهد: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. برای برگرداندن هر مؤلفه دیگری در گره، فقط آن مؤلفه را حذف نصب کنید، همانطور که مثال زیر نشان می دهد: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      جایی که component نام کامپوننت است.

    3. برای برگرداندن مسیریاب لبه، باید محتویات فایل /opt/nginx/conf.d را علاوه بر حذف نصب گروه مؤلفه edge-gateway حذف کنید: 
      cd /opt/nginx/conf.d
rm -rf *
  5. نسخه 4.53.00 apigee-setup را حذف نصب کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. نسخه 4.52.02 ابزار apigee-service و وابستگی های آن را نصب کنید. مثال زیر نسخه 4.52.02 apigee-service را نصب می کند: 
    sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

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

    اگر با خطا مواجه شدید، مطمئن شوید که فایل bootstrap.sh را در مرحله 1 دانلود کرده اید.

  7. نصب apigee-setup : 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. نسخه قدیمی کامپوننت را نصب کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    جایی که component کامپوننتی است که باید نصب شود و configFile فایل پیکربندی شما برای نسخه قدیمی است.

  9. اگر Qpid را به عقب برگردانید، iptables را فلاش کنید: 
    sudo iptables -F
  10. این فرآیند را برای هر گره ای که میزبان مؤلفه ای است که در حال بازگرداندن آن هستید، تکرار کنید.

به نسخه پچ قبلی برگردید

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

  1. دانلود نسخه کامپوننت خاص: 
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    جایی که component_version انتشار کامپوننت و پچ برای نصب است. به عنوان مثال:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.53.00-0.0.20254 install

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

    yum --showduplicates list comp

    به عنوان مثال:

    yum --showduplicates list edge-ui
  2. از apigee-setup برای نصب کامپوننت استفاده کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

    به عنوان مثال:

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

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

  3. این فرآیند را برای هر گره ای که میزبان مؤلفه ای است که در حال بازگرداندن آن هستید، تکرار کنید.

mTLS را به عقب برگردانید

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

  1. توقف Apigee: 
    apigee-all stop
  2. توقف mTLS: 
    apigee-service apigee-mtls uninstall
  3. نصب مجدد mTLS: 
    apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf