‫Apigee Edge نسخه 4.50.00 یا 4.51.00 را به 4.52.00 به‌روز کنید

‫Apigee از ارتقای Edge برای Private Cloud از نسخه ۴.۵۰.۰۰ یا نسخه ۴.۵۱.۰۰ مستقیماً به نسخه ۴.۵۲.۰۰ پشتیبانی می‌کند. این صفحه نحوه انجام هریک از این ارتقاها را شرح می‌دهد.

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

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

پس‌از نصب Edge RPM، هرکسی می‌تواند آن‌ها را پیکربندی کند.

کدام مؤلفه‌ها را باید به‌روز کنید

باید همه مؤلفه‌های Edge را به‌روز کنید. Edge از راه‌اندازی‌ای که شامل مؤلفه‌هایی از چندین نسخه باشد پشتیبانی نمی‌کند.

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

قبل‌از ارتقا دادن Apigee Edge، مطمئن شوید پیش‌نیازهای زیر را دارید:

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

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

  • مطمئن شوید Edge درحال اجرا است
    بااستفاده از این فرمان، مطمئن شوید Edge درطول فرایند به‌روزرسانی فعال و درحال اجرا است:
    /opt/apigee/apigee-service/bin/apigee-all status
  • مطمئن شوید که «راهبرد فشرده‌سازی کاساندرا» LeveledCompactionStrategy است
    مطمئن شوید که «راهبرد فشرده‌سازی کاساندرا» روی LeveledCompactionStrategy تنظیم شده باشد، همان‌طور که در تغییر راهبرد فشرده‌سازی کاساندرا شرح داده شده است.

انتشار خودکار تنظیمات دارایی

اگر با ویرایش کردن فایل‌های .properties در /opt/apigee/customer/application ویژگی‌هایی را تنظیم کرده باشید، این مقادیر با به‌روزرسانی حفظ می‌شوند.

ارتقا به Zookeeper 3.8.0 الزامی است

این نسخه از Edge for Private Cloudes شامل ارتقا به Zookeeper 3.8.0 است. به‌عنوان بخشی از آن ارتقا، همه داده‌های Zookeeper به Zookeeper 3.8.0 منتقل خواهد شد.

پیش‌از ارتقا دادن Zookeeper، راهنمای نگهداری Zookeeper را بخوانید. اکثر سیستم‌های تولید Edge از خوشه‌ای از گره‌های Zookeeper استفاده می‌کنند که در چندین مرکز داده توزیع شده‌اند. برخی‌از این گره‌ها به‌عنوان رأی‌دهندگانی پیکربندی شده‌اند که در انتخابات رهبر Zookeeper شرکت می‌کنند، و بقیه به‌عنوان ناظر پیکربندی شده‌اند. برای جزئیات بیشتر، درباره رهبران، دنبال‌کنندگان، رأی‌دهندگان، و ناظران را ببینید. گره‌های رأی‌دهنده رهبری را انتخاب می‌کنند که پس‌از آن خود گره‌های رأی‌دهنده پیرو می‌شوند.

درطول فرایند به‌روزرسانی، ممکن است تأخیر لحظه‌ای یا خطای نوشتن در Zookeeper هنگام خاموش شدن گره رهبر وجود داشته باشد. این امر می‌تواند بر عملیات «مدیریت» که در Zookeeper می‌نویسد، مانند عملیات استقرار پراکسی، و تغییرات زیرساخت Apigee، مانند افزودن یا حذف پردازشگر پیام و غیره، تأثیر بگذارد. درطول ارتقای Zookeeper، درصورت دنبال کردن رویه زیر، نباید هیچ تأثیری بر میاناهای برنامه‌سازی کاربردی زمان اجرای Apigee وجود داشته باشد (مگر اینکه این میاناهای برنامه‌سازی کاربردی زمان اجرا میاناهای برنامه‌سازی کاربردی مدیریت را فراخوانی کنند).

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

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

از همه گره‌های Zookeeper نسخه پشتیبان تهیه کنید تا درصورت نیاز به بازگشت به نسخه قبلی از آن استفاده کنید. توجه داشته باشید که بازگرداندن Zookeeper را به وضعیتی که هنگام پشتیبان‌گیری داشت بازیابی می‌کند. توجه: هرگونه استقرار یا تغییر زیرساخت در Apigee از زمان تهیه نسخه پشتیبان (که اطلاعات آن در Zookeeper ذخیره شده است) درطول بازیابی ازبین خواهد رفت.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

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

شناسایی رهبر، دنبال‌کنندگان، و ناظران

توجه: فرمان‌های نمونه زیر از ابزار nc برای ارسال داده به Zookeeper استفاده می‌کنند. می‌توانید از برنامه‌های کمکی جایگزین نیز برای ارسال داده به Zookeeper استفاده کنید.

  1. اگر روی گره ZooKeeper نصب نشده است، nc را نصب کنید:
      sudo yum install nc
  2. فرمان nc زیر را در گره اجرا کنید، که در آن ۲۱۸۱ درگاه ZooKeeper است:
      echo stat | nc localhost 2181

    باید بروندادی مانند زیر ببینید:

      Zookeeper version: 3.8.0-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
      Clients:
       /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
      
      Latency min/avg/max: 0/0.2518/41
      Received: 647228
      Sent: 647339
      Connections: 4
      Outstanding: 0
      Zxid: 0x400018b15
      Mode: follower
      Node count: 100597

    در خط Mode خروجی گره‌ها، باید ناظر، رهبر، یا پیرو (به‌معنای رأی‌دهنده‌ای که رهبر نیست) را بسته به پیکربندی گره ببینید. توجه: در نصب مستقل Edge با یک گره ZooKeeper، Mode روی مستقل تنظیم شده است.

  3. مراحل ۱ و ۲ را در هر گره ZooKeeper تکرار کنید.

Zookeeper را در گره‌های ناظر و پیرو ارتقا دهید

Zookeeper را در هریک از گره‌های ناظر و دنبال‌کننده به‌صورت زیر ارتقا دهید:

  1. راه‌انداز Edge for Private Cloud 4.52 را همان‌طور که در به‌روزرسانی به 4.52.00 در گره با اتصال اینترنت خارجی شرح داده شده است بارگیری و اجرا کنید. این فرایند احتمالاً بسته به اینکه گره اتصال اینترنت خارجی دارد یا درحال انجام نصب آفلاین هستید متفاوت خواهد بود.
  2. مؤلفه Zookeeper را ارتقا دهید:
      /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
    توجه: اگر این گره‌ها مؤلفه‌های دیگری (مانند Cassandra) نصب کرده باشند، می‌توانید آن‌ها را نیز اکنون ارتقا دهید (مانند نمایه cs,zk) یا می‌توانید مؤلفه‌های دیگر را بعداً ارتقا دهید. Apigee توصیه می‌کند که ابتدا فقط Zookeeper را ارتقا دهید و قبل‌از ارتقا دادن مؤلفه‌های دیگر، مطمئن شوید که خوشه‌تان به‌درستی کار می‌کند.
  3. مراحل بالا را برای هریک از گره‌های ناظر و پیرو Zookeeper تکرار کنید.

خاموش کردن رهبر

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

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

توجه داشته باشید که درطول این رویداد، قبل‌از انتخاب رهبر جدید، ممکن است تأخیرهای لحظه‌ای یا خطاهای نوشتن در Zookeeper رخ دهد. این امر می‌تواند بر عملیاتی که در Zookeeper نوشته می‌شود تأثیر بگذارد، مانند کنش استقرار پراکسی‌ها یا تغییرات زیرساخت Apigee، مانند افزودن یا برداشتن پردازشگرهای پیام، و غیره.

تأیید کنید که رهبر جدید انتخاب شده است

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

ارتقای رهبر

همان مراحل ارتقا دادن Zookeeper در گره‌های ناظر و دنبال‌کننده در بالا را دنبال کنید.

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

عقب‌گرد

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

  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
  • Zookeeper را طبق معمول نصب کنید:
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  • وقتی همه دنبال‌کنندگان و ناظران بازگردانده شدند، گره رهبر را با دنبال کردن مراحل ۲ تا ۵ در گره رهبر بازگردانید.
  • پس‌از اینکه همه گره‌ها بازگردانده شدند، سلامت خوشه را درستی‌سنجی کنید و مطمئن شوید که گره راهبر در خوشه وجود دارد.
  • بازیابی نسخه پشتیبان

    به بازیابی از نسخه پشتیبان مراجعه کنید. توجه داشته باشید که نسخه‌های پشتیبان Zookeeper که از نسخه‌های قبلی Edge for Private Cloud مانند 4.50 و 4.51 گرفته شده‌اند باید با نسخه Zookeeper در Edge for Private Cloud 4.52 سازگار باشند.

    ارتقا به Postgres 14 الزامی است

    این نسخه از Edge شامل ارتقا به Postgres 14 است. به‌عنوان بخشی از این ارتقا، همه داده‌های Postgres به Postgres 14 منتقل می‌شود.

    اکثر سیستم‌های تولید Edge از دو گره Postgres استفاده می‌کنند که برای تکرار اصلی-آماده‌به‌کار پیکربندی شده‌اند. درطول فرایند به‌روزرسانی، درحالی‌که گره‌های Postgres برای به‌روزرسانی غیرفعال هستند، داده‌های تجزیه‌وتحلیل همچنان در گره‌های Qpid نوشته می‌شوند. پس‌از به‌روزرسانی گره‌های Postgres و آنلاین شدن مجدد آن‌ها، داده‌های Analytics به گره‌های Postgres ارسال می‌شود.

    نحوه انجام به‌روزرسانی Postgres به نحوه پیکربندی فضای ذخیره‌سازی داده برای گره‌های Postgres بستگی دارد:

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

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

      در پیکربندی ۱ گره‌ای و ۲ گره‌ای Edge، توپولوژی‌های مورداستفاده برای نمونه‌سازی و آزمایش، شما فقط یک گره Postgres دارید. می‌توانید این گره‌های Postgres را مستقیماً به‌روز کنید بدون اینکه مجبور باشید گره Postgres جدیدی ایجاد کنید.

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

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

    درحال نصب گره آماده‌به‌کار Postgres جدید

    این رویه یک سرور آماده‌به‌کار Postgres در گره جدید ایجاد می‌کند. مطمئن شوید که سرور آماده‌به‌کار Postgres جدیدی را برای نسخه موجود Edge (‏۴.۵۰.۰۰ یا ۴.۵۱.۰۰) نصب می‌کنید، نه برای نسخه ۴.۵۲.۰۰.

    برای انجام نصب، از همان فایل پیکربندی‌ای استفاده کنید که برای نصب نسخه فعلی Edge استفاده کردید.

    برای ایجاد گره آماده‌به‌کار Postgres جدید:

    1. در Postgres master فعلی، فایل /opt/apigee/customer/application/postgresql.properties را ویرایش کنید تا توکن زیر را تنظیم کنید. اگر آن فایل وجود ندارد، آن را ایجاد کنید:
      conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

      که در آن existing_standby_ip نشانی IP سرور آماده‌به‌کار Postgres فعلی است و new_standby_ip نشانی IP گره آماده‌به‌کار جدید است.

    2. بازراه‌اندازی apigee-postgresql در Postgres master:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
    3. با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf در گره اصلی، تأیید کنید که گره آماده‌به‌کار جدید اضافه شده است. باید خطوط زیر را در آن فایل ببینید:
      host replication apigee existing_standby_ip/32 trust
      host replication apigee new_standby_ip/32 trust
    4. سرور آماده‌به‌کار Postgres جدید را نصب کنید:
      1. فایل پیکربندی را که برای نصب نسخه فعلی Edge استفاده کرده‌اید ویرایش کنید تا موارد زیر را مشخص کنید:
        # IP address of the current master:
        PG_MASTER=192.168.56.103
        # IP address of the new standby node
        PG_STANDBY=192.168.56.102
      2. SELinux را طبق روشی که در نصب ابزار کمکی apigee-setup در Edge توضیح داده شده است غیرفعال کنید.
      3. اگر درحال‌حاضر از Edge 4.51.00 استفاده می‌کنید:

        1. فایل Edge bootstrap_4.51.00.sh را در /tmp/bootstrap_4.51.00.sh بارگیری کنید:
          curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
        2. برنامه کمکی Edge apigee-service و وابستگی‌ها را نصب کنید:
          sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

        اگر درحال‌حاضر از Edge 4.50.00 استفاده می‌کنید:

        1. فایل Edge bootstrap_4.50.00.sh را در /tmp/bootstrap_4.50.00.sh بارگیری کنید:
          curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
        2. برنامه کمکی Edge apigee-service و وابستگی‌ها را نصب کنید:
          sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
      4. از apigee-service برای نصب ابزار apigee-setup استفاده کنید:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      5. نصب Postgres:
        /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
      6. در گره آماده‌به‌کار جدید، فرمان زیر را اجرا کنید:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

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

    درحال انجام ارتقای درجا برای Postgres

    توجه: قبل‌از انجام ارتقای درجا Postgres، باید مرحله مقدماتی زیر را انجام دهید.

    مرحله مقدماتی

    قبل‌از انجام ارتقای درجا به Postgres، مراحل زیر را در هر دو میزبان اصلی و آماده‌به‌کار انجام دهید تا ویژگی 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

    انجام ارتقای درجا

    برای انجام ارتقای درجا به Postgres 14، مراحل زیر را انجام دهید:

    1. ارتقا دادن postgres در میزبان اصلی
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
    2. فرمان راه‌اندازی را در میزبان اصلی اجرا کنید:
      apigee-service apigee-postgresql setup -f /opt/silent.conf
    3. فرمان پیکربندی را در میزبان اصلی اجرا کنید:
      apigee-service apigee-postgresql configure
    4. بازراه‌اندازی میزبان اصلی:
      apigee-service apigee-postgresql restart
    5. آن را به‌عنوان اصلی پیکربندی کنید:
      apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
    6. مطمئن شوید میزبان اصلی شروع کرده باشد:
      apigee-service apigee-postgresql wait_for_ready
    7. توقف حالت آماده‌به‌کار:
      apigee-service apigee-postgresql stop
    8. حالت آماده‌به‌کار را ارتقا دهید.

      توجه: اگر این مرحله با خطا مواجه شد/ ناموفق بود، می‌توانید آن را نادیده بگیرید. update.sh تلاش خواهد کرد سرور آماده‌به‌کار را با پیکربندی نادرست راه‌اندازی کند. اگر نصب Postgres به نسخه ۱۴ ارتقا داده شده باشد، می‌توان از این خطا صرف‌نظر کرد.

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
    9. مطمئن شوید حالت آماده‌به‌کار متوقف شده است:
      apigee-service apigee-postgresql stop
    10. پیکربندی آماده‌به‌کار قدیمی را بردارید:
      rm -rf /opt/apigee/data/apigee-postgresql/
    11. راه‌اندازی تکرار در سرور آماده‌به‌کار:
      apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
    12. خط conf/postgresql.conf+max_locks_per_transaction=30000 را از فایل /opt/apigee/customer/application/postgresql.properties هم در میزبان اصلی و هم در میزبان آماده‌به‌کار بردارید. این خط در مرحله مقدماتی اضافه شده است.

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

    ازکار انداختن گره Postgres

    پس‌از تکمیل به‌روزرسانی، گره آماده‌به‌کار جدید را از رده خارج کنید:

    1. مطمئن شوید Postgres درحال اجرا است:
      /opt/apigee/apigee-service/bin/apigee-all status

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

      /opt/apigee/apigee-service/bin/apigee-all start
    2. با اجرای فرمان curl زیر در گره آماده‌به‌کار جدید، شناسه UUID گره آماده‌به‌کار جدید را دریافت کنید:
      curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

      باید UUID گره را در انتهای خروجی به این شکل ببینید:

      "type" : [ "postgres-server" ],
      "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
    3. با اجرای فرمان زیر در گره آماده‌به‌کار جدید، گره آماده‌به‌کار جدید را متوقف کنید:
      /opt/apigee/apigee-service/bin/apigee-all stop
    4. در گره اصلی Postgres،‏ /opt/apigee/customer/application/postgresql.properties را ویرایش کنید تا گره آماده‌به‌کار جدید را از conf_pg_hba_replication.connection بردارید:
      conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
    5. apigee-postgresql را در Postgres master بازراه‌اندازی کنید:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
    6. با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf در گره اصلی، مطمئن شوید که گره آماده‌به‌کار جدید برداشته شده است. باید فقط خط زیر را در آن فایل ببینید:
      host replication apigee existing_standby_ip/32 trust
    7. با انجام فراخوانی Edge management API زیر در گره Management Server، شناسه UUID گره آماده‌به‌کار را از ZooKeeper حذف کنید:
      curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

    مراحل پس‌از ارتقا برای Postgres

    پس‌از ارتقای عمده Postgres، آمار داخلی Postgres پاک می‌شود. این آمار به برنامه‌ریز پُرسمان Postgres کمک می‌کند تا از بهینه‌ترین نمایه‌ها و مسیرها برای اجرای پُرسمان‌ها استفاده کند.

    Postgres می‌تواند به‌تدریج آمار خود را درطول زمان با اجرای پُرسمان‌ها و هنگام اجرای دیمن autovacuum بازسازی کند. بااین‌حال، تا زمانی که آمار بازسازی نشود، ممکن است پُرسمان‌هایتان کند باشد.

    برای رسیدگی به این مشکل، ANALYZE را در همه جدول‌های پایگاه داده در گره اصلی Postgres اجرا کنید. همچنین می‌توانید ANALYZE را برای چند جدول به‌طور هم‌زمان اجرا کنید.

    میانای کاربر جدید Edge

    این بخش ملاحظات مربوط به میانای کاربر Edge را فهرست می‌کند. برای اطلاعات بیشتر، میانای کاربر Edge جدید برای Private Cloud را ببینید.

    نصب کردن Edge UI

    پس‌از تکمیل نصب اولیه، Apigee توصیه می‌کند Edge UI را نصب کنید، که میانای کاربر بهبودیافته‌ای برای توسعه‌دهندگان و سرپرستان Apigee Edge for Private Cloud است.

    توجه داشته باشید که میانای کاربر Edge از شما می‌خواهد «اصالت‌سنجی پایه» را غیرفعال کنید و از IDP مثل SAML یا LDAP استفاده کنید.

    برای اطلاعات بیشتر، نصب واسط کاربر Edge جدید را ببینید.

    به‌روزرسانی میانای کاربر Edge

    برای به‌روزرسانی مؤلفه میانای کاربر Edge، نسخه Edge for the Private Cloud را که از آن ارتقا می‌دهید درنظر بگیرید:

    به‌روزرسانی با Apigee mTLS

    برای به‌روزرسانی Apigee mTLS، مراحل زیر را انجام دهید:

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

    درصورت ناموفق بودن به‌روزرسانی، می‌توانید مشکل را برطرف کنید و سپس update.sh را دوباره اجرا کنید. می‌توانید به‌روزرسانی را چندین بار اجرا کنید و به‌روزرسانی از جایی که آخرین‌بار متوقف شده بود ادامه می‌یابد.

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

    درحال ثبت اطلاعات به‌روزرسانی

    به‌طور پیش‌فرض، ابزار کمکی update.sh اطلاعات گزارش را در اینجا می‌نویسد:

    /opt/apigee/var/log/apigee-setup/update.log

    اگر فردی که ابزار کمکی update.sh را اجرا می‌کند به آن فهرست راهنما دسترسی نداشته باشد، گزارش را در فهرست راهنمای /tmp به‌عنوان فایلی با نام update_username.log می‌نویسد.

    اگر فرد به /tmp دسترسی نداشته باشد، ابزار update.sh ناموفق خواهد بود.

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

    به‌روزرسانی بدون زمان خرابی، یا به‌روزرسانی چرخشی، به شما امکان می‌دهد نصب Edge را بدون ازکار انداختن Edge به‌روز کنید.

    به‌روزرسانی بدون زمان خرابی فقط با پیکربندی ۵ گره‌ای و بزرگ‌تر امکان‌پذیر است.

    The key to zero-downtime upgrading is to remove each Router, one at a time, from the load balancer. سپس «رهیاب» و هر مؤلفه دیگری را در همان دستگاهی که «رهیاب» قرار دارد به‌روزرسانی می‌کنید، و سپس «رهیاب» را دوباره به متعادل‌کننده بار اضافه می‌کنید.

    1. دستگاه‌ها را به ترتیب صحیح برای نصب خود به‌روز کنید، همان‌طور که در ترتیب به‌روزرسانی دستگاه توضیح داده شده است.
    2. وقتی زمان به‌روزرسانی «رهیاب‌ها» فرا رسید، یکی از «رهیاب‌ها» را انتخاب کنید و آن را غیرقابل‌دسترس کنید، همان‌طور که در فعال/غیرفعال کردن دسترسی‌پذیری سرور (پردازشگر/رهیاب پیام) شرح داده شده است.
    3. «رهیاب» انتخاب‌شده و همه مؤلفه‌های Edge دیگر را در همان دستگاهی که «رهیاب» قرار دارد به‌روز کنید. همه پیکربندی‌های Edge یک «مسیریاب» و «پردازشگر پیام» را در یک گره نشان می‌دهند.
    4. رهیاب را دوباره دردسترس قرار دهید.
    5. مراحل ۲ تا ۴ را برای بقیه «رهیاب‌ها» تکرار کنید.
    6. به‌روزرسانی را برای هر دستگاه باقی‌مانده در نصب خود ادامه دهید.

    قبل و بعداز به‌روزرسانی، موارد زیر را رعایت کنید:

    استفاده از فایل پیکربندی خاموش

    باید فایل پیکربندی خاموش را به فرمان به‌روزرسانی ارسال کنید. فایل پیکربندی خاموش باید همان فایلی باشد که برای نصب Edge نسخه ۴.۵۰.۰۰ یا ۴.۵۱.۰۰ استفاده کردید.

    به‌روزرسانی به 4.52.00 در گره‌ای با اتصال اینترنت خارجی

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

    1. اگر وجود دارد، هرگونه کار cron را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده است تا پس‌از تکمیل به‌روزرسانی غیرفعال کنید.
    2. برای نصب Edge RPM، به‌عنوان root به سیستم گره وارد شوید.
    3. yum-utils و yum-plugin-priorities را نصب کنید:
      sudo yum install yum-utils
      sudo yum install yum-plugin-priorities
    4. SELinux را طبق توضیحات نصب برنامه کمکی apigee-setup در Edge غیرفعال کنید.
    5. اگر درحال نصب روی Oracle 7.x هستید، فرمان زیر را اجرا کنید:
      sudo yum-config-manager --enable ol7_optional_latest
    6. اگر در AWS نصب می‌کنید، فرمان‌های زیر را yum-configure-manager اجرا کنید:
      yum update rh-amazon-rhui-client.noarch
      sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
    7. اگر درحال‌حاضر از Edge 4.51.00 استفاده می‌کنید:

      1. فایل Edge bootstrap_4.52.00.sh را در /tmp/bootstrap_4.52.00.sh بارگیری کنید:
        curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
      2. با اجرای فرمان زیر، ابزار Edge 4.52.00 apigee-service و وابستگی‌ها را نصب کنید:
        sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

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

        به‌طور پیش‌فرض، نصب‌کننده بررسی می‌کند که Java 1.8 را نصب کرده باشید. اگر این کار را نکنید، نصب‌کننده آن را برایتان نصب می‌کند.

        از گزینه JAVA_FIX برای مشخص کردن نحوه مدیریت نصب Java استفاده کنید. JAVA_FIX مقادیر زیر را می‌گیرد:

        • I: OpenJDK 1.8 (پیش‌فرض) را نصب کنید.
        • C: بدون نصب Java ادامه دهید.
        • ‫Q: رها کردن. برای این گزینه، باید Java را خودتان نصب کنید.
      3. از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید، همان‌طور که در مثال زیر نشان داده شده است:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      4. برنامه کمکی apigee-validate را در «سرور مدیریت» به‌روز کنید، همان‌طور که در مثال زیر نشان داده شده است:
        /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      5. برنامه کمکی apigee-provision را در «سرور مدیریت» به‌روز کنید، همان‌طور که در مثال زیر نشان داده شده است:
        /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
      6. با اجرای فرمان زیر، ابزار update را در گره‌هایتان اجرا کنید:
        /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

        مکان:

        • component مؤلفه Edge برای به‌روزرسانی است. مقادیر ممکن عبارتند از:
          • ‫cs: کاساندرا
          • edge: همه مؤلفه‌های Edge به‌جز Edge UI: سرور مدیریت، پردازشگر پیام، مسیریاب، سرور QPID، سرور Postgres
          • ldap: ال‌دپ باز
          • ‫ps: postgresql
          • qpid: qpidd
          • sso: Apigee SSO (اگر SSO را نصب کرده باشید)
          • ue: New Edge UI
          • ui: میانای کاربر Edge کلاسیک
          • zk: نگهبان باغ وحش
        • configFile همان فایل پیکربندی است که برای تعریف مؤلفه‌های Edge درطول نصب نسخه ۴.۵۰.۰۰ یا ۴.۵۱.۰۰ استفاده کردید.

        می‌توانید update.sh را با تنظیم component روی «all» (همه) برای همه مؤلفه‌ها اجرا کنید، اما فقط درصورتی‌که نمایه نصب Edge همه‌کاره (AIO) داشته باشید. برای مثال:

        /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
      7. اگر قبلاً این کار را نکرده‌اید، مؤلفه‌های میانای کاربر Edge را در همه گره‌هایی که آن‌ها را اجرا می‌کنند بازراه‌اندازی کنید:
        /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
      8. به‌روزرسانی را با اجرای ابزار apigee-validate در «سرور مدیریت» آزمایش کنید، همان‌طور که در آزمایش نصب شرح داده شده است.

      اگر بعداً تصمیم گرفتید به‌روزرسانی را برگردانید، از روش شرح‌داده‌شده در برگرداندن 4.52.00 استفاده کنید.

      به‌روزرسانی به نسخه ۴.۵۲.۰۰ از مخزن محلی

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

      پس‌از ایجاد مخزن Edge محلی، دو گزینه برای به‌روزرسانی Edge از مخزن محلی دارید:

      • یک فایل tar .از مخزن ایجاد کنید، فایل tar .را در یک گره کپی کنید، و سپس Edge را از فایل tar. به‌روز کنید.
      • یک وب‌سرور روی گره با مخزن محلی نصب کنید تا گره‌های دیگر بتوانند به آن دسترسی داشته باشند. Apigee وب‌سرور Nginx را برای استفاده شما ارائه می‌دهد، یا می‌توانید از وب‌سرور خودتان استفاده کنید.

      برای به‌روزرسانی از مخزن محلی 4.52.00:

      1. یک مخزن محلی 4.52.00 ایجاد کنید، همان‌طور که در «ایجاد یک مخزن Apigee محلی» در نصب ابزار apigee-setup Edge توضیح داده شده است.
      2. برای نصب apigee-service از فایل tar.:
        1. در گره با مخزن محلی، از فرمان زیر برای بسته‌بندی مخزن محلی در یک فایل ‎ .tar با نام /opt/apigee/data/apigee-mirror/apigee-4.52.00.tar.gz استفاده کنید:
          /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
        2. فایل tar .را در گره‌ای که می‌خواهید Edge را به‌روز کنید کپی کنید. برای مثال، آن را در دایرکتوری /tmp در گره جدید کپی کنید.
        3. در گره جدید، فایل را در دایرکتوری /tmp از حالت tar خارج کنید:
          tar -xzf apigee-4.52.00.tar.gz

          این فرمان پوشه جدیدی به نام repos در پوشه حاوی فایل tar .ایجاد می‌کند. برای مثال /tmp/repos.

        4. برنامه کمکی Edge apigee-service و وابستگی‌ها را از /tmp/repos نصب کنید:
          sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

          توجه داشته باشید که مسیر دایرکتوری repos را در این فرمان اضافه می‌کنید.

      3. برای نصب apigee-service بااستفاده از وب‌سرور Nginx:
        1. سرور وب Nginx را همان‌طور که در «نصب از مخزن بااستفاده از سرور وب Nginx» در نصب ابزار کمکی apigee-setup در Edge شرح داده شده است پیکربندی کنید.
        2. در گره دور، فایل Edge bootstrap_4.52.00.sh را در /tmp/bootstrap_4.52.00.sh بارگیری کنید:
          /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh

          که uName:pWord نام کاربری و گذرواژه‌ای است که قبلاً برای مخزن تنظیم کرده‌اید، و remoteRepo نشانی IP یا نام ساناد (DNS) گره مخزن است.

        3. در گره راه دور، ابزار کمکی Edge apigee-setup و وابستگی‌ها را نصب کنید:
          sudo bash /tmp/bootstrap_4.52.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

          که uName:pWord نام کاربری و گذرواژه مخزن است.

      4. از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید، همان‌طور که در مثال زیر نشان داده شده است:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
      5. برنامه کمکی apigee-validate را در «سرور مدیریت» به‌روز کنید، همان‌طور که در مثال زیر نشان داده شده است:
        /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      6. برنامه کمکی apigee-provision را در «سرور مدیریت» به‌روز کنید، همان‌طور که در مثال زیر نشان داده شده است:
        /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
      7. برنامه کمکی update را در گره‌هایتان به‌ترتیبی که در ترتیب به‌روزرسانی دستگاه شرح داده شده است اجرا کنید:
        /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

        مکان:

        • component مؤلفه Edge برای به‌روزرسانی است. معمولاً مؤلفه‌های زیر را به‌روزرسانی می‌کنید:
          • ‫cs: کاساندرا
          • edge: همه مؤلفه‌های Edge به‌جز میانای کاربر Edge: سرور مدیریت، پردازشگر پیام، مسیریاب، سرور QPID، سرور Postgres
          • ldap: ال‌دپ باز
          • ‫ps: postgresql
          • qpid: qpidd
          • sso: Apigee SSO (اگر SSO را نصب کرده باشید)
          • ue میانای کاربر Edge جدید
          • ui: میانای کاربر Edge کلاسیک
          • zk: نگهبان باغ وحش
        • configFile همان فایل پیکربندی است که برای تعریف مؤلفه‌های Edge درطول نصب نسخه ۴.۵۰.۰۰ یا ۴.۵۱.۰۰ استفاده کردید.

        می‌توانید update.sh را با تنظیم component روی «all» (همه) برای همه مؤلفه‌ها اجرا کنید، اما فقط درصورتی‌که نمایه نصب Edge همه‌کاره (AIO) داشته باشید. برای مثال:

        /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
      8. اگر قبلاً این کار را نکرده‌اید، مؤلفه‌های میانای کاربر را در همه گره‌هایی که آن را اجرا می‌کنند بازراه‌اندازی کنید:
        /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
      9. به‌روزرسانی را با اجرای ابزار apigee-validate در «سرور مدیریت» آزمایش کنید، همان‌طور که در آزمایش نصب شرح داده شده است.

      اگر بعداً تصمیم گرفتید به‌روزرسانی را برگردانید، از روش شرح‌داده‌شده در برگرداندن 4.52.00 استفاده کنید.

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

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

      • باید همه گره‌های Cassandra و ZooKeeper را پیش‌از به‌روزرسانی هر گره دیگری به‌روز کنید.
      • برای هر ماشینی که چند مؤلفه Edge دارد (سرور مدیریت، پردازشگر پیام، رهیاب، سرور QPID، اما نه سرور Postgres)، از گزینه -c edge برای به‌روزرسانی همه آن‌ها به‌طور هم‌زمان استفاده کنید.
      • اگر در مرحله‌ای مشخص شده است که باید در چند دستگاه انجام شود، آن را به‌ترتیب دستگاه‌های مشخص‌شده انجام دهید.
      • مرحله جداگانه‌ای برای به‌روزرسانی «درآمدزایی» وجود ندارد. وقتی گزینه -c edge را مشخص کنید، به‌روز می‌شود.

      ارتقای مستقل ۱ گره‌ای

      برای ارتقا دادن پیکربندی مستقل ۱ گره‌ای به نسخه ۴.۵۲.۰۰:

      1. به‌روزرسانی همه عناصر:
        /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
      2. (اگر apigee-adminapi را نصب کرده‌اید) ابزار apigee-adminapi به‌روز شد:
        /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

      ارتقای مستقل ۲ گره‌ای

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

      برای مشاهده فهرست توپولوژی‌های Edge و شماره‌های گره، به توپولوژی‌های نصب مراجعه کنید.

      1. Cassandra و ZooKeeper را در ماشین ۱ به‌روز کنید:
        /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
      2. Qpid و Postgres را در دستگاه ۲ به‌روز کنید:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
      3. به‌روزرسانی LDAP در دستگاه ۱:
        /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
      4. به‌روزرسانی مؤلفه‌های Edge در ماشین ۲ و ۱:
        /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
      5. میانای کاربر را در دستگاه ۱ به‌روز کنید:
        /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
      6. (اگر apigee-adminapi را نصب کرده‌اید) ابزار apigee-adminapi در دستگاه ۱ به‌روز شد:
        /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
      7. (اگر Apigee SSO را نصب کرده‌اید) Apigee SSO را در دستگاه ۱ به‌روز کنید:
        /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

        که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کرده‌اید.

      8. مؤلفه میانای کاربر Edge را در دستگاه ۱ بازراه‌اندازی کنید:
        /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

      ارتقای ۵ گره‌ای

      برای نصب ۵ گره‌ای، مؤلفه‌های زیر را به‌روز کنید:

      برای مشاهده فهرست توپولوژی‌های Edge و شماره‌های گره، به توپولوژی‌های نصب مراجعه کنید.

      1. Cassandra و ZooKeeper را در ماشین ۱، ۲، و ۳ به‌روز کنید:
        /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
      2. Qpid و Postgres را در ماشین ۴ به‌روز کنید:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
      3. Qpid و Postgres را در دستگاه ۵ به‌روز کنید:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
      4. به‌روزرسانی LDAP در دستگاه ۱:
        /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
      5. به‌روزرسانی مؤلفه‌های Edge در ماشین ۴، ۵، ۱، ۲، ۳:
        /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
      6. میانای کاربر Edge را به‌روز کنید:
        • میانای کاربر کلاسیک: اگر از میانای کاربر کلاسیک استفاده می‌کنید، مؤلفه ui را در دستگاه ۱ به‌روز کنید، همان‌طور که در مثال زیر نشان داده شده است:
          /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
        • واسط کاربر Edge جدید: اگر واسط کاربر Edge جدید را نصب کرده‌اید، مؤلفه ue را در دستگاه مناسب به‌روز کنید (ممکن است دستگاه ۱ نباشد):
          /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
      7. (اگر apigee-adminapi را نصب کرده‌اید) ابزار apigee-adminapi در دستگاه ۱ به‌روز شد:
        /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
      8. (اگر Apigee SSO را نصب کرده‌اید) Apigee SSO را در دستگاه ۱ به‌روز کنید:
        /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

        که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کرده‌اید.

      9. جزء میانای کاربر را بازراه‌اندازی کنید:
        • میانای کاربر کلاسیک: اگر از میانای کاربر کلاسیک استفاده می‌کنید، مؤلفه edge-ui را در دستگاه ۱ بازراه‌اندازی کنید، همان‌طور که در مثال زیر نشان داده شده است:
          /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
        • واسط کاربر Edge جدید: اگر واسط کاربر Edge جدید را نصب کرده‌اید، مؤلفه edge-management-ui را در دستگاه مناسب بازراه‌اندازی کنید (ممکن است دستگاه ۱ نباشد):
          /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

      ارتقای خوشه‌ای ۹ گره‌ای

      مؤلفه‌های زیر را برای نصب خوشه‌ای ۹ گره‌ای به‌روز کنید:

      برای مشاهده فهرست توپولوژی‌های Edge و شماره‌های گره، به توپولوژی‌های نصب مراجعه کنید.

      1. Cassandra و ZooKeeper را در ماشین ۱، ۲، و ۳ به‌روز کنید:
        /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
      2. به‌روزرسانی Qpid در دستگاه‌های ۶ و ۷:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      3. به‌روزرسانی Postgres در دستگاه 8:
        /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      4. به‌روزرسانی Postgres در دستگاه 9:
        /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      5. به‌روزرسانی LDAP در دستگاه ۱:
        /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
      6. به‌روزرسانی مؤلفه‌های Edge در ماشین‌های ۶، ۷، ۸، ۹، ۱، ۴، و ۵ به‌ترتیب:
        /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
      7. میانای کاربر جدید (ue) یا میانای کاربر کلاسیک (ui) را در دستگاه ۱ به‌روز کنید:
        /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
      8. (اگر apigee-adminapi را نصب کرده‌اید) ابزار apigee-adminapi را در دستگاه ۱ به‌روز کنید:
        /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
      9. (اگر Apigee SSO را نصب کرده‌اید) Apigee SSO را در دستگاه ۱ به‌روز کنید:
        /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

        که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کرده‌اید.

      10. جزء میانای کاربر را بازراه‌اندازی کنید:
        • میانای کاربر کلاسیک: اگر از میانای کاربر کلاسیک استفاده می‌کنید، مؤلفه edge-ui را در دستگاه ۱ بازراه‌اندازی کنید، همان‌طور که در مثال زیر نشان داده شده است:
          /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
        • واسط کاربر Edge جدید: اگر واسط کاربر Edge جدید را نصب کرده‌اید، مؤلفه edge-management-ui را در دستگاه مناسب بازراه‌اندازی کنید (ممکن است دستگاه ۱ نباشد):
          /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

      ارتقای خوشه‌ای ۱۳ گره‌ای

      مؤلفه‌های زیر را برای نصب خوشه‌ای ۱۳ گره‌ای به‌روز کنید:

      برای مشاهده فهرست توپولوژی‌های Edge و شماره‌های گره، به توپولوژی‌های نصب مراجعه کنید.

      1. Cassandra و ZooKeeper را در ماشین‌های ۱، ۲، و ۳ به‌روز کنید:
        /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
      2. به‌روزرسانی Qpid در دستگاه‌های ۱۲ و ۱۳:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      3. به‌روزرسانی Postgres در دستگاه 8:
        /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      4. به‌روزرسانی Postgres در دستگاه 9:
        /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      5. به‌روزرسانی LDAP در دستگاه ۴ و ۵:
        /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
      6. مؤلفه‌های Edge را در ماشین‌های ۱۲، ۱۳، ۸، ۹، ۶، ۷، ۱۰، و ۱۱ به‌ترتیب زیر به‌روز کنید:
        /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
      7. میانای کاربر جدید (ue) یا میانای کاربر کلاسیک (ui) را در دستگاه‌های ۶ و ۷ به‌روز کنید:
        /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
      8. (اگر apigee-adminapi را نصب کرده‌اید) ابزار apigee-adminapi در دستگاه‌های ۶ و ۷ به‌روزرسانی شد:
        /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
      9. (اگر Apigee SSO را نصب کرده‌اید) Apigee SSO را در دستگاه‌های ۶ و ۷ به‌روز کنید:
        /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

        که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کرده‌اید.

      10. جزء میانای کاربر را بازراه‌اندازی کنید:
        • میانای کاربر کلاسیک: اگر از میانای کاربر کلاسیک استفاده می‌کنید، مؤلفه edge-ui را در دستگاه‌های ۶ و ۷ بازراه‌اندازی کنید، همان‌طور که در مثال زیر نشان داده شده است:
          /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
        • میانای کاربر Edge جدید: اگر میانای کاربر Edge جدید را نصب کرده‌اید، مؤلفه edge-management-ui را در دستگاه‌های ۶ و ۷ بازراه‌اندازی کنید:
          /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

      ارتقای خوشه‌ای ۱۲ گره‌ای

      مؤلفه‌های زیر را برای نصب خوشه‌ای ۱۲ گره‌ای به‌روز کنید:

      برای مشاهده فهرست توپولوژی‌های Edge و شماره‌های گره، به توپولوژی‌های نصب مراجعه کنید.

      1. به‌روزرسانی Cassandra و ZooKeeper:
        1. در ماشین‌های ۱، ۲، و ۳ در «مرکز داده ۱»:
          /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
        2. در ماشین‌های ۷، ۸، و ۹ در مرکز داده ۲
          /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
      2. به‌روزرسانی qpidd:
        1. ماشین‌های ۴ و ۵ در مرکز داده ۱
          1. به‌روزرسانی qpidd در دستگاه ۴:
            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
          2. به‌روزرسانی qpidd در دستگاه ۵:
            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
        2. ماشین‌های ۱۰ و ۱۱ در مرکز داده ۲
          1. به‌روزرسانی qpidd در دستگاه ۱۰:
            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
          2. به‌روزرسانی qpidd در دستگاه ۱۱:
            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      3. به‌روزرسانی Postgres:
        1. دستگاه ۶ در مرکز داده ۱
          /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
        2. دستگاه ۱۲ در مرکز داده ۲
          /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      4. به‌روزرسانی LDAP:
        1. دستگاه ۱ در مرکز داده ۱
          /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
        2. دستگاه ۷ در مرکز داده ۲
          /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
      5. به‌روزرسانی مؤلفه‌های Edge:
        1. ماشین‌های ۴، ۵، ۶، ۱، ۲، ۳ در مرکز داده ۱
          /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
        2. دستگاه‌های ۱۰، ۱۱، ۱۲، ۷، ۸، ۹ در مرکز داده ۲
          /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
      6. میانای کاربر جدید (ue) یا میانای کاربر کلاسیک (ui) را به‌روز کنید:
        1. دستگاه ۱ در مرکز داده ۱:
          /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
        2. دستگاه ۷ در مرکز داده ۲:
          /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
      7. (اگر apigee-adminapi را نصب کرده‌اید) ابزار apigee-adminapi به‌روز شد:
        1. دستگاه ۱ در مرکز داده ۱:
          /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
        2. دستگاه ۷ در مرکز داده ۲:
          /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
      8. (اگر Apigee SSO را نصب کرده‌اید) Apigee SSO را به‌روز کنید:
        1. دستگاه ۱ در مرکز داده ۱:
          /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
        2. دستگاه ۷ در مرکز داده ۲:
          /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
        3. که sso_config_file فایل پیکربندی است که هنگام نصب SSO ایجاد کرده‌اید.

      9. مؤلفه واسط کاربر Edge جدید (edge-management-ui) یا واسط کاربر Edge کلاسیک (edge-ui) را در ماشین‌های ۱ و ۷ بازراه‌اندازی کنید:
        /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

      برای پیکربندی غیرمعیار

      اگر پیکربندی غیراستاندارد دارید، مؤلفه‌های Edge را به‌ترتیب زیر به‌روز کنید:

      1. ZooKeeper
      2. Cassandra
      3. qpidd, ps
      4. LDAP
      5. Edge، یعنی نمایه «-c edge» در همه گره‌ها به‌ترتیب: گره‌های دارای سرور Qpid، سرور Edge Postgres، سرور مدیریت، پردازشگر پیام، و مسیریاب.
      6. میانای کاربر Edge (کلاسیک یا جدید)
      7. apigee-adminapi
      8. Apigee SSO

      پس‌از اتمام به‌روزرسانی، حتماً مؤلفه میانای کاربر Edge را در همه دستگاه‌هایی که آن را اجرا می‌کنند بازراه‌اندازی کنید.