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، دوباره آنها را کامل کنید.
• الزامات پایتون
  اطمینان حاصل کنید که همه گره ها، از جمله گره های 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

مرحله 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 را در همه مناطق یک به یک ارتقا دهید.

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

پس از تکمیل ارتقا، دستور زیر را روی هر گره Cassandra یکی یکی اجرا کنید:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

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

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

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

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

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

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

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

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

• 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. به‌روزرسانی را برای دستگاه‌های باقی‌مانده در نصب خود ادامه دهید.

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

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

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

شما باید یک فایل پیکربندی بی صدا را به دستور به روز رسانی ارسال کنید. فایل پیکربندی بی صدا باید همان فایلی باشد که برای نصب 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

اگر بعداً تصمیم به بازگرداندن به‌روزرسانی گرفتید، از روشی که در 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

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