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

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

می‌توانید Edge 4.53.01 را به هریک از نسخه‌های اصلی زیر برگردانید:

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

برگرداندن نسخه شامل برگرداندن هر مؤلفه‌ای است که ممکن است ارتقا داده باشید. علاوه‌براین، براساس نسخه‌ای که از آن شروع کرده‌اید، ممکن است لازم باشد قبل‌از برگرداندن برخی‌از عناصر نرم‌افزار، مراحل ویژه‌ای را درنظر بگیرید. جدول زیر فهرست اجزای مختلف نرم‌افزاری را ارائه می‌دهد که ممکن است درطول برگرداندن به مراحل ویژه‌ای نیاز داشته باشند:

برگشتن به نسخه ملاحظات ویژه برای نرم‌افزار
4.53.00 Zookeeper، Postgres، LDAP
4.52.02 Zookeeper، Cassandra، Postgres، LDAP

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

برگشتن به نسخه قبلی اصلی یا فرعی. برای مثال، از ۴.۵۳.۰۱ به ۴.۵۳.۰۰.

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

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

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

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

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

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

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

کاربری که بازگرداندن را انجام می‌دهد باید همان کاربری باشد که در ابتدا 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 4.0.X که با Edge for Private Cloud 4.53.01 دردسترس است با دیگر عناصر 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:
    9. # 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

برگرداندن به‌روزرسانی Zookeeper 3.8.4

عقب‌گرد

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

  1. ابتدا مراحل برگرداندن را روی ناظران و دنبال‌کنندگان انجام دهید.
  2. نسخه موردنظر برای برگرداندن را (یا ۴.۵۲.۰۲ یا ۴.۵۳.۰۰) بارگیری و راه‌اندازی کنید. این فرایند احتمالاً بسته به اینکه گره اتصال اینترنت خارجی داشته باشد یا از نصب آفلاین استفاده کنید متفاوت خواهد بود.
  3. اگر Zookeeper روی گره اجرا می‌شود، آن را متوقف کنید: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. حذف نصب zookeeper موجود: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  5. ‫Zookeeper را طبق معمول نصب کنید: 
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  6. پس‌از اینکه همه پیروان و ناظران به عقب برگردانده شدند، با دنبال کردن مراحل ۲ تا ۵ در گره رهبر، گره رهبر را به عقب برگردانید.
  7. پس‌از اینکه همه گره‌ها به عقب برگردانده شدند، سلامت خوشه را درستی‌سنجی کنید و مطمئن شوید که گره رهبری در خوشه وجود دارد.

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

به بازیابی از نسخه پشتیبان مراجعه کنید. توجه داشته باشید که پشتیبان‌گیری‌های Zookeeper که از نسخه‌های قدیمی‌تر Edge برای «ابر خصوصی» مثل 4.52.02 یا 4.53.00 گرفته شده است باید با نسخه Zookeeper در Edge برای «ابر خصوصی» 4.53.01 سازگار باشد

به‌روزرسانی Postgres 17 را برگردانید

اگر از نسخه ۴.۵۲.۰۲ یا ۴.۵۳.۰۰ به نسخه ۴.۵۳.۰۱ ارتقا داده‌اید، باید به‌علاوه مؤلفه‌های Edge، به‌روزرسانی Postgres را نیز برگردانید.

برای برگرداندن به‌روزرسانی Postgres هنگام به‌روزرسانی Postgres در پیکربندی اصلی-آماده‌به‌کار:

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

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

قبل‌از شروع

قبل‌از انجام برگرداندن Postgres 17 به 14، مراحل زیر را هم در میزبان آماده به‌کار جدید و هم در آماده به‌کار قدیمی انجام دهید تا دارایی 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
  1. مطمئن شوید گره آماده‌به‌کار جدید Postgres درحال اجرا است: 
    /opt/apigee/apigee-service/bin/apigee-all status

    اگر Postgres اجرا نمی‌شود، آن را شروع کنید:

    /opt/apigee/apigee-service/bin/apigee-all start
  2. مطمئن شوید که Postgres در گره اصلی قدیمی و گره آماده به‌کار قدیمی متوقف شده است: 
    /opt/apigee/apigee-service/bin/apigee-all status

    اگر Postgres درحال اجرا است، آن را متوقف کنید: 

    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop  
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  3. اگر نصب شده است، Qpid را در گره آماده به‌کار قدیمی شروع کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
  4. ترفیع دادن گره آماده به‌کار جدید به‌عنوان سرور اصلی Postgres:
    1. گره آماده به‌کار جدید را به کارگزار جدید ارتقا دهید: 
      apigee-service apigee-postgresql promote-standby-to-master old_master_IP

      درصورت درخواست، گذرواژه Postgres را برای کاربر «apigee» وارد کنید که به‌طور پیش‌فرض «postgres» است.

    2. فایل پیکربندی را که برای نصب نسخه فعلی Edge استفاده کرده‌اید ویرایش کنید تا موارد زیر را مشخص کنید: 
      # IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
    3. پیکربندی سرپرست جدید:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
  5. اگر ازقبل گره آماده به‌کار قدیمی را به نسخه جدیدتر ارتقا داده‌اید، ابتدا باید نرم‌افزار Apigee را در گره آماده به‌کار قدیمی تنزل دهید. اگر هنوز نسخه قدیمی‌تر را در گره آماده‌به‌کار قدیمی دارید، می‌توانید از این مرحله رد شوید و به مرحله ۶ بروید.
    1. ‫Postgres را در گره آماده‌به‌کار قدیمی متوقف کنید: 
      apigee-service apigee-postgresql stop
apigee-service edge-postgres-server stop
    2. ‫Postgres را از گره آماده به‌کار قدیمی حذف نصب کنید: 
      apigee-service apigee-postgresql uninstall
apigee-service edge-postgres-server uninstall
    3. دایرکتوری داده‌های Postgres را از گره آماده به‌کار قدیمی حذف کنید: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
    4. نسخه قدیمی‌تر bootstrap (برای نسخه Apigee که به آن برمی‌گردید) را در گره آماده به‌کار قدیمی بارگیری و اجرا کنید. مراحل دقیق ممکن است بسته به اینکه از نصب مبتنی بر اینترنت یا نصب آفلاین استفاده می‌کنید متفاوت باشد. اجرای نسخه قدیمی‌تر Apigee bootstrap مخازن yum را با داده‌های نسخه قدیمی‌تر Apigee راه‌اندازی می‌کند.
    5. عناصر Postgres را در گره آماده به‌کار قدیمی راه‌اندازی کنید: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. بررسی کنید و مطمئن شوید که عناصر Postgres در گره آماده به‌کار قدیمی به نسخه قدیمی‌تر برگردانده شده‌اند: 
      apigee-service apigee-postgresql version
apigee-service edge-postgres-server version
  6. بازسازی گره آماده‌به‌کار قدیمی:
    1. فایل پیکربندی را که برای نصب نسخه فعلی Edge استفاده کرده‌اید ویرایش کنید تا موارد زیر را مشخص کنید: 
      # IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
    2. فهرست راهنمای داده‌ها را در گره آماده به‌کار قدیمی بردارید: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
    3. گره آماده‌به‌کار قدیمی را دوباره پیکربندی کنید تا گره آماده‌به‌کار اصلی جدید باشد: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    4. مطمئن شوید که Postgres در گره آماده‌به‌کار قدیمی اجرا می‌شود: 
      /opt/apigee/apigee-service/bin/apigee-all status

      اگر Postgres اجرا نمی‌شود، آن را شروع کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
  7. با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf در سرور اصلی جدید، تأیید کنید که گره آماده‌به‌کار جدید اضافه شده است.
  8. با اجرای فرمان زیر در «سرور مدیریت»، اطلاعات گروه مصرف‌کننده و تجزیه‌وتحلیل فعلی را مشاهده کنید: 
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    این فرمان نام گروه تجزیه‌وتحلیل را در فیلد name و نام گروه مصرف‌کننده را در فیلد name در زیر consumer-groups برمی‌گرداند. همچنین شناسه‌های یکتای گره‌های آماده‌به‌کار و اصلی Postgres قدیمی را در فیلد postgres-server و در فیلد datastores برمی‌گرداند. باید برونداد را به‌صورت زیر ببینید: 

    {
  "name" : "axgroup-001",
  "properties" : {
  },
  "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
  "uuids" : {
    "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "postgres-server" : [
      "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256"
    ]
  },
  "consumer-groups" : [ {
    "name" : "consumer-group-001",
    "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "datastores" :
      [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ],
      "properties" : {     }
    }
  ],
  "data-processors" : {
  }
}
  9. با اجرای فرمان curl زیر در گره سرپرست قدیمی، نشانی UUID سرپرست قدیمی را دریافت کنید: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    باید UUID گره را در انتهای برونداد به‌صورت زیر ببینید:

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  10. مرحله قبلی را تکرار کنید تا نشانی‌های IP گره آماده به‌کار قدیمی و کارگزار جدید را دریافت کنید.
  11. گره‌های اصلی و آماده‌به‌کار قدیمی را از گروه مصرف‌کننده بردارید: 
    curl -u sysAdminEmail:password -X DELETE \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v

    که در آن axgroup-001 و consumer-group-001 نام‌های پیش‌فرض گروه‌های مصرف‌کننده و Analytics هستند. masterUUID,standbyUUID همان ترتیبی را دارند که وقتی اطلاعات گروه مصرف‌کننده و تجزیه‌وتحلیل فعلی را در بالا مشاهده کردید، در بالا نشان داده شدند. شاید لازم باشد آن‌ها را به‌عنوان standbyUUID,masterUUID مشخص کنید.

    دارایی datastores برای consumer-groups باید اکنون خالی باشد.

  12. گره‌های اصلی و آماده‌به‌کار قدیمی را از گروه تجزیه‌وتحلیل بردارید: 
    curl -u sysAdminEmail:password -X DELETE \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v

    دارایی postgres-server در uuids اکنون باید خالی باشد.

  13. ثبت گره‌های اصلی و آماده‌به‌کار PG جدید با گروه‌های مصرف‌کننده و تجزیه‌وتحلیل:
    curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v
  14. گروه تجزیه‌وتحلیل را اعتبارسنجی کنید: 
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    باید شناسه جهانی یکتای گره‌های اصلی و آماده به‌کار جدید را در گروه تجزیه‌وتحلیل و گروه مصرف‌کننده ببینید.

  15. «سرور مدیریت Edge» را بازراه‌اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
  16. بازراه‌اندازی همه سرورهای Qpid: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
  17. بازراه‌اندازی همه سرورهای Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  18. با اجرای دستورگان‌های زیر در هر دو سرور، وضعیت تکثیر را درستی‌سنجی کنید. سیستم باید نتایج یکسانی را در هر دو سرور نمایش دهد تا از موفقیت‌آمیز بودن تکثیر اطمینان حاصل شود:

    در اسلاید اصلی جدید، این دستور را اجرا کنید:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

    تأیید کنید که دستگاه اصلی است. در گره آماده‌به‌کار قدیمی: 

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

    درستی‌سنجی کنید که در حالت آماده‌به‌کار باشد.

  19. پس‌از انجام چند درخواست API، مرحله قبلی را تکرار کنید تا مطمئن شوید گره‌ها همگام‌سازی شده‌اند.
  20. بااستفاده از رویه موجود در ازکار انداختن گره Postgres، سرور اصلی قدیمی Postgres را ازکار بیندازید.

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

برگرداندن به‌روزرسانی LDAP 2.6

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

هدف اصلی این است که کل خوشه LDAP را از یک نسخه پشتیبان خوب و شناخته‌شده به حالت سازگار برگردانید. این روش برای همه سناریوها یکسان است - سرور تکی، فعال-فعال، و فعال-غیرفعال.

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

  • ناسازگاری پشتیبان‌گیری: از پشتیبان‌گیری نسخه قدیمی‌تر 2.4 LDAP که با Edge for Private Cloud 4.52.02 یا 4.53.00 اجرا می‌کردید استفاده کنید. این نسخه پشتیبان باید قبل‌از تلاش برای ارتقا گرفته شده باشد. پشتیبان‌گیری‌های انجام‌شده پس‌از ارتقا ناسازگار هستند و نمی‌توان از آن‌ها استفاده کرد.
  • زمان ازکارافتادگی «میانای برنامه‌سازی کاربردی مدیریت»: درطول بازگرداندن LDAP، میاناهای برنامه‌سازی کاربردی مدیریت دردسترس نخواهند بود که ممکن است بر وظایف سرپرستی تأثیر بگذارد. لطفاً قبل‌از ادامه دادن به برگرداندن LDAP، مطمئن شوید که همه edge-management-server و edge-ui را خاموش کرده‌اید.
  • خطر ازدست دادن داده‌ها: ادامه دادن بدون نسخه پشتیبان معتبر و سازگار، خطر ازدست دادن غیرقابل‌جبران داده‌ها را به‌همراه دارد.
  • پشتیبان‌گیری معتبر: پشتیبان‌گیری معتبر LDAP پیش‌از ارتقا الزامی است.

روش عقب‌گرد

  1. لطفاً قبل‌از ادامه دادن به ارتقای LDAP، مطمئن شوید همه edge-management-server و edge-ui خاموش شده باشند. 
    apigee-service edge-management-server stop
apigee-service edge-ui stop
  2. پشتیبان‌گیری از داده‌های LDAP موجود (قبل‌از توقف LDAP)

    تعداد کل سوابق را برای ارجاع از همه سرورهای ldap دریافت کنید. (تعداد گزارش باید در همه سرورهای 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 2.6 جدید

    سرویس apigee-openldap را متوقف کنید و پیکربندی و فهرست‌های داده آن را حذف کنید. این کار باید در همه سرورهای LDAP، یک گره در هر زمان در خوشه، انجام شود تا از یکپارچگی اطمینان حاصل شود.

    apigee-service apigee-openldap stop
apigee-service apigee-openldap uninstall
rm -rf /opt/apigee/data/apigee-openldap/*
  4. نصب نسخه قدیمی LDAP 2.4
    • نصب نسخه قدیمی LDAP: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ld -f /opt/silent.conf
    • اعتبارسنجی نسخه LDAP: 
      source ~/.bash_profile
ldapsearch -VV

#Expected output:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.4.46
    • مراحل بالا را در هر گره LDAP، یکی پس‌از دیگری، تکرار کنید
  5. پاک کردن داده‌های باقیمانده

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

    apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/*
  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. بازیابی داده‌های LDAP (قبل‌از بازیابی، مطمئن شوید مرحله ۴ در همه سرورها تکمیل شده است.)
      • در سرور LDAP تک و فعال (که در «مرحله ۵ الف» تعیین شده است)، نسخه پشتیبان را بازیابی کنید. 
        cd /opt/apigee/backup/openldap

# To restore a specific backup, provide the timestamp as shown below:
apigee-service apigee-openldap restore 2025.07.28,13.59.00
# Note: If no timestamp is provided, the latest available backup will be restored by default.
apigee-service apigee-openldap restore

# It is recommended to specify the backup explicitly to avoid restoring an unintended version.
      • سرویس apigee-openldap را شروع کنید. 
        apigee-service apigee-openldap start
  7. شروع سرورهای ال‌دپ باقی‌مانده

    اگر تنظیمات چند سروری دارید، در هریک از سرورهای LDAP، سرویس را شروع کنید:

    apigee-service apigee-openldap start
  8. اعتبارسنجی نهایی
    • مرحله آخر این است که تأیید کنید که برگرداندن باموفقیت انجام شده است و داده‌ها در سراسر خوشه LDAP یکسان است.
    • دستور اعتبارسنجی را در همه سرورهای LDAP اجرا کنید. تعداد گزارش باید در همه سرورها یکسان باشد و با تعداد گزارش‌هایی که در «مرحله ۱» ضبط کرده‌اید مطابقت داشته باشد. 
      # Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \ -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
    • پس‌از اینکه تأیید کردید داده‌ها درست و یکپارچه است، برگرداندن LDAP تکمیل می‌شود. اکنون می‌توانید طبق رویه استاندارد ارتقای سازمانتان، edge-management-server، edge-ui، و هر عنصر وابسته دیگری را راه‌اندازی کنید.

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

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

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

    • برای عقب‌گرد به نسخه ۴.۵۲.۰۲، 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 و apigee-cassandra-client بردارید، همان‌طور که در مثال زیر نشان داده شده است: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
       
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client 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. این فرایند را برای هر گره‌ای که میزبان مؤلفه‌ای است که درحال برگرداندن آن هستید تکرار کنید.

عقب‌گرد 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