Apigee Edge 4.52.02 را به 4.53.00 به روز کنید

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

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

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

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

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

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

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

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

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

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

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

  • مطمئن شوید که Edge در حال اجرا است
    با استفاده از دستور زیر مطمئن شوید که Edge در طول فرآیند به‌روزرسانی فعال است: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • پیش نیازهای کاساندرا را تأیید کنید
    اگر قبلاً از نسخه قدیمی Edge برای Private Cloud به نسخه 4.52.02 ارتقا داده اید و اکنون قصد دارید به نسخه 4.53.00 ارتقا دهید، مطمئن شوید که مراحل لازم پس از ارتقا را برای Cassandra انجام داده اید. این مراحل در اسناد ارتقاء نسخه 4.52.02 در زیر مراحل پس از ارتقا آورده شده است. اگر مطمئن نیستید که آیا این مراحل در طول ارتقای قبلی انجام شده است یا خیر، قبل از ادامه ارتقاء به نسخه 4.53.00، دوباره آنها را کامل کنید.
  • پیکربندی کلیدها و گواهی‌های IDP در Edge برای Private Cloud 4.53.00

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

  • الزامات پایتون
    اطمینان حاصل کنید که همه گره ها، از جمله گره های Cassandra، پایتون 3 را قبل از اقدام به ارتقاء نصب کرده اند.

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

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

ارتقاء مورد نیاز به 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 برای 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 موجود در مرکز داده جدید اضافه کنید . این کار باعث می‌شود کاساندرا بدون از دست رفتن داده یا اختلال در ترافیک API شما به عقب برگردد. این مرکز داده اضافی را می توان پس از پایان ارتقا یا رسیدن به Checkpoint 2 از کار انداخت.

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

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

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

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

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

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

پیش نیازهای ارتقاء کاساندرا

شما باید Cassandra 3.11.16 را با Edge برای Private Cloud 4.52.02 اجرا کنید و از موارد زیر اطمینان حاصل کنید:
  • کل خوشه با Cassandra 3.11.16 عملیاتی و کاملاً کاربردی است.
  • استراتژی فشرده سازی روی LeveledCompactionStrategy (پیش نیازی برای ارتقاء به نسخه 4.52.02) تنظیم شده است.
  • تمام مراحل پس از ارتقا از ارتقای اولیه به Cassandra 3.11.16 به عنوان بخشی از ارتقاء 4.52.02 کامل شده است. اگر نه، این مراحل را دوباره اجرا کنید. این فقط در صورتی اعمال می شود که از نسخه قدیمی تر به Private Cloud نسخه 4.52.02 ارتقا دهید.

مرحله 1: برای ارتقاء آماده شوید

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

  1. از کاساندرا با استفاده از Apigee نسخه پشتیبان تهیه کنید.
  2. از گره های کاساندرا (در صورت امکان) عکس های فوری VM بگیرید.
  3. اطمینان حاصل کنید که پورت 9042 از تمام اجزای Edge برای Private Cloud، از جمله مدیریت سرور، پردازشگر پیام، روتر، Qpid و Postgres به گره‌های Cassandra در صورتی که قبلاً پیکربندی نشده‌اند، قابل دسترسی باشد. برای اطلاعات بیشتر به الزامات بندر مراجعه کنید.

مرحله 2: تمام گره های Cassandra را ارتقا دهید

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

پس از ارتقاء تمام گره‌های کاساندرا در مرکز داده، قبل از ادامه کار با گره‌ها در مرکز داده بعدی، مدتی (30 دقیقه تا چند ساعت) صبر کنید. در این مدت، مرکز داده ای که به روز شده است را به طور کامل بررسی کنید و اطمینان حاصل کنید که معیارهای عملکردی و عملکرد خوشه 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

مرحله 3: تمام گره های مدیریت را ارتقا دهید

تمام گره های مدیریت را در همه مناطق یک به یک ارتقا دهید:

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

مرحله 4: تمام گره های Runtime را ارتقا دهید

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

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

مرحله 5: تمام اجزای Edge باقیمانده را برای Private Cloud 4.53.00 ارتقا دهید

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

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

در Edge for Private Cloud 4.53.00، کلیدهای IDP و گواهی‌های مورد استفاده در مؤلفه apigee-sso اکنون از طریق یک فروشگاه کلید پیکربندی می‌شوند. شما باید کلید و گواهی استفاده شده قبلی را به یک فروشگاه کلید صادر کنید، آن را پیکربندی کنید و سپس طبق معمول به‌روزرسانی SSO را ادامه دهید.

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

    1. با جستجوی مقدار SSO_SAML_SERVICE_PROVIDER_CERTIFICATE در فایل پیکربندی نصب SSO یا با پرس و جو از مؤلفه 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 در فایل پیکربندی نصب SSO یا با پرس و جو از مؤلفه 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 : مسیر فایل گواهی بازیابی شده در مرحله 1.a.
      • key_path : مسیر فایل کلید خصوصی بازیابی شده در مرحله 1.b.
      • 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 ایجاد شده در مرحله 2.a، حاوی گواهی و کلید.
      • destination_keystore_path : مسیری به فروشگاه کلید جدید JKS که در آن گواهی و کلید صادر می شود.
      • alias : نام مستعار برای جفت کلید و گواهی در فروشگاه کلید JKS استفاده می شود.

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

  3. مالک فایل keystore خروجی را به کاربر "apigee" تغییر دهید: 
    sudo chown apigee:apigee <keystore_file>
  4. ویژگی های زیر را در فایل پیکربندی Apigee SSO اضافه کنید و آنها را با مسیر فایل keystore، رمز عبور، نوع keystore و نام مستعار به روز کنید: 
    # 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 برای Private Cloud مراجعه کنید.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

      کجا:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

برای ارتقاء یک پیکربندی مستقل 1 گره به 4.53.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. به روز رسانی Postgres در دستگاه 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c 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. به روز رسانی Qpid در ماشین 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. رابط کاربری را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  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. مؤلفه 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. به روز رسانی Postgres در دستگاه 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. به روز رسانی Postgres در دستگاه 5: 
    /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
  5. به روز رسانی اجزای Edge در دستگاه 4، 5، 1، 2، 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. به روز رسانی Qpid در دستگاه 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. به روز رسانی Qpid در دستگاه 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. رابط کاربری Edge را به روز کنید:
    • رابط کاربری کلاسیک: اگر از رابط کاربری کلاسیک استفاده می کنید، همانطور که در مثال زیر نشان می دهد، مؤلفه ui در دستگاه 1 به روز کنید: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • رابط کاربری New Edge: اگر رابط کاربری Edge جدید را نصب کرده‌اید، مؤلفه ue را در دستگاه مناسب به‌روزرسانی کنید (ممکن است دستگاه 1 نباشد): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کردید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

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

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

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

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

  1. Cassandra و ZooKeeper را در دستگاه 1، 2 و 3 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. به روز رسانی Postgres در دستگاه 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. به روز رسانی Postgres در دستگاه 9: 
    /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
  5. اجزای Edge را در دستگاه 6، 7، 8، 9، 1، 4 و 5 به ترتیب به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. به روز رسانی Qpid در ماشین های 6 و 7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. رابط کاربری جدید ( ue ) یا رابط کاربری کلاسیک ( ui ) را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (اگر apigee-adminapi را نصب کرده اید) ابزار apigee-adminapi را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (اگر Apigee SSO را نصب کرده اید) Apigee SSO را در دستگاه 1 به روز کنید:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

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

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

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

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

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

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

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

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

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

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

  1. Cassandra و ZooKeeper را به روز کنید:
    1. در ماشین های 1، 2 و 3 در مرکز داده 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. در ماشین های 7، 8، و 9 در مرکز داده 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. به روز رسانی 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
  3. به روز رسانی 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
  4. به روز رسانی اجزای 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
  5. به روز رسانی 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
  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. ps
  4. LDAP
  5. Edge، به معنای نمایه "-c edge" در تمام گره ها به ترتیب: گره های دارای سرور Qpid، سرور Edge Postgres، سرور مدیریت، پردازشگر پیام و روتر.
  6. qpidd
  7. رابط کاربری Edge (کلاسیک یا جدید)
  8. apigee-adminapi
  9. Apigee SSO

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

،

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

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

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

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

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

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

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

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

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

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

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

  • اطمینان حاصل کنید که لبه در حال اجرا است
    اطمینان حاصل کنید که لبه در طی فرایند به روزرسانی با استفاده از دستور کار کرده و در حال اجرا است: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • پیش نیازهای کاساندرا را تأیید کنید
    اگر قبلاً از نسخه قدیمی Edge for Private Cloud به نسخه 4.52.02 به روز شده اید و اکنون قصد ارتقاء نسخه 4.53.00 را دارید ، مطمئن شوید که مراحل لازم برای به روزرسانی را برای Cassandra انجام داده اید. این مراحل در اسناد ارتقاء نسخه 4.52.02 در مراحل پس از ارتقاء بیان شده است. اگر مطمئن نیستید که آیا این مراحل در طول به روزرسانی قبلی انجام شده است ، قبل از ادامه کار به نسخه 4.53.00 ، دوباره آنها را تکمیل کنید.
  • پیکربندی کلیدها و گواهینامه های IDP برای Cloud Private 4.53.00

    در Edge for Private Cloud 4.53.00 ، کلیدهای IDP و گواهینامه های مورد استفاده در مؤلفه apigee-sso اکنون از طریق یک کلیدی کلیدی پیکربندی شده اند. شما باید کلید و گواهینامه ای را که قبلاً از آن استفاده کرده اید به یک کلیدی کلیدی صادر کنید. برای مراحل دقیق قبل از به روزرسانی مؤلفه SSO ، مراحل به روزرسانی Apigee SSO را از بخش نسخه های قدیمی تر دنبال کنید.

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

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

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

نیاز به ارتقا به Cassandra 4.0.13

Apigee Edge برای Cloud Private 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 منتشر شد ، با اجزای اجرا و مدیریت Cloud Private 4.52.02 سازگار است.
  • بازگشت مستقیم در محل از Cassandra 4.0.x تا 3.11.x امکان پذیر نیست. چرخش با استفاده از ماکت ها یا پشتیبان گیری یک روش پیچیده است و ممکن است شامل خرابی و/یا از دست دادن داده باشد. مشکلات عیب یابی و به روزرسانی به Cassandra 4.0.x از بازگشت به عقب ترجیح داده می شود.
  • مهم است که قبل از تلاش برای به روزرسانی ، خود را با روشهای برگشت پذیر آشنا کنید. با توجه به تفاوت های ظریف بازگشت در هنگام بروزرسانی ، برای اطمینان از در دسترس بودن مسیرهای برگشت پذیر ، بسیار مهم است.

مرکز داده

به روزرسانی کاساندرا از 3.11.x به 4.0.x در یک مرکز داده واحد یکپارچه است ، اما بازگشت مجدد پیچیده است و ممکن است منجر به خرابی و از دست دادن داده ها شود. برای بار کاری تولید ، به شدت توصیه می شود قبل از شروع به روزرسانی ، یک مرکز داده جدید با حداقل گره های کاساندرا موجود در مرکز داده جدید اضافه کنید . این امر باعث می شود تا بدون ایجاد از بین رفتن داده ها یا اختلال در ترافیک API ، بازگرداندن کاساندرا را فعال کند. این مرکز داده اضافی پس از اتمام به روزرسانی یا بازرسی 2 می تواند از بین برود.

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

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

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

  • بازپرداختها به داشتن حداقل یک مرکز داده در حال اجرا نسخه قدیمی کاساندرا (3.11.x) بستگی دارد.
  • اگر کل خوشه کاساندرا شما به 4.0.x ارتقا یافته است ، نباید به کاساندرا 3.11.x برگردید. شما باید با استفاده از نسخه جدید Cassandra با سایر مؤلفه های Cloud Private 4.53.00 یا 4.52.02 استفاده کنید.
  1. یک مرکز داده کاساندرا را در یک زمان ارتقا دهید: با به روزرسانی گره های کاساندرا به صورت جداگانه در یک مرکز داده واحد شروع کنید. ارتقاء تمام گره های کاساندرا را در یک مرکز داده قبل از ادامه کار بعدی انجام دهید.
  2. مکث و اعتبارسنجی: پس از به روزرسانی یک مرکز داده ، مکث برای اطمینان از خوشه ابر خصوصی شما ، به ویژه مرکز داده به روز شده ، به درستی کار می کند.
  3. به یاد داشته باشید: اگر حداقل یک مرکز داده هنوز نسخه قدیمی را اجرا می کنید ، فقط می توانید به نسخه قبلی Cassandra برگردید.
  4. حساس به زمان: در حالی که می توانید برای یک دوره کوتاه مکث کنید (چند ساعت توصیه می شود) برای اعتبارسنجی عملکرد ، شما نمی توانید به طور نامحدود در یک حالت مخلوط مخلوط بمانید. این امر به این دلیل است که یک خوشه غیر یکنواخت کاساندرا (با گره هایی در نسخه های مختلف) محدودیت های عملیاتی دارد.
  5. آزمایش کامل: Apigee قبل از به روزرسانی مرکز داده بعدی ، آزمایش جامع عملکرد و عملکرد را به شدت توصیه می کند. پس از به روزرسانی تمام مراکز داده ، بازگشت به نسخه قبلی غیرممکن است.
بازگشت به عنوان یک فرآیند دو چک
  1. ایست بازرسی 1: حالت اولیه ، با تمام مؤلفه های نسخه 4.52.02. بازپرداخت کامل تا زمانی که حداقل یک مرکز داده کاساندرا در نسخه قدیمی باقی بماند امکان پذیر است.
  2. پاسگاه 2: پس از به روزرسانی تمام گره های کاساندرا در کلیه مراکز داده. می توانید به این حالت برگردید ، اما نمی توانید به پاسگاه 1 برگردید.
مثال

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

  1. حالت شروع: گره های کاساندرا در هر دو DC در نسخه 3.11.x قرار دارند. تمام گره های دیگر برای Cloud Private نسخه 4.52.02 در لبه هستند. سه گره کاساندرا را در هر DC فرض کنید.
  2. ارتقاء DC-1: سه گره کاساندرا را در DC-1 یک به یک ارتقا دهید.
  3. مکث و اعتبارسنجی: مکث برای اطمینان از خوشه ، به ویژه DC-1 ، به درستی کار می کند (عملکرد ، عملکرد را بررسی کنید). می توانید با استفاده از گره های کاساندرا در DC-2 به حالت اولیه برگردید. به یاد داشته باشید ، این مکث باید به دلیل محدودیت یک خوشه مخلوط کاساندرا ، موقتی باشد.
  4. ارتقاء DC-2: سه گره کاساندرا باقیمانده را در DC-2 ارتقا دهید. این به ایست بازرسی جدید بازپرداخت شما می شود.
  5. سایر مؤلفه ها را ارتقا دهید: مدیریت ارتقاء ، زمان اجرا و گره های تحلیلی طبق معمول در تمام مراکز داده ، یک گره و یک مرکز داده به طور همزمان. در صورت بروز مشکلات ، می توانید به حالت مرحله 4 برگردید.

پیش نیازهای ارتقاء کاساندرا

شما باید Cassandra 3.11.16 را با Edge برای Cloud Private 4.52.02 اجرا کنید و موارد زیر را تضمین کنید:
  • کل خوشه با کاساندرا 3.11.16 عملیاتی و کاملاً کاربردی است.
  • استراتژی تراکم تنظیم شده است تا به صورت LeveledCompactionStrategy (پیش نیاز برای به روزرسانی به نسخه 4.52.02).
  • تمام مراحل پس از به روزرسانی از به روزرسانی اولیه به Cassandra 3.11.16 به عنوان بخشی از به روزرسانی 4.52.02 به پایان رسیده است. اگر اینطور نیست ، این مراحل را دوباره انجام دهید. این امر فقط در صورتی اعمال می شود که شما به نسخه Cloud Private 4.52.02 از نسخه قدیمی ارتقا یافته اید.

مرحله 1: برای به روزرسانی آماده شوید

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

  1. Backup Cassandra با استفاده از Apigee.
  2. عکسهای VM از گره های کاساندرا (در صورت امکان) بگیرید.
  3. اطمینان حاصل کنید که پورت 9042 برای اجزای ابری خصوصی ، از جمله سرور مدیریت ، پردازنده پیام ، روتر ، QPID و Postgres ، از All Edge در دسترس است تا در صورت عدم پیکربندی ، گره های کاساندرا. برای اطلاعات بیشتر به الزامات بندر مراجعه کنید.

مرحله 2: همه گره های کاساندرا را ارتقا دهید

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

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

  1. برای به روزرسانی یک گره کاساندرا ، دستور زیر را اجرا کنید: 
    /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

مرحله 3: تمام گره های مدیریتی را ارتقا دهید

همه گره های مدیریتی را در همه مناطق یک به یک ارتقا دهید:

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

مرحله 4: تمام گره های زمان اجرا را ارتقا دهید

تمام روترها و گره های پردازنده پیام را در همه مناطق یک به یک ارتقا دهید:

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

مرحله 5: تمام لبه های باقی مانده را برای Cloud Private 4.53.00 مؤلفه ارتقا دهید

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

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

در Edge for Private Cloud 4.53.00 ، کلیدهای IDP و گواهینامه های مورد استفاده در مؤلفه apigee-sso اکنون از طریق کلیدی کلیدی پیکربندی شده اند. شما باید کلید و گواهی مورد استفاده را در ابتدا به یک کلید اصلی صادر کنید ، آن را پیکربندی کنید و سپس طبق معمول به روزرسانی SSO را ادامه دهید.

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

    1. با جستجوی مقدار SSO_SAML_SERVICE_PROVIDER_CERTIFICATE در پرونده پیکربندی نصب SSO یا با پرس و جو از مؤلفه 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 در پرونده پیکربندی نصب SSO یا با پرس و جو از مؤلفه 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 : مسیر پرونده گواهینامه بازیابی شده در مرحله 1.A.
      • key_path : مسیر به پرونده کلید خصوصی که در مرحله 1.b. بازیابی شده است.
      • keystore_path : مسیر به کلیدهای تازه ایجاد شده حاوی گواهی و کلید خصوصی.
      • alias : alias برای جفت کلید و گواهینامه در کلیدینگ استفاده می شود.

      Refer to the OpenSSL documentation for more details.

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

      پارامترها:

      • PKCS12_keystore_path : مسیر به کلید اصلی PKCS12 ایجاد شده در مرحله 2.A ، حاوی گواهی و کلید.
      • destination_keystore_path : مسیر به کلید اصلی JKS که در آن گواهی و کلید صادر می شود.
      • alias : alias برای جفت کلید و گواهینامه در jks keystore استفاده می شود.

      3. برای اطلاعات بیشتر به مستندات KeyTool مراجعه کنید.

  3. صاحب پرونده کلیدی خروجی را به کاربر "Apigee" تغییر دهید: 
    sudo chown apigee:apigee <keystore_file>
  4. ویژگی های زیر را در پرونده پیکربندی Apigee SSO اضافه کرده و آنها را با مسیر فایل Keystore ، رمز عبور ، نوع کلید اصلی و نام مستعار به روز کنید: 
    # 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 را به طور معمول با استفاده از دستور زیر به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

UI Edge جدید

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

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

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

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

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

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

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

به روزرسانی

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. در صورت وجود ، هرگونه شغل cron را که برای انجام یک عملیات تعمیر در کاساندرا تنظیم شده است ، غیرفعال کنید تا پس از اتمام به روزرسانی.
  2. برای نصب RPMS Edge به گره خود به عنوان ریشه وارد شوید.
  3. Selinux را همانطور که در نصب ابزار Edge Apigee-setup توضیح داده شده است ، غیرفعال کنید.
  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. اگر در حال حاضر در لبه 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 Utility و وابستگی ها را با اجرای دستور زیر نصب کنید:
      sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

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

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

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

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

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

      کجا:

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

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

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

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

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

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

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

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

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

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

    3. در گره از راه دور ، ابزار و وابستگی های Edge apigee-setup نصب کنید:
      sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      جایی که uName:pWord نام کاربری و رمز عبور repo است.

  4. برای به روزرسانی ابزار apigee-setup ، از apigee-service استفاده کنید ، همانطور که مثال زیر نشان می دهد: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. همانطور که در مثال زیر نشان می دهد ، ابزار apigee-validate را در سرور مدیریت به روز کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. همانطور که مثال زیر نشان می دهد ، ابزار apigee-provision را در سرور مدیریت به روز کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. ابزار update را روی گره های خود به ترتیب شرح داده شده به ترتیب به روزرسانی دستگاه اجرا کنید:
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    کجا:

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

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

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

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

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

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

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

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

برای به روزرسانی یک پیکربندی مستقل 1 گره به 4.53.00:

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

به روزرسانی مستقل 2 گره

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

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

  1. کاساندرا و Zookeeper را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. به روزرسانی postgres در دستگاه 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. LDAP را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. اجزای Edge Edge را در دستگاه 2 و 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. QPID را در دستگاه 2 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. UI را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  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. مؤلفه Edge UI را در دستگاه 1 مجدداً راه اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ارتقاء 5 گره

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

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

  1. کاساندرا و Zookeeper را در دستگاه 1 ، 2 و 3 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. به روزرسانی postgres در دستگاه 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. به روزرسانی postgres در دستگاه 5: 
    /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
  5. اجزای Edge Edge را در دستگاه 4 ، 5 ، 1 ، 2 ، 3 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. QPID را در دستگاه 4 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. QPID را در دستگاه 5 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. Edge UI را به روز کنید:
    • UI کلاسیک: اگر از UI کلاسیک استفاده می کنید ، سپس مؤلفه ui را در دستگاه 1 به روز کنید ، همانطور که مثال زیر نشان می دهد: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • UI New Edge: اگر UI Edge New Edge را نصب کردید ، سپس مؤلفه ue را روی دستگاه مناسب به روز کنید (ممکن است دستگاه 1 نباشد): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (اگر apigee-adminapi را نصب کردید) ابزار apigee-adminapi را در دستگاه 1 به روز کرد: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (اگر Apigee SSO را نصب کردید) Apigee SSO را در دستگاه 1 به روز کنید:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

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

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

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

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

  1. کاساندرا و Zookeeper را در دستگاه 1 ، 2 و 3 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. به روزرسانی postgres در دستگاه 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. به روزرسانی postgres در دستگاه 9: 
    /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
  5. اجزای Edge را در دستگاه 6 ، 7 ، 8 ، 9 ، 1 ، 4 و 5 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. QPID را در دستگاه های 6 و 7 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. UI جدید ( ue ) یا UI کلاسیک ( ui ) را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (اگر apigee-adminapi را نصب کردید) ابزار apigee-adminapi را در دستگاه 1 به روز کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (اگر Apigee SSO را نصب کردید) Apigee SSO را در دستگاه 1 به روز کنید:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

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

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

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

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

  1. کاساندرا و Zookeeper را در دستگاه های 1 ، 2 و 3 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. به روزرسانی postgres در دستگاه 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. به روزرسانی postgres در دستگاه 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. LDAP را در دستگاه 4 و 5 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. اجزای Edge را در دستگاه های 12 ، 13 ، 8 ، 9 ، 6 ، 7 ، 10 و 11 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. QPID را در دستگاه های 12 و 13 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. UI جدید ( ue ) یا UI کلاسیک ( ui ) را در دستگاه های 6 و 7 به روز کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (اگر apigee-adminapi را نصب کردید) ابزار apigee-adminapi را در دستگاه های 6 و 7 به روز کرد: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (اگر Apigee SSO را نصب کردید) Apigee SSO را در دستگاه های 6 و 7 به روز کنید:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  10. مؤلفه UI را مجدداً راه اندازی کنید:
    • UI کلاسیک: اگر از UI کلاسیک استفاده می کنید ، سپس مؤلفه edge-ui را در دستگاه های 6 و 7 مجدداً راه اندازی کنید ، همانطور که مثال زیر نشان می دهد: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • UI New Edge: اگر UI Edge جدید را نصب کردید ، سپس مؤلفه edge-management-ui در دستگاه های 6 و 7 شروع کنید: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. کاساندرا و باغ وحش را به روز کنید:
    1. در دستگاه های 1 ، 2 و 3 در مرکز داده 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. در دستگاه های 7 ، 8 و 9 در مرکز داده 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. به روزرسانی 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
  3. 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
  4. به روزرسانی اجزای لبه:
    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
  5. qpidd را به روز کنید:
    1. ماشین آلات 4 ، 5 در مرکز داده 1
      1. Update qpidd on machine 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. qpidd در دستگاه 5 به روز کنید: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. ماشین آلات 10 ، 11 در مرکز داده 2
      1. qpidd در دستگاه 10 به روز کنید: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. qpidd در دستگاه 11 به روز کنید: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. UI جدید ( ue ) یا UI کلاسیک ( ui ) را به روز کنید:
    1. دستگاه 1 در مرکز داده 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. دستگاه 7 در مرکز داده 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (اگر 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. مؤلفه جدید UI Edge UI ( edge-management-ui ) یا Edge Edge UI ( edge-ui ) را در دستگاه های 1 و 7 راه اندازی کنید: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

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

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

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

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