به‌روزرسانی Apigee Edge 4.52.02 به 4.53.00

‫Apigee از ارتقا دادن Edge for Private Cloud مستقیماً از نسخه 4.52.02 به نسخه 4.53.00 پشتیبانی می‌کند. این صفحه نحوه انجام چنین ارتقاهایی را توضیح می‌دهد.

برای نمای کلی مسیرهای ارتقای سازگار، ماتریس سازگاری ارتقا برای نسخه‌های Edge for Private Cloud را ببینید.

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

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

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

کدام عناصر را باید به‌روز کنید

باید همه عناصر Edge را به‌روز کنید. ‫Edge از تنظیماتی که شامل عناصر چند نسخه باشد پشتیبانی نمی‌کند.

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

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

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

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

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

    اگر قبلاً از نسخه قدیمی‌تر Edge for Private Cloud به نسخه ۴.۵۲.۰۲ ارتقا داده‌اید و اکنون قصد دارید به نسخه ۴.۵۳.۰۰ ارتقا دهید، مطمئن شوید مراحل پس‌از ارتقای لازم برای Cassandra را تکمیل کرده‌اید. این مراحل در مستندات ارتقا به نسخه ۴.۵۲.۰۲ شرح داده شده است و همچنین در بخش پیش‌نیازهای ارتقا Cassandra ذکر شده است. اگر مطمئن نیستید که این مراحل درطول ارتقای قبلی تکمیل شده‌اند یا نه، قبل‌از ادامه ارتقا به نسخه ۴.۵۳.۰۰، آن‌ها را دوباره تکمیل کنید.

  • پیکربندی کلیدها و گواهینامه‌های IDP در Edge برای «ابر خصوصی» نسخه ۴.۵۳.۰۰

    در Edge for Private Cloud نسخه ۴.۵۳.۰۰، کلیدها و گواهینامه‌های IDP که در عنصر apigee-sso استفاده می‌شوند اکنون ازطریق محل ذخیره کلید پیکربندی می‌شوند. باید کلید و گواهینامه‌ای را که قبلاً استفاده کرده‌اید به یک انبار کلید صادر کنید. قبل‌از به‌روزرسانی کردن عنصر SSO، مراحل بخش مراحل به‌روزرسانی Apigee SSO از نسخه‌های قدیمی‌تر را برای مراحل دقیق دنبال کنید.

  • الزامات Python
    قبل‌از تلاش برای ارتقا، مطمئن شوید که همه گره‌ها، ازجمله گره‌های Cassandra، دارای Python 3 نصب‌شده هستند.

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

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

ارتقا Nginx 1.26 در Edge-Router

ارتقا دادن به Edge for Private Cloud 4.53.00 از نسخه‌های قبلی، نرم‌افزار Nginx را به‌طور خودکار به جدیدترین نسخه (1.26.x) ارتقا نمی‌دهد. این کار برای جلوگیری از هرگونه اثر جانبی تصادفی زمان اجرا در نتیجه تغییرات مستندشده در تغییرات Nginx 1.26 در Apigee Edge 4.53.00 انجام می‌شود. پس‌از درستی‌سنجی در محیط‌های پایین‌تر، می‌توانید Nginx را به‌صورت دستی از نسخه 1.20.x به 1.26.x ارتقا دهید. برای ارتقا دادن دستی:

  1. مطمئن شوید گره روتر لبه جدیدترین نرم‌افزار 4.53.00 را داشته باشد

    /opt/apigee/apigee-service/bin/apigee-service edge-router version

  2. نسخه Nginx را که درحال‌حاضر اجرا می‌کنید بررسی و درستی‌سنجی کنید

    /opt/nginx/sbin/nginx -V

    اگر از نسخه قدیمی‌تری از Nginx استفاده می‌کنید، می‌توانید مراحل زیر را برای ارتقا دادن Nginx به نسخه 1.26.X در گره مسیریاب دنبال کنید.

  3. فرایند رهیاب لبه را در گره رهیاب متوقف کنید

    /opt/apigee/apigee-service/bin/apigee-service edge-router stop

  4. ارتقا دادن نرم‌افزار nginx در گره مسیریاب

    dnf update apigee-nginx-1.26.3

  5. تأیید کنید که نسخه Nginx به‌روز شده است

    /opt/nginx/sbin/nginx -V

  6. فرایند رهیاب را در گره شروع کنید

    /opt/apigee/apigee-service/bin/apigee-service edge-router start

  7. این فرایند را برای هر گره مسیریاب، یکی‌یکی، تکرار کنید

ارتقا به Cassandra 4.0.13 الزامی است

‫Apigee Edge for Private Cloud 4.53.00 شامل ارتقا Cassandra به نسخه 4.0.13 است.

ارتقا و برگرداندن

  • ارتقا از Cassandra 3.11.X به Cassandra 4.0.X فرایندی روان است. ‫Cassandra 4.0.X که با Edge for Private Cloud 4.53.00 منتشر شده است با اجزای زمان اجرا و مدیریت Private Cloud 4.52.02 سازگار است.
  • برگرداندن مستقیم درجا از Cassandra 4.0.X به 3.11.X امکان‌پذیر نیست. برگرداندن بااستفاده از رونوشت‌ها یا پشتیبان‌گیری‌ها فرایندی پیچیده است و ممکن است شامل زمان ازکارافتادگی و/یا ازدست رفتن داده‌ها باشد. عیب‌یابی کردن مشکلات و ارتقا به Cassandra 4.0.X بهتر از بازگشت به نسخه قبلی است.
  • مهم است که قبل‌از تلاش برای ارتقا، با روش‌های برگرداندن آشنا شوید. توجه به تفاوت‌های ظریف برگرداندن درطول ارتقا برای اطمینان از دردسترس بودن مسیرهای برگرداندن مناسب بسیار مهم است.

مرکز داده تکی

ارتقا دادن Cassandra از نسخه 3.11.X به 4.0.X در یک مرکز داده واحد یکپارچه است، اما برگرداندن پیچیده است و ممکن است منجر به زمان ازکارافتادگی و ازدست رفتن داده‌ها شود. برای حجم‌های کاری تولید، اکیداً توصیه می‌شود که قبل‌از شروع ارتقا، مرکز داده جدیدی اضافه کنید که حداقل گره‌های Cassandra در مرکز داده جدید دردسترس باشد. این کار امکان برگرداندن Cassandra را بدون ازدست رفتن داده‌ها یا اختلال در ترافیک API شما فراهم می‌کند. پس‌از تکمیل ارتقا یا رسیدن به «ایست بازرسی ۲»، این مرکز داده اضافی می‌تواند ازکار انداخته شود.

اگر افزودن مرکز داده جدید امکان‌پذیر نیست اما قابلیت برگرداندن همچنان موردنظر است، برای بازیابی Cassandra 3.11.X، پشتیبان‌گیری ضروری خواهد بود. بااین‌حال، این روش احتمالاً هم شامل زمان توقف و هم ازدست رفتن داده‌ها می‌شود.

چندین مرکز داده

اجرای چندین مرکز داده با Edge for Private Cloud 4.52.02 انعطاف‌پذیری بیشتری برای بازگرداندن به نسخه قبلی درطول ارتقا به Edge for Private Cloud 4.53.00 ارائه می‌دهد.

  • بازگرداندن به نسخه قبلی به داشتن حداقل یک مرکز داده که نسخه قدیمی‌تر Cassandra (3.11.X) را اجرا می‌کند بستگی دارد.
  • اگر کل خوشه Cassandra شما به نسخه 4.0.X ارتقا یافته است، نباید به Cassandra 3.11.X برگردید. باید به استفاده از نسخه جدیدتر Cassandra با دیگر عناصر Private Cloud 4.53.00 یا 4.52.02 ادامه دهید.
  1. ارتقا دادن یک مرکز داده Cassandra در هر بار: با ارتقا دادن گره‌های Cassandra به‌صورت جداگانه در یک مرکز داده شروع کنید. پیش‌از رفتن به مرکز داده بعدی، ارتقای همه گره‌های Cassandra را در یک مرکز داده تکمیل کنید.
  2. توقف موقت و اعتبارسنجی: پس‌از ارتقا دادن یک مرکز داده، موقتاً متوقف کنید تا مطمئن شوید خوشه «ابر خصوصی» شما، به‌ویژه مرکز داده ارتقایافته، به‌درستی کار می‌کند.
  3. به‌یاد داشته باشید: فقط درصورتی می‌توانید به نسخه قبلی Cassandra برگردید که حداقل یک مرکز داده داشته باشید که هنوز نسخه قدیمی‌تر را اجرا می‌کند.
  4. حساس به زمان: اگرچه می‌توانید برای مدت کوتاهی (توصیه می‌شود چند ساعت) برای اعتبارسنجی عملکرد موقتاً متوقف کنید، نمی‌توانید برای همیشه در وضعیت نسخه ترکیبی باقی بمانید. دلیل این امر این است که خوشه Cassandra غیریکنواخت (با گره‌هایی در نسخه‌های مختلف) محدودیت‌های عملیاتی دارد.
  5. آزمایش کامل: Apigee اکیداً توصیه می‌کند قبل‌از ارتقا دادن مرکز داده بعدی، عملکرد و کارایی را به‌طور جامع آزمایش کنید. پس‌از ارتقا یافتن همه مراکز داده، بازگرداندن به نسخه قبلی غیرممکن است.
برگرداندن به‌عنوان فرایند دو ایست‌بازرسی
  1. ایست بازرسی ۱: وضعیت اولیه، با همه عناصر در نسخه ۴.۵۲.۰۲. تا زمانی که حداقل یک مرکز داده Cassandra در نسخه قدیمی‌تر باقی بماند، بازگرداندن کامل امکان‌پذیر است.
  2. ایست بازرسی ۲: پس‌از به‌روزرسانی همه گره‌های Cassandra در همه مراکز داده. می‌توانید به این وضعیت عقب‌گرد کنید، اما نمی‌توانید به «ایست بازرسی ۱» برگردید.
مثال

خوشه دو مرکز داده (DC) را درنظر بگیرید:

  1. وضعیت شروع: گره‌های Cassandra در هر دو مرکز داده در نسخه 3.11.X هستند. همه گره‌های دیگر در Edge برای نسخه 4.52.02 «ابر خصوصی» هستند. فرض کنید سه گره Cassandra در هر DC وجود دارد.
  2. ارتقا DC-1: سه گره Cassandra در DC-1 را یکی‌یکی ارتقا دهید.
  3. توقف موقت و اعتبارسنجی: برای اطمینان از اینکه خوشه، به‌ویژه DC-1، به‌درستی کار می‌کند، موقتاً متوقف کنید (عملکرد و کارایی را بررسی کنید). بااستفاده از گره‌های Cassandra در DC-2 می‌توانید به وضعیت اولیه برگردید. به‌خاطر داشته باشید که این توقف موقت باید به‌دلیل محدودیت‌های خوشه Cassandra با نسخه ترکیبی باشد.
  4. ارتقا DC-2: سه گره Cassandra باقی‌مانده در DC-2 را ارتقا دهید. این نقطه بازگشت جدید شما می‌شود.
  5. ارتقا دادن دیگر عناصر: گره‌های مدیریت، زمان اجرا، و تجزیه‌وتحلیل را طبق معمول در همه مراکز داده، یک گره و یک مرکز داده در هر زمان، ارتقا دهید. اگر مشکلی پیش آمد، می‌توانید به وضعیت مرحله ۴ برگردید.

پیش‌نیازهای ارتقا Cassandra

باید Cassandra 3.11.16 را با Edge for Private Cloud 4.52.02 اجرا کنید و از موارد زیر مطمئن شوید:
  1. کل خوشه با Cassandra 3.11.16 عملیاتی و کاملاً کارآمد است.
  2. استراتژی فشرده‌سازی روی LeveledCompactionStrategy تنظیم شده است (پیش‌نیاز ارتقا به نسخه ۴.۵۲.۰۲).
  3. مطمئن شوید که همه مراحل زیر به‌عنوان بخشی از ارتقای اولیه Cassandra 3.11 در Edge برای «ابر خصوصی» نسخه 4.52.02 تکمیل شده است:
    • فرمان post_upgrade باید درطول ارتقای قبلی در هر گره Cassandra اجرا شده باشد.
    • فرمان drop_old_tables باید درطول ارتقای قبلی روی کل خوشه Cassandra اجرا شده باشد.

اگر مطمئن نیستید که مراحل قبلی تکمیل شده است یا نه، می‌توانید آن‌ها را دوباره اجرا کنید. مطمئن شوید که این مراحل در Cassandra 3.11 اجرا می‌شوند درحالی‌که هنوز از Edge for Private Cloud 4.52.02 استفاده می‌کنید، قبل‌از اینکه ارتقا به 4.53.00 انجام شود:

  1. فرمان post_upgrade زیر را روی هر گره Cassandra یکی‌یکی اجرا کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
  2. فرمان زیر را اجرا کنید تا جدول‌های قدیمی و استفاده‌نشده از خوشه Cassandra حذف شود. این فرمان فقط باید در ۱ گره در خوشه اجرا شود: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

مرحله ۱: آماده شدن برای ارتقا

مراحل زیر علاوه‌بر فایل‌های استانداردی است که معمولاً ایجاد می‌کنید، مثل فایل پیکربندی استاندارد Apigee برای فعال کردن ارتقاهای مؤلفه.

  1. بااستفاده از Apigee از Cassandra پشتیبان‌گیری کنید.
  2. از گره‌های Cassandra عکس‌های فوری ماشین مجازی بگیرید (درصورت امکان).
  3. اگر قبلاً پیکربندی نشده است، مطمئن شوید که درگاه ۹۰۴۲ از همه عناصر Edge for Private Cloud، ازجمله «سرور مدیریت»، «پردازشگر پیام»، «مسیریاب»، Qpid، و Postgres، به گره‌های Cassandra قابل‌دسترسی باشد. برای اطلاعات بیشتر، به الزامات درگاه مراجعه کنید.

مرحله ۲: ارتقا دادن همه گره‌های Cassandra

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

پس‌از ارتقا دادن همه گره‌های Cassandra در مرکز داده، قبل‌از ادامه دادن با گره‌های مرکز داده بعدی، مدتی (۳۰ دقیقه تا چند ساعت) صبر کنید. در این مدت، مرکز داده‌ای را که به‌روز شده است به‌طور کامل بررسی کنید و مطمئن شوید که سنجه‌های عملکرد و کارکرد خوشه Apigee شما دست‌نخورده است. این مرحله برای اطمینان از پایداری مرکز داده‌ای که در آن Cassandra به نسخه 4.0.X ارتقا یافته است بسیار مهم است، درحالی‌که بقیه عناصر Apigee در نسخه 4.52.02 باقی می‌مانند.

  1. برای ارتقا دادن گره Cassandra، فرمان زیر را اجرا کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. پس‌از به‌روزرسانی گره، فرمان زیر را در گره اجرا کنید تا قبل‌از ادامه دادن، چند اعتبارسنجی انجام شود: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. مورد بالا چیزی شبیه به این برونداد خواهد داشت: 
    Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.13 | CQL spec 3.4.5 | Native protocol v5] 
Metadata is verified
  4. فرمان post_upgrade زیر را در گره Cassandra اجرا کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
  5. فرمان‌های nodetool زیر را اجرا کنید تا شاخص‌ها را بازسازی کنید در گره Cassandra: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index
     اگر از درآمدزایی استفاده می‌کنید، فرمان‌های بازسازی نمایه‌های زیر را نیز که مربوط به فضاهای کلید درآمدزایی است اجرا کنید: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx

مرحله ۳: ارتقا دادن همه گره‌های «مدیریت»

همه گره‌های «مدیریت» را در همه مناطق یکی‌یکی ارتقا دهید:

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

مرحله ۴: ارتقا دادن همه گره‌های «زمان اجرا»

همه گره‌های «پردازشگر پیام» و «مسیریاب» را در همه مناطق یکی‌یکی ارتقا دهید:

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

مرحله ۵: ارتقا دادن همه مؤلفه‌های باقی‌مانده Edge for Private Cloud نسخه ۴.۵۳.۰۰

همه گره‌های edge-qpid-server و edge-postgres-server باقی‌مانده را در همه مناطق یکی‌یکی ارتقا دهید.

مراحل به‌روزرسانی Apigee SSO از نسخه‌های قدیمی‌تر

در Edge for Private Cloud نسخه ۴.۵۳.۰۰، کلیدها و گواهینامه‌های IDP که در عنصر apigee-sso استفاده می‌شوند اکنون ازطریق محل ذخیره کلید پیکربندی می‌شوند. باید کلید و گواهی‌ای را که قبلاً استفاده می‌کردید به یک keystore صادر کنید، آن را پیکربندی کنید، و سپس به‌طور معمول به‌روزرسانی SSO را انجام دهید.

  1. کلید و گواهینامه موجود مورداستفاده برای پیکربندی IDP را شناسایی کنید:

    1. با جستجوی مقدار SSO_SAML_SERVICE_PROVIDER_CERTIFICATE در فایل پیکربندی نصب «ورود به سیستم با یک حساب کاربری» یا با پُرسمان کردن عنصر apigee-sso برای conf_login_service_provider_certificate، گواهینامه را بازیابی کنید.

      از فرمان زیر در گره SSO برای پُرسمان apigee-sso برای مسیر گواهی IDP استفاده کنید. در برونداد، مقدار را در خط آخر پیدا کنید. 

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

    2. با جستجوی مقدار SSO_SAML_SERVICE_PROVIDER_KEY در فایل پیکربندی نصب «شناسایی یگانه» یا با پُرسمان کردن عنصر apigee-sso برای conf_login_service_provider_key، کلید را بازیابی کنید.

      از فرمان زیر در گره SSO برای پُرسمان apigee-sso برای مسیر کلید IDP استفاده کنید. در برونداد، مقدار را در خط آخر پیدا کنید.

      apigee-service apigee-sso configure -search conf_login_service_provider_key
  2. کلید و گواهینامه را به یک انبار کلید صادر کنید:
    1. کلید و گواهی را به یک انبار کلید PKCS12 صادر کنید: 
      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      پارامترها:

      • certificate_path: مسیر فایل گواهینامه بازیابی‌شده در مرحله ۱.الف.
      • ‫key_path: مسیر فایل کلید خصوصی که در «مرحله ۱.ب» بازیابی شده است.
      • ‫keystore_path: مسیر به انبار کلید جدیداً ایجادشده که حاوی گواهی و کلید خصوصی است.
      • ‫alias: نام مستعار استفاده‌شده برای جفت کلید و گواهی در انبار کلید.

      برای جزئیات بیشتر، به اسناد OpenSSL مراجعه کنید.

    2. (اختیاری) کلید و گواهینامه را از PKCS12 به انبار کلید JKS صادر کنید: 
      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      پارامترها:

      • PKCS12_keystore_path: مسیر انبار کلید PKCS12 که در مرحله ۲.الف ایجاد شده است و حاوی گواهی و کلید است.
      • ‫destination_keystore_path: مسیر به انبار کلید JKS جدید که گواهینامه و کلید در آن صادر خواهد شد.
      • ‫alias: نام مستعار استفاده‌شده برای جفت کلید و گواهی در انبار کلید JKS.

      3. برای جزئیات بیشتر به اسناد keytool مراجعه کنید.

  3. مالک فایل keystore برونداد را به کاربر «apigee» تغییر دهید: 
    sudo chown apigee:apigee <keystore_file>
  4. ویژگی‌های زیر را در فایل پیکربندی Apigee SSO اضافه کنید و آن‌ها را با مسیر فایل انبار کلید، گذرواژه، نوع انبار کلید، و نام مستعار به‌روز کنید: 
    # Path to the keystore file
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks

# Keystore password
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore

# Keystore type
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12

# Alias within keystore that stores the key and certificate
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert
  5. نرم‌افزار Apigee SSO را در گره SSO طبق معمول بااستفاده از فرمان زیر به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

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

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

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

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

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

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

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

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

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

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

اگر این خرابی باعث می‌شود که به‌روزرسانی را به نسخه قبلی برگردانید، برای دریافت دستورالعمل‌های دقیق، به برگرداندن به نسخه ۴.۵۳.۰۰ مراجعه کنید.

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

به‌طور پیش‌فرض، ابزار 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 «پردازشگر پیام» و «مسیریاب» را در یک گره نشان می‌دهند.
  4. «رهیاب» را دوباره دردسترس قرار دهید.
  5. مراحل ۲ تا ۴ را برای «مسیریاب‌های» باقی‌مانده تکرار کنید.
  6. به‌روزرسانی را برای همه ماشین‌های باقیمانده در نصب ادامه دهید.

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

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

باید فایل پیکربندی بی‌صدایی را به فرمان به‌روزرسانی ارسال کنید. فایل پیکربندی بی‌صدا باید همان فایلی باشد که برای نصب Edge for Private Cloud 4.52.02 استفاده کرده‌اید.

به ۴.۵۳.۰۰ در گرهی با اتصال اینترنت خارجی به‌روزرسانی کنید

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

  1. درصورت وجود، همه کارهای cron را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده‌اند تا پس‌از تکمیل به‌روزرسانی غیرفعال کنید.
  2. برای نصب کردن Edge RPM، به‌عنوان ریشه به سیستم گره‌تان وارد شوید.
  3. ‫SELinux را طبق آنچه در نصب ابزار کمکی apigee-setup در Edge توضیح داده شده است غیرفعال کنید.
  4. اگر درحال نصب در 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

  5. اگر درحال‌حاضر از Edge 4.52.02 استفاده می‌کنید:

    1. فایل Edge bootstrap_4.53.00.sh را در /tmp/bootstrap_4.53.00.sh بارگیری کنید: 
      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
    2. با اجرای فرمان زیر، ابزار و وابستگی‌های Edge 4.53.00 apigee-service را نصب کنید: 
      sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

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

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

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

      • ‫I: نصب OpenJDK 1.8 (پیش‌فرض).
      • ‫C: بدون نصب Java ادامه دهید.
      • ‫Q: رها کردن. برای این گزینه، باید خودتان Java را نصب کنید.
    3. از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید، همان‌طور که در مثال زیر نشان داده شده است: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. برنامه کمکی apigee-validate را در «سرور مدیریت» به‌روزرسانی کنید، همان‌طور که در مثال زیر نشان داده شده است: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. برنامه کمکی apigee-provision را در «سرور مدیریت» به‌روزرسانی کنید، همان‌طور که در مثال زیر نشان داده شده است: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. با اجرای فرمان زیر، ابزار update را در گره‌هایتان اجرا کنید: 
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

      مکان:

      • ‫component جزء Edge برای به‌روزرسانی است. مقادیر ممکن شامل موارد زیر است:
        • ‫cs: Cassandra
        • ‫edge: همه عناصر Edge به‌جز «میانای کاربر Edge»: «سرور مدیریت»، «پردازشگر پیام»، «مسیریاب»، «سرور QPID»، «سرور Postgres»
        • ‫ldap: ال‌دپ باز
        • ‫ps: postgresql
        • qpid: qpidd
        • sso: Apigee SSO (اگر SSO را نصب کرده‌اید)
        • ‫ue: میانای کاربر جدید Edge
        • ‫ui: میانای کاربر کلاسیک Edge
        • ‫zk: Zookeeper
      • ‫configFile همان فایل پیکربندی است که برای تعریف کردن عناصر Edge درطول نصب نسخه 4.52.02 استفاده کردید.

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

      /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 در «سرور مدیریت» همان‌طور که در آزمایش نصب توضیح داده شده است آزمایش کنید.

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

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

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

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

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

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

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

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

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

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

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

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

    3. در گره از دور، ابزار apigee-setup Edge و وابستگی‌ها را نصب کنید: 
      sudo bash /tmp/bootstrap_4.53.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»: «سرور مدیریت»، «پردازشگر پیام»، «مسیریاب»، «سرور QPID»، «سرور Postgres»
      • ‫ldap: ال‌دپ باز
      • ‫ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (اگر SSO را نصب کرده‌اید)
      • ue میانای کاربر جدید Edge
      • ‫ui: میانای کاربر کلاسیک Edge
      • ‫zk: Zookeeper
    • ‫configFile همان فایل پیکربندی است که برای تعریف کردن عناصر Edge درطول نصب نسخه 4.50.00 یا 4.51.00 استفاده کردید.

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

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. اگر قبلاً این کار را نکرده‌اید، مؤلفه‌های واسط کاربر را در همه گره‌هایی که آن را اجرا می‌کنند بازراه‌اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. به‌روزرسانی را با اجرای ابزار apigee-validate در «سرور مدیریت» همان‌طور که در آزمایش نصب توضیح داده شده است آزمایش کنید.

اگر بعداً تصمیم گرفتید به‌روزرسانی را برگردانید، از روش شرح‌داده‌شده در برگرداندن 4.53.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. به‌روزرسانی Postgres در ماشین ۲: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. به‌روزرسانی LDAP در ماشین ۱: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. به‌روزرسانی اجزای Edge در ماشین ۲ و ۱: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. به‌روزرسانی Qpid در «ماشین ۲»: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. به‌روزرسانی کردن واسط کاربر در ماشین ۱: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (اگر apigee-adminapi را نصب کرده باشید) ابزار apigee-adminapi در ماشین ۱ به‌روز شد: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (اگر Apigee SSO را نصب کرده‌اید) Apigee SSO را در ماشین ۱ به‌روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  9. بازراه‌اندازی مؤلفه Edge UI در ماشین ۱: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقا ۵ گره

برای نصب ۵ گره، اجزای زیر را به‌روز کنید:

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

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

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

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

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

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

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

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

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

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

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

برای نصب خوشه‌ای ۱۳ گره‌ای، اجزای زیر را به‌روز کنید:

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

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

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

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

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

برای نصب خوشه‌ای ۱۲ گره‌ای، اجزای زیر را به‌روز کنید:

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

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

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

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

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

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

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

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