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

به‌روزرسانی Apigee Edge 4.16.01/4.16.05 به 4.17.01

Edge for Private Cloud نسخه ۴.۱۷.۰۱

کدام نسخه‌های Edge را می‌توانید به ۴.۱۷.۰۱ به‌روز کنید

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

اگر نسخه‌ای از Edge دارید که قدیمی‌تر از نسخه ۴.۱۶.۰۱ است، ابتدا باید به نسخه ۴.۱۶.۰۱ مهاجرت کنید و سپس به نسخه ۴.۱۷.۰۱ به‌روزرسانی کنید.

می‌توانید Apigee Edge نسخه ۴.۱۵.۰۷ را به ۴.۱۶.۰۱ منتقل کنید.
اگر نسخه‌ای از Edge دارید که قدیمی‌تر از نسخه ۴.۱۵.۰۷ است، ابتدا باید به نسخه ۴.۱۵.۰۷ و سپس به نسخه ۴.۱۶.۰۱ مهاجرت کنید.
- اگر از Edge نسخه ۴.۱۴.۰۴ یا جدیدتر مهاجرت می‌کنید: مستقیماً به نسخه ۴.۱۵.۰۷ مهاجرت کنید.
- اگر از Edge نسخه ۴.۱۴.۰۱ مهاجرت می‌کنید: ابتدا باید به نسخه ۴.۱۴.۰۴ مهاجرت کنید و سپس به نسخه ۴.۱۵.۰۷ مهاجرت کنید.

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

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

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

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

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

تنزل رتبه Zookeeper درصورت به‌روزرسانی از 4.16.01

نسخه Zookeeper RPM در Edge for 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 برگردانده شد. این کار از ارتقای Zookeeper توسط yum به نسخه‌های بالاتر از ۴.۱۶.۰۱ جلوگیری می‌کند. راه اصلاح این وضعیت این است که قبل‌از به‌روزرسانی Zookeeper،‏ yum downgrade apigee-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 status

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

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

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

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

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

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

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

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

ارتقا به Java JDK نسخه ۸ الزامی است

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

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

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

برای نصب یا به‌روزرسانی Edge، باید بسته‌های اضافی برای Enterprise Linux (یا 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 به نسخه ۴.۱۷.۰۱، خط زیر را به فایل پیکربندی خود اضافه کنید:

IS_EXTERNAL_AUTH="true"

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

ارتقا به Qpid 1.35 لازم است

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

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

توجه داشته باشید که اگر از iptables برای قوانین دیگر استفاده می‌کنید، می‌توانید از گزینه -D برای معکوس کردن تغییر خاص استفاده کنید:
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -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 (‏۴.۱۶.۰۱ یا ۴.۱۶.۰۵) نصب می‌کنید، نه برای نسخه ۴.۱۷.۰۱.

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

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

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

conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

که در آن existing_slave_ip نشانی IP سرور آماده‌به‌کار Postgres فعلی است و new_slave_ip نشانی IP گره آماده‌به‌کار جدید است.
apigee-postgresql را در Postgres اصلی بازراه‌اندازی کنید:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf در گره اصلی، بررسی کنید که گره آماده‌به‌کار جدید اضافه شده باشد. باید خطوط زیر را در آن فایل ببینید:
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
سرور آماده‌به‌کار Postgres جدید را نصب کنید:
1. فایل پیکربندی را که برای نصب نسخه فعلی Edge استفاده کرده‌اید ویرایش کنید تا موارد زیر را مشخص کنید:
  
  # IP address of the current master:
  PG_MASTER=192.168.56.103
  # IP address of the new standby node
  PG_STANDBY=192.168.56.102
2. SELinux را طبق توضیحات نصب ابزار کمکی Edge apigee-setup غیرفعال کنید.
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 status

اگر Postgres درحال اجرا نیست، آن را شروع کنید:
> /opt/apigee/apigee-service/bin/apigee-all start
Get the UUID of the new standby node by running the following cURL command on the new standby node:
> curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

You should see the UUID of the node at the end of the output, in the form:
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
با اجرای فرمان زیر در گره آماده‌به‌کار جدید، گره آماده‌به‌کار جدید را متوقف کنید:
> /opt/apigee/apigee-service/bin/apigee-all stop
On the Postgres master node, edit /opt/apigee/customer/application/postgresql.properties to remove the new standby node from conf_pg_hba_replication.connection:
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
apigee-postgresql را در Postgres master بازراه‌اندازی کنید:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
با مشاهده فایل /opt/apigee/apigee-postgresql/conf/pg_hba.conf در گره اصلی، بررسی کنید که گره آماده‌به‌کار جدید برداشته شده باشد. باید فقط خط زیر را در آن فایل ببینید:
host replication apigee existing_slave_ip/32 trust
با برقراری تماس Edge management API زیر در گره Management Server، شناسه UUID گره آماده‌به‌کار را از ZooKeeper حذف کنید:
> curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

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

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

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

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

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

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

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

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

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

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

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

اگر درحال‌حاضر از تکرار Postgres master-standby استفاده می‌کنید، گره آماده‌به‌کار Postgres جدیدی را همان‌طور که در بالا در نصب گره آماده‌به‌کار Postgres جدید توضیح داده شده است نصب کنید.
درصورت وجود، هرگونه کار CRON را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده است غیرفعال کنید تا زمانی که به‌روزرسانی تکمیل شود.
برای نصب Edge RPM، به‌عنوان root به سیستم گره وارد شوید.
توجه: اگرچه نصب RPM به دسترسی ریشه نیاز دارد، می‌توانید پیکربندی Edge را بدون دسترسی ریشه انجام دهید.
SELinux را طبق توضیحات نصب ابزار کمکی apigee-setup Edge غیرفعال کنید.
فایل 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 را حذف کنید، از شما خواسته می‌شود آن را وارد کنید.

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

I = نصب OpenJDK 1.8 (پیش‌فرض)
C = ادامه دادن بدون نصب Java
Q = خروج. برای این گزینه، باید Java را خودتان نصب کنید.
(فقط CentOS-6.x و RedHat-6.x) در همه گره‌های Qpid، فرمان زیر را اجرا کنید تا مطمئن شوید نسخه صحیح Qpid را بارگیری می‌کنید:
> yum install apigee-qpidd --disablerepo=epel
از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید:
1. اگر نسخه ۴.۱۶.۰۱ را با ارتقا دادن Edge نسخه ۴.۱۵.۰۷.۰x نصب کرده‌اید، باید برنامه کمکی 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 update
2. اگر نسخه ۴.۱۶.۰۱ را مستقیماً نصب کرده‌اید، یعنی ارتقا را از نسخه ۴.۱۵.۰۷.۰x انجام نداده‌اید، باید ابزار کمکی apigee-setup را به‌روز کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  این به‌روزرسانی برای apigee-service ابزار کمکی update.sh را در /opt/apigee/apigee-setup/bin نصب می‌کند.
3. اگر نسخه ۴.۱۶.۰۵ را مستقیماً یا ازطریق به‌روزرسانی نصب کرده‌اید، باید ابزار کمکی apigee-setup را به‌روز کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  این به‌روزرسانی برای apigee-service ابزار کمکی update.sh را در /opt/apigee/apigee-setup/bin نصب می‌کند.
بسته به نسخه فعلی Edge، باید ابزار کمکی apigee-validate را در «سرور مدیریت» نصب یا به‌روزرسانی کنید.
1. اگر درحال‌حاضر از Edge 4.16.05 استفاده می‌کنید: ابزار apigee-validate را در Management Server به‌روز کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
2. اگر درحال‌حاضر از Edge 4.16.01 استفاده می‌کنید: ابزار کمکی apigee-validate را در Management Server نصب کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  توجه: اگر ابزار کمکی apigee-validate را هنگام نصب نسخه 4.16.01 در گره Message Processor نصب کرده‌اید، می‌توانید آن را بااستفاده از فرمان زیر در آن گره به‌روز کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  بااین‌حال، از نسخه 4.16.05 به بعد، Apigee توصیه می‌کند که ابزار کمکی apigee-validate را در Management Server نصب و اجرا کنید.
3. اگر از نسخه 4.16.01 ارتقا می‌دهید: فایل پیکربندی ارسال‌شده به ابزار کمکی apigee-validate را ویرایش کنید. در نسخه 4.16.01 Edge، فایل پیکربندی مورداستفاده apigee-validate به ویژگی‌های زیر نیاز داشت:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  در این نسخه، فایل پیکربندی فقط به ویژگی APIGEE_ADMINPW نیاز دارد. می‌توانید دو دارایی دیگر را از فایل بردارید.
Update the apigee-provision utility:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
ابزار به‌روزرسانی را در گره‌هایتان به‌ترتیبی که در بخش «ترتیب به‌روزرسانی دستگاه» در زیر شرح داده شده است اجرا کنید:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

از گزینه «-c» برای مشخص کردن مؤلفه موردنظر برای به‌روزرسانی استفاده کنید. فهرست مؤلفه‌های احتمالی شامل موارد زیر است:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =همه مؤلفه‌های Edge به‌جز Edge UI: سرور مدیریت، پردازشگر پیام، مسیریاب، سرور QPID، سرور Postgres
ui = Edge UI
all = به‌روزرسانی همه مؤلفه‌ها در دستگاه (فقط برای نمایه نصب Edge aio یا نمایه نصب API BaaS asa استفاده می‌شود)
e = ElasticSearch
b = پشته API BaaS
p = درگاه API BaaS
ebp = ElasticSearch، پشته API BaaS، و درگاه API BaaS در همان گره
به‌روزرسانی را با اجرای ابزار کمکی apigee-validate در «سرور مدیریت» آزمایش کنید، همان‌طور که در آزمایش نصب شرح داده شده است.
اگر گره آماده‌به‌کار Postgres جدیدی نصب کرده‌اید، گره را طبق شرح بالا در ازکار انداختن گره Postgres ازکار بیندازید.

برای بازگرداندن به‌روزرسانی در آینده، از رویه شرح‌داده‌شده در فرایند بازگرداندن ۴.۱۶.۰۹ استفاده کنید.

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

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

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

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

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

اگر درحال‌حاضر از تکرار Postgres master-standby استفاده می‌کنید، گره آماده‌به‌کار Postgres جدیدی را همان‌طور که در بالا در نصب گره آماده‌به‌کار Postgres جدید توضیح داده شده است نصب کنید.
یک مخزن محلی 4.17.01 ایجاد کنید، همان‌طور که در «ایجاد مخزن Apigee محلی» در نصب ابزار کمکی apigee-setup در Edge شرح داده شده است.
توجه: اگر ازقبل مخزن 4.16.01 یا 4.16.05 دارید، می‌توانید مخزن 4.17.01 را به آن اضافه کنید، همان‌طور که در «به‌روزرسانی مخزن Apigee محلی» در نصب ابزار کمکی apigee-setup در Edge شرح داده شده است.
برای نصب apigee-service از فایل tar .:
1. On the node with the local repo, use the following command to package the local repo into a single .tar file named /opt/apigee/data/apigee-mirror/apigee-4.17.01.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. فایل tar .را در گره‌ای که می‌خواهید Edge را به‌روز کنید کپی کنید. برای مثال، آن را در دایرکتوری /tmp در گره جدید کپی کنید.
3. در گره جدید، فایل را در دایرکتوری /tmp از حالت tar خارج کنید:
  > 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» در نصب ابزار کمکی apigee-setup در Edge شرح داده شده است پیکربندی کنید.
2. On the remote node, download the Edge bootstrap_4.17.01.sh file to /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
  
  where uName:pWord are the username and password you set above for the repo, and remoteRepo is the IP address or DNS name of the repo node.
3. On the remote node, install the Edge apigee-service utility and dependencies:
  > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  where uName:pWord are the repo username and password.
از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید:
1. اگر نسخه ۴.۱۶.۰۱ را با ارتقا دادن Edge نسخه ۴.۱۵.۰۷.۰x نصب کرده‌اید، باید برنامه کمکی 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 update
2. اگر نسخه ۴.۱۶.۰۱ را مستقیماً نصب کرده‌اید، یعنی ارتقا را از نسخه ۴.۱۵.۰۷.۰x انجام نداده‌اید، باید ابزار کمکی apigee-setup را به‌روز کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  این به‌روزرسانی برای apigee-service ابزار کمکی update.sh را در /opt/apigee/apigee-setup/bin نصب می‌کند.
3. اگر نسخه ۴.۱۶.۰۵ را مستقیماً یا ازطریق به‌روزرسانی نصب کرده‌اید، باید ابزار کمکی apigee-setup را به‌روز کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  این به‌روزرسانی برای apigee-service ابزار کمکی update.sh را در /opt/apigee/apigee-setup/bin نصب می‌کند.
بسته به نسخه فعلی Edge، باید ابزار کمکی apigee-validate را در «سرور مدیریت» نصب یا به‌روزرسانی کنید.
1. اگر درحال‌حاضر از Edge 4.16.05 استفاده می‌کنید: ابزار apigee-validate را در Management Server به‌روز کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
2. اگر درحال‌حاضر از Edge 4.16.01 استفاده می‌کنید: ابزار کمکی apigee-validate را در «سرور مدیریت» نصب کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  توجه: اگر ابزار کمکی apigee-validate را هنگام نصب 4.16.01 در گره «پردازشگر پیام» نصب کرده‌اید، می‌توانید آن را بااستفاده از فرمان زیر در آن گره به‌روز کنید:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  بااین‌حال، از نسخه 4.16.05 به بعد، Apigee توصیه می‌کند ابزار کمکی apigee-validate را در «سرور مدیریت» نصب و اجرا کنید.
3. اگر از نسخه 4.16.01 ارتقا می‌دهید: فایل پیکربندی ارسال‌شده به ابزار کمکی apigee-validate را ویرایش کنید. در نسخه 4.16.01 Edge، فایل پیکربندی مورداستفاده apigee-validate به ویژگی‌های زیر نیاز داشت:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  در این نسخه، فایل پیکربندی فقط به ویژگی APIGEE_ADMINPW نیاز دارد. می‌توانید دو دارایی دیگر را از فایل بردارید.
Update the apigee-provision utility:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
ابزار به‌روزرسانی را در گره‌هایتان به‌ترتیبی که در زیر در «ترتیب به‌روزرسانی دستگاه» شرح داده شده است اجرا کنید:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

از گزینه «-c» برای مشخص کردن مؤلفه موردنظر برای به‌روزرسانی استفاده کنید. فهرست مؤلفه‌های احتمالی شامل موارد زیر است:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =همه مؤلفه‌های Edge به‌جز Edge UI: سرور مدیریت، پردازشگر پیام، مسیریاب، سرور QPID، سرور Postgres
ui = Edge UI
all = به‌روزرسانی همه مؤلفه‌ها در دستگاه (فقط برای نمایه نصب Edge aio یا نمایه نصب API BaaS asa استفاده می‌شود)
e = ElasticSearch
b = پشته API BaaS
p = درگاه API BaaS
ebp = ElasticSearch، پشته API BaaS، و درگاه API BaaS در همان گره
به‌روزرسانی را با اجرای ابزار کمکی apigee-validate در «سرور مدیریت» آزمایش کنید، همان‌طور که در آزمایش نصب شرح داده شده است.
اگر گره آماده‌به‌کار Postgres جدیدی نصب کرده‌اید، گره را طبق شرح بالا در ازکار انداختن گره Postgres ازکار بیندازید.

برای بازگرداندن به‌روزرسانی در آینده، از رویه شرح‌داده‌شده در فرایند بازگرداندن ۴.۱۶.۰۹ استفاده کنید.

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

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

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