ارتقاء سیستم عامل گره به گره برای Apigee Edge برای فضای ابری خصوصی

شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید . اطلاعات

این سند، روشی جایگزین برای ارتقای سیستم عامل (OS) سرورهای موجود در خوشه Apigee Edge برای ابر خصوصی شما را شرح می‌دهد. به جای راه‌اندازی یک مرکز داده موازی کاملاً جدید، این رویکرد گره به گره به شما امکان می‌دهد سیستم عامل خود را درجا، یک ماشین/گره در هر زمان ارتقا دهید.

سازگاری

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

پیش‌نیازها

قبل از شروع ارتقاء گره به گره، تأیید کنید که کارهای زیر را انجام داده‌اید:

پشتیبان‌گیری از تمام گره‌ها

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

مطمئن شوید که Edge در حال اجرا است

با استفاده از دستور زیر، مطمئن شوید که Edge در طول فرآیند به‌روزرسانی فعال و در حال اجرا است:

/opt/apigee/apigee-service/bin/apigee-all status

ترتیب جایگزینی گره

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

سناریوهای اضافی

هنگام انجام ارتقاء سیستم عامل به صورت گره به گره، اگر هر یک از پیکربندی‌های زیر در تنظیمات موجود وجود دارد، لطفاً این مراحل اضافی را در نظر بگیرید:

  • apigee-mtls - اگر apigee-mtls فعال باشد، ارتقاء سیستم عامل node-by-node (rolling) برای این تنظیمات پشتیبانی نمی‌شود. برای ارتقاء، لطفاً راهنمای ارتقاء apigee-mtls را دنبال کنید.

کاساندرا

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

موارد خاصی که باید برای کاساندرا در نظر گرفته شوند به شرح زیر است:

  • Cassandra Native-mTLS - اگر native-mTLS فعال و اعمال شده است، با تنظیم conf_cassandra_client_encryption_optional=true ، اعمال آن را روی گره‌های فعال‌شده با mTLS حذف کنید. برای اطلاعات بیشتر، به مستندات native-mTLS مراجعه کنید.
  • رمزگذاری میان‌گره‌های کاساندرا فعال شده است - برای اطمینان از اینکه گواهی‌های گره‌های کاساندرا موجود در مخزن اعتماد گره تازه جایگزین شده گنجانده شده‌اند و برعکس، به بخش فعال کردن رمزگذاری میان‌گره‌های کاساندرا مراجعه کنید.

مراحل جایگزینی گره کاساندرا:

  1. با گرفتن اسنپ‌شات از ماشین مجازی (در صورت امکان) از گره پشتیبان بگیرید و با استفاده از دستور زیر، از تمام گره‌ها برای کاساندرا در Apigee پشتیبان بگیرید: 
    apigee-service apigee-cassandra backup
  2. با سیستم عامل ارتقا یافته، گره جدیدی را بدست آورید.
  3. پیش‌نیازهای مربوط به سیستم عامل را اعمال کنید.
  4. فایل Edge را دانلود و اجرا کنید تا ابزار apigee-service نصب شود. bootstrap نسخه Apigee مورد استفاده را اجرا کنید، bootstrap را اجرا کنید تا apigee-service را دریافت کرده و apigee-setup را نصب کنید.
  5. گره‌های اولیه را فهرست کنید: 
    apigee-service apigee-cassandra configure -search conf_cassandra_seeds
  6. فایل پیکربندی را با تغییر IP گره کاساندرای موجود و جایگزینی آن با آدرس IP گره جدید، به‌روزرسانی کنید.

    میزبان‌های CASS موجود

    CASS_HOSTS="$IP1 $IP2 $IP3"

    CASS_HOSTS که به تازگی به‌روزرسانی شده است

    CASS_HOSTS="$IP1 $IP4 $IP3"
  7. گره‌های موجود در کلاستر را با IP گره کاساندرای جدید و به‌روز شده (به جز گره‌ای که قرار است جایگزین شود) مجدداً پیکربندی کنید. لطفاً از مرجع فایل پیکربندی استفاده کنید. 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
  8. کاساندرا را روی گره قدیمی متوقف و از حالت ثبت خارج کنید:
    1. کاساندرا را روی گره‌ای که قرار است جایگزین شود، متوقف کنید: 
      apigee-service apigee-cassandra stop
    2. UUID گره کاساندرا را که قرار است از رده خارج شود، فهرست کنید (اگر چندین مرکز داده به طور همزمان در نظر بگیرند): 
      apigee-adminapi.sh servers list -r dc-1 -p central -t application-datastore --admin AdminEmailID --pwd 'AdminPassword' --host localhost
    3. انواع پایگاه داده مرتبط با UUID موجود Cassandra را از حالت ثبت خارج کنید: 
      curl -u AdminEmailID:'AdminPassword' -X POST http://MS_IP:8080/v1/servers -d "type=cache-datastore&type=user-settings-datastore&type=scheduler-datastore&type=audit-datastore&type=apimodel-datastore&type=application-datastore&type=edgenotification-datastore&type=identityzone-datastore&type=auth-datastore&region=dc-1&pod=central&uuid=old_cassandra_uuid&action=remove"
    4. سرور را حذف کنید.
      curl -u AdminEmailID:AdminPassword -X DELETE http://MS_IP:8080/v1/servers/old_cassandra_uuid
  9. یک گره جدید برای میزبان apigee-cassandra آماده کنید. خط زیر را به فایل cassandra.properties در مسیر /opt/apigee/customer/application/cassandra.properties (در صورت عدم وجود، آن را ایجاد کنید) در گره جدید Cassandra اضافه کنید: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
  10. تأیید کنید که مالک و گروه در فایل cassandra.properties روی apigee:apigee تنظیم شده باشند. در صورت لزوم، از دستور زیر برای به‌روزرسانی مالک و گروه استفاده کنید: 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  11. کاساندرا را نصب کنید و تنظیمات را روی گره تازه اضافه شده اجرا کنید: 
    apigee-service apigee-cassandra install
    apigee-service apigee-cassandra setup -f updatedConfigFile
  12. پس از تنظیم گره جدید، پیکربندی اضافی اضافه شده به /opt/apigee/customer/application/cassandra.properties را حذف کرده و apigee-cassandra را مجدداً راه‌اندازی کنید: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
    apigee-service apigee-cassandra restart
  13. وضعیت گره جایگزین شده جدید را بررسی کنید: 
    apigee-service apigee-cassandra status
    /opt/apigee/apigee-cassandra/bin/nodetool status
  14. گره جدید اضافه شده به کلاستر را بازسازی کنید: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc dc-1
  15. گره‌های موجود در سرورهای Router، Message-Processor، Qpid، Postgres و Management را به ترتیب با به‌روزرسانی IP گره جدید Cassandra در فایل پیکربندی، مجدداً راه‌اندازی کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
  16. حذف/حذف نصب کاساندرا از گره قدیمی‌تر: 
    apigee-service apigee-cassandra uninstall
  17. برای سایر گره‌های کاساندرا در خوشه تکرار کنید.

متصدی باغ وحش

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

  1. با گرفتن اسنپ‌شات از ماشین مجازی (در صورت امکان) از گره پشتیبان بگیرید و از Apigee برای Zookeeper روی همه گره‌ها پشتیبان بگیرید.
  2. متوقف کردن و حذف نصب Zookeeper روی گره موجود: 
    apigee-service apigee-zookeeper stop
    apigee-service apigee-zookeeper uninstall
  3. با سیستم عامل ارتقا یافته، گره جدیدی را بدست آورید.
  4. پیش‌نیازهای مربوط به سیستم عامل را اعمال کنید.
  5. بوت‌استرپ نسخه مورد استفاده Apigee را دانلود کنید، بوت‌استرپ را اجرا کنید تا apigee-service را دریافت کنید و apigee-setup را نصب کنید.
  6. فایل پیکربندی را با حذف آدرس‌های IP گره‌های قدیمی/حذف‌شده و جایگزینی آن با IP گره جدید برای Zookeeper به‌روزرسانی کنید. برای جزئیات بیشتر، به مرجع فایل پیکربندی مراجعه کنید:

    پیکربندی ZK موجود 

    ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"

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

    ZK_HOSTS="$IP1 $IP4 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP4 $IP3"
  7. نصب، راه‌اندازی و اجرای Zookeeper روی گره جدید با استفاده از فایل پیکربندی به‌روزرسانی‌شده: 
    /opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile
  8. با استفاده از updatedConfigFile، تغییراتی در گره Zookeeper موجود ایجاد کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile
  9. گره‌های موجود در سرورهای Router، Message-Processor، Qpid، Postgres و Management را به ترتیب با به‌روزرسانی IP گره New Zookeeper در فایل پیکربندی، مجدداً راه‌اندازی کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
  10. این کار را برای تمام گره‌های Zookeeper تکرار کنید.

پستگرس

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

  • هر یک از گره‌های آماده به کار موجود را با سیستم عامل مورد نظر جایگزین کنید.
  • گره آماده به کار جدید را به گره اصلی ارتقا دهید.
  • ارباب قدیمی را از رده خارج کنید.
  • به جایگزینی گره‌های آماده به کار اضافی ادامه دهید.

قبل از شروع به‌روزرسانی، توصیه می‌شود edge-qpid-server را متوقف کنید تا احتمال از دست رفتن پیام‌های تحلیلی به حداقل برسد. 

apigee-service edge-qpid-server stop

آماده به کار

  1. دریافت UUID گره‌های edge-postgres-server : 
    curl http://pg_standby_ip:8084/v1/servers/self
  2. متوقف کردن پستگرس: 
    apigee-service edge-postgres-server stop
    apigee-service apigee-postgresql stop
  3. با دنبال کردن مراحل زیر، Postgres standby موجود را از گروه analytics حذف کنید.
  4. apigee-postgres و postgres-server را حذف نصب کنید: 
    apigee-service edge-postgres-server uninstall
    apigee-service apigee-postgresql uninstall
  5. با سیستم عامل ارتقا یافته، گره جدیدی را بدست آورید.
  6. پیش‌نیازهای مربوط به سیستم عامل را اعمال کنید.
  7. بوت‌استرپ نسخه مورد استفاده Apigee را دانلود کنید، بوت‌استرپ را اجرا کنید تا apigee-service را دریافت کنید و apigee-setup را نصب کنید.
  8. با به‌روزرسانی فایل پیکربندی با EXISTING_PG_MASTER_IP و NEW_PG_STANDBY_IP ، تکثیر master-standby را روی master موجود راه‌اندازی کنید. برای جزئیات بیشتر، به مرجع فایل پیکربندی مراجعه کنید: 
    PG_MASTER=EXISTING_PG_MASTER_IP
    PG_STANDBY=NEW_PG_STANDBY_IP
    apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
  9. نصب، راه‌اندازی و اجرای Postgres با پیکربندی‌های master-standby روی گره standby جدید: 
    PG_MASTER=EXISTING_PG_MASTER_IP
    PG_STANDBY=NEW_PG_STANDBY_IP
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile
  10. تنظیمات آماده به کار را بررسی کنید: 
    apigee-service apigee-postgresql postgres-check-standby

استاد

  1. دریافت UUID گره اصلی Postgres موجود: 
    curl http://pg_ip:8084/v1/servers/self
  2. گره آماده به کار سیستم عامل ارتقا یافته جدید را به حالت master ارتقا دهید.
  3. Postgres را روی master موجود متوقف کنید: 
    apigee-service apigee-postgresql stop
    apigee-service edge-postgres-server stop
  4. گره آماده به کار جدید را به حالت master ارتقا دهید: 
    apigee-service apigee-postgresql promote-standby-to-master EXISTING_PG_MASTER_IP
  5. گره اصلی قدیمی را از گروه‌های تحلیلی و مصرف‌کننده حذف کنید.
  6. گره اصلی جدید را به گروه‌های تحلیلی و مصرف‌کننده اضافه کنید.
  7. اگر از کسب درآمد استفاده می‌کنید، گره اصلی Postgres جدید را به‌روزرسانی کنید و مراحل زیر را انجام دهید .
  8. پس از تعویض گره اصلی، edge-qpid-server می‌تواند با پیکربندی به‌روز شده گره اصلی راه‌اندازی شود: 
    apigee-service edge-qpid-server start
  9. اگر از کسب درآمد استفاده می‌کنید، سرور مدیریت و پردازنده پیام را نیز مجدداً راه‌اندازی کنید: 
    apigee-service edge-management-server restart
  10. متوقف کردن و حذف نصب apigee-postgres و postgres-server روی نسخه قدیمی master: 
    apigee-service edge-postgres-server uninstall
    apigee-service apigee-postgresql uninstall

اضافه شدن حالت آماده به کار جدید

  1. با سیستم عامل ارتقا یافته، گره جدیدی را بدست آورید.
  2. پیش‌نیازهای مربوط به سیستم عامل را اعمال کنید.
  3. بوت‌استرپ نسخه مورد استفاده Apigee را دانلود کنید، بوت‌استرپ را اجرا کنید تا apigee-service را دریافت کنید و apigee-setup را نصب کنید.
  4. با استفاده از IP جدید برای گره master و IP جدید برای گره standby در فایل پیکربندی master و گره standby جدید، replication مربوط به master-standby را راه‌اندازی کنید. برای جزئیات بیشتر، به مرجع فایل پیکربندی مراجعه کنید: 
    apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
  5. نصب و راه‌اندازی روی گره آماده به کار جدید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile
  6. با دنبال کردن مراحل مربوط به راه‌اندازی master-standby، حالت آماده‌به‌کار جدید را به گروه‌های تحلیلی اضافه کنید.

LDAP

جایگزینی گره LDAP مستلزم توقف سرور مدیریت است و هر یک از APIهای مدیریت در طول مدت جایگزینی این گره، غیرقابل دسترس تلقی می‌شوند.

  1. سرور مدیریت را روی همه گره‌ها متوقف کنید: 
    apigee-service edge-management-server stop
  2. از رده خارج کردن گره LDAP موجود:
    1. از گره LDAP در سطح ماشین مجازی پشتیبان/عکس فوری بگیرید.
    2. قبل از متوقف کردن LDAP، مطمئن شوید که تعداد داده‌های LDAP را ثبت کرده‌اید، که بعداً می‌توان آن را تأیید کرد، برای مثال: 
      ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w Secret123 | wc -l
    3. برای تنظیمات فعال-غیرفعال:
      1. با اضافه کردن فایل mark_writable.ldif به گره غیرفعال با محتوای زیر، حالت غیرفعال فعلی را به فعال تبدیل کنید: 
        dn: olcDatabase={2}bdb,cn=config
changetype: modify
replace: olcReadOnly
olcReadOnly: FALSE
      2. برای فعال کردن گره غیرفعال، دستور زیر را روی آن اجرا کنید: 
        ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif
      3. برای گره‌های فعال-فعال برای از رده خارج کردن، به مرحله د) ادامه دهید.
    4. در یک پیکربندی Active-Active LDAP، تکثیر بین دو گره LDAP را متوقف کرده و پیکربندی‌ها را به‌روزرسانی کنید. مراحل ذکر شده در سند غیرفعال‌سازی LDAP را دنبال کنید.
    5. متوقف کنید و از داده‌های LDAP پشتیبان بگیرید و گره LDAP موجود را حذف نصب کنید (اگر قبلاً راه‌اندازی فعال-فعال انجام شده است، از آن صرف نظر کنید): 
      apigee-service apigee-openldap stop
      apigee-service apigee-openldap backup
      apigee-service apigee-openldap uninstall
  3. با سیستم عامل ارتقا یافته، گره جدیدی را بدست آورید.
  4. پیش‌نیازهای مربوط به سیستم عامل را اعمال کنید.
  5. بوت‌استرپ نسخه مورد استفاده Apigee را دانلود کنید، بوت‌استرپ را اجرا کنید تا apigee-service را دریافت کنید و apigee-setup را نصب کنید.
  6. راه‌اندازی گره LDAP جدید:
    1. فایل پیکربندی را برای گره جدید بر اساس تنظیمات به‌روزرسانی کنید، می‌توانید برای این کار به مرجع فایل پیکربندی اج ، بر اساس تنظیمات فقط فعال یا فعال-فعال، مراجعه کنید:
      • LDAP_TYPE
      • LDAP_PEER
      • LDAP_SID
      • USE_LDAP_REMOTE_HOST=y/n
    2. راه‌اندازی و شروع LDAP روی گره جدید با updatedConfigFile : 
      /opt/apigee/apigee-setup/bin/setup.sh -p ld -f updatedConfigFile
    3. از داده‌های LDAP گره‌های قدیمی‌تر پشتیبان بگیرید (اگر می‌توان از راه‌اندازی فعال-فعال صرف‌نظر کرد):
      1. یک نمونه پشتیبان‌گیری روی گره جدید انجام دهید، این کار به گونه‌ای انجام می‌شود که یک پوشه/مسیر پشتیبان‌گیری پیش‌فرض ایجاد شود: 
        apigee-service apigee-openldap backup
      2. داده‌های پشتیبان‌گیری‌شده‌ی خود را از گره‌ی قدیمی به پوشه‌ی پشتیبان ایجادشده منتقل کنید.
      3. قبل از بازیابی داده‌ها ، apigee-openldap را متوقف کنید: 
        apigee-service apigee-openldap stop
      4. پشتیبان گرفته شده از گره قدیمی‌تر را بازیابی کنید:
        apigee-service apigee-openldap restore backup_file

        برای مثال: 

        apigee-service apigee-openldap restore 2026.02.09,10.28.20
  7. برای گره LDAP دیگر (در صورت فعال بودن-فعال بودن) تکرار کنید.
  8. سرور مدیریت را با پیکربندی‌های میزبان LDAP به‌روز شده، راه‌اندازی و اجرا کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
  9. تنظیم مجدد و شروع SSO (در صورت وجود): 
    apigee-service apigee-sso setup -f updatedConfigFile
    apigee-service apigee-sso restart
  10. (اختیاری) با دنبال کردن مراحل مستندات ، دایرکتوری فعال دوم را به حالت فقط خواندنی پیکربندی کنید.

کیوپید

برای جایگزینی یک گره Qpid موجود با یک گره OS ارتقا یافته، باید مراحل زیر را انجام دهیم:

  1. دریافت هرگونه پیام از پردازنده‌های پیام به صف گره موجود را متوقف کنید.
  2. پیام‌های موجود در صف را تخلیه کنید.
  3. گره موجود را متوقف و از رده خارج کنید.

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

  1. کارگزار Qpid را متوقف کنید: 
    apigee-service apigee-qpidd stop
  2. ترافیک ورودی روی پورت ۵۶۷۲ را از تمام پردازنده‌های پیام مسدود کنید: 
    iptables -A INPUT -p tcp --dport 5672 -s MP_IP -j DROP
  3. برای تخلیه پیام‌های موجود، Qpid broker را دوباره اجرا کنید: 
    apigee-service apigee-qpidd start
  4. قبل از شروع به غیرفعال کردن، مطمئن شوید که تمام پیام‌های موجود در صف به مصرف‌کننده ارسال شده‌اند.
  5. دریافت UUID گره edge-qpid-server : 
    curl http://qpid_node_ip:8083/v1/servers/self
  6. مراحل غیرفعال‌سازی یا حذف Qpid از تجزیه و تحلیل برای apigee-qpidd و edge-qpid-server را تکمیل کنید.
  7. هر دو سرویس apigee-qpidd و edge-qpid-server را متوقف و حذف نصب کنید: 
    apigee-service apigee-qpidd stop
    apigee-service edge-qpid-server stop
    apigee-service apigee-qpidd uninstall
    apigee-service edge-qpid-server uninstall

اضافه کردن گره جدید:

  1. با سیستم عامل ارتقا یافته، گره جدیدی را بدست آورید.
  2. پیش‌نیازهای مربوط به سیستم عامل را اعمال کنید.
  3. بوت‌استرپ نسخه مورد استفاده Apigee را دانلود کنید، بوت‌استرپ را اجرا کنید تا apigee-service را دریافت کنید و apigee-setup را نصب کنید.
  4. سرویس‌های Qpid را روی گره جدید راه‌اندازی و اجرا کنید و با دنبال کردن این مراحل ، آنها را به گروه‌های مصرف‌کننده اضافه کنید. همین مراحل را برای اضافه کردن گروه‌های دیگر مانند گروه‌های کسب درآمد در نظر بگیرید.
  5. اگر سرویس کسب درآمد فعال است، سرور مدیریت و پردازشگر پیام را مجدداً راه‌اندازی کنید: 
    apigee-service edge-management-server restart
    apigee-service edge-message-processor restart
  6. روی تمام گره‌های Qpid تکرار کنید.

پردازشگر پیام

  1. دریافت UUID گره edge-message-processor : 
    curl http://mp_ip:8082/v1/servers/self
  2. گره پردازشگر پیام را از کار انداخته و حذف نصب کنید.
  3. اگر سرویس کسب درآمد فعال است، edge-mint-message-processor را حذف نصب کنید.
  4. حذف پردازشگر پیام: 
    apigee-service edge-message-processor uninstall
  5. با سیستم عامل ارتقا یافته، گره جدیدی را بدست آورید.
  6. پیش‌نیازهای مربوط به سیستم عامل را اعمال کنید.
  7. بوت‌استرپ نسخه مورد استفاده Apigee را دانلود کنید، بوت‌استرپ را اجرا کنید تا apigee-service را دریافت کنید و apigee-setup را نصب کنید.
  8. با دنبال کردن مراحل زیر ، Message Processor را به کلاستر اضافه، تنظیم و اجرا کنید.
  9. اگر کسب درآمد فعال است، سرویس کسب درآمد را به همراه پردازشگر پیام راه‌اندازی کنید. برای اطلاعات بیشتر، به مستندات زیر مراجعه کنید.

روتر

  1. دریافت UUID گره edge-router : 
    curl http://router_ip:8081/v1/servers/self
  2. غیرفعال کردن قابلیت دسترسی و بررسی اینکه آیا قابل دسترسی است: 
    iptables -A INPUT -i eth0 -p tcp --dport 15999 -j REJECT
    curl -vvv -X GET http://router_ip:15999/v1/servers/self/reachable
  3. گره روتر را از کار انداخته و حذف نصب کنید .
  4. حذف نصب روتر: 
    apigee-service edge-router uninstall
  5. با سیستم عامل ارتقا یافته، گره جدیدی را بدست آورید.
  6. پیش‌نیازهای مربوط به سیستم عامل را اعمال کنید.
  7. بوت‌استرپ نسخه مورد استفاده Apigee را دانلود کنید، بوت‌استرپ را اجرا کنید تا apigee-service را دریافت کنید و apigee-setup را نصب کنید.
  8. روتر را به کلاستر اضافه، تنظیم و راه‌اندازی کنید .

سرور مدیریت

فقط یک سرور مدیریت واحد

  1. با سیستم عامل ارتقا یافته، گره جدیدی را بدست آورید.
  2. پیش‌نیازهای مربوط به سیستم عامل را اعمال کنید.
  3. بوت‌استرپ نسخه مورد استفاده Apigee را دانلود کنید، بوت‌استرپ را اجرا کنید تا apigee-service را دریافت کنید و apigee-setup را نصب کنید.
  4. سرور مدیریت را با استفاده از IP و فایل پیکربندی به‌روز شده که از اینجا قابل دسترسی است، اضافه کنید و دستور راه‌اندازی را اجرا کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
  5. رابط کاربری را با پیکربندی جدید IP مدیریت، مجدداً تنظیم و راه‌اندازی کنید. 
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
  6. راه‌اندازی مجدد SSO با پیکربندی IP مدیریتی جدید (در صورت وجود): 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  7. راه‌اندازی مجدد رابط کاربری جدید (UE) با پیکربندی IP مدیریت جدید (در صورت وجود): 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
  8. اگر کسب درآمد فعال باشد:
    1. راه‌اندازی مجدد سیستم مدیریت کسب درآمد با پیکربندی IP مدیریت جدید (در صورت وجود)، با ارجاع به مستندات پیکربندی کسب درآمد . 
      /opt/apigee/apigee-setup/bin/setup.sh -p mo -f updatedConfigFile
    2. سرور مدیریت را مجدداً راه اندازی کنید: 
      apigee-service edge-management-server restart
  9. سرور مدیریت را روی گره موجود/قدیمی، با دنبال کردن مراحل زیر ، از کار بیندازید.
  10. اگر کسب درآمد فعال است، شناسه کاربری مدیریت سرور (Management Server UUID) را از گروه‌های تحلیلی حذف کنید. مثال: 
    curl -v -u AdminEmail:AdminPassword -X DELETE "http://localhost:8080/v1/analytics/groups/ax/mint_axgroup/servers?uuid=MS_UUID&type=consumer-server"
  11. سرور مدیریت کسب درآمد را حذف نصب کنید: 
    apigee-service edge-mint-management-server uninstall

سرورهای مدیریتی چندگانه

  1. با دنبال کردن مراحل زیر ، یکی از سرورهای مدیریت را با استفاده از دیگری روی گره موجود غیرفعال کنید.
  2. سرور مدیریت را متوقف و حذف نصب کنید: 
    apigee-service edge-management-server stop
    apigee-service edge-management-server uninstall
  3. با سیستم عامل ارتقا یافته، گره جدیدی را بدست آورید.
  4. پیش‌نیازهای مربوط به سیستم عامل را اعمال کنید.
  5. بوت‌استرپ نسخه مورد استفاده Apigee را دانلود کنید، بوت‌استرپ را اجرا کنید تا apigee-service را دریافت کنید و apigee-setup را نصب کنید.
  6. سرور مدیریت را با استفاده از IP و فایل پیکربندی به‌روز شده که از اینجا قابل دسترسی است، اضافه کنید و دستور راه‌اندازی را اجرا کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
  7. رابط کاربری را با پیکربندی IP مدیریت به‌روز شده، مجدداً راه‌اندازی و راه‌اندازی کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
  8. (فقط در صورت فعال بودن SSO) SSO را با پیکربندی IP مدیریت به‌روز شده، مجدداً راه‌اندازی و راه‌اندازی کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  9. (فقط در صورتی که رابط کاربری جدید فعال باشد) رابط کاربری جدید را با پیکربندی IP مدیریت به‌روز شده، مجدداً راه‌اندازی و راه‌اندازی کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
  10. برای سایر سرورهای مدیریت تکرار کنید.

رابط کاربری/کاربری

  1. از گره رابط کاربری، پشتیبان/عکس فوری از ماشین مجازی بگیرید.
  2. رابط کاربری را متوقف و حذف نصب کنید: 
    apigee-service edge-ui stop
    apigee-service edge-ui uninstall
  3. (فقط در صورت استفاده از رابط کاربری جدید) رابط کاربری جدید را متوقف و حذف نصب کنید: 
    apigee-service edge-management-ui stop
    apigee-service edge-management-ui uninstall
  4. با سیستم عامل ارتقا یافته، گره جدیدی را بدست آورید.
  5. پیش‌نیازهای مربوط به سیستم عامل را اعمال کنید.
  6. بوت‌استرپ نسخه مورد استفاده Apigee را دانلود کنید، بوت‌استرپ را اجرا کنید تا apigee-service را دریافت کنید و apigee-setup را نصب کنید.
  7. edge-ui روی گره جدید، با پیکربندی‌های IP به‌روز شده، راه‌اندازی و اجرا کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
  8. (فقط در صورت فعال بودن SSO) SSO را با تنظیمات IP گره جدید UI مطابق با موارد زیر مجدداً راه‌اندازی و اجرا کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  9. (فقط در صورتی که رابط کاربری جدید فعال باشد) رابط کاربری جدید را روی گره جدید، با پیکربندی‌های IP به‌روز شده، راه‌اندازی و اجرا کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
    apigee-service edge-management-ui configure-sso -f updatedConfigFile
    apigee-service edge-ui configure-sso -f updatedConfigFile

اس‌اس‌او

  1. از گره رابط کاربری، پشتیبان/عکس فوری از ماشین مجازی بگیرید.
  2. SSO را متوقف و حذف نصب کنید: 
    apigee-service apigee-sso stop
    apigee-service apigee-sso uninstall
  3. با سیستم عامل ارتقا یافته، گره جدیدی را بدست آورید.
  4. پیش‌نیازهای مربوط به سیستم عامل را اعمال کنید.
  5. بوت‌استرپ نسخه مورد استفاده Apigee را دانلود کنید، بوت‌استرپ را اجرا کنید تا apigee-service را دریافت کنید و apigee-setup را نصب کنید.
  6. با توجه به IP گره جدید، پیکربندی‌ها و کلیدهای SSO را طبق راهنما اضافه کنید.
  7. راه‌اندازی و شروع SSO: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  8. پیکربندی را با IP های جدید گره SSO به روز کنید و SSO را برای رابط کاربری دوباره پیکربندی کنید: 
    apigee-service edge-ui configure-sso -f updatedConfigFile
  9. (در صورت استفاده از New UI) دستور configure-sso را روی گره New UI اجرا کنید، و به مستندات آن مراجعه کنید: 
    apigee-service edge-management-ui configure-sso -f updatedConfigFile
    apigee-service edge-ui configure-sso -f updatedConfigFile