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

این بخش نحوه ارتقا دادن از Apigee Edge نسخه ۴.۱۹.۰۶ یا ۴.۵۰.۰۰ به نسخه ۴.۵۱.۰۰ را شرح می‌دهد.

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

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

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

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

باید همه مؤلفه‌های 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 تبدیل می‌شود. Therefore, when you install the new Postgres standby node, it should be on a node that meets all the hardware requirements of a Postgres server, as defined in the Edge Installation requirements.

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

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

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

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

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

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

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

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

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

  2. بازراه‌اندازی apigee-postgresql در Postgres master: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf در گره اصلی، بررسی کنید که گره آماده‌به‌کار جدید اضافه شده باشد. باید خطوط زیر را در آن فایل ببینید: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. سرور آماده‌به‌کار Postgres جدید را نصب کنید:
    1. فایل پیکربندی را که برای نصب نسخه فعلی Edge استفاده کرده‌اید ویرایش کنید تا موارد زیر را مشخص کنید: 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. SELinux را طبق توضیحات نصب ابزار کمکی apigee-setup در Edge غیرفعال کنید.
    3. بسته به اینکه از کدام نسخه Edge ارتقا می‌دهید، یکی از کارهای زیر را انجام دهید:
      • اگر از 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 نسخه ۴.۵۰.۰۰ ارتقا می‌دهید، فایل 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. فرمان راه‌اندازی را در میزبان اصلی اجرا کنید: 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. فرمان پیکربندی را در میزبان اصلی اجرا کنید: 
    apigee-service apigee-postgresql configure
  4. میزبان اصلی را بازراه‌اندازی کنید: 
    apigee-service apigee-postgresql restart
  5. آن را به‌عنوان اصلی پیکربندی کنید: 
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. مطمئن شوید میزبان اصلی شروع کرده باشد: 
    apigee-service apigee-postgresql wait_for_ready
  7. توقف حالت آماده‌به‌کار: 
    apigee-service apigee-postgresql stop
  8. حالت آماده‌به‌کار را ارتقا دهید.

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

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

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

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

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

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

    اگر Postgres درحال اجرا نیست، آن را شروع کنید: 

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

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

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

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

قبل‌از ارتقا دادن Apigee Edge، پیش‌نیازهای زیر را رعایت کنید:

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

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

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

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

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

نصب Edge UI

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

کلید ارتقا بدون زمان خرابی این است که هر «رهیاب» را، یکی یکی، از متعادل‌کننده بار بردارید. سپس «رهیاب» و هر مؤلفه دیگری را در همان دستگاهی که «رهیاب» قرار دارد به‌روزرسانی می‌کنید، و سپس «رهیاب» را دوباره به متعادل‌کننده بار اضافه می‌کنید.

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

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

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

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

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

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

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

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

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

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

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

    مکان:

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

    می‌توانید update.sh را با تنظیم component روی «همه» برای همه مؤلفه‌ها اجرا کنید، اما فقط درصورتی‌که نمایه نصب Edge همه‌کاره (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. به‌روزرسانی را با اجرای ابزار کمکی apigee-validate در «سرور مدیریت» آزمایش کنید، همان‌طور که در آزمایش نصب شرح داده شده است.

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

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

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

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

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

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

  1. مخزن محلی 4.51.00 را طبق توضیحات «ایجاد مخزن Apigee محلی» در نصب ابزار کمکی apigee-setup در Edge ایجاد کنید.
  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 از حالت tar خارج کنید: 
      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» در نصب ابزار کمکی apigee-setup در Edge شرح داده شده است پیکربندی کنید.
    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) گره مخزن است.

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

    می‌توانید update.sh را با تنظیم component روی «همه» برای همه مؤلفه‌ها اجرا کنید، اما فقط درصورتی‌که نمایه نصب Edge همه‌کاره (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 در «سرور مدیریت» آزمایش کنید، همان‌طور که در آزمایش نصب شرح داده شده است.

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

ترتیب به‌روزرسانی ماشین

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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