ارتقا دادن درگاه

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

این رویه نحوه ارتقا دادن نصب درون‌محل درگاه Apigee Developer Services (یا به‌طور خلاصه، درگاه) موجود را شرح می‌دهد.

تعیین روش صحیح به‌روزرسانی

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

• اگر نصب شما از Nginx/Postgres استفاده می‌کند، از ارتقا دادن درگاه بااستفاده از RPM در زیر استفاده کنید.
• اگر نصب شما از Apache/MySQL یا Apache/MariaDB استفاده می‌کند، تبدیل درگاه مبتنی بر tar به درگاه مبتنی بر RPM را ببینید.

تعیین نوع نصب فعلی

اگر درباره نوع نصب فعلی‌تان مطمئن نیستید، از فرمان زیر برای تعیین آن استفاده کنید:

• ls /opt

  اگر از Nginx/Postgres استفاده می‌کنید، دایرکتوری‌های زیر را خواهید دید: /opt/apigee و /opt/nginx.

  اگر از Apache/MySQL یا Apache/MariaDB استفاده می‌کنید، این دایرکتوری‌ها نباید وجود داشته باشند.

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

  اگر از Nginx/Postgres استفاده می‌کنید، خروجی زیر را خواهید دید:

  + apigee-service
  apigee-drupal-devportal status
  OK: apigee-drupal-devportal is up and running
  + apigee-service apigee-lb status
  apigee-service: apigee-lb: OK
  + apigee-service apigee-postgresql status
  apigee-service: apigee-postgresql: OK

• apachectl -S

  اگر از Apache/MySQL یا Apache/MariaDB استفاده می‌کنید، این فرمان باید دایرکتوری ریشه وب درگاه را به این شکل برگرداند:

  *:80
  192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)

دایرکتوری نصب پیش‌فرض

فرایند ارتقا فرض می‌کند که درگاه در این نشانی نصب شده است:

• نسخه ۴.۱۷.۰۵ و بالاتر: /opt/apigee/apigee-drupal/wwwroot
• قبل‌از نسخه ۴.۱۷.۰۵: /opt/apigee/apigee-drupal (Nginx) یا /var/www/html (Apache)

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

نسخه‌های ارتقای پشتیبانی‌شده

این روش ارتقا برای نسخه‌های زیر از درگاه پشتیبانی می‌شود:

• OPDK-17-01.x
• OPDK-17-05.x
• OPDK-17-09.x
• OPDK-18-01.x
• OPDK-18-05.x

برای تعیین نسخه درگاه، نشانی وب زیر را در مرورگر باز کنید:

http://yourportal.com/buildInfo

قبل‌از به‌روز کردن

برای نصب‌های موجود، اگر کدی را در هسته Drupal یا در هریک از ماژول‌های غیرسفارشی اصلاح کرده باشید، اصلاحات شما رونویسی خواهد شد. این شامل، ازجمله، هرگونه تغییری است که ممکن است در .htaccess ایجاد کرده باشید. باید فرض کنید که هر چیزی خارج از فهرست راهنمای /sites متعلق به Drupal است. یک استثنا برای این قانون robots.txt است؛ اگر این فایل در ریشه وب وجود داشته باشد، برای شما حفظ خواهد شد.

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

ارتقا دادن درگاه بااستفاده از RPM

برای به‌روزرسانی RPM درگاه در گره:

1. به فهرست Drupal بروید، /opt/apigee/apigee-drupal به‌طور پیش‌فرض:

   cd /opt/apigee/apigee-drupal

2. از نمونه پایگاه داده Drupal خود پشتیبان‌گیری کنید. فرمان pg_dump نسخه‌ای از پایگاه داده ایجاد می‌کند:

   pg_dump --dbname=devportal --host=host_IP_address --username=drupaladmin
     --password --format=c > /tmp/portal.dmp

   مکان:

   • devportal نام پایگاه داده است که توسط ویژگی PG_NAME در فایل پیکربندی نصب پورتال مشخص شده است.
   • host_IP_address نشانی IP گره درگاه است.
   • drupaladmin نام کاربری Postgres است که پورتال برای دسترسی به پایگاه داده استفاده می‌کند، همان‌طور که توسط ویژگی DRUPAL_PG_USER در فایل پیکربندی نصب پورتال مشخص شده است.

   از شما خواسته می‌شود گذرواژه کاربر Postgres را همان‌طور که توسط ویژگی DRUPAL_PG_PASS در فایل پیکربندی نصب درگاه تعریف شده است وارد کنید.

   اگر بعداً خواستید از نسخه پشتیبان بازیابی کنید، از فرمان زیر استفاده کنید:

   pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp

3. از کل دایرکتوری ریشه وب Drupal خود نسخه پشتیبان تهیه کنید. مکان نصب پیش‌فرض /opt/apigee/apigee-drupal است، اما ممکن است آن را تغییر داده باشید.

   اگر از مکان این دایرکتوری مطمئن نیستید، از فرمان drush status یا ورودی پیکربندی > رسانه > فایل در منو Drupal برای تعیین مکان سیستم فایل عمومی و مسیر سیستم فایل خصوصی (برای مرحله بعدی) استفاده کنید.

4. از فایل‌های موجود در /opt/apigee/data/apigee-drupal-devportal/private نسخه پشتیبان تهیه کنید.
5. Drupal را روی حالت تعمیر و نگهداری تنظیم کنید:
   1. پیکربندی را در منو Drupal انتخاب کنید.
   2. در صفحه پیکربندی، حالت تعمیر را در بخش توسعه انتخاب کنید.
   3. چارگوش قرار دادن سایت در حالت تعمیر را انتخاب کنید.
   4. پیامی را وارد کنید که کاربران درطول تعمیرات می‌بینند.
   5. ذخیره پیکربندی را انتخاب کنید.
6. SELinux را طبق روشی که در نصب ابزار کمکی apigee-setup در Edge توضیح داده شده است غیرفعال کنید.
7. به فهرست راهنمای /opt بروید:

   cd /opt

8. برای ارتقا دادن در سروری که اتصال اینترنت دارد:
   1. فایل Edge 4.19.01 bootstrap_4.19.01.sh را در /tmp/bootstrap_4.19.01.sh بارگیری کنید:

      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

   2. برنامه کمکی Edge 4.19.01 apigee-service و وابستگی‌ها را نصب کنید:

      sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

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

      به‌طور پیش‌فرض، نصب‌کننده بررسی می‌کند که Java 1.8 را نصب کرده باشید. می‌توانید از گزینه «C» برای ادامه دادن بدون نصب Java استفاده کنید.

9. برای ارتقا در سروری که اتصال اینترنت ندارد:
   1. یک مخزن محلی 4.19.01 ایجاد کنید، همان‌طور که در ایجاد مخزن Apigee محلی شرح داده شده است.
   2. برای نصب apigee-service از فایل tar .:
      1. در گره با مخزن محلی، از فرمان زیر برای بسته‌بندی مخزن محلی در یک فایل ‎ .tar با نام /opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz استفاده کنید:

         /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

      2. فایل tar .را در گره‌ای که می‌خواهید Edge را به‌روز کنید کپی کنید. برای مثال، آن را در دایرکتوری /tmp در گره جدید کپی کنید.
      3. در گره جدید، فایل را در دایرکتوری /tmp از حالت tar خارج کنید:

         tar -xzf apigee-4.19.01.tar.gz

         این فرمان یک فهرست راهنمای جدید به نام repos در فهرست راهنمای حاوی فایل .tar ایجاد می‌کند. برای مثال tmp /repos/.

      4. برنامه کمکی Edge apigee-service و وابستگی‌ها را از /tmp/repos نصب کنید:

         sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

         توجه داشته باشید که مسیر دایرکتوری repos را در این فرمان اضافه می‌کنید.

   3. برای نصب apigee-service بااستفاده از وب‌سرور Nginx:
      1. سرور وب Nginx را همان‌طور که در «نصب از مخزن بااستفاده از سرور وب Nginx» در نصب ابزار کمکی apigee-setup در Edge شرح داده شده است پیکربندی کنید.
      2. در گره دور، فایل Edge bootstrap_4.19.01.sh را در /tmp/bootstrap_4.19.01.sh بارگیری کنید:

         /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh
           -o /tmp/bootstrap_4.19.01.sh

         که در آن uName و pWord نام کاربری و گذرواژه‌ای هستند که در بالا برای مخزن تنظیم کرده‌اید، و remoteRepo نشانی IP یا نام ساناد گره مخزن است.

      3. در گره راه دور، ابزار کمکی Edge apigee-service و وابستگی‌ها را نصب کنید:

         sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939
           apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

         که uName و pWord نام کاربری و گذرواژه مخزن هستند.

10. از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید:

    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

11. برنامه کمکی به‌روزرسانی را در گره Postgres اجرا کنید:

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

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

12. برای به‌روزرسانی درگاه، ابزار کمکی به‌روزرسانی را در گره خود اجرا کنید:

    /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

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

13. اسکریپت update.php Drupal را با باز کردن نشانی وب زیر در پنجره مرورگر اجرا کنید:

    http://portal_IP_DNS:8079/update.php

14. غیرفعال کردن حالت تعمیر:
    1. پیکربندی را در منو Drupal انتخاب کنید.
    2. در صفحه پیکربندی، حالت تعمیر را در بخش توسعه انتخاب کنید.
    3. چارگوش قرار دادن سایت در حالت تعمیر را لغو انتخاب کنید.
    4. ذخیره پیکربندی را انتخاب کنید.

توجه داشته باشید که دایرکتوری ریشه پس‌از به‌روزرسانی عبارت است از:

/opt/apigee/apigee-drupal/wwwroot

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

ارتقای Drupal را دوباره اجرا کنید

اگر اجرای ابزار به‌روزرسانی Apigee برای ارتقا دادن Edge for Private Cloud درواقع منجر به تنزل نسخه Drupal شما می‌شود، ارتقای Drupal را بازنصب کنید. این ممکن است درصورتی اتفاق بیفتد که شما فقط Drupal را در بین به‌روزرسانی‌های Private Cloud ارتقا داده باشید.

برای مثال:

1. شما درحال اجرای نسخه 4.18.05 از Edge for Private Cloud بودید که شامل Drupal 7.59 بود.
2. به‌دلیل به‌روزرسانی امنیتی لازم، Drupal را به نسخه ۷.۶۴ ارتقا دادید.
3. اکنون درحال ارتقا دادن Private Cloud به نسخه ۴.۱۹.۰۱ هستید که شامل Drupal 7.61 است.

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