به‌روزرسانی Apigee Edge 4.51.00 یا 4.52.00 به 4.52.01

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.3 لازم است

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

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

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

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

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

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

  • اگر درحال ارتقا دادن از Edge for Private Cloud نسخه ۴.۵۱.۰۰ به نسخه ۴.۵۲.۰۱ هستید، لازم است مراحل اضافی ارتقا دادن Postgres را دنبال کنید. اگر از نسخه ۴.۵۱.۰۰ به ۴.۵۲.۰۱ ارتقا می‌دهید، به بخش ارتقای الزامی به Postgres 14 مراجعه کنید.
  • اگر درحال ارتقا دادن از Edge for Private Cloud نسخه ۴.۵۲.۰۰ به ۴.۵۲.۰۱ هستید، هیچ مرحله تکمیلی برای ارتقا دادن Postgres لازم نیست.

ارتقا دادن Qpid

این نسخه Edge for Private Cloud شامل ارتقا به Qpid J-Broker است.

توصیه می‌کنیم یکی از روش‌های زیر را برای ارتقای Qpid انتخاب کنید:

ارتقای درجا بدون زمان خرابی

این روش تضمین می‌کند که هیچ زمان ازکارافتادگی‌ای برای محیط زمان اجرای Edge شما وجود نداشته باشد و ازدست رفتن داده‌های زمان اجرا را که برای تجزیه‌وتحلیل به‌دست آمده‌اند (درصورت وجود) به حداقل می‌رساند.

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

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

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

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  4. کارگزار Qpid را دوباره راه‌اندازی کنید تا پیام‌های موجود (درصورت وجود) تخلیه شود: 
    apigee-service apigee-qpidd start
  5. بررسی کنید که صف‌های موجود خالی باشند: 
    qpid-stat -q

    اگر پیام‌ها در صف پیام‌های ناموفق (DLQ) (ax-q-axgroup-001-consumer-group-001-dl) گیر کرده‌اند، صف را بااستفاده از مراحل حل مشکل گیر کردن داده‌های Analytics در صف پیام‌های ناموفق تخلیه کنید.

  6. پس‌از درستی‌سنجی اینکه صف‌ها در گره قدیمی خالی شده‌اند، apigee-qpidd را متوقف کنید: 
    apigee-service apigee-qpidd stop
  7. ارتقا دادن Qpid در گره: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. بازراه‌اندازی edge-qpid-server: 
    apigee-service edge-qpid-server restart

  9. قانون دیواره آتش اعمال‌شده در مرحله ۳ را بردارید.

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

    iptables -F
  iptables -L
  10. از نظارت وب برای تأیید اینکه صف‌های Qpid پیام‌ها را دریافت می‌کنند استفاده کنید: 
    http://QPID_NODE_IP:8090
  11. مراحل ۱ تا ۹ را برای هر گره Qpid تکرار کنید.

راه‌اندازی گره Qpid جدید

این روش apigee-qpidd و edge-qpid-server را در گره جدیدی راه‌اندازی و نصب می‌کند.

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

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

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  5. کارگزار Qpid را دوباره راه‌اندازی کنید تا پیام‌های موجود (درصورت وجود) تخلیه شود: 
    apigee-service apigee-qpidd start
  6. بررسی کنید تا مطمئن شوید صف‌های موجود خالی هستند: 
    qpid-stat -q

    اگر پیام‌ها در صف پیام‌های ناموفق (DLQ) (ax-q-axgroup-001-consumer-group-001-dl) گیر کرده‌اند، صف را با دنبال کردن مراحل موضوع عیب‌یابی داده‌های Analytics در صف پیام‌های ناموفق Qpidd گیر کرده‌اند تخلیه کنید.

  7. پس‌از تأیید اینکه صف‌ها در گره قدیمی تخلیه شده‌اند، apigee-qpidd را متوقف کنید 
    apigee-service apigee-qpidd stop
  8. با دنبال کردن مراحل موجود در برداشتن سرور Qpid، ثبت گره Qpid قدیمی را لغو کنید.
  9. به افزودن گره جدید و برداشتن گره قدیمی، یکی‌یکی، ادامه دهید تا همه گره‌های Qpid ارتقا یابند.

عقب‌گرد

برای برگشتن به «نسخه ویژه» قبلی، حتماً فایل bootstrap.sh را برای نسخه‌ای که می‌خواهید به آن برگردید بارگیری کنید. برای بازگشت به نسخه ۴.۵۲.۰۰، bootstrap_4.52.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
     توجه: اگر این درگاه ۸۰۹۰ در گره QPID دردسترس نباشد، می‌توانید از سازوکارهای جایگزین مانند بازارسال درگاه SSH برای دسترسی به این نشانی وب استفاده کنید.
  5. پس‌از درستی‌سنجی اینکه صف‌ها خالی شده‌اند، Qpid را متوقف و حذف نصب کنید: 
    apigee-service apigee-apidd 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

میانای کاربر جدید 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.01 در گره‌ای با اتصال اینترنت خارجی

از روش زیر برای به‌روزرسانی مؤلفه‌های 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.01.sh را در /tmp/bootstrap_4.52.01.sh بارگیری کنید: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
    2. با اجرای فرمان زیر، ابزار Edge 4.52.01 apigee-service و وابستگی‌ها را نصب کنید: 
      sudo bash /tmp/bootstrap_4.52.01.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.01 استفاده کنید.

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

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

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

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

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

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

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

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

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

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

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

    3. در گره راه دور، ابزار کمکی Edge apigee-setup و وابستگی‌ها را نصب کنید: 
      sudo bash /tmp/bootstrap_4.52.01.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.01 استفاده کنید.

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

ترتیب به‌روزرسانی دستگاه‌ها در نصب 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. Postgres را در دستگاه ۲ به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c 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. به‌روزرسانی Qpid در Machine 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. میانای کاربر را در دستگاه ۱ به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  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 را در دستگاه ۱ بازراه‌اندازی کنید: 
    /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. به‌روزرسانی Postgres در دستگاه ۴: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. به‌روزرسانی Postgres در دستگاه ۵: 
    /opt/apigee/apigee-setup/bin/update.sh -c 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. به‌روزرسانی Qpid در دستگاه ۴: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. به‌روزرسانی Qpid در دستگاه ۵: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. میانای کاربر 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
  9. (اگر apigee-adminapi را نصب کرده‌اید) ابزار apigee-adminapi در دستگاه ۱ به‌روز شد: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (اگر Apigee SSO را نصب کرده‌اید) Apigee SSO را در دستگاه ۱ به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  11. جزء میانای کاربر را بازراه‌اندازی کنید:
    • میانای کاربر کلاسیک: اگر از میانای کاربر کلاسیک استفاده می‌کنید، مؤلفه 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. به‌روزرسانی Postgres در دستگاه 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. به‌روزرسانی Postgres در دستگاه 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c 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. به‌روزرسانی Qpid در دستگاه‌های ۶ و ۷: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -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. به‌روزرسانی Postgres در دستگاه 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. به‌روزرسانی Postgres در دستگاه 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c 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. به‌روزرسانی Qpid در دستگاه‌های ۱۲ و ۱۳: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -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. به‌روزرسانی 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
  3. به‌روزرسانی 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
  4. به‌روزرسانی مؤلفه‌های 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
  5. به‌روزرسانی 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
  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. ps
  4. LDAP
  5. Edge، یعنی نمایه «-c edge» در همه گره‌ها به‌ترتیب: گره‌های دارای سرور Qpid، سرور Edge Postgres، سرور مدیریت، پردازشگر پیام، و مسیریاب.
  6. qpidd
  7. میانای کاربر Edge (کلاسیک یا جدید)
  8. apigee-adminapi
  9. Apigee SSO

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