این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

آپدیت Apigee Edge 4.16.01/4.16.05 به 4.17.01

Edge for Private Cloud نسخه 4.17.01

کدام نسخه های Edge را می توانید به 4.17.01 به روز کنید

با استفاده از این روش می توانید Apigee Edge نسخه 4.16.01.0x و 4.16.05.x را به 4.17.01 به روز کنید.

اگر نسخه ای از Edge قبل از نسخه 4.16.01 دارید، ابتدا باید به نسخه 4.16.01 مهاجرت کنید و سپس به نسخه 4.17.01 آپدیت کنید.

می توانید Apigee Edge نسخه 4.15.07 را به 4.16.01 منتقل کنید.
اگر نسخه ای از Edge قبل از نسخه 4.15.07 دارید، ابتدا باید به نسخه 4.15.07 و سپس به نسخه 4.16.01 مهاجرت کنید.
- اگر از Edge نسخه 4.14.04 یا جدیدتر مهاجرت می کنید: مستقیماً به نسخه 4.15.07 مهاجرت کنید.
- اگر از Edge نسخه 4.14.01 مهاجرت می کنید: ابتدا باید به نسخه 4.14.04 و سپس به نسخه 4.15.07 مهاجرت کنید.

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

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

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

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

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

کاهش رتبه Zookeeper در صورت به روز رسانی از 4.16.01

نسخه Zookeeper RPM در Edge برای Private Cloud 4.16.01 apigee-zookeeper-3.4.5-1.0.905.noarch.rpm است. در نسخه‌های بعدی Edge، نسخه Zookeeper به apigee-zookeeper-3.4.5-0.0.94x برگردانده شد. این امر از yum از ارتقای Zookeeper به نسخه های بعدی از 4.16.01 جلوگیری می کند. راه اصلاح این وضعیت اجرای yum downgrade apigee-zookeeper قبل از به‌روزرسانی Zookeeper است.

با استفاده از دستور زیر می توانید نسخه Zookeeper خود را بررسی کنید:

> rpm -qa |grep apigee-zookeeper

اگر این دستور نسخه Zookeeper را برگرداند:

apigee-zookeeper-3.4.5-1.0.905

سپس باید دانگرید را انجام دهید.

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

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

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

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

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

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

> وضعیت /opt/apigee/apigee-service/bin/apigee-all

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

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

اگر برای خرابی لازم است که به‌روزرسانی را به نسخه قبلی خود برگردانید، برای اطلاعات بیشتر به 4.17.01 Rollback Process مراجعه کنید.

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

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

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

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

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

نیاز به ارتقاء به Java JDK نسخه 8

این نسخه از Edge مستلزم آن است که Java JDK نسخه 8 را روی تمام گره‌های پردازش Edge نصب کرده باشید. می توانید Oracle JDK 8 یا OpenJDK 8 را نصب کنید. اگر Java JDK 8 قبلاً نصب نشده باشد، اسکریپت به روز رسانی می تواند آن را برای شما نصب کند.

به‌عنوان بخشی از به‌روزرسانی به جاوا 8، برخی از رمزهای TLS دیگر در Oracle JDK 8 در دسترس نیستند. برای فهرست کامل، به بخش «مجموعه‌های پیش‌فرض رمز غیرفعال‌شده» در http://docs.oracle.com/javase/8/ مراجعه کنید. docs/technotes/guides/security/SunProviders.html .

برای فعال کردن مخزن EPEL مورد نیاز است

برای نصب یا به‌روزرسانی Edge باید بسته‌های اضافی برای لینوکس سازمانی (یا EPEL) را فعال کنید. دستوری که استفاده می کنید به نسخه RedHat/CentOS شما بستگی دارد:

برای RedHat/CentOS 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm؛ rpm -ivh epel-release-latest-7.noarch.rpm
برای RedHat/CentOS 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

در صورت به‌روزرسانی هنگام استفاده از احراز هویت خارجی، لازم است

می‌توانید یک سرویس فهرست خارجی را در نصب Apigee Edge Private Cloud ادغام کنید. این ویژگی برای کار با هر سرویس دایرکتوری که از LDAP پشتیبانی می‌کند، مانند Active Directory، OpenLDAP و غیره طراحی شده است. یک راه حل خارجی LDAP به مدیران سیستم اجازه می دهد تا اعتبار کاربری را از یک سرویس مدیریت دایرکتوری متمرکز، خارج از سیستم هایی مانند Apigee Edge که از آنها استفاده می کنند، مدیریت کنند.

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

هنگامی که احراز هویت خارجی فعال است، اکثر مشتریان از قسمت نام حساب Active Directory SAM به عنوان نام کاربری برای احراز هویت استفاده می کنند، به جای آدرس ایمیلی که توسط سرور Edge OpenLDAP استفاده می شود.

اگر با یک سرویس دایرکتوری خارجی ادغام شده اید، هنگام به روز رسانی Edge به 4.17.01 خط زیر را به فایل پیکربندی خود اضافه کنید:

IS_EXTERNAL_AUTH="true"

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

ارتقاء مورد نیاز به Qpid 1.35

این نسخه حاوی یک به روز رسانی لازم برای Qpid 1.35 است. به عنوان بخشی از به روز رسانی یک گره Qpid، شما باید:

با مسدود کردن پورت 5672 در گره Qpid، به طور موقت از نوشتن روترها و پردازشگرهای پیام در گره Qpid جلوگیری کنید. می توانید از دستور زیر برای مسدود کردن این پورت در گره Qpid استفاده کنید:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -i eth0 -j DROP
منتظر بمانید تا صف Qpid از پیام ها خالی شود تا مطمئن شوید که گره Qpid همه پیام ها را قبل از به روز رسانی پردازش کرده است. برای اطمینان از خالی بودن صف پیام Qpid از دستور زیر استفاده کنید:
> qpid-stat -q
گره Qpid را به روز کنید.
پورت 5672 را در گره Qpid رفع انسداد کنید تا امکان دسترسی از روترها و پردازشگرهای پیام فراهم شود. برای رفع انسداد این پورت می توانید از دستور زیر استفاده کنید:
> sudo iptables -F

توجه داشته باشید که اگر از iptables برای قوانین دیگر استفاده می کنید، می توانید از گزینه -D برای معکوس کردن تغییر خاص استفاده کنید:
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s «نام میزبان» -i eth0 -j DROP

این فرآیند به تفصیل در زیر برای هر توپولوژی Edge توضیح داده شده است.

ارتقاء مورد نیاز به Postgres 9.4

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

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

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

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

این روش یک سرور آماده به کار Postgres را در یک گره جدید ایجاد می کند. مطمئن شوید که یک سرور آماده به کار Postgres جدید را برای نسخه فعلی Edge (4.16.01 یا 4.16.05) نصب کرده اید، نه برای نسخه 4.17.01.

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

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

در استاد فعلی Postgres، فایل /opt/apigee/customer/application/postgresql.properties را ویرایش کنید تا توکن زیر را تنظیم کنید. اگر آن فایل وجود ندارد، آن را ایجاد کنید:

conf_pg_hba_replication.connection=تکثیر میزبان apigee exist_slave_ip /32 trust\ \nتکثیر میزبان apigee new_slave_ip /32 trust

که موجود_slave_ip آدرس IP سرور آماده به کار Postgres فعلی و new_slave_ip آدرس IP گره آماده به کار جدید است.
apigee-postgresql را در Master Postgres راه اندازی مجدد کنید:
> /opt/apigee/apigee-service/bin/apigee-service راه اندازی مجدد apigee-postgresql
بررسی کنید که گره آماده به کار جدید با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf در اصلی اضافه شده است. شما باید خطوط زیر را در آن فایل ببینید:
Host Replication apigee exist_slave_ip/32 trust
Host Replication apigee new_slave_ip/32 trust
سرور آماده به کار جدید Postgres را نصب کنید:
1. فایل پیکربندی را که برای نصب نسخه فعلی Edge استفاده کردید، ویرایش کنید تا موارد زیر را مشخص کنید:
  
  # آدرس IP استاد فعلی:
  PG_MASTER=192.168.56.103
  # آدرس IP گره آماده به کار جدید
  PG_STANDBY=192.168.56.102
2. همانطور که در Install the Edge apigee-setup utility توضیح داده شد SELinux را غیرفعال کنید.
3. فایل Edge bootstrap_4.16.05.sh را در /tmp/bootstrap_4.16.05.sh دانلود کنید:
  > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  
  توجه : اگر از 4.16.01 به روز رسانی می کنید، فایل Edge bootstrap.sh را دانلود کنید.
4. ابزار و وابستگی های Edge apigee-service را نصب کنید:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser= uName apigeepassword= pWord
5. از apigee-service برای نصب ابزار apigee-setup استفاده کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
6. Postgres را نصب کنید:
  > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
7. در گره آماده به کار جدید دستور زیر را اجرا کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  تأیید کنید که می گوید در حالت آماده به کار است.

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

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

مطمئن شوید که Postgres در حال اجرا است:
> وضعیت /opt/apigee/apigee-service/bin/apigee-all

اگر Postgres در حال اجرا نیست، آن را شروع کنید:
> /opt/apigee/apigee-service/bin/apigee-all start
UUID گره آماده به کار جدید را با اجرای دستور cURL زیر در گره آماده به کار جدید دریافت کنید:
> curl -u sysAdminEmail:password http:// <node_IP> :8084/v1/servers/self

شما باید UUID گره را در انتهای خروجی به شکل زیر ببینید:
"نوع" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
با اجرای دستور زیر بر روی گره آماده به کار جدید، گره آماده به کار جدید را متوقف کنید:
> /opt/apigee/apigee-service/bin/apigee-all stop
در گره اصلی Postgres، /opt/apigee/customer/application/postgresql.properties را ویرایش کنید تا گره آماده به کار جدید را از conf_pg_hba_replication.connection حذف کنید:
conf_pg_hba_replication.connection=تکثیر میزبان apigee exist_slave_ip /32 trust
apigee-postgresql را در Master Postgres راه اندازی مجدد کنید:
> /opt/apigee/apigee-service/bin/apigee-service راه اندازی مجدد apigee-postgresql
بررسی کنید که گره آماده به کار جدید با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf در اصلی حذف شده است. شما باید فقط خط زیر را در آن فایل ببینید:
Host Replication apigee exist_slave_ip /32 trust
UUID گره آماده به کار را از ZooKeeper با فراخوانی API مدیریت Edge زیر در گره مدیریت سرور حذف کنید:
> curl -u sysAdminEmail:password -X DELETE http:// <ms_IP> :8080/v1/servers/ <new_slave_uuid>

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

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

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

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

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

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

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

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

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

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

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

اگر در حال حاضر از Replication Master-standby Postgres استفاده می کنید، یک گره آماده به کار Postgres جدید را همانطور که در بالا در نصب یک گره آماده به کار جدید Postgres توضیح داده شد نصب کنید.
در صورت وجود، کارهای CRON را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده اند، تا زمانی که به روز رسانی کامل نشده است، غیرفعال کنید.
برای نصب Edge RPM به عنوان root وارد گره خود شوید.
توجه : در حالی که نصب RPM به دسترسی ریشه نیاز دارد، می‌توانید پیکربندی Edge را بدون دسترسی ریشه انجام دهید.
همانطور که در Install the Edge apigee-setup utility توضیح داده شد SELinux را غیرفعال کنید.
فایل Edge 4.17.01 bootstrap_4.17.01.sh را در /tmp/bootstrap_4.17.01.sh دانلود کنید:
> curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
ابزار و وابستگی های سرویس edge 4.17.01 apigee-service را نصب کنید:
> sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser= uName apigeepassword= pWord

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

به طور پیش فرض، نصب کننده بررسی می کند که جاوا 1.8 را نصب کرده اید. اگر این کار را نکنید، آن را برای شما نصب می کند. از گزینه JAVA_FIX برای تعیین نحوه مدیریت نصب جاوا استفاده کنید. JAVA_FIX مقادیر زیر را می گیرد:

I = نصب OpenJDK 1.8 (پیش‌فرض)
C = بدون نصب جاوا ادامه دهید
Q = ترک. برای این گزینه باید خود جاوا را نصب کنید.
(فقط CentOS-6.x و RedHat-6.x) در تمام گره های Qpid، دستور زیر را اجرا کنید تا مطمئن شوید که نسخه صحیح Qpid را دانلود کرده اید:
> yum نصب apigee-qpidd --disablerepo=epel
از apigee-service برای به روز رسانی ابزار apigee-setup استفاده کنید:
1. اگر نسخه 4.16.01 را با ارتقاء Edge نسخه 4.15.07.0x نصب کرده اید، باید ابزار apigee-setup را نصب کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  این دستور ابزار update.sh را در /opt/apigee/apigee-setup/bin نصب می کند.
  
  اگر قبلاً ابزار apigee-setup را نصب کرده اید، آن را به روز کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup به روز رسانی
2. اگر نسخه 4.16.01 را مستقیماً نصب کرده اید، به این معنی که ارتقاء را از 4.15.07.0x انجام نداده اید، باید ابزار apigee-setup را به روز کنید :
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup به روز رسانی
  
  این به‌روزرسانی برای apigee-service ، ابزار update.sh را در /opt/apigee/apigee-setup/bin نصب می‌کند.
3. اگر نسخه 4.16.05 را مستقیماً یا با به روز رسانی نصب کرده اید، باید ابزار apigee-setup را به روز کنید :
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup به روز رسانی
  
  این به‌روزرسانی برای apigee-service ، ابزار update.sh را در /opt/apigee/apigee-setup/bin نصب می‌کند.
بسته به نسخه فعلی Edge، باید ابزار apigee-validate را در مدیریت سرور نصب یا به‌روزرسانی کنید.
1. اگر در حال حاضر از Edge 4.16.05 استفاده می کنید : ابزار apigee-validate را در سرور مدیریت به روز کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate به روز رسانی
2. اگر در حال حاضر از Edge 4.16.01 استفاده می کنید : ابزار apigee-validate را روی سرور مدیریت نصب کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  توجه : اگر هنگام نصب 4.16.01 ابزار apigee-validate را بر روی گره پردازشگر پیام نصب کرده اید، می توانید با استفاده از دستور زیر در آن گره، آن را به روز کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate به روز رسانی
  
  با این حال، از تاریخ 4.16.05 و بعد از آن، Apigee توصیه می‌کند که برنامه apigee-validate را روی سرور مدیریت نصب و اجرا کنید.
3. اگر در حال ارتقا از 4.16.01 هستید : فایل پیکربندی ارسال شده به ابزار apigee-validate را ویرایش کنید. در نسخه 4.16.01 Edge، فایل پیکربندی مورد استفاده توسط apigee-validate به ویژگی‌های زیر نیاز داشت:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD = دروازه
  REGION=dc-1
  
  در این نسخه، فایل پیکربندی فقط به ویژگی APIGEE_ADMINPW نیاز دارد. می توانید دو ویژگی دیگر را از فایل حذف کنید.
ابزار apigee-provision را به روز کنید:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision به روز رسانی
ابزار به روز رسانی را بر روی گره های خود به ترتیبی که در زیر در " ترتیب به روز رسانی ماشین " در زیر توضیح داده شده است اجرا کنید:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

تنها مورد نیاز فایل پیکربندی این است که فایل پیکربندی باید توسط کاربر "apigee" قابل دسترسی یا خواندن باشد.

از گزینه "-c" برای تعیین کامپوننت برای به روز رسانی استفاده کنید. لیست اجزای احتمالی شامل:
ldap = OpenLDAP
cs = کاساندرا
zk = نگهبان باغ وحش
qpid = qpidd
ps = postgresql
edge = همه اجزای Edge به جز Edge UI: سرور مدیریت، پردازشگر پیام، روتر، سرور QPID، سرور Postgres
UI = رابط کاربری لبه
همه = به‌روزرسانی همه اجزای دستگاه (فقط برای پروفایل نصب Edge aio یا نمایه نصب API BaaS asa استفاده کنید)
e = ElasticSearch
b = پشته API BaaS
p = پورتال API BaaS
ebp = ElasticSearch، API BaaS Stack، و API BaaS Portal در همان گره
همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.
اگر یک گره آماده به کار Postgres جدید نصب کرده اید، گره را همانطور که در بالا در Decommissioning a Postgres توضیح داده شد، از کار خارج کنید.

برای بازگرداندن به‌روزرسانی بعداً، از روشی که در 4.16.09 Rollback Process توضیح داده شده است استفاده کنید.

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

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

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

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

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

اگر در حال حاضر از Replication Master-standby Postgres استفاده می کنید، یک گره آماده به کار Postgres جدید را همانطور که در بالا در نصب یک گره آماده به کار جدید Postgres توضیح داده شد نصب کنید.
یک مخزن محلی 4.17.01 همانطور که در "ایجاد یک مخزن محلی Apigee" در نصب ابزار Edge apigee-setup توضیح داده شده است، ایجاد کنید.
توجه : اگر قبلاً یک مخزن 4.16.01 یا 4.16.05 دارید، می‌توانید مخزن 4.17.01 را همانطور که در «به‌روزرسانی یک مخزن محلی Apigee» در نصب ابزار Edge apigee-setup توضیح داده شده است، به آن اضافه کنید.
برای نصب apigee-service از فایل tar :
1. در گره دارای مخزن محلی، از دستور زیر برای بسته بندی مخزن محلی در یک فایل .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.17.01.tar.gz استفاده کنید:
  > /opt/apigee/apigee-service/bin/apigee-service بسته apigee-mirror
2. فایل tar را در گره ای که می خواهید Edge را به روز کنید کپی کنید. به عنوان مثال، آن را در پوشه /tmp در گره جدید کپی کنید.
3. در گره جدید، فایل را در پوشه /tmp untar کنید:
  > tar -xzf apigee-4.17.01.tar.gz
  
  این دستور یک دایرکتوری جدید به نام repos در دایرکتوری حاوی فایل tar ایجاد می کند. به عنوان مثال /tmp/repos.
4. ابزار و وابستگی های Edge apigee-service را از /tmp/repos نصب کنید:
  > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  توجه داشته باشید که مسیر دایرکتوری repos را در این دستور قرار داده اید.
برای نصب apigee-service با استفاده از وب سرور Nginx:
1. وب سرور Nginx را همانطور که در «نصب از مخزن با استفاده از وب سرور Nginx» در نصب ابزار Edge apigee-setup توضیح داده شده پیکربندی کنید.
2. در گره راه دور، فایل Edge bootstrap_4.17.01.sh را در /tmp/bootstrap_4.17.01.sh دانلود کنید:
  > /usr/bin/curl http:// uName: pWord @ remoteRepo :3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
  
  که در آن uName:pWord نام کاربری و رمز عبوری است که در بالا برای مخزن تنظیم کرده اید و remoteRepo آدرس IP یا نام DNS گره repo است.
3. در گره راه دور، ابزار Edge apigee-service و وابستگی ها را نصب کنید:
  > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost= remoteRepo :3939 apigeeuser= uName apigeepassword= pWord apigeeprotocol=http://
  
  که در آن uName:pWord نام کاربری و رمز عبور مخزن است.
از apigee-service برای به روز رسانی ابزار apigee-setup استفاده کنید:
1. اگر نسخه 4.16.01 را با ارتقاء Edge نسخه 4.15.07.0x نصب کرده اید، باید ابزار apigee-setup را نصب کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  این دستور ابزار update.sh را در /opt/apigee/apigee-setup/bin نصب می کند.
  
  اگر قبلاً ابزار apigee-setup را نصب کرده اید، آن را به روز کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup به روز رسانی
2. اگر نسخه 4.16.01 را مستقیماً نصب کرده اید، به این معنی که ارتقاء را از 4.15.07.0x انجام نداده اید، باید ابزار apigee-setup را به روز کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup به روز رسانی
  
  این به‌روزرسانی برای apigee-service ، ابزار update.sh را در /opt/apigee/apigee-setup/bin نصب می‌کند.
3. اگر نسخه 4.16.05 را مستقیماً یا با به روز رسانی نصب کرده اید، باید ابزار apigee-setup را به روز کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup به روز رسانی
  
  این به‌روزرسانی برای apigee-service ، ابزار update.sh را در /opt/apigee/apigee-setup/bin نصب می‌کند.
بسته به نسخه فعلی Edge، باید ابزار apigee-validate را در مدیریت سرور نصب یا به‌روزرسانی کنید.
1. اگر در حال حاضر از Edge 4.16.05 استفاده می کنید : ابزار apigee-validate را در سرور مدیریت به روز کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate به روز رسانی
2. اگر در حال حاضر از Edge 4.16.01 استفاده می کنید : ابزار apigee-validate را روی سرور مدیریت نصب کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  توجه : اگر هنگام نصب 4.16.01 ابزار apigee-validate را بر روی گره پردازشگر پیام نصب کرده اید، می توانید با استفاده از دستور زیر در آن گره، آن را به روز کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate به روز رسانی
  
  با این حال، از تاریخ 4.16.05 و بعد از آن، Apigee توصیه می‌کند که برنامه apigee-validate را روی سرور مدیریت نصب و اجرا کنید.
3. اگر در حال ارتقا از 4.16.01 هستید : فایل پیکربندی ارسال شده به ابزار apigee-validate را ویرایش کنید. در نسخه 4.16.01 Edge، فایل پیکربندی مورد استفاده توسط apigee-validate به ویژگی‌های زیر نیاز داشت:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD = دروازه
  REGION=dc-1
  
  در این نسخه، فایل پیکربندی فقط به ویژگی APIGEE_ADMINPW نیاز دارد. می توانید دو ویژگی دیگر را از فایل حذف کنید.
ابزار apigee-provision را به روز کنید:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision به روز رسانی
ابزار به روز رسانی را بر روی گره های خود به ترتیبی که در زیر در "ترتیب به روز رسانی ماشین" در زیر توضیح داده شده است، اجرا کنید:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

تنها مورد نیاز فایل پیکربندی این است که فایل پیکربندی باید توسط کاربر "apigee" قابل دسترسی یا خواندن باشد.

از گزینه "-c" برای تعیین کامپوننت برای به روز رسانی استفاده کنید. لیست اجزای احتمالی شامل:
ldap = OpenLDAP
cs = کاساندرا
zk = نگهبان باغ وحش
qpid = qpidd
ps = postgresql
edge = همه اجزای Edge به جز Edge UI: سرور مدیریت، پردازشگر پیام، روتر، سرور QPID، سرور Postgres
UI = رابط کاربری لبه
همه = به‌روزرسانی همه اجزای دستگاه (فقط برای پروفایل نصب Edge aio یا نمایه نصب API BaaS asa استفاده کنید)
e = ElasticSearch
b = پشته API BaaS
p = پورتال API BaaS
ebp = ElasticSearch، API BaaS Stack، و API BaaS Portal در همان گره
همانطور که در Test the install توضیح داده شده است، به‌روزرسانی را با اجرای ابزار apigee-validate روی سرور مدیریت آزمایش کنید.
اگر یک گره آماده به کار Postgres جدید نصب کرده اید، گره را همانطور که در بالا در Decommissioning a Postgres توضیح داده شد، از کار خارج کنید.

برای بازگرداندن به‌روزرسانی بعداً، از روشی که در 4.16.09 Rollback Process توضیح داده شده است استفاده کنید.

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

ترتیب به روز رسانی دستگاه ها در نصب Edge مهم است. مهمترین ملاحظات به روز رسانی عبارتند از:

قبل از اینکه گره های دیگری را به روز کنید، باید تمام گره های Cassandra و ZooKeeper را به روز کنید.
برای هر ماشینی با چندین مؤلفه Edge (مدیریت سرور، پردازشگر پیام، روتر، سرور QPID اما نه سرور Postgres)، از گزینه "-c edge" استفاده کنید تا همه آنها را همزمان به روز کنید.
اگر مرحله ای مشخص می کند که باید روی چندین ماشین انجام شود، آن را به ترتیب ماشین مشخص شده انجام دهید.
هیچ مرحله جداگانه ای برای به روز رسانی کسب درآمد وجود ندارد. زمانی که گزینه "-c edge" را مشخص کنید به روز می شود.
(فقط CentOS-6.x و RedHat-6.x) در تمام گره های Qpid با اتصال اینترنت خارجی، اطمینان حاصل کنید که دستور زیر را برای دانلود نسخه صحیح Qpid همانطور که در بالا نشان داده شده است اجرا کرده اید:
> yum نصب apigee-qpidd --disablerepo=epel