عقب‌گرد کردن Apigee Edge 4.53.00

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

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

  • نسخه ۴.۵۲.۰۲

برگرداندن نسخه شامل برگرداندن هر مؤلفه‌ای است که ممکن است ارتقا داده باشید. علاوه‌براین، هنگام برگرداندن Cassandra به نسخه ۴.۵۲.۰۲ باید ملاحظات ویژه‌ای را درنظر بگیرید.

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

  1. برگشتن به نسخه قبلی اصلی یا فرعی. برای مثال از ۴.۵۳.۰۰ به ۴.۵۲.۰۲.
  2. برگشتن به نسخه وصله قبلی در همان نسخه پخش. برای مثال، از 4.53.00.01 به 4.53.00.00.

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

ترتیب عقب‌گرد

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

ترتیب معمول بازگرداندن نسخه برای Private Cloud 4.53.00 به‌صورت زیر است:

  1. برگرداندن Postgres،‏ Qpid، و دیگر عناصر مربوط به تجزیه‌وتحلیل
  2. برگرداندن رهیاب‌ها و پردازنده‌های پیام
  3. برگرداندن Cassandra،‏ Zookeeper
  4. سرور مدیریت عقب‌گرد

برای مثال، فرض کنید کل خوشه Cassandra، همه سرورهای مدیریت، و چند RMP را از نسخه ۴.۵۲.۰۲ به نسخه ۴.۵۳.۰۰ ارتقا داده‌اید و می‌خواهید به نسخه قبلی برگردانید. در این مورد، شما:

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

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

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

به‌طور پیش‌فرض، عناصر Edge به‌عنوان کاربر «apigee» اجرا می‌شوند. در برخی موارد، ممکن است عناصر Edge را به‌عنوان کاربران مختلف اجرا کنید. برای مثال، اگر «مسیریاب» باید به درگاه‌های ممتاز، مثل درگاه‌های زیر ۱۰۰۰، دسترسی داشته باشد، باید «مسیریاب» را به‌عنوان ریشه یا به‌عنوان کاربری که به آن درگاه‌ها دسترسی دارد اجرا کنید. یا ممکن است یک عنصر را به‌عنوان یک کاربر و عنصر دیگر را به‌عنوان کاربر دیگری اجرا کنید.

عناصر دارای کد مشترک

اجزای Edge زیر کد مشترک دارند. بنابراین، برای عقب‌گرد کردن هریک از این عناصر در یک گره، باید همه این عناصر موجود در آن گره را عقب‌گرد کنید.

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

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

برگرداندن Cassandra

برگرداندن Cassandra

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

سناریوهای عقب‌گرد

‫Cassandra 4.0.X که با Edge for Private Cloud 4.53.00 دردسترس است با دیگر عناصر Private Cloud 4.52.02 سازگار است.

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

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

ملاحظات کلی

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

  • برگرداندن مؤلفه‌های زمان اجرا یا مدیریت: اگر می‌خواهید مؤلفه‌هایی مثل edge-management-server،‏ edge-message-processor، یا هر مؤلفه غیر Cassandra را به نسخه 4.52.02 «ابر خصوصی» برگردانید، توصیه می‌شود که Cassandra را برنگردانید. ‫Cassandra که با Private Cloud نسخه ۴.۵۳.۰۰ ارائه شده است با همه عناصر غیر Cassandra در Edge for Private Cloud نسخه ۴.۵۲.۰۲ سازگار است. می‌توانید مؤلفه‌های غیرCassandra را بااستفاده از روش‌شناسی فهرست‌شده در اینجا برگردانید، درحالی‌که Cassandra در نسخه 4.0.13 باقی می‌ماند.
  • برگرداندن پس‌از ارتقا کل خوشه Cassandra به 4.0.X: اگر کل خوشه Cassandra شما به‌عنوان بخشی از ارتقا به نسخه 4.53.00 «ابر خصوصی» به نسخه 4.0.X ارتقا یافته است، توصیه می‌شود که با این تنظیم خوشه ادامه دهید و Cassandra را برنگردانید. مؤلفه‌هایی مثل edge-management-server،‏ edge-message-processor،‏ edge-router، و غیره در نسخه 4.52.02 «ابر خصوصی» با نسخه 4.0.X از Cassandra سازگار هستند.
  • برگرداندن Cassandra درطول ارتقای Cassandra: اگر درطول ارتقای Cassandra با مشکل مواجه شدید، ممکن است بخواهید برگرداندن را درنظر بگیرید. براساس وضعیتی که درطول فرایند ارتقا در آن قرار دارید، می‌توانید از استراتژی‌های برگشت به نسخه قبلی که در این مقاله فهرست شده است پیروی کنید.
  • برگرداندن بااستفاده از نسخه‌های پشتیبان: نسخه‌های پشتیبان گرفته‌شده از Cassandra 4.0.X با نسخه‌های پشتیبان Cassandra 3.11.X سازگار نیستند. برای برگرداندن Cassandra بااستفاده از بازیابی پشتیبان‌گیری، باید قبل‌از تلاش برای ارتقا، از Cassandra 3.11.X پشتیبان‌گیری کنید.

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

پیش‌نیازها

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

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

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

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

مراحل مشروح

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

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

    /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 را در گره‌ها اجرا کنید تا وضعیت فعلی کل خوشه را متوجه شوید. برای مثال، مورد زیر نمونه‌ای از یک خوشه ۲ مرکز داده را نشان می‌دهد که در آن همه گره‌های DC-1 در نسخه ۴ کاساندرا هستند، درحالی‌که همه گره‌های DC-2 در نسخه ۳ کاساندرا هستند:

    # 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. اولین گره بذر را در نسخه ۴ کاساندرا در این مرکز داده انتخاب کنید. متوقف کن. 
    # 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. نرم‌افزار قدیمی‌تر Cassandra را روی گره نصب کنید و برخی پیکربندی‌ها را تنظیم کنید. فایل bootstrap مربوط به Edge for 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
  5. فایل /opt/apigee/customer/application/cassandra.properties را ایجاد یا ویرایش کنید.
  6. محتوای زیر را به فایل اضافه کنید. ‫ipOfNode نشانی IP گرهی است که Cassandra برای ارتباط با گره‌های دیگر Cassandra استفاده می‌کند: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
  7. مطمئن شوید که فایل متعلق به کاربر apigee است و کاربر می‌تواند آن را بخواند: 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  8. نصب و راه‌اندازی Cassandra: 
    # Install cassandra version 3.11.X
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

# Setup cassandra while passing standard configuration file
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
# Ensure Cassandra version is correct and service is running
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status
  9. تأیید کنید که گره شروع شده است. فرمان زیر را در این گره و گره‌های دیگر در خوشه بررسی کنید. گره باید گزارش دهد که در وضعیت «UN» (بالا/عادی) است: 
    /opt/apigee/apigee-cassandra/bin/nodetool status
  10. پیکربندی‌های اضافی را که قبلاً به فایل /opt/apigee/customer/application/cassandra.properties اضافه شده است بردارید.
  11. مراحل ۳ تا ۱۰ را روی همه گره‌های اولیه Cassandra در مرکز داده، یکی‌یکی، تکرار کنید.
  12. مراحل ۳ تا ۱۰ را روی همه گره‌های Cassandra باقی‌مانده در مرکز داده، یکی‌یکی، تکرار کنید.
  13. همه گره‌های مرکز داده را از مرکز داده‌ای که نسخه قدیمی‌تر Cassandra را اجرا می‌کند بازسازی کنید. این مرحله را یک گره در هر زمان انجام دهید: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc <name of working DC>

    این فرایند ممکن است زمان‌بر باشد. درصورت نیاز می‌توانید streamingthroughput را تنظیم کنید. برای اطلاع از وضعیت تکمیل عملیات، nodetool netstats را بررسی کنید.

  14. (اختیاری) اگر داده‌ها بازسازی نمی‌شوند، فرمان تعمیر را در گره Cassandra اجرا کنید. 
    /opt/apigee/apigee-cassandra/bin/nodetool -h node-IP repair -pr
  15. همه عناصر 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
  16. ترافیک را اعتبارسنجی و به این مرکز داده برگردانید. برخی‌از اعتبارسنجی‌ها را برای ترافیک زمان اجرا و میاناهای برنامه‌سازی کاربردی مدیریت در این مرکز داده اجرا کنید و هدایت مجدد ترافیک میانای برنامه‌سازی کاربردی مدیریت و کارگزار را به آن شروع کنید.
  17. مراحل بالا را برای هر مرکز داده‌ای که می‌خواهید به عقب برگردانید تکرار کنید.

عقب‌گرد Cassandra بااستفاده از «پشتیبان‌گیری»

پیش‌نیازها

  1. در فرایند ارتقا دادن Cassandra از نسخه 3.11.X به 4.0.X هستید و درطول ارتقا با مشکلاتی مواجه شده‌اید.
  2. برای گرهی که درحال عقب‌گرد است پشتیبان‌گیری دارید. نسخه پشتیبان قبل‌از تلاش برای ارتقا از نسخه ۳.۱۱.X به نسخه ۴.۰.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 را در گره نصب کنید و آن را پیکربندی کنید:

    • فایل bootstrap را برای 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 را برای نسخه‌ای که می‌خواهید به آن برگردید بارگیری کنید:

    • برای بازگشت به نسخه ۴.۵۲.۰۲، 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. برای عقب‌گرد کردن Nginx به نسخه زیر: 
      ###Find the apigee-nginx RPM 
rpm -qa | grep -i "apigee-nginx"

###Remove the apigee-nginx RPM
dnf remove apigee-nginx-1.26.x
    3. برای برگرداندن هر عنصر دیگری در گره، فقط آن عنصر را حذف نصب کنید، همان‌طور که مثال زیر نشان می‌دهد: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      که در آن component نام عنصر است.

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

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

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

  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