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

به‌روزرسانی Apigee Edge 4.17.0x به 4.18.01

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

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

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

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

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

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

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

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

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

حفظ سازگاری

هنگام ارتقا دادن Apigee Edge for Private Cloud به نسخه ۴.۱۸.۰۱، باید مطمئن شوید که پیاده‌سازی حاصل فقط به ویژگی‌های پشتیبانی‌شده در فایل‌های پیکربندی آن ارجاع می‌دهد.

دارایی	مکان	شرح
`conf_load_balancing_load.balancing. driver.nginx.server.retry`	`router.properties`	این ویژگی را از فایل `router.properties` خود بردارید. برای تنظیم گزینه‌های تکرار مجدد در نسخه ۴.۱۸.۰۱، از ویژگی‌های پیکربندی میزبان مجازی استفاده کنید.

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

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

افزودن پارامتر پیکربندی SMTPMAILFROM الزامی است

Edge 4.17.05 پارامتر الزامی جدیدی به فایل پیکربندی اضافه کرد که هنگام فعال کردن سرور SMTP استفاده می‌شود. اگر از نسخه ۴.۱۷.۰۱ به‌روزرسانی می‌کنید، باید SMTPMAILFROM را در فایل پیکربندی هنگام فعال کردن سرور SMTP تنظیم کنید.

API BaaS نسخه ۴.۱۷.۰۹ همچنین پشتیبانی از ویژگی SMTPMAILFROM را اضافه کرد. هنگام به‌روزرسانی API BaaS از 4.17.01 یا 4.17.05، باید SMTPMAILFROM را در فایل پیکربندی تنظیم کنید.

این پارامتر این فرم را دارد:

SMTPMAILFROM="My Company <myco@company.com>"

ارتقا به Postgres 9.6 لازم است

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

اکثر سیستم‌های تولید Edge از دو گره Postgres استفاده می‌کنند که برای تکرار اصلی-آماده‌به‌کار پیکربندی شده‌اند. درطول فرایند به‌روزرسانی، وقتی گره‌های Postgres برای به‌روزرسانی غیرفعال هستند، داده‌های تجزیه‌وتحلیل همچنان در گره‌های Qpid نوشته می‌شوند. پس‌از به‌روزرسانی گره‌های Postgres و آنلاین شدن مجدد آن‌ها، داده‌های تجزیه‌وتحلیل به گره‌های Postgres ارسال می‌شود.

نحوه انجام به‌روزرسانی Postgres به نحوه پیکربندی فضای ذخیره‌سازی داده برای گره‌های Postgres بستگی دارد:

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

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

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

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

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

این رویه یک سرور آماده‌به‌کار Postgres در گره جدید ایجاد می‌کند. مطمئن شوید که سرور آماده‌به‌کار Postgres جدیدی را برای نسخه موجود Edge‏ (4.17.0x) نصب می‌کنید، نه برای نسخه 4.18.01.

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

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

در Postgres master فعلی، فایل /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 گره آماده‌به‌کار جدید است.

اگر فایل postgresql.properties وجود ندارد، آن را ایجاد کنید و از chown استفاده کنید تا به کاربر apigee دسترسی به آن را بدهید، همان‌طور که در مثال زیر نشان داده شده است:
```
chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
```
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.17.0x.sh را (که در آن 4.17.0x برابر با 4.17.01،‏ 4.17.05، یا 4.17.09 است) در /tmp/bootstrap_4.17.0x.sh بارگیری کنید:
```
curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
```
4. ابزار Edge apigee-service و وابستگی‌ها را نصب کنید:
```
sudo bash /tmp/bootstrap_4.17.0x.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>

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

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

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

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

> /opt/apigee/apigee-service/bin/apigee-all status

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

اگر درحال‌حاضر از تکرار Postgres master-standby با فضای ذخیره‌سازی محلی استفاده می‌کنید، گره آماده‌به‌کار Postgres جدیدی را همان‌طور که در بالا در نصب گره آماده‌به‌کار Postgres جدید شرح داده شده است نصب کنید.

اگر از فضای ذخیره‌سازی شبکه استفاده می‌کنید، لازم نیست گره جدید را نصب کنید. به‌جای آن، عکس آنی شبکه از فضای ذخیره‌سازی داده مورداستفاده Postgres بگیرید. برای اطلاعات بیشتر، به ارتقای الزامی به Postgres 9.6 مراجعه کنید.
درصورت وجود، هرگونه کار CRON را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده است غیرفعال کنید تا زمانی که به‌روزرسانی تکمیل شود.
برای نصب Edge RPM، به‌عنوان root به سیستم گره وارد شوید.
توجه: اگرچه نصب RPM به دسترسی ریشه نیاز دارد، می‌توانید پیکربندی Edge را بدون دسترسی ریشه انجام دهید.
yum-utils و yum-plugin-priorities را نصب کنید:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
SELinux را طبق توضیحات نصب برنامه کمکی apigee-setup در Edge غیرفعال کنید.
اگر در Oracle 7.x نصب می‌کنید، فرمان زیر را اجرا کنید:
> sudo yum-config-manager --enable ol7_optional_latest
اگر در 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
فایل Edge 4.18.01 bootstrap_4.18.01.sh را در /tmp/bootstrap_4.18.01.sh بارگیری کنید:
> curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
Install the Edge 4.18.01 apigee-service utility and dependencies:
> sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

where uName:pWord are the username and password you received from Apigee. اگر pWord را حذف کنید، از شما خواسته می‌شود آن را وارد کنید.

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

I = نصب OpenJDK 1.8 (پیش‌فرض)
C = ادامه دادن بدون نصب Java
Q = خروج. برای این گزینه، باید Java را خودتان نصب کنید.
از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
apigee-validate را در «سرور مدیریت» به‌روز کنید:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
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 شرح داده شده است ازکار بیندازید.

اگر از فضای ذخیره‌سازی شبکه استفاده می‌کنید، لازم نیست گره جدید را نصب کنید. برای اطلاعات بیشتر، به ارتقای الزامی به Postgres 9.6 مراجعه کنید.

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

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

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

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

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

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

اگر درحال‌حاضر از تکرار Postgres master-standby استفاده می‌کنید، گره آماده‌به‌کار Postgres جدیدی را طبق توضیحات بالا در نصب گره آماده‌به‌کار Postgres جدید نصب کنید.

اگر از فضای ذخیره‌سازی شبکه استفاده می‌کنید، لازم نیست گره جدید را نصب کنید. به‌جای آن، عکس آنی شبکه از فضای ذخیره‌سازی داده مورداستفاده Postgres بگیرید. برای اطلاعات بیشتر، به ارتقای الزامی به Postgres 9.6 مراجعه کنید.
یک مخزن محلی 4.18.01 ایجاد کنید، همان‌طور که در «ایجاد مخزن Apigee محلی» در نصب ابزار کمکی apigee-setup در Edge شرح داده شده است.
توجه: اگر ازقبل مخزن 4.17.0x دارید، می‌توانید مخزن 4.18.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.18.01.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. فایل tar .را در گره‌ای که می‌خواهید Edge را به‌روز کنید کپی کنید. برای مثال، آن را در دایرکتوری /tmp در گره جدید کپی کنید.
3. در گره جدید، فایل را در دایرکتوری /tmp از حالت tar خارج کنید:
  > tar -xzf apigee-4.18.01.tar.gz
  
  این فرمان دایرکتوری جدیدی به نام repos در دایرکتوری حاوی فایل tar .ایجاد می‌کند. برای مثال tmp /repos/.
4. ابزار کمکی Edge apigee-service و وابستگی‌ها را از /tmp/repos نصب کنید:
  > sudo bash /tmp/repos/bootstrap_4.18.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.18.01.sh file to /tmp/bootstrap_4.18.01.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.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.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  where uName:pWord are the repo username and password.
از apigee-service برای به‌روزرسانی ابزار کمکی apigee-setup استفاده کنید:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
برنامه کمکی apigee-validate را در «سرور مدیریت» به‌روز کنید.
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
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 ازکار بیندازید.

اگر از فضای ذخیره‌سازی شبکه استفاده می‌کنید، لازم نیست گره جدید را نصب کنید. برای اطلاعات بیشتر، به ارتقای الزامی به Postgres 9.6 مراجعه کنید.

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

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

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

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

برای نصب خوداتکای ۱ میزبان

توجه: برای نصب ۱-میزبان، لازم نیست گره آماده‌به‌کار Postgres جدیدی ایجاد کنید، حتی اگر از فضای ذخیره‌سازی محلی استفاده کند. توپولوژی همه‌کاره Edge برای محیط‌های شروع به کار و نمونه‌سازی طراحی شده است، نه برای تولید. بنابراین، هیچ رویه عقب‌گردی وجود ندارد. اگر به‌روزرسانی ناموفق بود، مراحل به‌روزرسانی را دوباره امتحان کنید. اگر به‌روزرسانی پس‌از چندبار تلاش همچنان ناموفق بود، ساده‌ترین گزینه این است که نسخه ‫۴.۱۸.۰۱ را از ابتدا نصب کنید.

اگر از نسخه 4.17.01 به‌روزرسانی می‌کنید، SMTPMAILFROM را در فایل پیکربندی خود تنظیم کنید اگر SMTP را در Edge فعال کرده‌اید. این پارامتر این فرم را دارد:
SMTPMAILFROM="My Company <myco@company.com>"
Update Cassandra and ZooKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
Update Qpid:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
به‌روزرسانی LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
Stop Postgres Server, Qpid server, and PostgreSQL:
> /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
Update postgresql:
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
پایگاه داده Postgres را به‌روز کنید:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
Update the remaining Edge components:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
Update Edge UI:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

برای نصب مستقل با ۲ میزبان

توجه: برای نصب ۲ میزبان، لازم نیست گره آماده‌به‌کار Postgres جدیدی ایجاد کنید، حتی اگر از فضای ذخیره‌سازی محلی استفاده کند. توپولوژی ۲ گره‌ای Edge برای شروع به کار و محیط‌های نمونه‌سازی طراحی شده است، نه برای تولید. بنابراین، هیچ رویه عقب‌گردی وجود ندارد. در شرایطی که به‌روزرسانی ناموفق است، مراحل به‌روزرسانی را دوباره امتحان کنید. اگر به‌روزرسانی پس‌از چندبار تلاش همچنان ناموفق بود، ساده‌ترین گزینه این است که نسخه ۴.۱۸.۰۱ را از نو نصب کنید.