ارتقای سیستم‌عامل گره به گره برای Apigee Edge for Private Cloud

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

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

سازگاری

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

پیش‌نیازها

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

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

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

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

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

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

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

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

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

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

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

Cassandra

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

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

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

مراحل جایگزینی گره Cassandra:

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

    CASS_HOSTS موجود

    CASS_HOSTS="$IP1 $IP2 $IP3"

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

    CASS_HOSTS="$IP1 $IP4 $IP3"
  7. گره‌های موجود در خوشه را با IP گره جدید به‌روزرسانی‌شده Cassandra (به‌جز گره‌ای که باید جایگزین شود) پیکربندی مجدد کنید. لطفاً از مرجع فایل پیکربندی استفاده کنید. 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
  8. توقف و لغو ثبت Cassandra در گره قدیمی:
    1. ‫Cassandra را در گرهی که قرار است جایگزین شود متوقف کنید: 
      apigee-service apigee-cassandra stop
    2. شناسه UUID گره Cassandra را که باید ازکار بیفتد فهرست کنید (اگر چندین مرکز داده دارید، براین‌اساس درنظر بگیرید): 
      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. ‫Cassandra را نصب کنید و راه‌اندازی را در گره تازه اضافه‌شده اجرا کنید: 
    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. با به‌روزرسانی «پروتکل اینترنتی گره Cassandra جدید» در فایل پیکربندی، گره‌های موجود سرورهای «رهیاب»، «پردازشگر پیام»، «کیوپید»، «پستگرس»، و «مدیریت» را به‌ترتیب بازراه‌اندازی کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
  16. حذف/لغو نصب Cassandra از گره قدیمی‌تر: 
    apigee-service apigee-cassandra uninstall
  17. برای دیگر گره‌های Cassandra در خوشه تکرار کنید.

نگهبان باغ‌وحش

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

  1. با گرفتن چرخه‌های زمانی ماشین مجازی (درصورت امکان) از گره پشتیبان‌گیری کنید و برای Zookeeper در همه گره‌ها از Apigee پشتیبان‌گیری کنید.
  2. توقف و حذف نصب Zookeeper در گره موجود: 
    apigee-service apigee-zookeeper stop
     
    apigee-service apigee-zookeeper uninstall
  3. گره جدید را با سیستم‌عامل ارتقایافته دریافت کنید.
  4. پیش‌نیازهای مختص سیستم‌عامل را اعمال کنید.
  5. نسخه درحال استفاده Apigee را بارگیری کنید، bootstrap را اجرا کنید تا 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. با به‌روزرسانی IP گره Zookeeper جدید در فایل پیکرببندی، گره‌های موجود سرورهای «مدیر مسیریاب»، «پردازشگر پیام»،‏ Qpid،‏ Postgres، و «مدیریت» را به‌ترتیب بازراه‌اندازی کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
  10. این کار را برای همه گره‌های Zookeeper تکرار کنید.

Postgres

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

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

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

apigee-service edge-qpid-server stop

آماده به کار

  1. ‫UUID گره‌های edge-postgres-server را دریافت کنید: 
    curl http://pg_standby_ip:8084/v1/servers/self
  2. توقف Postgres: 
    apigee-service edge-postgres-server stop
     
    apigee-service apigee-postgresql stop
  3. با دنبال کردن این مراحل، آماده‌به‌کار Postgres موجود را از گروه تجزیه‌وتحلیل بردارید.
  4. apigee-postgres و postgres-server را حذف نصب کنید: 
    apigee-service edge-postgres-server uninstall
     
    apigee-service apigee-postgresql uninstall
  5. گره جدید را با سیستم‌عامل ارتقایافته دریافت کنید.
  6. پیش‌نیازهای مختص سیستم‌عامل را اعمال کنید.
  7. نسخه درحال استفاده Apigee را بارگیری کنید، bootstrap را اجرا کنید تا apigee-service را دریافت کنید و apigee-setup را نصب کنید.
  8. با به‌روزرسانی فایل پیکربندی با EXISTING_PG_MASTER_IP و NEW_PG_STANDBY_IP، تکثیر اصلی-آماده‌به‌کار را در اصلی موجود راه‌اندازی کنید. برای جزئیات بیشتر، به مرجع فایل پیکربندی مراجعه کنید: 
    PG_MASTER=EXISTING_PG_MASTER_IP
     
    PG_STANDBY=NEW_PG_STANDBY_IP
     
    apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
  9. نصب، راه‌اندازی، و شروع Postgres با پیکربندی‌های اصلی-آماده‌به‌کار در گره آماده‌به‌کار جدید: 
    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. شناسه منحصربه‌فرد جهانی گره اصلی Postgres موجود را دریافت کنید: 
    curl http://pg_ip:8084/v1/servers/self
  2. گره آماده‌به‌کار سیستم‌عامل ارتقایافته جدید را به گره اصلی ارتقا دهید.
  3. ‫Postgres را در سرور اصلی موجود متوقف کنید: 
    apigee-service apigee-postgresql stop
     
    apigee-service edge-postgres-server stop
  4. ترفیع دادن گره آماده به‌کار جدید به گره اصلی: 
    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 را در سرور اصلی قدیمی متوقف و حذف نصب کنید: 
    apigee-service edge-postgres-server uninstall
     
    apigee-service apigee-postgresql uninstall

درحال افزودن آماده‌به‌کار جدید

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

LDAP

جایگزین کردن گره LDAP مستلزم توقف «سرور مدیریت» است و هریک از «میاناهای برنامه‌سازی کاربردی مدیریت» در طول مدت جایگزینی این گره دردسترس نخواهد بود.

  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. در راه‌اندازی «فعال-فعال» 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 را بارگیری کنید، bootstrap را اجرا کنید تا apigee-service را دریافت کنید و apigee-setup را نصب کنید.
  6. راه‌اندازی گره جدید LDAP:
    1. configFile را برای گره جدید براساس راه‌اندازی به‌روز کنید، می‌توانید به مرجع فایل پیکربندی Edge برای راه‌اندازی فقط فعال یا فعال-فعال مراجعه کنید:
      • 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

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

  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 را دوباره شروع کنید: 
    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 را بارگیری کنید، bootstrap را اجرا کنید تا 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 را بارگیری کنید، bootstrap را اجرا کنید تا apigee-service را دریافت کنید و apigee-setup را نصب کنید.
  8. «پردازشگر پیام» را به خوشه اضافه کنید، آن را راه‌اندازی کنید، و شروع کنید، مراحل را دنبال کنید.
  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 را بارگیری کنید، bootstrap را اجرا کنید تا apigee-service را دریافت کنید و apigee-setup را نصب کنید.
  8. افزودن، راه‌اندازی، و شروع مسیریاب به خوشه.

سرور مدیریت

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

  1. گره جدید را با سیستم‌عامل ارتقایافته دریافت کنید.
  2. پیش‌نیازهای مختص سیستم‌عامل را اعمال کنید.
  3. نسخه درحال استفاده Apigee را بارگیری کنید، bootstrap را اجرا کنید تا apigee-service را دریافت کنید و apigee-setup را نصب کنید.
  4. «سرور مدیریت» را بااستفاده از نشانی IP به‌روزرسانی‌شده و فایل پیکربندی که می‌توان از اینجا به آن ارجاع داد اضافه کنید و فرمان راه‌اندازی را اجرا کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
  5. واسط کاربر را با پیکربندی جدید «پروتکل اینترنتی مدیریت» بازراه‌اندازی و دوباره راه‌اندازی کنید. 
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
  6. راه‌اندازی مجدد «شناسایی یگانه» با پیکربندی جدید «پروتکل اینترنتی مدیریت» (درصورت وجود): 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  7. راه‌اندازی مجدد «واسط کاربر جدید» (UE) با پیکربندی جدید «پروتکل اینترنتی مدیریت» (درصورت وجود): 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
  8. اگر درآمدزایی فعال باشد:
    1. راه‌اندازی مجدد MS درآمدزایی با پیکربندی جدید IP مدیریت (درصورت لزوم)، با مراجعه به مستندات پیکربندی درآمدزایی. 
      /opt/apigee/apigee-setup/bin/setup.sh -p mo -f updatedConfigFile
    2. بازراه‌اندازی سرور مدیریت: 
      apigee-service edge-management-server restart
  9. «سرور مدیریت» را در گره موجود/قدیمی، طبق مراحل، ازکار بیندازید.
  10. اگر درآمدزایی فعال است، «شناسه یکتای سرور مدیریت» را از گروه‌های تجزیه‌وتحلیل بردارید. مثال: 
    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 را بارگیری کنید، bootstrap را اجرا کنید تا 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. (فقط درصورتی‌که «شناسایی یگانه» فعال باشد) «شناسایی یگانه» را با پیکربندی «پروتکل اینترنتی مدیریت» به‌روزشده بازراه‌اندازی و راه‌اندازی مجدد کنید: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  9. (فقط درصورتی‌که «واسط کاربر جدید» فعال باشد) «واسط کاربر جدید» را با پیکربندی «پروتکل اینترنتی مدیریت» به‌روزشده بازراه‌اندازی و دوباره راه‌اندازی کنید: 
    /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 را بارگیری کنید، bootstrap را اجرا کنید تا apigee-service را دریافت کنید و apigee-setup را نصب کنید.
  7. ‫edge-ui را با پیکربندی‌های به‌روزرسانی‌شده پروتکل اینترنتی در گره جدید راه‌اندازی و اجرا کنید: 
    /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

SSO

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