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

Developer Services Portal نسخه ۴.۱۷.۰۱

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

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

فرایند ارتقا فرض می‌کند که «درگاه توسعه‌دهندگان» در /var/www/html نصب شده است. اگر درگاه را در دایرکتوری پیش‌فرض نصب نکرده‌اید، مسیرهای موجود در رویه زیر را اصلاح کنید تا از دایرکتوری نصب شما استفاده شود.

اگر فهرست نصب را نمی‌دانید، می‌توانید آن را همان‌طور که در فرمان‌های Drush که معمولاً استفاده می‌شود شرح داده شده است تعیین کنید.

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

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

  • pantheon-14.02.x
  • pantheon-14.03.x
  • pantheon-14.04.x
  • pantheon-14.07.x
  • pantheon-15-01.x
  • OPDK-15-04.x
  • OPDK-15-07.x
  • OPDK-16-01.x
  • OPDK-16-05.x
  • OPDK-16-09.x

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

http://yourportal.com/buildInfo

قبل‌از نصب

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

قبل‌از ادامه نصب، از کل دایرکتوری ریشه وب Drupal خود نسخه پشتیبان تهیه کنید. مکان نصب پیش‌فرض /var/www/html است، اما ممکن است آن را در زمان نصب تغییر داده باشید. پس‌از انجام مراحل نصب شرح‌داده‌شده در زیر، می‌توانید سفارشی‌سازی‌هایتان را از نسخه پشتیبان بازیابی کنید.

ارتقا دادن سرویس‌های کانال توسعه‌دهنده Apigee به نسخه جدید

  1. پشتیبان‌گیری از نمونه Drupal MySQL شما.
    برای اطلاعات بیشتر، به http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/ مراجعه کنید
    1. گزینه ۱: استفاده از Drush

      فرمان Drush sql-dump نسخه‌ای از پایگاه داده ایجاد می‌کند. از فهرست Drupal، /var/www/html به‌طور پیش‌فرض، فرمان زیر را اجرا کنید:
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      برای اطلاعات بیشتر، از drush help sql-dump استفاده کنید.
    2. گزینه ۲: استفاده از MySQLdump
      از فرمان mysqldump برای ایجاد نسخه‌ای از پایگاه داده استفاده کنید:
      mysqldump -u USERNAME -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql

      نباید بین گزینه -p و گذرواژه فاصله‌ای وجود داشته باشد. اگر گذرواژه حاوی نویسه‌های خاص باشد، باید در دو طرف گذرواژه گیومه تکی قرار دهید.

      USERNAME و DATABASENAME را هنگام نصب درگاه تنظیم کرده‌اید. به‌طور پیش‌فرض، هر دو devportal هستند.
  2. از کل دایرکتوری ریشه وب Drupal خود نسخه پشتیبان تهیه کنید. مکان نصب پیش‌فرض /var/www/html است، اما ممکن است آن را در زمان نصب تغییر داده باشید.
  3. فایل DeveloperServices_x.y.z.tar مربوط به «سرویس‌های کانال توسعه‌دهنده» را از ftp.apigee.com بارگیری کنید، که در آن x.y.z با شماره نسخه درگاه مطابقت دارد. وقتی از شما خواسته شد، اطلاعات اعتباری را که از Apigee دریافت کرده‌اید وارد کنید.

    می‌توانید فایلی را از پیوندی که Apigee برایتان ارسال کرده است در مرورگر بارگیری کنید یا آن را کپی کنید و سپس به فرمان cURL زیر اضافه کنید:
    > curl -kOL <paste link here>

    توجه: اگر درگاهتان در سروری بدون اتصال اینترنت خارجی است، این مرحله را در سروری با دسترسی انجام دهید.

    به http://community.apigee.com/content/apigee-customer-support بروید و ورود به سیستم «درگاه پشتیبانی» را انتخاب کنید تا فایل tar .ارتقای «سرویس‌های کانال توسعه‌دهنده» را درخواست کنید. اگر حسابی در «درگاه پشتیبانی» ندارید، ورود به سیستم «درگاه پشتیبانی» را انتخاب کنید و سپس در صفحه ورود به سیستم، عجله دارید؟ را انتخاب کنید. در اینجا بلیت پشتیبانی ایجاد کنید.
  4. برای ارتقا دادن در سرور دارای اتصال اینترنت:
    1. فایل ارتقای پورتال را استخراج کنید:
      > tar -xvf <tar file>

      این فرمان استخراج، دایرکتوری جدیدی به‌نام DeveloperServices-4.x.y.z ایجاد می‌کند.
    2. به دایرکتوری DeveloperServices-4.x.y.z تغییر دهید.
    3. جدیدترین نسخه Drupal را بااستفاده از فرمان زیر بارگیری کنید:
      > drush dl drupal

      این فرمان دایرکتوری‌ای با نام drupal-x.y ایجاد می‌کند که x.y با نسخه فعلی Drupal مطابقت دارد.
    4. اسکریپت networked-update.sh را اجرا کنید:
      > ./networked-update.sh

      بسته به اجازه‌های فایل، ممکن است لازم باشد از sudo برای اجرای این فرمان استفاده کنید، یا آن را به‌عنوان سرپرست اجرا کنید.
    5. برای دریافت اعلان‌های به‌روزرسانی‌های Drupal، مطمئن شوید که ماژول Drupal Update manager فعال است. از منو Drupal، Modules (ماژول‌ها) را انتخاب کنید و به پایین پیمایش کنید تا به ماژول Update manager (مدیر به‌روزرسانی) برسید. اگر فعال نیست، آن را فعال کنید.

      پس‌از فعال کردن، می‌توانید به‌روزرسانی‌های دردسترس را بااستفاده از گزینه منو گزارش‌ها > به‌روزرسانی‌های دردسترس ببینید.

      از گزینه منو گزارش‌ها > به‌روزرسانی‌های دردسترس > تنظیمات استفاده کنید تا ماژول را پیکربندی کنید تا وقتی به‌روزرسانی‌ها دردسترس هستند به شما ایمیل بزند و تناوب بررسی به‌روزرسانی‌ها را تنظیم کنید.
  5. برای ارتقا در سروری که اتصال اینترنت ندارد:
    1. در سروری که فایل DeveloperServices_x.y.z.tar مربوط به Developer Channel Services را بارگیری کردید، فایل ارتقای پورتال را از حالت فشرده خارج کنید:
      > tar -xvf <tar file>

      این فرمان استخراج، پوشه جدیدی به‌نام DeveloperServices-4.x.y.z ایجاد می‌کند.
    2. به دایرکتوری DeveloperServices-4.x.y.z تغییر دهید.
    3. اسکریپت non-networked-update.sh را اجرا کنید:
      > ./non-networked-update.sh

      بسته به اجازه‌های فایل، ممکن است لازم باشد از sudo برای اجرای این فرمان استفاده کنید یا آن را به‌عنوان سرپرست اجرا کنید.

      این فرمان همه فایل‌های به‌روزرسانی لازم را بارگیری می‌کند و آن‌ها را در یک فایل واحد به‌نام devportal-update.tgz بسته‌بندی می‌کند و فایل را در مکانی که انتخاب می‌کنید می‌نویسد.
    4. devportal-update.tgz را در سرور هدف، یعنی سروری که درگاه را اجرا می‌کند، کپی کنید.
      توجه: devportal-update.tgz را در ریشه وب سرور هدف کپی نکنید.
    5. فایل devportal-update.tgz را در دایرکتوری فعلی از حالت فشرده خارج کنید:
      > tar -xzf /path/to/devportal-update.tgz
    6. به دایرکتوری developer-update بروید.
    7. فرمان زیر را برای نصب به‌روزرسانی اجرا کنید:
      > ./install-update.sh
    8. به پیام‌واره‌ها پاسخ دهید.

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