ارتقاء پورتال خدمات توسعه دهنده

پورتال خدمات توسعه دهنده نسخه 4.17.05

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

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

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

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

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

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

    اگر از Apache/MySQL یا Apache/MariaDB استفاده می کنید، این دایرکتوری ها نباید وجود داشته باشند.
  • وضعیت /opt/apigee/apigee-service/bin/apigee-all
    اگر از Nginx/Postgres استفاده می کنید، خروجی زیر را مشاهده خواهید کرد:

    + وضعیت apigee-service apigee-drupal-devportal
    خوب: apigee-drupal-devportal راه اندازی شده است
    + وضعیت apigee-service apigee-lb
    apigee-service: apigee-lb: خوب
    + وضعیت apigee-service apigee-postgresql
    apigee-service: apigee-postgresql: خوب
  • 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 (آپاچی)

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

اگر دایرکتوری نصب را نمی دانید، می توانید آن را همانطور که در Commonly used Drush commands توضیح داده شده است، تعیین کنید.

دایرکتوری نصب پیش فرض جدید پس از به روز رسانی 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

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

http:// yourportal .com/buildInfo

قبل از آپدیت

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

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

ارتقاء پورتال با استفاده از فایل tar

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

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

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

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

      وقتی پورتال را نصب کردید، USERNAME و DATABASENAME را تنظیم کردید. به طور پیش فرض، هر دو deportal هستند.
  2. از کل فهرست اصلی وب دروپال خود یک نسخه پشتیبان تهیه کنید. محل نصب پیش فرض /var/www/html است، اما ممکن است در زمان نصب آن را تغییر داده باشید.
  3. فایل Developer Channel Services DeveloperServices_ x.yz .tar را از ftp.apigee.com دانلود کنید، جایی که xyz با شماره نسخه پورتال مطابقت دارد. وقتی از شما خواسته شد، اعتبارنامه هایی را که از Apigee دریافت کرده اید وارد کنید.

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

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

    به پشتیبانی Apigee Edge بروید و ورود به پورتال پشتیبانی خود را انتخاب کنید تا فایل tar ارتقاء خدمات کانال توسعه دهنده را درخواست کنید. اگر در پورتال پشتیبانی حساب کاربری ندارید، ورود به پورتال پشتیبانی خود را انتخاب کنید و سپس در صفحه ورود به سیستم، عجله دارید؟ یک بلیط پشتیبانی از اینجا تهیه کنید .
  4. برای ارتقا در سرور با اتصال اینترنت:
    1. فایل ارتقای پورتال را استخراج کنید:
      > tar -xvf <tar file>

      این دستور یک دایرکتوری جدید به نام DeveloperServices-4.xyz ایجاد می کند.
    2. به دایرکتوری DeveloperServices-4.xyz تغییر دهید.
    3. آخرین نسخه دروپال را با استفاده از دستور زیر دانلود کنید:
      > دروش dl دروپال

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

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

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

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

      این دستور یک دایرکتوری جدید به نام DeveloperServices-4.xyz ایجاد می کند.
    2. به دایرکتوری DeveloperServices-4.xyz تغییر دهید.
    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. به طور پیش فرض به دایرکتوری دروپال، /opt/apigee/apigee-drupal تغییر دهید:
    > cd /opt/apigee/apigee-drupal
  2. از نمونه پایگاه داده دروپال خود نسخه پشتیبان تهیه کنید. دستور pg_dump یک کپی از پایگاه داده ایجاد می کند:

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

    کجا:
    • dbname نام پایگاه داده را همانطور که توسط ویژگی PG_NAME در فایل پیکربندی نصب پورتال مشخص شده است، مشخص می کند.
    • میزبان آدرس IP گره پورتال را مشخص می کند.
    • نام کاربری نام کاربری Postgres را مشخص می کند که توسط پورتال برای دسترسی به پایگاه داده استفاده می شود، همانطور که توسط ویژگی DRUPAL_PG_USER در فایل پیکربندی نصب پورتال مشخص شده است.
    • از شما خواسته می شود رمز عبور کاربر Postgres را همانطور که توسط ویژگی DRUPAL_PG_PASS در فایل پیکربندی نصب پورتال تعریف شده است، وارد کنید.

    اگر بعداً مجبور شدید از نسخه پشتیبان بازیابی کنید، از دستور استفاده کنید:
    pg_restore --clean --dbname=devportal --host=localhost --username=apigee < /tmp/portal.dmp
  3. از کل فهرست اصلی وب دروپال خود یک نسخه پشتیبان تهیه کنید. محل نصب پیش فرض /opt/apigee/apigee-drupal است، اما ممکن است آن را تغییر داده باشید.

    اگر از مکان این دایرکتوری مطمئن نیستید، از دستور وضعیت drush یا Configuration > Media > File entry در منوی Drupal برای تعیین مکان سیستم فایل عمومی و مسیر سیستم فایل خصوصی (برای مرحله بعدی) استفاده کنید.
  4. یک نسخه پشتیبان از فایل ها در /opt/apigee/data/apigee-drupal-devportal/private تهیه کنید.
  5. همانطور که در Install the Edge apigee-setup utility توضیح داده شد SELinux را غیرفعال کنید.
  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 را حذف کنید، از شما خواسته می شود آن را وارد کنید.

      به طور پیش فرض، نصب کننده بررسی می کند که جاوا 1.8 را نصب کرده اید. برای ادامه بدون نصب جاوا می توانید از گزینه "C" استفاده کنید.
  7. برای ارتقا در سرور بدون اتصال به اینترنت:
    1. یک مخزن محلی 4.17.05 همانطور که در "ایجاد یک مخزن محلی Apigee" در نصب ابزار Edge apigee-setup توضیح داده شده است، ایجاد کنید.
      توجه : اگر قبلاً مخزن 4.17.01 موجود دارید، می‌توانید مخزن 4.17.05 را همانطور که در «به‌روزرسانی یک مخزن محلی Apigee» در نصب ابزار Edge apigee-setup توضیح داده شده است، به آن اضافه کنید.
    2. برای نصب apigee-service از فایل tar :
      1. در گره دارای مخزن محلی، از دستور زیر برای بسته بندی مخزن محلی در یک فایل .tar به نام /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz استفاده کنید:
        > /opt/apigee/apigee-service/bin/apigee-service بسته apigee-mirror
      2. فایل tar را در گره ای که می خواهید Edge را به روز کنید کپی کنید. به عنوان مثال، آن را در پوشه /tmp در گره جدید کپی کنید.
      3. در گره جدید، فایل را در پوشه /tmp untar کنید:
        > 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» در نصب ابزار Edge apigee-setup توضیح داده شده پیکربندی کنید.
      2. در گره راه دور، فایل Edge bootstrap_4.17.05.sh را در /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

        که در آن uName:pWord نام کاربری و رمز عبوری است که در بالا برای مخزن تنظیم کرده اید و remoteRepo آدرس IP یا نام DNS گره repo است.
      3. در گره راه دور، ابزار Edge apigee-service و وابستگی ها را نصب کنید:
        > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost= remoteRepo :3939 apigeeuser= uName apigeepassword= pWord apigeeprotocol=http://

        که در آن uName:pWord نام کاربری و رمز عبور مخزن است.
  8. از apigee-service برای به روز رسانی ابزار apigee-setup استفاده کنید:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup به روز رسانی
  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

ارتقا در حال حاضر کامل شده است.