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

Apigee از ارتقاء Edge برای Private Cloud از نسخه 4.50.00 یا نسخه 4.51.00 به طور مستقیم به نسخه 4.52.00 پشتیبانی می کند. این صفحه نحوه انجام هر یک از ارتقاء را شرح می دهد.

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

شخصی که آپدیت را اجرا می کند باید همان شخصی باشد که Edge را در ابتدا نصب کرده است یا شخصی که به عنوان روت اجرا می شود.

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

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

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

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

قبل از ارتقاء Apigee Edge از پیش نیازهای زیر اطمینان حاصل کنید:

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

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

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

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

• اطمینان حاصل کنید که استراتژی Comptification Cassandra LeveledCompactionStrategy است
  اطمینان حاصل کنید که استراتژی سازگاری Cassandra روی LeveledCompactionStrategy تنظیم شده است، همانطور که در تغییر استراتژی فشرده سازی Cassandra توضیح داده شده است.

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

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

ارتقاء لازم به Zookeeper 3.8.0

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

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

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

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

بک آپ بگیرید

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

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

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

رهبر، پیروان و ناظران را شناسایی کنید

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

1. اگر روی گره ZooKeeper نصب نشده است، nc را نصب کنید:

     sudo yum install nc

2. دستور nc زیر را روی گره اجرا کنید، جایی که 2181 پورت 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. مراحل 1 و 2 را در هر گره ZooKeeper تکرار کنید.

Zookeeper را در گره های مشاهده گر و دنبال کننده ارتقا دهید

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

1. بوت استرپ Edge را برای 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، مانند افزودن یا حذف پردازنده‌های پیام و غیره تأثیر بگذارد.

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

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

ارتقا رهبر

همان مراحلی را که در Upgrading Zookeeper در گره‌های مشاهده‌گر و دنبال‌کننده بالا انجام دادید، دنبال کنید.

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

بازگشت به عقب

در صورت نیاز به بازگشت:

1. ابتدا مراحل بازگشت را روی ناظران و پیروان انجام دهید.
2. بوت استرپ نسخه ای را که در حال بازگشت به آن هستید دانلود و اجرا کنید—چه 4.50 یا 4.51. بسته به اینکه گره اتصال اینترنت خارجی داشته باشد یا نصب آفلاین را دنبال می کنید، روند احتمالاً متفاوت خواهد بود.
3. اگر Zookeeper روی گره اجرا می شود، آن را متوقف کنید:

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

4. حذف نصب باغ وحش موجود:

     /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

  /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

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

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

ارتقاء مورد نیاز به Postgres 14

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

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

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

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

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

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

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

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

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

این روش یک سرور آماده به کار Postgres را در یک گره جدید ایجاد می کند. اطمینان حاصل کنید که یک سرور آماده به کار Postgres جدید را برای نسخه فعلی Edge خود (4.50.00 یا 4.51.00) نصب کرده اید، نه برای نسخه 4.52.00.

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

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

1. در استاد فعلی Postgres، فایل /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 در Master Postgres راه اندازی مجدد کنید:

   /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. همانطور که در Install the Edge apigee-setup utility توضیح داده شد SELinux را غیرفعال کنید.

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

   apigee-service apigee-postgresql setup -f /opt/silent.conf

3. دستور configure را در هاست اصلی اجرا کنید:

   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 به 14 ارتقا یابد، می توان خطا را نادیده گرفت.

   /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. UUID گره آماده به کار جدید را با اجرای دستور curl زیر بر روی گره آماده به کار جدید دریافت کنید:

   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 را در Master Postgres راه اندازی مجدد کنید:

   /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. UUID گره آماده به کار را از ZooKeeper با فراخوانی API مدیریت Edge زیر در گره مدیریت سرور حذف کنید:

   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 را نصب کنید

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

توجه داشته باشید که رابط کاربری Edge نیاز دارد که احراز هویت پایه را غیرفعال کنید و از یک IDP مانند SAML یا LDAP استفاده کنید.

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

رابط کاربری Edge را به روز کنید

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

• از 4.51.00 تا 4.52.00 (با رابط کاربری Edge جدید از قبل نصب شده): از دستورالعمل های ارتقاء در این بخش برای مؤلفه edge-management-ui استفاده کنید.

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

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

• Apigee mTLS را حذف نصب کنید .
• Apigee mTLS را دوباره نصب کنید .

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

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

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

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

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

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

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

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

به روز رسانی بدون توقف

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

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

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

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

قبل و بعد از آپدیت به موارد زیر توجه کنید:

• روی گره ترکیبی روتر و پردازشگر پیام:
  • قبل از به روز رسانی - موارد زیر را انجام دهید:
    1. روتر را غیر قابل دسترس کنید.
    2. پردازشگر پیام را غیرقابل دسترس کنید.
  • پس از به روز رسانی - موارد زیر را انجام دهید:
    1. پردازشگر پیام را در دسترس قرار دهید.
    2. روتر را در دسترس قرار دهید.
• در گره های روتر تک:
  • قبل از به‌روزرسانی، روتر را غیرقابل دسترس کنید .
  • پس از به‌روزرسانی، روتر را در دسترس قرار دهید .
• در گره های پردازشگر پیام واحد:
  • قبل از به‌روزرسانی، پردازشگر پیام را غیرقابل دسترس کنید .
  • پس از به‌روزرسانی، پردازشگر پیام را در دسترس قرار دهید .

از فایل پیکربندی بی صدا استفاده کنید

شما باید یک فایل پیکربندی بی صدا را به دستور به روز رسانی ارسال کنید. فایل پیکربندی بی صدا باید همان فایلی باشد که برای نصب Edge 4.50.00 یا 4.51.00 استفاده کردید.

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

برای به روز رسانی اجزای Edge در یک گره از روش زیر استفاده کنید:

1. در صورت وجود، هر cron job پیکربندی شده برای انجام عملیات تعمیر در Cassandra را تا زمانی که به‌روزرسانی کامل نشده است، غیرفعال کنید.
2. برای نصب Edge RPM به عنوان root وارد گره خود شوید.
3. yum-utils و yum-plugin-priorities را نصب کنید:

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. همانطور که در Install the Edge apigee-setup utility توضیح داده شد SELinux را غیرفعال کنید.
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 حذف کنید، از شما خواسته می شود آن را وارد کنید.

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

      از گزینه JAVA_FIX برای تعیین نحوه مدیریت نصب جاوا استفاده کنید. JAVA_FIX مقادیر زیر را می گیرد:

      • I : OpenJDK 1.8 (پیش‌فرض) را نصب کنید.
      • C : بدون نصب جاوا ادامه دهید.
      • Q : ترک برای این گزینه باید خود جاوا را نصب کنید.
   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

      این کار را به ترتیبی که در Order of machine update توضیح داده شده است انجام دهید.

      کجا:

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

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

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config

   7. اگر قبلاً این کار را نکرده‌اید، مؤلفه Edge UI را در تمام گره‌هایی که آن را اجرا می‌کنند، مجدداً راه‌اندازی کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

   8. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.

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

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

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

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

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

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

   1. یک مخزن محلی 4.52.00 همانطور که در "ایجاد یک مخزن محلی Apigee" در نصب ابزار Edge apigee-setup توضیح داده شده است، ایجاد کنید.
   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 untar کنید:

         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» در نصب ابزار Edge apigee-setup توضیح داده شده پیکربندی کنید.
      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 گره repo است.

      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 UI: سرور مدیریت، پردازشگر پیام، روتر، سرور QPID، سرور Postgres
        • ldap : OpenLDAP
        • ps : postgresql
        • qpid : qpidd
        • sso : Apigee SSO (اگر SSO را نصب کرده باشید)
        • ue New Edge UI
        • ui : رابط کاربری کلاسیک Edge
        • zk : نگهبان باغ وحش
      • configFile همان فایل پیکربندی است که برای تعریف اجزای Edge خود در هنگام نصب 4.50.00 یا 4.51.00 استفاده کردید.

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

      /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config

   8. اگر قبلاً این کار را نکرده‌اید، مؤلفه‌های UI را در تمام گره‌هایی که آن را اجرا می‌کنند، راه‌اندازی مجدد کنید:

      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart

   9. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.

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

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

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

   • قبل از اینکه گره های دیگری را به روز کنید، باید تمام گره های Cassandra و ZooKeeper را به روز کنید.
   • برای هر ماشینی با چندین مؤلفه Edge (Management Server، Message Processor، Router، QPID Server اما نه Postgres Server)، از گزینه -c edge استفاده کنید تا همه آنها را همزمان به روز کنید.
   • اگر مرحله ای مشخص می کند که باید روی چندین ماشین انجام شود، آن را به ترتیب ماشین مشخص شده انجام دهید.
   • هیچ مرحله جداگانه ای برای به روز رسانی کسب درآمد وجود ندارد. زمانی که گزینه -c edge را مشخص کنید به روز می شود.

   ارتقاء مستقل 1 گره

   برای ارتقاء یک پیکربندی مستقل 1 گره به 4.52.00:

   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

   ارتقاء مستقل 2 گره

   اجزای زیر را برای نصب مستقل 2 گره به روز کنید:

   توپولوژی های نصب را برای لیست توپولوژی های لبه و شماره گره ها ببینید.

   1. Cassandra و ZooKeeper را در دستگاه 1 به روز کنید:

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

   2. Qpid و Postgres را در دستگاه 2 به روز کنید:

      /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile

   3. به روز رسانی LDAP در دستگاه 1:

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

   4. به روز رسانی اجزای Edge در ماشین 2 و 1:

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   5. رابط کاربری را در دستگاه 1 به روز کنید:

      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

   6. (اگر apigee-adminapi نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کردید:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   7. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

   8. مؤلفه Edge UI را در دستگاه 1 مجدداً راه اندازی کنید:

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

   ارتقاء 5 گره

   اجزای زیر را برای نصب 5 گره به روز کنید:

   توپولوژی های نصب را برای لیست توپولوژی های لبه و شماره گره ها ببینید.

   1. Cassandra و ZooKeeper را در دستگاه 1، 2، و 3 به روز کنید:

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

   2. Qpid و Postgres را در دستگاه 4 به روز کنید:

      /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile

   3. Qpid و Postgres را در دستگاه 5 به روز کنید:

      /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile

   4. به روز رسانی LDAP در دستگاه 1:

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

   5. به روز رسانی اجزای Edge در دستگاه 4، 5، 1، 2، 3:

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   6. رابط کاربری Edge را به روز کنید:
      • رابط کاربری کلاسیک: اگر از رابط کاربری کلاسیک استفاده می کنید، همانطور که در مثال زیر نشان می دهد، مؤلفه ui را در دستگاه 1 به روز کنید:

        /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

      • رابط کاربری New Edge: اگر رابط کاربری Edge جدید را نصب کرده‌اید، مؤلفه ue را در دستگاه مناسب به‌روزرسانی کنید (ممکن است دستگاه 1 نباشد):

        /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf

   7. (اگر apigee-adminapi نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کردید:

      /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

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

   9. کامپوننت UI را مجددا راه اندازی کنید:
      • رابط کاربری کلاسیک: اگر از رابط کاربری کلاسیک استفاده می‌کنید، همانطور که در مثال زیر نشان می‌دهد، مؤلفه edge-ui را در دستگاه 1 مجدداً راه‌اندازی کنید:

        /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

      • New Edge UI: اگر رابط کاربری Edge جدید را نصب کرده اید، سپس مؤلفه edge-management-ui را در دستگاه مناسب راه اندازی مجدد کنید (ممکن است دستگاه 1 نباشد):

        /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

   ارتقاء خوشه ای 9 گره

   اجزای زیر را برای نصب خوشه ای 9 گره به روز کنید:

   توپولوژی های نصب را برای لیست توپولوژی های لبه و شماره گره ها ببینید.

   1. Cassandra و ZooKeeper را در دستگاه 1، 2، و 3 به روز کنید:

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

   2. به روز رسانی Qpid در ماشین های 6 و 7:

      /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 در دستگاه 1:

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

   6. اجزای Edge را در دستگاه 6، 7، 8، 9، 1، 4 و 5 به ترتیب به روز کنید:

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   7. رابط کاربری جدید ( ue ) یا رابط کاربری کلاسیک ( ui ) را در دستگاه 1 به روز کنید:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   8. (اگر apigee-adminapi نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کنید:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   9. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

   10. کامپوننت UI را مجددا راه اندازی کنید:
       • رابط کاربری کلاسیک: اگر از رابط کاربری کلاسیک استفاده می‌کنید، همانطور که در مثال زیر نشان می‌دهد، مؤلفه edge-ui را در دستگاه 1 مجدداً راه‌اندازی کنید:

         /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

       • New Edge UI: اگر رابط کاربری Edge جدید را نصب کرده اید، سپس مؤلفه edge-management-ui را در دستگاه مناسب راه اندازی مجدد کنید (ممکن است دستگاه 1 نباشد):

         /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

   ارتقاء خوشه ای 13 گره

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

   توپولوژی های نصب را برای لیست توپولوژی های لبه و شماره گره ها ببینید.

   1. Cassandra و ZooKeeper را در ماشین‌های 1، 2 و 3 به‌روزرسانی کنید:

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

   2. به روز رسانی Qpid در ماشین های 12 و 13:

      /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 در دستگاه 4 و 5:

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

   6. اجزای Edge را در ماشین‌های 12، 13، 8، 9، 6، 7، 10 و 11 به ترتیب به‌روزرسانی کنید:

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   7. رابط کاربری جدید ( ue ) یا رابط کاربری کلاسیک ( ui ) را در ماشین های 6 و 7 به روز کنید:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   8. (اگر apigee-adminapi نصب کرده اید) ابزار apigee-adminapi را در ماشین های 6 و 7 به روز کردید:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   9. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در ماشین های 6 و 7 به روز کنید:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

   10. کامپوننت UI را مجددا راه اندازی کنید:
       • رابط کاربری کلاسیک: اگر از رابط کاربری کلاسیک استفاده می‌کنید، همانطور که در مثال زیر نشان می‌دهد، مؤلفه edge-ui را در ماشین‌های 6 و 7 مجدداً راه‌اندازی کنید:

         /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

       • New Edge UI: اگر Edge UI جدید را نصب کرده اید، سپس مولفه edge-management-ui را در ماشین های 6 و 7 راه اندازی مجدد کنید:

         /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

   ارتقاء خوشه ای 12 گره

   اجزای زیر را برای نصب خوشه ای 12 گره به روز کنید:

   توپولوژی های نصب را برای لیست توپولوژی های لبه و شماره گره ها ببینید.

   1. Cassandra و ZooKeeper را به روز کنید:
      1. در ماشین های 1، 2 و 3 در مرکز داده 1:

         /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

      2. در ماشین های 7، 8، و 9 در مرکز داده 2

         /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

   2. به روز رسانی qpidd:
      1. Machines 4, 5 در مرکز داده 1
         1. به روز رسانی qpidd در ماشین 4:

            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

         2. به روز رسانی qpidd در ماشین 5:

            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. Machines 10, 11 in Data Center 2
         1. به روز رسانی qpidd در دستگاه 10:

            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

         2. به روز رسانی qpidd در ماشین 11:

            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

   3. به روز رسانی Postgres:
      1. ماشین 6 در مرکز داده 1

         /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

      2. ماشین 12 در مرکز داده 2

         /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

   4. به روز رسانی LDAP:
      1. ماشین 1 در مرکز داده 1

         /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

      2. ماشین 7 در مرکز داده 2

         /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

   5. به روز رسانی اجزای Edge:
      1. ماشین های 4، 5، 6، 1، 2، 3 در مرکز داده 1

         /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

      2. ماشین های 10، 11، 12، 7، 8، 9 در مرکز داده 2

         /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   6. رابط کاربری جدید ( ue ) یا رابط کاربری کلاسیک ( ui ) را به روز کنید:
      1. ماشین 1 در مرکز داده 1:

         /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

      2. ماشین 7 در مرکز داده 2:

         /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   7. (اگر apigee-adminapi نصب کرده اید) ابزار apigee-adminapi را به روز کردید:
      1. ماشین 1 در مرکز داده 1:

         /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

      2. ماشین 7 در مرکز داده 2:

         /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   8. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را به روز کنید:
      1. ماشین 1 در مرکز داده 1:

         /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      2. ماشین 7 در مرکز داده 2:

         /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

   9. Edge UI جدید ( edge-management-ui ) یا Edge UI کلاسیک ( edge-ui ) را در ماشین‌های 1 و 7 مجدداً راه‌اندازی کنید:

      /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

   برای پیکربندی غیر استاندارد

   اگر پیکربندی غیر استاندارد دارید ، سپس اجزای Edge را به ترتیب زیر به روز کنید:

   1. باغ وحش
   2. کاساندرا
   3. qpidd ، ps
   4. LDAP
   5. لبه ، به معنی پروفایل "-C Edge" در همه گره ها به ترتیب: گره هایی با سرور QPID ، سرور Edge Postgres ، سرور مدیریت ، پردازنده پیام و روتر.
   6. Edge UI (یا کلاسیک یا جدید)
   7. apigee-adminapi
   8. Apigee SSO

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