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

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

این رویه نحوه ارتقا دادن نصب محلی موجود «سرویس‌های کانال توسعه‌دهنده 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 (Nginx)
  • /var/www/html (Apache)

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

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

دایرکتوری نصب پیش‌فرض جدید پس‌از به‌روزرسانی Nginx/Postgres از نصب جدید 4.17.01

پس‌از به‌روزرسانی نصب جدید 4.17.01 که از Nginx/Postgres استفاده می‌کند، دایرکتوری ریشه از این مقدار تغییر کرد:

/opt/apigee/apigee-drupal

به:

/opt/apigee/apigee-drupal/wwwroot

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

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

  • 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
  • OPDK-17-01.x

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

http://yourportal.com/buildInfo

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

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

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

ارتقا دادن درگاه بااستفاده از فایل tar.

  1. از نمونه Drupal MySQL/MariaDB خود پشتیبان‌گیری کنید.
    برای اطلاعات بیشتر، به 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>

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

    به پشتیبانی Apigee Edge بروید و ورود به سیستم «درگاه پشتیبانی» را انتخاب کنید تا فایل 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. به پیام‌واره‌ها پاسخ دهید.

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

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

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

  1. به فهرست Drupal، /opt/apigee/apigee-drupal به‌طور پیش‌فرض بروید:
    > cd /opt/apigee/apigee-drupal
  2. از نمونه پایگاه داده Drupal خود پشتیبان‌گیری کنید. The pg_dump command creates a copy of the database:

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

    where:
    • 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. SELinux را طبق توضیحات نصب برنامه کمکی apigee-setup در Edge غیرفعال کنید.
  6. برای ارتقا دادن در سرور دارای اتصال اینترنت:
    1. فایل Edge 4.17.05 bootstrap_4.17.05.sh را در /tmp/bootstrap_4.17.05.sh بارگیری کنید:
      > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
    2. برنامه کمکی Edge 4.17.05 apigee-service و وابستگی‌ها را نصب کنید:
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

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

      به‌طور پیش‌فرض، نصب‌کننده بررسی می‌کند که Java 1.8 را نصب کرده باشید. می‌توانید از گزینه «C» برای ادامه بدون نصب Java استفاده کنید.
  7. برای ارتقا دادن سرور بدون اتصال اینترنت:
    1. یک مخزن محلی 4.17.05 ایجاد کنید، همان‌طور که در «ایجاد مخزن Apigee محلی» در نصب ابزار کمکی راه‌اندازی apigee در Edge شرح داده شده است.
      توجه: اگر ازقبل مخزن 4.17.01 دارید، می‌توانید مخزن 4.17.05 را به آن اضافه کنید، همان‌طور که در «به‌روزرسانی مخزن Apigee محلی» در نصب ابزار کمکی apigee-setup در Edge شرح داده شده است.
    2. برای نصب apigee-service از فایل tar .:
      1. On the node with the local repo, use the following command to package the local repo into a single .tar file named /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
      2. فایل tar .را در گره‌ای که می‌خواهید Edge را به‌روز کنید کپی کنید. برای مثال، آن را در دایرکتوری /tmp در گره جدید کپی کنید.
      3. در گره جدید، فایل را در دایرکتوری /tmp از حالت tar خارج کنید:
        > tar -xzf apigee-4.17.05.tar.gz

        این فرمان دایرکتوری جدیدی به‌نام repos در دایرکتوری حاوی فایل tar .ایجاد می‌کند. برای مثال tmp /repos/.
      4. ابزار Edge apigee-service و وابستگی‌ها را از /tmp/repos نصب کنید:
        > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

        توجه داشته باشید که مسیر دایرکتوری repos را در این فرمان اضافه کنید.
    3. برای نصب apigee-service بااستفاده از وب‌سرور Nginx:
      1. سرور وب Nginx را همان‌طور که در «نصب از مخزن بااستفاده از سرور وب Nginx» در نصب ابزار کمکی apigee-setup در Edge شرح داده شده است پیکربندی کنید.
      2. On the remote node, download the Edge bootstrap_4.17.05.sh file to /tmp/bootstrap_4.17.05.sh:
        > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh

        where uName:pWord are the username and password you set above for the repo, and remoteRepo is the IP address or DNS name of the repo node.
      3. On the remote node, install the Edge apigee-service utility and dependencies:
        > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        where uName:pWord are the repo username and password.
  8. از apigee-service برای به‌روزرسانی ابزار apigee-setup استفاده کنید:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  9. ابزار به‌روزرسانی را در گره خود اجرا کنید تا پایگاه داده Postgres به‌روز شود:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    که configFile فایل پیکربندی است که برای نصب پایگاه داده Postgres استفاده کردید. تنها شرط لازم برای فایل پیکربندی این است که فایل پیکربندی باید برای کاربر «apigee» قابل‌دسترسی یا خواندن باشد.
  10. Postgres را راه‌اندازی کنید:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  11. ابزار به‌روزرسانی را در گره خود اجرا کنید تا درگاه به‌روز شود:
    > /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

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

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

/opt/apigee/apigee-drupal/wwwroot

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