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

به روز رسانی Apigee Edge 4.16.01 به 4.16.05، به روز رسانی Apigee Edge 4.16.01 به 4.16.05

Edge for Private Cloud نسخه 4.16.05

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

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

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

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

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

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

نیاز به ارتقاء به 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 .

هشدار : این نسخه از Edge از JDK 7 پشتیبانی نمی کند. اگر در حال حاضر از JDK 7 استفاده می کنید، باید به JDK 8 ارتقا دهید. اگر نصب Edge 4.16.05 را برگردانید، می توانید Edge را برای استفاده از Java JDK 7 مجدداً پیکربندی کنید.

تنزل رتبه Zookeeper

نسخه 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.948 بازگشت. این امر از yum از ارتقای Zookeeper به نسخه های بعدی از 4.16.01 جلوگیری می کند. راه برای اصلاح این وضعیت این است که قبل از به‌روزرسانی Zookeeper ، yum downgrade apigee-zookeeper را اجرا کنید.

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

> rpm -qa |grep apigee-zookeeper

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

apigee-zookeeper-3.4.5-1.0.905

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

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

قبل از انجام به روز رسانی، مطمئن شوید که حداقل 1 گیگابایت فضای دیسک آزاد دارید.

انتشار خودکار تنظیمات ویژگی از 4.16.01.x

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

به روز رسانی ابزار apigee-validate

در 4.16.01، ابزار apigee-validate را بر روی یک گره Message Processor نصب و اجرا کردید. در 4.16.05، ابزار apigee-validate برای اجرا در گره مدیریت سرور به روز شده است.

وقتی به 4.16.05 به روز می کنید، دو گزینه برای نحوه به روز رسانی ابزار apigee-validate دارید:

توصیه Apigee - ابزار apigee-validate را در گره مدیریت سرور نصب و اجرا کنید.

می‌توانید به‌صورت اختیاری ابزار apigee-validate را از گره‌های Message Processor حذف نصب کنید. اگر آن را روی گره Message Processor بگذارید، باید آن را به 4.16.05 به روز کنید.
روش دیگر، ابزار apigee-validate را در گره Message Processor به روز کنید و آن را از آنجا اجرا کنید. با این حال، Apigee توصیه می کند که آن را از سرور مدیریت نصب و اجرا کنید.

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

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

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

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

> /<inst_root>/apigee/apigee-service/bin/apigee-all status

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

در صورت وجود، کارهای CRON را که برای انجام عملیات تعمیر در Cassandra پیکربندی شده اند، تا زمانی که به روز رسانی کامل نشده است، غیرفعال کنید.
برای نصب Edge RPM به عنوان root وارد گره خود شوید
توجه : در حالی که نصب RPM به دسترسی ریشه نیاز دارد، می‌توانید پیکربندی Edge را بدون دسترسی ریشه انجام دهید.
همانطور که در Install the Edge apigee-setup utility توضیح داده شد SELinux را غیرفعال کنید.
فایل Edge 4.16.05 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
ابزار و وابستگی های سرویس edge 4.16.05 apigee-service را نصب کنید:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser= uName apigeepassword= pWord
که در آن uName:pWord نام کاربری و رمز عبوری است که از Apigee دریافت کرده اید. اگر pWord را حذف کنید، از شما خواسته می شود آن را وارد کنید.
به طور پیش فرض، نصب کننده بررسی می کند که جاوا 1.8 را نصب کرده اید. اگر این کار را نکنید، آن را برای شما نصب می کند. از گزینه JAVA_FIX برای تعیین نحوه مدیریت نصب جاوا استفاده کنید. JAVA_FIX مقادیر زیر را می گیرد:
I = نصب OpenJDK 1.8 (پیش‌فرض)
C = بدون نصب جاوا ادامه دهید
Q = ترک. برای این گزینه باید خود جاوا را نصب کنید.
از 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 را در <inst_dir>/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 را در <inst_dir>/apigee/apigee-setup/bin نصب می‌کند.
ابزار apigee-validate را روی سرور مدیریت نصب کنید:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
توجه : اگر ابزار apigee-validate را روی یک گره پردازشگر پیام نصب کرده اید، می توانید با استفاده از دستور زیر در آن گره، آن را به روز کنید:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate به روز رسانی
با این حال، برای 4.16.05، Apigee توصیه می‌کند که برنامه apigee-validate را روی سرور مدیریت نصب و اجرا کنید.
فایل پیکربندی ارسال شده به ابزار apigee-validate را ویرایش کنید. در نسخه قبلی Edge، فایل پیکربندی مورد استفاده توسط apigee-validate به ویژگی‌های زیر نیاز داشت:
APIGEE_ADMINPW=sysAdminPword
MP_POD = دروازه
REGION=dc-1
در این نسخه، فایل پیکربندی فقط به ویژگی APIGEE_ADMINPW نیاز دارد. می توانید دو ویژگی دیگر را از فایل حذف کنید.
ابزار به روز رسانی را بر روی گره های خود به ترتیبی که در زیر در "ترتیب به روز رسانی ماشین" در زیر توضیح داده شده است، اجرا کنید:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
تنها مورد نیاز فایل پیکربندی این است که فایل پیکربندی باید توسط کاربر "apigee" قابل دسترسی یا خواندن باشد. برای مثال، فایل را در پوشه /tmp روی گره قرار دهید.
از گزینه "-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 روی سرور مدیریت آزمایش کنید.

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

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

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

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

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

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

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

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

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

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

قبل از اینکه گره های دیگری را به روز کنید، باید تمام گره های Cassandra و ZooKeeper را به روز کنید.
قبل از به‌روزرسانی گره‌های روتر و پردازشگر پیام، باید تمام گره‌های qpidd و postgresql را به‌روزرسانی کنید.
برای هر ماشینی با اجزای متعدد لبه (مدیریت سرور، پردازشگر پیام، روتر، سرور QPID، سرور Postgres)، از گزینه "-c edge" استفاده کنید تا همه آنها را همزمان به روز کنید.
اگر مرحله ای مشخص می کند که باید روی چندین ماشین انجام شود، آن را به ترتیب ماشین مشخص شده انجام دهید.
هیچ مرحله جداگانه ای برای به روز رسانی کسب درآمد وجود ندارد. زمانی که گزینه "-c edge" را مشخص کنید به روز می شود.
پس از به روز رسانی یک گره روتر، باید همه فایل ها را از پوشه /opt/nginx/conf.d حذف کنید و سپس روتر را مجددا راه اندازی کنید.