درحال ارتقا دادن درگاه «سرویس‌های توسعه‌دهنده»

Developer Services Portal v. 4.17.09

این رویه نحوه ارتقا دادن نصب محلی موجود «سرویس‌های کانال توسعه‌دهنده Apigee» را شرح می‌دهد.

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

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

درحال تعیین نوع نصب فعلی شما

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

  • 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
  • قبل‌از 4.17.05: /opt/apigee/apigee-drupal (Nginx) یا /var/www/html (Apache)

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

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

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

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

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

http://your_portal.com/buildInfo

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

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

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

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

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

  1. به دایرکتوری Drupal بروید. برای مثال، /opt/apigee/apigee-drupal/wwwroot. 

    cd /opt/apigee/apigee-drupal/wwwroot

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

  2. از نمونه پایگاه داده Drupal خود پشتیبان‌گیری کنید. فرمان pg_dump نسخه‌ای از پایگاه داده ایجاد می‌کند:
    pg_dump --dbname=devportal --host=192.168.56.101
  --username=drupaladmin --password --format=c > /tmp/portal.dmp

    مکان:

    • dbname نام پایگاه داده را همان‌طور که توسط ویژگی PG_NAME در فایل پیکربندی نصب پورتال مشخص شده است، تعیین می‌کند.
    • host نشانی IP گره درگاه را مشخص می‌کند.
    • username نام کاربری 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.17.09 bootstrap_4.17.09.sh را در /tmp/bootstrap_4.17.09.sh بارگیری کنید: 
      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
    2. برنامه کمکی Edge 4.17.09 apigee-service و وابستگی‌ها را نصب کنید: 
      sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName
  apigeepassword=pWord

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

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

  9. برای ارتقا در سروری که اتصال اینترنت ندارد:
    1. یک مخزن محلی 4.17.09 ایجاد کنید، همان‌طور که در «ایجاد مخزن Apigee محلی» در نصب Edge ابزار کمکی apigee-setup شرح داده شده است.
    2. برای نصب apigee-service از فایل tar .:
      1. در گره با مخزن محلی، از فرمان زیر برای بسته‌بندی مخزن محلی در یک فایل ‎ .tar با نام /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz استفاده کنید: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
      2. فایل tar .را در گره‌ای که می‌خواهید Edge را به‌روز کنید کپی کنید. برای مثال، آن را در دایرکتوری /tmp در گره جدید کپی کنید.
      3. در گره جدید، فایل را در دایرکتوری /tmp از حالت tar خارج کنید:
        tar -xzf apigee-4.17.09.tar.gz

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

      4. ابزار Edge apigee-service و وابستگی‌ها را از /tmp/repos نصب کنید: 
        sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

    3. برای نصب apigee-service بااستفاده از وب‌سرور Nginx:
      1. سرور وب Nginx را همان‌طور که در «نصب از مخزن بااستفاده از سرور وب Nginx» در نصب ابزار کمکی apigee-setup در Edge شرح داده شده است پیکربندی کنید.
      2. در گره دور، فایل Edge bootstrap_4.17.09.sh را در /tmp/bootstrap_4.17.09.sh بارگیری کنید: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh
  -o /tmp/bootstrap_4.17.09.sh

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

      3. در گره راه دور، ابزار کمکی Edge apigee-service و وابستگی‌ها را نصب کنید:code 
        sudo bash /tmp/bootstrap_4.17.09.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. Postgres را راه‌اندازی کنید:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  13. برای به‌روزرسانی درگاه، ابزار کمکی به‌روزرسانی را در گره خود اجرا کنید: 
    /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

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

  14. اسکریپت update.php Drupal را با باز کردن نشانی وب زیر در پنجره مرورگر اجرا کنید: 
    http://portalIP_DNS:8079/update.php
  15. Drupal را در حالت تعمیر غیرفعال کنید:
    1. پیکربندی را در منو Drupal انتخاب کنید.
    2. در صفحه پیکربندی، حالت نگهداری را در بخش توسعه انتخاب کنید.
    3. چارگوش قرار دادن سایت در حالت تعمیر را لغو انتخاب کنید.
    4. ذخیره پیکربندی را انتخاب کنید.

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

/opt/apigee/apigee-drupal/wwwroot

ارتقا اکنون تکمیل شده است.