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

درگاه خدمات توسعه‌دهنده نسخه ۴.۱۶.۰۹

این رویه نحوه ارتقا دادن نصب محلی موجود «خدمات کانال توسعه‌دهندگان 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

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

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 نام کاربری -p'گذرواژه' DATABASENAME > /path/to/backup_dir/database-backup.sql

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

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

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

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

    به 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» فعال باشد. از منو Drupal، واحدها را انتخاب کنید و به پایین واحد مدیر به‌روزرسانی پیمایش کنید. اگر فعال نیست، آن را فعال کنید.

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

      از عنصر منو گزارش‌ها > به‌روزرسانی‌های دردسترس > تنظیمات برای پیکربندی واحد استفاده کنید تا وقتی به‌روزرسانی دردسترس است به شما ایمیل کند و تعداد دفعات بررسی به‌روزرسانی‌ها را تنظیم کنید.
  5. برای ارتقا در سروری که اتصال اینترنت ندارد:
    1. در سروری که فایل «خدمات کانال توسعه‌دهندگان» DeveloperServices_x.y.z.tar را بارگیری کرده‌اید، فایل ارتقای درگاه را استخراج کنید:
      > 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. به پیام‌واره‌ها پاسخ دهید.

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