به روز رسانی 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 را در تمام گره‌هایی که آنها را اجرا می‌کنند، مجدداً راه‌اندازی کنید:

      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|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 را در تمام دستگاه های موجود در آن مجدداً راه اندازی کنید.

   ،

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

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

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

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

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

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

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

   قبل از به روزرسانی لبه Apigee: از پیش نیازهای زیر اطمینان حاصل کنید:

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

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

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

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

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

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

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

   نیاز به ارتقا به Zookeeper 3.8.0

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

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

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

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

   بک آپ بگیرید

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

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

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

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

   توجه: دستورات نمونه زیر از NC Utility برای ارسال داده ها به 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 خروجی گره ها ، باید بسته به پیکربندی گره ، Observer ، Leader یا پیرو (به معنای رای دهنده ای که رهبر نیست) را ببینید. توجه: در یک نصب مستقل از لبه با یک گره باغ وحش منفرد ، Mode روی مستقل تنظیم شده است.

   3. مراحل 1 و 2 را در هر گره باغ وحش تکرار کنید.

   Zookeeper را بر روی گره های Observer و پیروان ارتقا دهید

   Zookeeper را در هر یک از گره های Observer و پیرو به شرح زیر ارتقا دهید:

   1. bootstrap of Edge را برای Cloud Private 4.52 بارگیری و اجرا کنید ، همانطور که در به روزرسانی 4.52.00 در یک گره با اتصال اینترنتی خارجی توضیح داده شده است. این روند بسته به اینکه گره دارای اتصال اینترنتی خارجی باشد یا شما در حال انجام نصب آفلاین هستید ، متفاوت خواهد بود.
   2. مؤلفه Zookeeper را ارتقا دهید:

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

      توجه: اگر این گره ها اجزای دیگری را نصب کرده اند (مانند کاساندرا) ، اکنون می توانید آنها را نیز ارتقا دهید (مانند مشخصات CS ، ZK) یا بعداً می توانید سایر اجزای دیگر را ارتقا دهید. Apigee توصیه می کند که ابتدا Zookeeper را ارتقا دهید و اطمینان حاصل کنید که خوشه شما قبل از به روزرسانی سایر اجزای دیگر به درستی کار می کند.
   3. مراحل بالایی را روی هر یک از گره های ناظر و Zookeeper تکرار کنید.

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

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

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

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

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

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

   رهبر ارتقاء

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

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

   بازگشت به عقب

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

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

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

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

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

8. زاویه دار را طبق معمول نصب کنید:

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

9. هنگامی که همه پیروان و ناظران به عقب برگشتند ، با دنبال کردن مراحل 2 تا 5 روی گره رهبر ، گره رهبر را به عقب برگردانید.
10. بعد از اینکه همه گره ها به عقب برگردانده شده اند ، سلامت خوشه را تأیید کرده و اطمینان حاصل کنید که یک گره رهبر در خوشه وجود دارد.

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

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

به روزرسانی مورد نیاز به Postgres 14

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

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

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

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

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

  در یک پیکربندی 1 گره و 2 گره از لبه ، توپولوژی هایی که برای نمونه سازی و آزمایش استفاده می شوند ، فقط یک گره 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. Selinux را همانطور که در نصب ابزار Edge Apigee-setup توضیح داده شده است ، غیرفعال کنید.

   3. اگر در حال حاضر در لبه 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. ابزار و وابستگی های سرویس apigee-service را نصب کنید:

         sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

      اگر در حال حاضر در لبه 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. ابزار و وابستگی های سرویس apigee-service را نصب کنید:

         sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

   4. برای نصب ابزار apigee-setup از apigee-service استفاده کنید:

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

1. در صورت عدم وجود ، File /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. دستور پیکربندی را روی میزبان اصلی اجرا کنید:

   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. با اجرای دستور 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. در گره Master Postgres ، edit /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. با برقراری تماس API مدیریت لبه زیر در گره سرور مدیریت ، UUID گره آماده به کار را از Zookeeper حذف کنید:

   curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

مراحل پس از به روزرسانی برای postgres

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

Postgres می تواند به تدریج آمار خود را با گذشت زمان بازسازی کند زیرا نمایش داده ها اجرا می شوند و هنگامی که Daemon Autovacuum اجرا می شود. با این حال ، تا زمانی که آمار بازسازی نشود ، ممکن است سؤالات شما کند باشد.

برای پرداختن به این موضوع ، ANALYZE در تمام جداول موجود در پایگاه داده در گره Master Postgres انجام دهید. از طرف دیگر ، شما می توانید ANALYZE برای چند جدول به طور همزمان اجرا کنید.

UI Edge جدید

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

لبه UI را نصب کنید

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

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

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

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

برای به روزرسانی مؤلفه Edge UI ، نسخه Edge را برای ابر خصوصی که از آن به روز می کنید در نظر بگیرید:

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

با MTL های Apigee به روز کنید

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

• حذف MTL های Apigee .
• مجدداً MTLS Apigee را نصب کنید .

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

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

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

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

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

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

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

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

بروزرسانی صفر پایین

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

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

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

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

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

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

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

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

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

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

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

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

4. Selinux را همانطور که در نصب ابزار Edge Apigee-setup توضیح داده شده است ، غیرفعال کنید.
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. اگر در حال حاضر در لبه 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 Utility و وابستگی ها را با اجرای دستور زیر نصب کنید:

      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-setup ، از apigee-service استفاده کنید ، همانطور که مثال زیر نشان می دهد:

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

      شما می توانید با تنظیم component "همه" ، در برابر همه مؤلفه ها update.sh اجرا کنید ، اما تنها در صورتی که دارای یک پروفایل نصب Edge all-in-on-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-management-ui|edge-ui] restart

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

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

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

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

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

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

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

   1. یک repo محلی 4.52.00 ایجاد کنید همانطور که در "ایجاد یک مخزن محلی Apigee" در نصب ابزار Edge Apigee-Setup توضیح داده شده است.
   2. برای نصب سرویس Apigee از یک پرونده .tar :
      1. در گره با repo محلی ، از دستور زیر استفاده کنید تا repo محلی را در یک پرونده .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 -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 با استفاده از NGINX WebServer:
      1. سرور وب Nginx را همانطور که در "نصب از repo با استفاده از WebServer 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 نام کاربری و رمز عبوری است که قبلاً برای repo تنظیم کرده اید ، و 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 نام کاربری و رمز عبور repo است.

   4. برای به روزرسانی ابزار apigee-setup ، از apigee-service استفاده کنید ، همانطور که مثال زیر نشان می دهد:

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

      شما می توانید با تنظیم component "همه" ، در برابر همه مؤلفه ها update.sh اجرا کنید ، اما تنها در صورتی که دارای یک پروفایل نصب Edge all-in-on-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. همانطور که در تست نصب توضیح داده شده است ، به روزرسانی را با اجرای ابزار apigee-validate در سرور مدیریت آزمایش کنید.

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

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

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

   • قبل از به روزرسانی هر گره دیگر ، باید تمام گره های Cassandra و Zookeeper را به روز کنید.
   • برای هر دستگاهی با مؤلفه های چند لبه (سرور مدیریت ، پردازنده پیام ، روتر ، سرور QPID اما سرور Postgres) ، از گزینه -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. کاساندرا و 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 Edge را در دستگاه 2 و 1 به روز کنید:

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

   5. UI را در دستگاه 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. کاساندرا و 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 Edge را در دستگاه 4 ، 5 ، 1 ، 2 ، 3 به روز کنید:

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

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

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

      • UI New Edge: اگر UI Edge New 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 را مجدداً راه اندازی کنید:
      • UI کلاسیک: اگر از UI کلاسیک استفاده می کنید ، سپس مؤلفه edge-ui را در دستگاه 1 مجدداً راه اندازی کنید ، همانطور که مثال زیر نشان می دهد:

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

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

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

   به روزرسانی خوشه ای 9 گره

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

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

   1. کاساندرا و 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. UI جدید ( ue ) یا UI کلاسیک ( 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 را مجدداً راه اندازی کنید:
       • UI کلاسیک: اگر از UI کلاسیک استفاده می کنید ، سپس مؤلفه edge-ui را در دستگاه 1 مجدداً راه اندازی کنید ، همانطور که مثال زیر نشان می دهد:

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

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

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

   به روزرسانی خوشه ای 13 گره

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

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

   1. کاساندرا و 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. UI جدید ( ue ) یا UI کلاسیک ( 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 را مجدداً راه اندازی کنید:
       • UI کلاسیک: اگر از UI کلاسیک استفاده می کنید ، سپس مؤلفه edge-ui را در دستگاه های 6 و 7 مجدداً راه اندازی کنید ، همانطور که مثال زیر نشان می دهد:

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

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

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

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

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

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

   1. کاساندرا و باغ وحش را به روز کنید:
      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. ماشین آلات 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. ماشین آلات 10 ، 11 در مرکز داده 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. به روزرسانی اجزای لبه:
      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. UI جدید ( ue ) یا UI کلاسیک ( 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. (If you installed apigee-adminapi ) Updated the apigee-adminapi utility:
      1. Machine 1 in Data Center 1:

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

      2. Machine 7 in Data Center 2:

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

   8. (If you installed Apigee SSO) Update Apigee SSO:
      1. Machine 1 in Data Center 1:

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

      2. Machine 7 in Data Center 2:

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

      Where sso_config_file is the configuration file you created when you installed SSO .

   9. Restart the new Edge UI ( edge-management-ui ) or classic Edge UI ( edge-ui ) component on machines 1 and 7:

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

   For a non-standard configuration

   If you have a non-standard configuration, then update Edge components in the following order:

   1. باغ وحش
   2. کاساندرا
   3. qpidd, ps
   4. LDAP
   5. Edge, meaning the "-c edge" profile on all nodes in the order: nodes with Qpid server, Edge Postgres Server, Management Server, Message Processor, and Router.
   6. Edge UI (either classic or new)
   7. apigee-adminapi
   8. Apigee SSO

   After you finish updating, be sure to restart the Edge UI component on all machines running it.