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

این بخش نحوه ارتقا از Apigee Edge 4.19.06 یا 4.50.00 به 4.51.00 را توضیح می دهد.

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

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

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

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

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

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

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

ارتقاء لازم به Postgres 10.17

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

اکثر سیستم های تولید 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.19.06 یا 4.50.00) نصب کرده اید، نه برای نسخه 4.51.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 ارتقا می دهید، یکی از موارد زیر را انجام دهید:
      • اگر در حال ارتقا از Edge 4.19.06 هستید، فایل Edge bootstrap_4.19.06.sh را به /tmp/bootstrap_4.19.06.sh : 
        curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
        دانلود کنید.

        در مرحله بعد، ابزار Edge apigee-service و وابستگی ها را نصب کنید: 

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
      • اگر در حال ارتقا از Edge 4.50.00 هستید، فایل 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

        بعد، ابزار 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 10.17، مراحل زیر را انجام دهید:

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

    /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

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

از کار انداختن یک گره 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

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

قبل از ارتقاء Apigee Edge به پیش نیازهای زیر توجه کنید:

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

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

  • مطمئن شوید که Edge در حال اجرا است
    با استفاده از دستور: 
    /opt/apigee/apigee-service/bin/apigee-all status
    اطمینان حاصل کنید که Edge در طول فرآیند به‌روزرسانی فعال است

رابط کاربری جدید Edge

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

رابط کاربری Edge را نصب کنید

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

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

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

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

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

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

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

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

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

اگر برای خرابی لازم است که به‌روزرسانی را به نسخه قبلی خود برگردانید، برای دستورالعمل‌های دقیق به بازگشت به نسخه 4.51.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. به‌روزرسانی را برای دستگاه‌های باقی‌مانده در نصب خود ادامه دهید.

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

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

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

به روز رسانی به 4.51.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 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
  8. ابزار و وابستگی های Edge 4.51.00 apigee-service با اجرای دستور زیر نصب کنید: 
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

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

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

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

    • I : OpenJDK 1.8 (پیش‌فرض) را نصب کنید.
    • C : بدون نصب جاوا ادامه دهید.
    • Q : ترک برای این گزینه باید خود جاوا را نصب کنید.
  9. همانطور که مثال زیر نشان می دهد، از apigee-service برای به روز رسانی ابزار apigee-setup استفاده کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  10. همانطور که مثال زیر نشان می دهد، ابزار apigee-validate را در سرور مدیریت به روز کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  11. همانطور که مثال زیر نشان می دهد، ابزار apigee-provision را در سرور مدیریت به روز کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  12. با اجرای دستور زیر برنامه 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.19.06 یا 4.50.00 استفاده کردید.

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

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  13. اگر قبلاً این کار را نکرده‌اید، مؤلفه Edge UI را در تمام گره‌هایی که آن را اجرا می‌کنند، مجدداً راه‌اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  14. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.

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

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

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

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

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

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

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

      این دستور یک دایرکتوری جدید به نام repos در دایرکتوری حاوی فایل tar ایجاد می کند. به عنوان مثال /tmp/repos .

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

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

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

      که در آن uName:pWord نام کاربری و رمز عبوری است که قبلاً برای مخزن تنظیم کرده‌اید و remoteRepo آدرس IP یا نام DNS گره repo است.

    3. در گره راه دور، ابزار Edge apigee-setup و وابستگی ها را نصب کنید: 
      sudo bash /tmp/bootstrap_4.51.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.19.06 یا 4.50.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. اگر قبلاً این کار را نکرده‌اید، مؤلفه‌های رابط کاربری را در تمام گره‌هایی که آن را اجرا می‌کنند، مجدداً راه‌اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.

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

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

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

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

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

برای ارتقاء یک پیکربندی مستقل 1 گره به 4.51.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 UI: اگر رابط کاربری 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 UI جدید را نصب کرده اید، سپس مولفه 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 UI جدید را نصب کرده اید، سپس مولفه 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: اگر رابط کاربری Edge جدید را نصب کرده‌اید، مؤلفه 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

      3. جایی که 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. Edge، به معنای نمایه "-c edge" در تمام گره ها به ترتیب: گره های دارای سرور Qpid، سرور Edge Postgres، سرور مدیریت، پردازشگر پیام و روتر.
  6. رابط کاربری Edge (کلاسیک یا جدید)
  7. apigee-adminapi
  8. Apigee SSO

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