برگرداندن Apigee Edge 4.54.00

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

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

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

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

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

بازگرداندن مؤلفه‌ها باید به ترتیب معکوس ارتقای آن‌ها انجام شود. ترتیب کلی معمول برای بازگرداندن Private Cloud 4.54.00 به نسخه قبلی به‌صورت زیر خواهد بود:

  • Cassandra،‏ Zookeeper را برگردانید.
  • Qpid، دیگر مؤلفه‌های مرتبط با تجزیه‌وتحلیل، و Postgres را برگردانید.
  • برگرداندن واسط کاربر
  • برگشتن به LDAP.
  • سرور مدیریت بازگشت به نسخه قبلی.
  • بازگرداندن مسیریاب‌ها و پردازشگرهای پیام.

برای مثال، فرض کنید همه «مسیرگزین‌ها» و «پردازشگرهای پیام»، همه سرورهای مدیریت، LDAP، و چند گره واسط کاربر را از نسخه ۴.۵۳.۰۰ (یا) ۴.۵۳.۰۱ به نسخه ۴.۵۴.۰۰ ارتقا داده‌اید و می‌خواهید به نسخه قبلی برگردید. در این مورد، شما باید:

  • برگرداندن گره‌های واسط کاربر ارتقایافته
  • برگرداندن گره‌های LDAP
  • برگرداندن گره‌های سرور مدیریت یکی پس‌از دیگری
  • برگرداندن همه RMPها یکی‌یکی

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

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

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

برگشتن به نسخه قبلی Cassandra

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

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

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

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

ملاحظات کلی

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

  • برگرداندن Cassandra درطول ارتقای Cassandra: اگر درطول ارتقای Cassandra با مشکل مواجه شدید، شاید بخواهید برگرداندن را درنظر بگیرید. استراتژی‌های برگرداندن در این مقاله را براساس وضعیت خود درطول فرایند ارتقا دنبال کنید.
  • بازگشت بااستفاده از نسخه‌های پشتیبان: نسخه‌های پشتیبان گرفته‌شده از Cassandra 5.0.X با نسخه‌های پشتیبان Cassandra 4.0.X سازگار نیستند. برای بازگرداندن Cassandra بااستفاده از بازیابی پشتیبان، باید قبل‌از تلاش برای ارتقا، از Cassandra 4.0.X پشتیبان‌گیری کنید.

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

پیش‌نیازها

  • شما درحال بهره‌برداری از خوشه Edge for Private Cloud 4.53.00/4.53.01 در چندین مرکز داده هستید.
  • شما درحال ارتقا دادن Cassandra از 4.0.X به 5.0.X هستید و درطول ارتقا با مشکلاتی مواجه شده‌اید.
  • حداقل یک مرکز داده کاملاً فعال در خوشه دارید که هنوز نسخه قدیمی‌تر Cassandra (Cassandra 4.0.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:
    5.0.8: [DC-1-IP1:7000, DC-1-IP2:7000, DC-1-IP3:7000]
    4.0.13: [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 را روی گره نصب کنید و برخی پیکربندی‌ها را تنظیم کنید. فایل راه‌انداز Edge for Private Cloud 4.53.00/4.53.01 را اجرا کنید. 
    5. # Download bootstrap of 4.53.00
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh -u uName:pWord

# Execute bootstrap of 4.53.00
sudo bash /tmp/bootstrap_4.53.00.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 4.0.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 از 4.0.X به 5.0.X هستید و درطول ارتقا با مشکلاتی مواجه شده‌اید.
  2. برای گره‌ای که می‌خواهید عقب‌گرد کنید، نسخه پشتیبان داشته باشید. نسخه پشتیبان قبل‌از تلاش برای ارتقا از 4.0.X به 5.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 نسخه ۴.۵۳.۰۰/۴.۵۳.۰۱ اجرا کنید:
      • # Download bootstrap for 4.53.00
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh -u uName:pWord

# Execute bootstrap for 4.53.00
sudo bash /tmp/bootstrap_4.53.00.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 4.0.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

عقب‌گرد

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

  1. مراحل بازگشت به نسخه قبلی را ابتدا روی ناظران و دنبال‌کنندگان انجام دهید. برای انتخاب ناظران و پیروان، لطفاً به شناسایی رهبر، پیروان، و ناظران مراجعه کنید.
  2. راه‌انداز نسخه‌ای را که می‌خواهید به آن عقب‌گرد کنید (نسخه 4.53.00 یا 4.53.01) بارگیری و اجرا کنید. این فرایند احتمالاً بسته به اینکه گره اتصال اینترنت خارجی دارد یا نه یا اینکه نصب آفلاین را دنبال می‌کنید، متفاوت خواهد بود.
  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. پس‌از اینکه همه گره‌ها به عقب برگردانده شدند، سلامت خوشه را درستی‌سنجی کنید و مطمئن شوید که گره رهبری در خوشه وجود دارد.

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

به بازیابی از نسخه پشتیبان مراجعه کنید.

برگرداندن Qpid

برای برگشتن به «نسخه ویژه» قبلی، حتماً فایل bootstrap.sh را برای نسخه‌ای که می‌خواهید به آن برگردید بارگیری کنید. برای بازگشت به نسخه ۴.۵۳.۰۰/۴.۵۳.۰۱، bootstrap_4.53.00.sh را بارگیری کنید.

برای برگرداندن Qpid به نسخه قبلی، این مراحل را در همه میزبان‌های Qpid دنبال کنید:

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

    توصیه می‌کنیم همین مرحله را برای همه نشانی‌های IP پردازشگر پیام انجام دهید. برای مثال، برای «رها کردن» درخواست‌هایی که از نشانی‌های IP پردازشگر پیام به گره Qpid در درگاه ۵۶۷۲ بااستفاده از IPTables می‌آیند، می‌توانید از فرمانی مانند این استفاده کنید:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  3. کارگزار Qpid را دوباره راه‌اندازی کنید تا پیام‌های موجود (درصورت وجود) تخلیه شود: 
    apigee-service apigee-qpidd start
  4. مطمئن شوید که صف‌های موجود خالی هستند. برای بررسی، به سیستم درگاه مدیریت Qpid وارد شوید: 
    http://QPID_NODE_IP:8090
  5. پس‌از درستی‌سنجی اینکه صف‌ها خالی شده‌اند، Qpid را متوقف و حذف نصب کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop
/opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall
  6. دایرکتوری داده Qpid را حذف کنید: 
    rm -r APIGEE_ROOT/data/apigee-qpidd
  7. کارگزار Qpid را بازنصب کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  8. پس‌از نصب مجدد کارگزار Qpid، تنظیمات دیوار آتش را بردارید و تنظیمات موجود را بااستفاده از فرمان‌های زیر فهرست کنید: 
    iptables -F
iptables -L

برگشتن به Postgres

برای تنزل از نسخه 4.54.00 به نسخه 4.53.00/4.53.01، باید علاوه‌بر مؤلفه‌های Edge، به‌روزرسانی Postgres را نیز برگردانید.

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

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

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

قبل‌از شروع

قبل‌از انجام برگرداندن Postgres 18 به 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
apigee-service edge-analytics uninstall
    3. دایرکتوری داده Postgres را از گره آماده‌به‌کار قدیمی حذف کنید: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
    4. نسخه قدیمی‌تر bootstrap (برای نسخه Apigee که به آن برمی‌گردید) را در گره آماده به‌کار قدیمی بارگیری و اجرا کنید. مراحل دقیق ممکن است بسته به اینکه از نصب مبتنی بر اینترنت یا آفلاین استفاده می‌کنید متفاوت باشد. اجرای نسخه قدیمی‌تر راه‌انداز Apigee مخازن 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. با اجرای فرمان زیر در «سرور مدیریت»، اطلاعات گروه مصرف‌کننده و Analytics فعلی را مشاهده کنید: 
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    این فرمان نام گروه Analytics را در فیلد name و نام گروه مصرف‌کننده را در فیلد name در بخش consumer-groups برمی‌گرداند. همچنین شناسه‌های UUID گره‌های اصلی و آماده‌به‌کار 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:

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

برگشتن به واسط کاربر Edge جدید

Apigee Edge for Private Cloud نسخه ۴.۵۴.۰۰ جایگزین «میانای کاربری کلاسیک» (edge-ui) با «میانای کاربری Edge جدید» (edge-management-ui) می‌شود. به‌دلیل تغییر مؤلفه میانای کاربری در نسخه ۴.۵۴.۰۰، برای بازگشت به نسخه ۴.۵۳.۰۰ یا ۴.۵۳.۰۱ باید edge-management-ui را حذف نصب کنید و نمایه میانای کاربری قبلی‌تان را بازنصب کنید:

  • میانای کاربر کلاسیک (edge-ui): نمایه ui را بازنصب کنید.
  • واسط کاربر جدید Edge (edge-ui و edge-management-ui): هر دو نمایه ui و ue را در گره‌های مربوطه بازنصب کنید.

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

  1. برای بازگشت به نسخه قبلی، New Edge UI نسخه ۴.۵۴.۰۰ را متوقف و حذف نصب کنید و نسخه قبلی را نصب کنید:
    1. «میانای کاربر Edge جدید» نسخه ۴٫۵۴٫۰۰ را متوقف و حذف نصب کنید (edge-management-ui): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui uninstall
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static uninstall
    2. فایل راه‌انداز را برای Apigee Edge for Private Cloud 4.53.00/4.53.01 اجرا کنید: 
      # Download bootstrap for 4.53.00
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh -u uName:pWord

# Execute bootstrap for 4.53.00
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
    3. برگرداندن apigee-setup از 4.54.00 به نسخه قبلی: 
      # Uninstall apigee-setup
/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall

# Install apigee-setup
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  2. پیکربندی‌های میانای کاربر 4.53.00/4.53.01 را بازیابی کنید:
    • اگر از فایل پیکربندی بی‌صدا از نصب 4.53.00 یا 4.53.01 خود پشتیبان‌گیری کرده‌اید، از آن فایل پشتیبان برای روش بازگشت استفاده کنید. درغیراین‌صورت، در فایل پیکربندی بی‌صدای 4.54.00، ویژگی‌های رابط کاربری 4.53.00 یا 4.53.01 را که درطول ارتقا برداشته شده یا به‌صورت نظر درآمده است بازیابی یا از حالت نظر خارج کنید. برای مرجع، بخش ارتقای میانای کاربری را ببینید.
    • اگر /opt/apigee/customer/application/ui.properties درطول ارتقا حذف شده است، آن را از دایرکتوری پشتیبان بازیابی کنید: 
      cp -rf /opt/apigee/backup/ui/customer/application/ui.properties /opt/apigee/customer/application/
chown apigee:apigee /opt/apigee/customer/application/ui.properties
  3. بازنصب و پیکربندی نسخه قبلی میانای کاربر:
    • بازگشت به «میانای کاربر کلاسیک» (edge-ui):
      1. «رابط کاربری کلاسیک» را نصب و راه‌اندازی کنید (برای احراز هویت پایه، هیچ مرحله اضافی لازم نیست): 
        /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
      2. اگر «شناسایی یگانه» فعال است، «شناسایی یگانه» را در «رابط کاربری کلاسیک» پیکربندی کنید (مطمئن شوید apigee-sso ابتدا درحال اجرا باشد): 
        /opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile
    • بازگشت به میانای کاربر Edge جدید نسخه ۴.۵۳.۰۰ یا ۴.۵۳.۰۱ (edge-management-ui و Shoehorn edge-ui):
      1. مطمئن شوید EDGEUI_ENABLE_UNIFIED_UI=y در فایل پیکربندی بی‌صدا تنظیم شده باشد، سپس نمایه‌های ui و ue را نصب و راه‌اندازی کنید: 
        /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile
      2. اگر SSO فعال است، SSO را در هر دو مؤلفه UI پیکربندی کنید (مطمئن شوید ابتدا apigee-sso درحال اجرا است): 
        /opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile
  4. وضعیت و نسخه میانای کاربر برگردانده‌شده را درستی‌سنجی کنید:
    • برای واسط کاربر کلاسیک (edge-ui): 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui status
/opt/apigee/apigee-service/bin/apigee-service edge-ui version
    • برای واسط کاربر Edge جدید (edge-management-ui): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui status
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui version

برگرداندن OpenLDAP

این بخش راهنمای گام‌به‌گامی برای بازگرداندن Symas OpenLDAP نسخه ۲.۶.۱۰ در Edge for Private Cloud نسخه ۴.۵۴.۰۰ به OpenLDAP نسخه ۲.۴.۴۶ (Edge for Private Cloud نسخه ۴.۵۳.۰۰) یا Symas OpenLDAP نسخه ۲.۶.۷ (Edge for Private Cloud نسخه ۴.۵۳.۰۱) ارائه می‌دهد. باید بااستفاده از نسخه پشتیبان LDAP معتبر قبل‌از ارتقا، بازگشت به نسخه قبلی را در کل خوشه LDAP انجام دهید.

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

قبل‌از شروع

  • ناسازگاری نسخه پشتیبان: از نسخه پشتیبان پیش‌از ارتقا از OpenLDAP 2.4.46 ‏ (Edge for Private Cloud 4.53.00) یا Symas OpenLDAP 2.6.7 ‏ (Edge for Private Cloud 4.53.01) که بااستفاده از apigee-service apigee-openldap backup قبل‌از تلاش برای ارتقا گرفته شده است استفاده کنید. پشتیبان‌گیری‌های انجام‌شده پس‌از ارتقا ناسازگارند و نمی‌توان از آن‌ها استفاده کرد.
  • ازکارافتادگی «میانای برنامه‌سازی کاربردی مدیریت»: درطول برگرداندن LDAP، میاناهای برنامه‌سازی کاربردی مدیریت دردسترس نخواهند بود که ممکن است بر تکالیف سرپرستی تأثیر بگذارد. پیش‌از ادامه دادن با برگرداندن LDAP، همه نمونه‌های edge-management-server و edge-ui را خاموش کنید.
  • خطر ازدست رفتن داده‌ها: ادامه دادن بدون نسخه پشتیبان معتبر و سازگار، خطر ازدست رفتن غیرقابل‌بازگشت داده‌ها را به‌همراه دارد.
  • پشتیبان‌گیری معتبر: پشتیبان‌گیری معتبر LDAP پیش‌از ارتقا الزامی است.
  • پشتیبان‌گیری از silent.conf فایل: برای جلوگیری از اشتباهات پیکربندی درطول ارتقا و بازگرداندن نسخه‌های قبلی، پشتیبان‌های silent.conf فایل را از هر دو نسخه قبلی و فعلی حفظ کنید.
  • توالی بازگشت: قبل‌از بازگرداندن OpenLDAP، مراحل بازگشت را برای Cassandra،‏ ZooKeeper،‏ Qpid،‏ PostgreSQL،‏ apigee-sso، و Edge UI تکمیل کنید.

روش عقب‌گرد

  1. خاموش کردن سرور مدیریت و میانای کاربر: قبل‌از ادامه دادن با بازگرداندن LDAP، همه نمونه‌های edge-management-server و edge-ui را خاموش کنید: 
    apigee-service edge-management-server stop
apigee-service edge-ui stop
  2. تعداد مدخل‌های فعلی ال‌دپ را ثبت کنید (قبل‌از توقف ال‌دپ): تعداد کل رکوردها را برای مرجع از همه سرورهای ال‌دپ دریافت کنید، YOUR_PASSWORD را با گذرواژه فعلی مدیر ال‌دپ خود جایگزین کنید. (تعداد سوابق باید در همه سرورهای 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‏ ۲.۴.۴۶ یا ۲.۶.۷ را نصب کنید:
    • نصب نسخه قدیمی LDAP: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ld -f /opt/silent.conf
    • اعتبارسنجی نسخه LDAP: 
      source ~/.bash_profile
ldapsearch -VV

# Expected output if rolled back to 4.53.00:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.4.46

# Expected output if rolled back to 4.53.01:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.6.7
    • زیرمراحل قبلی در مرحله ۴ را در هر گره 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
    2. بازیابی داده‌های LDAP (مطمئن شوید مرحله ۵ در همه سرورها قبل‌از بازیابی تکمیل شده است):
      • در سرور LDAP تکی یا فعال (که در مرحله ۶الف تعیین شده است)، به دایرکتوری پشتیبان‌گیری پیمایش کنید و پشتیبان‌گیری پیش‌از ارتقا را بازیابی کنید (برای مثال، 2025.07.28,13.59.00، یا اگر پشتیبان‌گیری پیش‌از ارتقا جدیدترین پشتیبان‌گیری در دایرکتوری است، مُهر زمان را حذف کنید): 
        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 باقی‌مانده: اگر راه‌اندازی چندسروری دارید، در هریک از سرورهای LDAP باقی‌مانده، سرویس را راه‌اندازی کنید: 
    apigee-service apigee-openldap start
  8. اعتبارسنجی نهایی:
    • تأیید کنید که برگرداندن باموفقیت انجام شده است و داده‌ها در سراسر خوشه LDAP یکسان است.
    • فرمان اعتبارسنجی را در همه سرورهای LDAP اجرا کنید و YOUR_PASSWORD را با گذرواژه مدیر 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
    • پس‌از تأیید اینکه داده‌ها صحیح و سازگار هستند، edge-management-server، edge-ui، و هر مؤلفه وابسته دیگری را طبق رویه استاندارد سازمانتان شروع کنید.

برگشتن به نسخه قبلی Edge Components

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

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

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

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

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

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

    • برای بازگشت به نسخه ۴.۵۳.۰۰/۴.۵۳.۰۱، bootstrap_4.53.00.sh/bootstrap_4.53.01.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.30.x
    3. برای برگرداندن هر عنصر دیگری در گره، فقط آن عنصر را لغو نصب کنید، همان‌طور که مثال زیر نشان می‌دهد: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      که component نام مؤلفه است.

    4. برای بازگرداندن Edge Router، باید علاوه‌بر حذف نصب گروه مؤلفه edge-gateway، محتوای فایل /opt/nginx/conf.d را نیز حذف کنید: 
      cd /opt/nginx/conf.d
rm -rf *
  5. نسخه 4.54.00 از apigee-setup را حذف نصب کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. نسخه ۴.۵۳.۰۰ ابزار apigee-service و وابستگی‌های آن را نصب کنید. مثال زیر نسخه ۴.۵۳.۰۰ از apigee-service را نصب می‌کند: 
    sudo bash /tmp/bootstrap_4.53.00.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